Query Metric
Time-bucketed count/sum/avg/min/max for one metric, with optional dimension filters.
Needs analytics.read for an unrestricted query. Passing project_id also accepts projects.alarms.read on that project, so a project-scoped role can read the series behind its own alarms.
Authorizations
Timbal API key. Obtain your API key from the Timbal platform settings. See Authentication for more information.
Path Parameters
Query Parameters
Metric to read, e.g. app.run.errors, deployment.health.
Bucket size in seconds (multiple of 60). Default 60.
Inclusive range start (epoch milliseconds). Default: 100 buckets before to.
Exclusive range end (epoch milliseconds). Default: now.
Filter to one project. Omit to aggregate across projects.
Filter to one environment.
Filter to one deployment.
Filter to one agent/workflow app (OrgsApps.id).
Filter to one label — the span name behind a trace-derived metric
(llm, get_address). Omit to sum across every label.
Response
Metric series