Skip to content

Telemetry correlation

Telemetry explains what happened operationally. Evidence explains why an outcome should be trusted. Agent Evidence should reference telemetry without replacing it.

Required correlation fields

  • trace_id
  • span_id
  • span_kind when known
  • event_id or log id when known
  • runtime_id, session_id, thread_id, turn_id, task_id, run_id, tool_call_id, artifact_id when available
  • exporter or backend reference when traces are not embedded

Rules

  • Do not copy raw traces into every evidence pack.
  • Preserve W3C trace context ids when available.
  • Preserve OpenTelemetry GenAI operation names when available.
  • Mark telemetry as unavailable or not_collected instead of inferring success.
  • Link evidence facts to the smallest useful span or event.
  • Treat tool arguments and results as potentially sensitive.

Common joins

Evidence factTelemetry join
Claim derived from tool resulttool_call_id, tool span, result ref.
Claim derived from retrievalretrieval span, query id, source ids.
Artifact generated by a modelmodel span, artifact id, version id.
Verification checkcheck activity id, span id, issue refs.
Exportexport activity id, file hashes, pack id.

Draft standard for portable agent evidence, provenance, review, and replay.