opschain admin providers overview
Included from Basic tier
opschain admin providers overview [--filter <expr>] [-o json|yaml] [--server <url>] [--auth-token <token>]
Lists every registered provider of every family (v2
ModelUsageService.ListProvidersOverview) — secrets, transport, model,
image build, image registry, identity, SIEM, OTLP, GitHub, JSM — with
the health its own record keeps, today's count and errors on the
reporting calendar's local day, and the family's gauges: the page an
operator opens first (opschain docs provider-usage). Needs the
provider-record administrator's verdict.
Flags
| Flag | Meaning |
|---|---|
--filter <expr> | Narrow the rows by column (KIND=siem, HEALTH=unhealthy), as every list verb does. |
--server <url> | Server base URL. Default: the active context, then OPSCHAIN_SERVER. |
--auth-token <token> | Bearer token override. Default: your opschain login session, then $OPSCHAIN_ADMIN_TOKEN, then the token stored by opschain admin login for that server. |
Output
One row per provider: KIND (the family), CODE, PROVIDER KIND (the
record's own kind — anthropic, openbao, ssh-ca, splunk_hec …;
empty where the family has one shape), ENABLED, HEALTH (healthy,
unhealthy or unknown — the test verb's last outcome where the record
stores one, the delivery health for SIEM and OTLP connections, unknown
for the families that keep no probe or were never tested), CHECKED
(when), TODAY (the family's primary count since local midnight),
ERRORS (across every metric) and GAUGES (backlog_depth=…,
rate_limit_remaining=… where observed), followed by a line naming the
day's start and the calendar.
-o json / -o yaml carry today_start, computed_at,
calendar_timezone and providers (opschain docs resources/model_usage, ProviderOverviewRow).
Exit codes
| Code | Meaning |
|---|---|
| 0 | The overview was printed (no registered providers when nothing is registered). |
| 1 | The server refused or failed the request (a rejected credential). |
| 2 | Usage — no server / credential resolvable. |
Named errors
a server is required — pass --server <url>, set OPSCHAIN_SERVER, or 'opschain context use <name>'— exit 2.the server rejected the credential — run 'opschain login' again, or check the admin token— exit 1.
Examples
opschain admin providers overview
opschain admin providers overview --filter HEALTH=unhealthy
opschain admin providers overview -o json | jq '.providers[] | select(.kind == "siem")'
Related settings
usage.timezone,usage.fiscal_year_start— the calendar "today" starts on.
See also
opschain docs provider-usage— the component page.opschain docs cli/admin-providers-usage— one family's rows over time.