Skip to content

adr-telemetry-observable-agent-steps

Decision

Promote and institutionalize telemetry-observable-agent-steps as a core architectural pattern following ratified Reference Architecture approval.

Context

  • Source: governance-flow
  • Pattern: telemetry-observable-agent-steps
  • Promotion Recommendation: recommendation-telemetry-observable-agent-steps
  • Scope Classification: global
  • Scope Classification Artifact: pattern-scope-classification

Telemetry-observable agent steps provides OpenTelemetry instrumentation across pipeline execution and agent interactions to trace latency, token spend, and execution errors.

Scope

Applicability: Global across continuous architecture runner workflows, agent tasks, and governance evaluation pipelines.

Enforces distributed tracing and metric collection contracts across all agentic execution steps.

Consequences

Governance

Establishes institutionalized compliance requirements for OpenTelemetry span propagation and traceable metric collection.

Execution

Requires execution runners to initialize telemetry contexts and envelope step metrics in TraceableMetric schemas.

System Behaviour

Provides continuous visibility into agent execution latency, model invocation costs, and step error boundaries.

Evidence Summary

Promotion Evidence

Ratified Reference Architecture in ArchGov and integrated OpenTelemetry dependencies.

Promotion Criteria

Satisfied governance maturity and ratified reference architecture criteria.

Governance Risks

No unmitigated governance risks recorded.

Traceability

Pattern Proposal

telemetry-observable-agent-steps

Scope Classification

Artifact: pattern-scope-classification

Classification: global

Promotion Recommendation

recommendation-telemetry-observable-agent-steps

Promotion Decision

promotion-decision-telemetry-observable-agent-steps

Next Step

  • Submit ADR to Architecture Forum for formal institutionalisation
  • Generate global pattern record in knowledge/global/patterns/