axonpush
API referenceAnalytics

GET /analytics/breakdown agent, tool, or tag

GET
/analytics/breakdown

Query Parameters

since?string

Window start (RFC3339); defaults to 24h before until

until?string

Window end (RFC3339); defaults to now

dimension?string

Breakdown dimension (default model)

Value in

  • "model"
  • "provider"
  • "status"
  • "source"
  • "app"
  • "channel"
  • "apiKey"
  • "user"
  • "agent"
  • "tool"
  • "eventType"
  • "finishReason"
  • "semanticKind"
  • "service"
  • "operation"
  • "errorType"
  • "tag"
tagKey?string

Attribute key to group by when dimension=tag

limit?integer

Top-N entries (default 50, max 500)

Formatint64
source?string

Filter by event source (e.g. gateway)

model?string

Filter by request/response model

provider?string

Filter by model provider

app?string

Filter by app id

channel?string

Filter by channel id

environment?string

Filter by environment id or slug

apiKey?string

Filter by API key id

user?string

Filter by end-user id

filterTagKey?string

Custom-dimension (attribute) key to filter on; pair with filterTagValue

filterTagValue?string

Value for filterTagKey

service?string

Filter by service (resource service.name)

operation?string

Filter by operation / span name

errorType?string

Filter by error type

Response Body

application/json

application/problem+json

curl -X GET "https://example.com/analytics/breakdown"
{  "$schema": "https://example.com/schemas/BreakdownOutputBody.json",  "dimension": "string",  "rows": [    {      "avgDurationMs": 0.1,      "costUsd": 0.1,      "errorCount": 0,      "eventCount": 0,      "inputTokens": 0,      "key": "string",      "outputTokens": 0,      "totalTokens": 0    }  ]}

PATCH /v2/alerts/{alertRuleId} PATCH

Previous Page

GET /analytics/dimensions GET

Start here for custom-dimension analytics: this lists the business attribute keys your app has stamped on its telemetry (e.g. participant_role, tenant, plan). Feed a key into /analytics/breakdown?dimension=tag&tagKey=<key> to rank it, then into filterTagKey+filterTagValue on /analytics/timeseries and /analytics/latency to trend and get percentiles for one value.