Documentation
Docs
GUIDE

Observability

Gain complete visibility into agent workflows with OpenTelemetry distributed tracing.

Debugging multi-agent systems is notoriously difficult. Consonant providesend-to-end distributed tracing out of the box. Every system component emits OTEL traces.

Trace Structure

A single "Run" (Workflow) creates a root span. Each step (Planning, Policy Check, Agent Execution) is a child span.

run-8392Order Processing4.2s
planningPlanner1.1s
policy-checkOPA0.05s
agent-execstripe-agent0.8s

Exporting Traces

Consonant supports standard OTLP exporters. You can send traces to:

  • Jaeger
  • Prometheus / Grafana
  • Datadog
  • Honeycomb
yaml
# helm-values.yaml
observability:
  tracing:
    enabled: true
    exporter: otlp
    endpoint: "http://jaeger-collector:4317"

Audit Logs

Separate from performance traces, Consonant maintains immutable Audit Logsfor compliance. These log decisions rather than just latency.

Audit Retention
Audit logs are stored in PostgreSQL by default but can be streamed to S3 or Splunk for long-term retention.