GET /v1/metrics
Query aggregated metrics.
Request
curl "https://api.anyway.sh/v1/metrics?metric=llm.requests.total&interval=1h" \
-H "Authorization: Bearer YOUR_API_KEY"
Query Parameters
Metric name to query. Available metrics:
llm.requests.totalllm.requests.errorsllm.tokens.inputllm.tokens.outputllm.tokens.totalllm.cost.totalllm.latency_ms
Start of the time range (ISO 8601).
End of the time range (ISO 8601).
Aggregation interval: 1m, 5m, 15m, 1h, 1d.
Aggregation function: sum, avg, min, max, count, p50, p90, p99.
Dimension to group by: model, vendor, environment, project.
Example: Total Requests by Model
curl "https://api.anyway.sh/v1/metrics?\
metric=llm.requests.total&\
start_time=2024-01-15T00:00:00Z&\
end_time=2024-01-16T00:00:00Z&\
interval=1h&\
group_by=model" \
-H "Authorization: Bearer YOUR_API_KEY"
Response
{
"data": {
"metric": "llm.requests.total",
"aggregation": "sum",
"interval": "1h",
"series": [
{
"group": {
"model": "gpt-4"
},
"datapoints": [
{
"timestamp": "2024-01-15T00:00:00Z",
"value": 1500
},
{
"timestamp": "2024-01-15T01:00:00Z",
"value": 1420
},
{
"timestamp": "2024-01-15T02:00:00Z",
"value": 890
}
]
},
{
"group": {
"model": "gpt-4o-mini"
},
"datapoints": [
{
"timestamp": "2024-01-15T00:00:00Z",
"value": 5200
},
{
"timestamp": "2024-01-15T01:00:00Z",
"value": 4800
},
{
"timestamp": "2024-01-15T02:00:00Z",
"value": 3100
}
]
}
]
}
}
Example: P99 Latency
curl "https://api.anyway.sh/v1/metrics?\
metric=llm.latency_ms&\
start_time=2024-01-15T00:00:00Z&\
end_time=2024-01-16T00:00:00Z&\
interval=1h&\
aggregation=p99&\
group_by=model" \
-H "Authorization: Bearer YOUR_API_KEY"
Response
{
"data": {
"metric": "llm.latency_ms",
"aggregation": "p99",
"interval": "1h",
"series": [
{
"group": {
"model": "gpt-4"
},
"datapoints": [
{
"timestamp": "2024-01-15T00:00:00Z",
"value": 2340
},
{
"timestamp": "2024-01-15T01:00:00Z",
"value": 2150
}
]
}
]
}
}
Errors
| Code | Description |
|---|
invalid_metric | Unknown metric name |
invalid_interval | Invalid time interval |
invalid_aggregation | Invalid aggregation function |
