Telemetry
cambium’s tracing is configured by the standard OTEL_* variables only, with service.name=cambium. Only graph runs are traced (engine: "graph"); the legacy stage tick is not.
On and off
Section titled “On and off”| Condition | Tracing |
|---|---|
OTEL_EXPORTER_OTLP_ENDPOINT or OTEL_EXPORTER_OTLP_TRACES_ENDPOINT set |
on |
OTEL_SDK_DISABLED=true or OTEL_TRACES_EXPORTER=none |
off |
| Neither endpoint set | off; nothing is imported |
Metrics follow the same rule with OTEL_EXPORTER_OTLP_METRICS_ENDPOINT and OTEL_METRICS_EXPORTER.
With an endpoint but no collector, shutdown can take about 8 s. OTEL_EXPORTER_OTLP_TIMEOUT=2000 shortens it.
With tracing off there is no TRACEPARENT for workers and markers keep traceparent: null.
Spans and metrics
Section titled “Spans and metrics”| Name | When | Parent |
|---|---|---|
cambium.issue |
Once per issue, when the marker has no traceparent. Ended at once; its traceparent goes into the marker. |
mycelium’s intake span from the issue body, else none |
cambium.node |
Each step-node run. | Marker’s traceparent |
cambium.wait |
When a wait ends; start time is the marker’s enteredAt. |
Marker’s traceparent |
cambium.wait.not_ready |
Counter, +1 per not-ready poll. Attributes: graph, node, repo. | |
claude.session |
From the worker’s stream-json log, once it exits. | The start-worker cambium.node span |
claude.tool |
Each tool_use → tool_result. |
claude.session, or a subagent’s Agent tool span |
claude.turn |
Each assistant message with thinking or text. | claude.session, or a subagent’s Agent tool span |
claude.task |
Each background task. | The tool that started it |
One trace covers an issue across ticks: intake, triage, each task attempt, CI and close-out. A release-prepare run is its own root; the promotion PR’s release-promote turns continue it.
Attributes
Section titled “Attributes”cambium.node and cambium.wait:
| Attribute | Value |
|---|---|
cambium.graph |
Graph name. |
cambium.graph.version |
Graph version. |
cambium.node |
Node name. |
cambium.attempt |
Attempt. |
cambium.repo |
owner/name. |
cambium.issue.number |
Issue number (the PR number for release graphs). |
cambium.edge |
Edge taken. |
cambium.outcome |
Output’s outcome string, else ok; error on a throw. |
claude.session: claude.session_id, claude.model, claude_code.version, claude.cost_usd, claude.tokens.{input,output,cache_read,cache_creation}, claude.turns, claude.duration_ms, claude.terminal_reason, claude.result, claude.permission_denials. No result event, or an error result: status ERROR.
claude.tool: claude.tool.name, claude.tool.outcome (ok | error | unfinished), claude.tool.command (Bash, 200 characters). Unpaired: ends at the last timestamp, ERROR.
claude.turn: claude.thinking, claude.text (4000 characters each), claude.turn.tools.
claude.task events carry no timestamp; their times are those of the latest timestamped event.
Worker environment
Section titled “Worker environment”Workers receive TRACEPARENT set to their start node’s span. Claude Code’s own spans under it need these in worker.env:
"worker": { "env": { "CLAUDE_CODE_ENABLE_TELEMETRY": "1", "CLAUDE_CODE_ENHANCED_TELEMETRY_BETA": "1", "OTEL_TRACES_EXPORTER": "otlp", "OTEL_METRICS_EXPORTER": "none", "OTEL_LOGS_EXPORTER": "none", "OTEL_EXPORTER_OTLP_PROTOCOL": "http/protobuf", "OTEL_EXPORTER_OTLP_ENDPOINT": "http://127.0.0.1:4318" }}Resulting spans: claude_code.interaction → claude_code.llm_request, claude_code.tool (→ .execution, .blocked_on_user). They carry per-request timing and tokens but no cost.
Prompts and tool inputs are redacted unless OTEL_LOG_USER_PROMPTS, OTEL_LOG_TOOL_DETAILS or OTEL_LOG_TOOL_CONTENT is set.
Local collector
Section titled “Local collector”cambium’s package ships otel/:
| File | Contents |
|---|---|
otelcol.yaml |
otelcol-contrib config: OTLP/HTTP on 127.0.0.1:4318 → ~/.cambium/otel/{traces,metrics}.jsonl and Jaeger. |
otelcol-aws.yaml |
Same receiver; traces to X-Ray’s OTLP endpoint, metrics to Amazon Managed Service for Prometheus (sigv4auth). |
com.oakgreencc.otelcol.plist |
launchd agent com.oakgreencc.otelcol. |
| Path | Contents |
|---|---|
~/.cambium/otel/traces.jsonl |
Spans, OTLP/JSON lines; read by canopy. |
~/.cambium/otel/metrics.jsonl |
Metrics. |
~/.cambium/otel/otelcol.log |
Collector log. |
Jaeger, when run, takes OTLP/gRPC on 14317 and serves its UI on 16686.