Quickstart

First event to first graph. You'll need about five minutes and a terminal.

1. Get your API key

Sign in with Google. The 14-day trial starts automatically, no card. Your API key is on the account page. It looks like st_9f2c…. Treat it like a password.

2. Send an event

curl -X POST https://api.simpletelemetry.io/v1/events \
  -H "Authorization: Bearer st_your_api_key" \
  -d '{"event":"deploy_finished","duration_ms":8421,"ok":true}'

The response is 202 {"accepted":1}. The event name became a table (deploy_finished), the fields became columns, and the server stamped the time. You never send timestamps. It's queryable within a couple of seconds.

3. Graph it

Open your dashboard (the ST logo, or simpletelemetry.io/your-alias), hit Edit Dash, then Add card → Graph over time. Open the card's gear, set the SQL to:

SELECT COUNT(*) FROM deploy_finished

and press Cmd/Ctrl+Enter. That's it: the card charts events per time bucket over the dashboard's time range. You didn't write any time handling; cards add it for you.

4. Keep sending

Run the curl a few more times. The dashboard refreshes every 30 seconds by default (or hit refresh in the toolbar) and the line moves. Send richer events, like {"event":"deploy_finished","duration_ms":912,"ok":false,"region":"eu"}, and try SELECT AVG(duration_ms) FROM deploy_finished GROUP BY region: one series per region.

Where next

Sending events for the rules (names, types, limits), and SQL for the whole query language. It fits on one page.