Skip to main content
GET
Query a metric series

Authorizations

Authorization
string
header
required

Timbal API key. Obtain your API key from the Timbal platform settings. See Authentication for more information.

Path Parameters

org_id
string
required

Query Parameters

name
string
required

Metric to read, e.g. app.run.errors, deployment.health.

period_seconds
integer<int32> | null

Bucket size in seconds (multiple of 60). Default 60.

from
integer<int64> | null

Inclusive range start (epoch milliseconds). Default: 100 buckets before to.

to
integer<int64> | null

Exclusive range end (epoch milliseconds). Default: now.

project_id
string | null

Filter to one project. Omit to aggregate across projects.

project_env_id
string | null

Filter to one environment.

deployment_id
string | null

Filter to one deployment.

workforce_id
string | null

Filter to one agent/workflow app (OrgsApps.id).

label
string | null

Filter to one label — the span name behind a trace-derived metric (llm, get_address). Omit to sum across every label.

Response

Metric series

Wrapper for GET /orgs/{org_id}/metrics.

bins
object[]
required

Buckets with data, ascending; empty buckets are omitted.

from
integer<int64>
required

Range start (epoch milliseconds).

name
string
required
period_seconds
integer<int32>
required
to
integer<int64>
required

Range end (epoch milliseconds).