Getting Started

• TempoDB is a database service for time series data. It is optimized for storing and analyzing data that looks like this:

  2014-01-03T14:23:33.000+0600, 52.113
  2014-01-03T14:23:34.000+0600, 51.762
  2014-01-03T14:23:35.000+0600, 49.2
  2014-01-03T14:23:36.000+0600, 49.7123
  2014-01-03T14:23:37.000+0600, 50.43

  The first part is a timestamp in ISO8601 format. The second part is a number, which can be a double, float, or integer.

• Interacting with TempoDB

  You interact with TempoDB via our ReST API and data admin. We offer API clients in a number of languages to make it easy for you to get started.

• Example of Reading and Writing Data

  Below is an example of using the Python API client to read and write data. Clients in other languages work similarly. If you'd like help getting started, send us a note at [email protected].

  1. Signup for a TempoDB account. You will be prompted to create your first database. Note the API key and API secret that are created for you.

  2. Install the TempoDB Python API client library.

     pip install tempodb

  3. Download tempodb-write-demo.py.

     curl -O https://raw.github.com/tempodb/tempodb-python/master/tempodb/demo/tempodb-write-demo.py

     You can also use wget on Linux, or just copy and paste the contents of the file

  4. Edit your-api-key and your-api-secret in tempodb-write-demo.py.

  5. Run tempodb-write-demo.py to insert 10 days of test data.

     python tempodb-write-demo.py

  6. Download tempodb-read-demo.py.

     curl -O https://raw.github.com/tempodb/tempodb-python/master/tempodb/demo/tempodb-read-demo.py

     You can also use wget on Linux, or just copy and paste the contents of the file

  7. Edit your-api-key and your-api-secret in tempodb-read-demo.py.

  8. Run tempodb-read-demo.py to read back some of the data you just wrote in.

     python tempodb-read-demo.py