Skip to Content
Referenceoo CLI

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]
ArgumentRequiredDefaultChoicesDescription
--query NAME=VALUEnoa 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]
ArgumentRequiredDefaultChoicesDescription
--query NAME=VALUEnoa 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]
ArgumentRequiredDefaultChoicesDescription
--from DATEnothe period's first day, such as 2026-09-01
--to DATEnothe period's last day, such as 2026-09-30
--dailynoone 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 reliability

It also takes the connection options.

On this page