Skip to main content
GET
Get Observability Metrics
Returns aggregated observability metrics for the machine-identity service within the specified time range. Metrics are pre-computed and bucketed by the requested granularity, enabling efficient dashboard queries and SLA reporting. Use this endpoint to power operational dashboards, monitor service health, track agent activity trends, and generate compliance reports.

Authentication

string
required
API key with metrics:read scope. Alternatively, pass a Bearer JWT token in the Authorization header.
string
required
Tenant identifier for multi-tenant isolation.

Query Parameters

string
required
Start of the time range in ISO 8601 format (e.g. 2026-04-06T00:00:00Z).
string
required
End of the time range in ISO 8601 format (e.g. 2026-04-06T23:59:59Z).
string
Aggregation granularity. Must be one of: hour, day, week. Defaults to hour.

Response

string
Start of the queried time range (ISO 8601).
string
End of the queried time range (ISO 8601).
string
Aggregation granularity used.
object
Counts per event type within the time range. Each key is an event type (e.g. orchestration.completed), each value is the total count.
object
Latency percentiles in milliseconds for key operations: - orchestration_p50 (number) — Median orchestration duration - orchestration_p95 (number) — 95th percentile orchestration duration - orchestration_p99 (number) — 99th percentile orchestration duration - guardrail_check_p50 (number) — Median guardrail check latency - guardrail_check_p95 (number) — 95th percentile guardrail check latency - guardrail_check_p99 (number) — 99th percentile guardrail check latency
number
Percentage of events with error severity across all event types. Range: 0.0 to 100.0.
integer
Number of unique agents that emitted at least one event during the time range.
integer
Total number of orchestrations started during the time range.
number
Total accumulated LLM inference cost in US cents across all orchestrations.
array
Time-series array of metric buckets. Each bucket contains timestamp, event_counts, error_rate, and active_agents for the bucket’s time window.

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Query Parameters

agent_id
string<uuid>

Filter by agent

metric_names
string

Comma-separated metric names (e.g. invocations,errors,latency_p99)

from
string<date-time>

Start of time range (ISO 8601)

to
string<date-time>

End of time range (ISO 8601)

interval
enum<string>
default:1h

Aggregation interval

Available options:
1m,
5m,
15m,
1h,
6h,
1d

Response

Metrics data

metrics
object[]