Set up tracing
Only graph runs are traced, so set "engine": "graph" in the cambium config. The doctor does not check tracing; the checks below are the proof.
Run the local collector
Section titled “Run the local collector”-
Put
otelcol-contribin/opt/homebrew/binor/usr/local/bin(the agent’sPATHsearches only those and/usr/bin:/bin). Downloadotelcol-contrib_<version>_darwin_arm64.tar.gz(ordarwin_amd64) from the collector releases. -
Find the config shipped with cambium:
Terminal window OTEL_DIR="$(npm root -g)/oakgreen/node_modules/@oakgreencc/cambium/otel"[ -d "$OTEL_DIR" ] || OTEL_DIR="$(npm root -g)/@oakgreencc/cambium/otel" -
Install the config and the agent, then start it:
Terminal window mkdir -p ~/.cambium/otelcp "$OTEL_DIR/otelcol.yaml" ~/.cambium/otel/otelcol.yamlotelcol-contrib validate --config ~/.cambium/otel/otelcol.yamlcp "$OTEL_DIR/com.oakgreencc.otelcol.plist" ~/Library/LaunchAgents/oakgreen start otelcol -
Check that it accepts spans (prints
200):Terminal window curl -s -o /dev/null -w '%{http_code}\n' -X POST -H 'content-type: application/json' \-d '{"resourceSpans":[]}' http://127.0.0.1:4318/v1/traces
Point cambium at it
Section titled “Point cambium at it”cambium reads tracing settings from its environment only, so they go in its launchd agent:
P=~/Library/LaunchAgents/com.oakgreencc.cambium.plistplutil -replace EnvironmentVariables.OTEL_EXPORTER_OTLP_ENDPOINT -string http://127.0.0.1:4318 "$P"plutil -replace EnvironmentVariables.OTEL_EXPORTER_OTLP_TIMEOUT -string 2000 "$P"oakgreen reload cambiumcambium install rewrites the plist without these. Repeat this step after any reinstall. cambium update leaves the plist alone.
Check: ~/.cambium/otel/traces.jsonl grows after the next graph run, and canopy’s Traces tab lists it.
Point mycelium at it
Section titled “Point mycelium at it”Add OTEL_EXPORTER_OTLP_ENDPOINT=http://127.0.0.1:4318 to ~/.mycelium/env, then oakgreen restart mycelium. Issues it files then start their trace.
Add Jaeger
Section titled “Add Jaeger”docker run -d --name jaeger -p 16686:16686 -p 14317:4317 jaegertracing/jaeger:latestThe UI is on http://127.0.0.1:16686. Without Jaeger, the collector still writes its files.
Send to AWS instead
Section titled “Send to AWS instead”- Copy
otelcol-aws.yamlfrom$OTEL_DIRto~/.cambium/otel/otelcol.yamland set the region and workspace in it. - Enable X-Ray Transaction Search in the region, and give the collector’s process AWS credentials through the default chain (for example a profile in
~/.aws). oakgreen restart otelcol, then check~/.cambium/otel/otelcol.logfor export errors.
cambium’s environment stays the same.
Add Claude Code’s own spans
Section titled “Add Claude Code’s own spans”Add to worker.env in the cambium config:
"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" }}Span names and attributes: cambium telemetry.