Troubleshooting

No rows appear after wrapping

1. Confirm sp.init / init ran with a valid key, or that SP_API_KEY is set in the same process.
2. Confirm the client you call is the wrapped client (or a tracked Vercel AI / batch helper).
3. For TypeScript serverless, keep the default immediate flush mode, or await flush() before exit.
4. For Python short scripts, call sp.flush() before process exit.
5. Check that ingest errors are not being swallowed only in logs (throwOnError / onError in TypeScript).

Cost shows as $0

• The model may be missing from the pricing catalog (usage still tracks).
• Bedrock rows are priced server-side; client cost is intentionally 0.
• Batch jobs need an explicit track_*_batch / track*Batch call after success.

Metadata missing in the dashboard

• Prefer sp.metadata() / spMetadata over provider-native fields that validators reject.
• Remember precedence: per-call > trace/context > wrap defaults.
• Custom keys become tags; reserved pricing keys (region, service_tier, ...) are first-class fields.

Content capture not appearing

Capture requires the org Settings opt-in (Pro/Enterprise), SDK allow not vetoing, and sampling. SDK configure helpers cannot enable capture by themselves. Set session_id / turn_id to group turns.

Provider connection sync issues

• Re-check credentials and scopes in the dashboard connection.
• Confirm the provider account has usage in the backfill window.
• For provider implementers, run the conformance runner against your sandbox.

Still stuck?

Email [email protected] with your org name, SDK language/version, provider, and a non-secret description of the failing path.