Troubleshooting•stable•Updated 2026-07-06

Ingestion errors

Diagnose and fix ingestion errors.

Use this page when the symptom matches what you see in Kadryn or in your integration logs.

Symptoms

  • Usage events are rejected or missing.
  • Direct ingest attempts appear invalid or duplicated.

Most common causes

  • Invalid schema.
  • Missing idempotency key.
  • Bad timestamp or provider/model values.
  • Wrong API key or workspace.

Fix

  1. Validate payload shape.
  2. Add idempotency keys.
  3. Verify timestamps and model identifiers.
  4. Search Logs & Traces for ingestion attempts.

Verify the fix

  • Re-run the smallest safe test.
  • Open Logs & Traces and search by request ID, trace ID or resource ID.
  • Confirm the relevant dashboard card updates after refresh.
  • Confirm no retry loop or duplicate delivery was created.

When to escalate

Escalate when the issue affects production traffic, billing-sensitive reporting, audit evidence, or any workflow where a customer-facing AI feature is blocked.

Related pages