Skip to content

Specify a machine-readable baseline for the Evidence Preservation list: map it to OpenTelemetry GenAI semantic conventions #5

Description

@meshailabs

The Evidence Preservation section requires members to preserve prompts, traces, tool calls, logs, model and safeguard versions, agent and workload identities, permissions available during the run, human approval and intervention events, and a complete incident timeline. The Notification Timelines table requires "machine-readable updates" while material risks remain unresolved, and "From Lessons to Controls" commits to a versioned catalog of machine-readable policies and reproducible verification methods.

None of these name a format. Without one, each member preserves evidence in a proprietary shape, and every cross-member incident review starts with manual normalization before the eight-layer review framework can be applied. The verification methods in the catalog also cannot be executable if the evidence they run against has no common representation.

Proposal: reference the OpenTelemetry GenAI semantic conventions as the baseline representation for the runtime items on the evidence list, rather than defining a new schema. Most of the list already has a home there:

SAFE evidence item Existing OTel representation
Prompts, tool calls, model versions gen_ai.* spans and events (inference and tool-execution conventions)
Agent and workload identities gen_ai.agent.* attributes, with SPIFFE IDs (already an alliance contribution via HPE) as the identity value
Incident timeline W3C Trace Context, which the MCP specification adopted in its July 2026 revision
Detection, containment, recovery events Span events and log records on the same trace

Two items on the list have no settled upstream convention yet: human approval and intervention events, and safeguard/policy version identifiers. These are the requirements SAFE is best placed to surface from real incidents. Rather than specifying them independently, SAFE should feed them into the OpenTelemetry GenAI SIG, where related threads are already open: agent lifecycle events covering pause and resume for human approval (open-telemetry/semantic-conventions-genai#159), opaque references from decision spans to governance records (open-telemetry/semantic-conventions-genai#368), and guardrail conventions that include a policy version attribute (open-telemetry/semantic-conventions-genai#427).

The practical benefit: incident evidence becomes something members collect from telemetry their systems already emit in production, rather than a separate forensic artifact assembled after the fact. That serves the RFC's stated principle that reporting should reflect actual risk with minimal friction, and it keeps SAFE from becoming the source of one more competing agent-telemetry schema.

If maintainers want it, I can open a PR against the RFC adding the full mapping as an appendix.

Disclosure: I work on OTel-based runtime evidence tooling for AI agents (MeshAI Labs) and participate in the OTel GenAI semantic-conventions threads linked above.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions