Debugging playbook

Docs Ingestion Failure

Use when Docs source fetch, parse, scoring, publishing, or report spans fail.

Linked toolsok
3
Source: playbook registry
Updated: 5/25/2026, 5:11:10 PM
Evidence/query
Commandsok
2
Source: playbook registry
Updated: 5/25/2026, 5:11:10 PM
Evidence/query
DocsTraceSheets
Symptoms
  • docs span failed.
  • Document ref is missing.
  • Docs report publishing is protected or degraded.
Likely Causes
  • Source fetch failed.
  • Parser rejected content.
  • Publish adapter requires PLATPHORM_API_KEY.
Checks
  • Inspect docs_report evidence.
  • Open related trace timeline.
  • Check protected report route output.
Evidence To Collect
  • document ID
  • source URL
  • parse summary
  • publish result
platphormctl Commands
platphormctl trace report <traceId>
platphormctl policy inspect trace