Skip to main content

​
Providers Telemetry Guide (si providers)

Providers si providers is the control-plane view across SI integration runtimes.

​
Command surface

si providers <characteristics|health> [--provider <id>] [--json]
Aliases: 
si integrations ...
si apis ...

​
Characteristics view

Use this to inspect static policy and capability metadata. 
si providers characteristics --json
si providers characteristics --provider github --json
Output includes:
  • base URL and API version
  • auth style
  • rate and burst policy
  • public probe endpoint
  • capability flags (pagination/bulk/idempotency/raw)

​
Health view

Use this for runtime traffic and guardrail telemetry. 
si providers health --json
si providers health --provider openai --json
Output includes:
  • per-provider request counts and latency percentiles
  • 429 and 5xx surfaces
  • circuit state snapshots
  • guardrail warnings
  • API version warnings/errors and coverage gaps

​
Provider IDs

Common IDs:
  • github
  • cloudflare
  • google_places
  • google_play
  • apple_appstore
  • youtube
  • stripe
  • social_facebook, social_instagram, social_x, social_linkedin, social_reddit
  • workos
  • aws_iam
  • gcp_serviceusage
  • openai
  • oci_core

​
Operational playbook

  1. Run si providers characteristics --json after upgrading SI.
  2. Run si providers health --json after auth/context setup.
  3. Investigate guardrail or version warnings before production writes.
  4. Pair provider health checks with integration-specific doctor commands.

​
Troubleshooting

  • No entries in health output usually means no integration traffic yet.
  • Version policy errors indicate missing/invalid provider policy metadata.
  • Re-run affected integration doctor command and verify context/account.