oo observability
Request health, prompt caching, service calls and reliability.
Read what the Observability page shows, as JSON: request health, prompt caching and the calls agents make to services such as web search, and the Sunport's reliability snapshot. Services needs billing.read, and the others sunport.read.
oo observability requests
Print request health as JSON: how many model requests there were and how many of them failed, the median and 95th-percentile latency of those that succeeded, and each model's most common error status, in total, by model, and by hour or day. The period is this month unless --query gives range (today, current_week or current_month), or from and to (its first and last day, at most 31 days), and timeZone.
oo observability requests [options]| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
--query NAME=VALUE | no | a period input; repeatable |
It also takes the connection options.
oo observability caching
Print prompt caching as JSON: for each model that caches prompts, its requests and input tokens, how many were read from and written to the cache, its hit rate by hour or day, and what caching saved at list prices; and the models that don't cache. The period is this month unless --query gives range (today, current_week or current_month), or from and to (its first and last day, at most 31 days), and timeZone.
oo observability caching [options]| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
--query NAME=VALUE | no | a period input; repeatable |
It also takes the connection options.
oo observability services
Print the calls agents made to services such as web search, as JSON, as the Observability page's Services shows them: by service, provider and meter, each with its calls, errors, quantity, time taken and cost, and when it was last used. The period is this month by UTC days unless --from and --to give its first and last day; --daily splits it by day, for at most 31 days.
oo observability services [options]| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
--from DATE | no | the period's first day, such as 2026-09-01 | ||
--to DATE | no | the period's last day, such as 2026-09-30 | ||
--daily | no | one row per day, service and provider |
It also takes the connection options.
oo observability reliability
Print the latest reliability snapshot the Sunport collected, as JSON. Until it has collected one, the answer is reliability_snapshot_unavailable with its reason.
oo observability reliabilityIt also takes the connection options.