Get metrics | Astro AI | Documentation

curl -G https://astropods.com/api/v1/agents/account/name/observability/metrics \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     --data-urlencode start_time=2024-04-01T00:00:00Z \
     --data-urlencode end_time=2024-04-01T06:00:00Z \
     -d interval=60

{
  "buckets": [
    {
      "timestamp": "2024-04-01T00:00:00Z",
      "trace_count": 120,
      "avg_latency_ms": 250.5,
      "input_tokens": 15000,
      "output_tokens": 18000,
      "error_count": 3
    },
    {
      "timestamp": "2024-04-01T01:00:00Z",
      "trace_count": 135,
      "avg_latency_ms": 230.2,
      "input_tokens": 16500,
      "output_tokens": 19500,
      "error_count": 1
    },
    {
      "timestamp": "2024-04-01T02:00:00Z",
      "trace_count": 110,
      "avg_latency_ms": 245,
      "input_tokens": 14000,
      "output_tokens": 17000,
      "error_count": 0
    }
  ],
  "time_range": {
    "start": "2024-04-01T00:00:00Z",
    "end": "2024-04-01T03:00:00Z"
  },
  "interval_minutes": 60
}

Returns bucketed trace metrics for the agent over a time range. Requires Langfuse observability to be configured.

Authentication

AuthorizationBearer

OAuth 2.0 device flow or platform session token

Path parameters

accountstringRequired

Account name (slug)

namestringRequired

Agent name

Query parameters

start_timedatetimeOptional

Start of time range (RFC 3339)

end_timedatetimeOptional

End of time range (RFC 3339)

intervalintegerOptionalDefaults to 60

Bucket interval in minutes (default 60)

Response

Bucketed metrics

bucketslist of objects

time_rangeobject

interval_minutesinteger

Errors

401

Unauthorized Error

403

Forbidden Error

503

Service Unavailable Error