Getting started

Metrics helps you collect custom time-series data, query it at useful resolutions, and turn it into dashboards and alerts for operational work.

Start with the API guide when you want to send data from an application, service, job, or script. Move to dashboards when you want to turn those metrics into a workspace view your team can monitor.

Guides

• Send your first metric — publish a single value or a pre-aggregated min, max, avg, and count statistic set.
• Query metrics in the UI — inspect metric data with aggregations, time ranges, resolution, and dimension filters.
• Understand metric rollups — learn how resolution, buckets, sample count, and aggregations affect charts and alarms.
• Create an API token — generate a workspace token, store the secret, set expiration, and revoke old tokens.
• Create a dashboard — build a UI view for related metrics, add charts, arrange them, and share a read-only iframe.
• Create an alarm — define metric conditions, tune evaluation windows, and notify channels on state changes.
• Create notification channels — configure email and webhook destinations for alarm notifications.
• Create and use roles — understand built-in roles, create custom policies, invite members, and scope API tokens.
• Invite users to a workspace — send owner-only invitations, choose roles, and understand the acceptance flow.
• Manage account settings — update account details, change passwords, schedule deletion, and restore accounts.
• Manage workspaces — switch workspaces, understand owner/member access, and invite teammates.

Reference

• API reference — inspect endpoints, request shapes, response examples, and documented errors.

Suggested first path

1. Create an API token with write access.
2. Send a single metric value.
3. Query the metric with count, avg, or another aggregation.
4. Create a dashboard and add a chart for the metric.
5. Create a notification channel.
6. Create an alarm for the signal that needs attention.
7. Invite teammates with the role they need.