Get log statistics

Returns statistics for logs matching the specified filters.

GET /api/logs/stats

Error

A valid request URL is required to generate request examples

200

{
  "total_requests": 123,
  "total_tokens": 123,
  "total_cost": 123,
  "average_latency": 123,
  "success_rate": 123,
  "user_facing_success_rate": 123,
  "user_facing_total_requests": 123,
  "cache_hit_rate_total_requests": 123,
  "direct_cache_hits": 123,
  "semantic_cache_hits": 123
}

Authorizations

Authorization · string · header · required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <API key>. Virtual keys, dashboard/user/session tokens, and x-api-key headers are not supported on management APIs.

Query Parameters

providers · string

Comma-separated list of providers to filter by

models · string

Comma-separated list of models to filter by

status · string

Comma-separated list of statuses to filter by

objects · string

Comma-separated list of object types to filter by

selected_key_ids · string

Comma-separated list of selected key IDs to filter by

virtual_key_ids · string

Comma-separated list of virtual key IDs to filter by

routing_rule_ids · string

Comma-separated list of routing rule IDs to filter by

routing_engine_used · string

Comma-separated list of routing engines to filter by (routing-rule, governance, or loadbalancing)

start_time · string<date-time>

Start time filter (RFC3339 format)

end_time · string<date-time>

End time filter (RFC3339 format)

min_latency · number

Minimum latency filter

max_latency · number

Maximum latency filter

min_tokens · integer

Minimum tokens filter

max_tokens · integer

Maximum tokens filter

min_cost · number

Minimum cost filter

max_cost · number

Maximum cost filter

missing_cost_only · boolean

Only show logs with missing cost

content_search · string

Search in request/response content

Response

200

application/json

Successful response

Log statistics

total_requests · integer<int64> · required

total_tokens · integer<int64> · required

total_cost · number · required

average_latency · number · required

success_rate · number · required

Percentage of completed provider attempts that succeeded

user_facing_success_rate · number · required

Percentage of user requests that ultimately succeeded, counting fallback chains as one request

user_facing_total_requests · integer<int64> · required

Count of root requests used as the denominator for user_facing_success_rate

cache_hit_rate_total_requests · integer<int64>

Completed requests used as the local-cache hit-rate denominator

direct_cache_hits · integer<int64>

Number of direct local-cache hits

semantic_cache_hits · integer<int64>

Number of semantic local-cache hits