Debugging playbook

Missing Evidence

Use when a span claims work happened but has no public-safe artifact, result reference, or redacted summary.

Linked toolsok
5
Source: playbook registry
Updated: 5/25/2026, 5:11:09 PM
Evidence/query
Commandsok
2
Source: playbook registry
Updated: 5/25/2026, 5:11:09 PM
Evidence/query
DocsSheetsBrowserOpsEvalsSandbox
Symptoms
  • Evidence count is zero for an important span.
  • Report generation has insufficient refs.
  • The timeline cannot prove a claimed outcome.
Likely Causes
  • The source service did not call link_evidence.
  • Evidence was private and correctly withheld from public view.
  • Adapter is degraded and cannot persist artifact references.
Checks
  • Open /api/v1/traces/{traceId}/evidence.
  • Inspect span metadata for publicSafe and protected flags.
  • Check storage state in /api/health.
Evidence To Collect
  • span ID
  • artifact URL or protected ref
  • publicSafe flag
  • redaction summary
platphormctl Commands
platphormctl trace get <traceId>
platphormctl trace report <traceId>