Monitoring and analytics

Code offers configurable local/enterprise OpenTelemetry and Anthropic organizational analytics. They serve different purposes.

#OpenTelemetry quickstart

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer your-token"

claude

Shorten export intervals for diagnostics:

export OTEL_METRIC_EXPORT_INTERVAL=10000
export OTEL_LOGS_EXPORT_INTERVAL=5000

Avoid overly short production intervals that burden clients and collectors.

#Administrator delivery

Enable through managed settings:

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp",
    "OTEL_LOGS_EXPORTER": "otlp",
    "OTEL_EXPORTER_OTLP_PROTOCOL": "grpc",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "http://collector.example.com:4317",
    "OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Bearer example-token"
  }
}

Managed environment settings have high priority. OTEL variables are not automatically forwarded to Bash, hooks, MCP or language servers; configure those separately.

#Common environment variables

#Metrics cardinality

High-cardinality labels raise storage costs. Available controls:

For team dimensions:

export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"

Avoid spaces and random high-cardinality values here.

#Traces

Tracing requires the additional beta switch:

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1
export OTEL_TRACES_EXPORTER=otlp

Each prompt creates a claude_code.interaction root span with model, tool and hook children. Subagent spans attach beneath the parent Agent tool span.

claude_code.interaction
├── claude_code.llm_request
├── claude_code.hook
└── claude_code.tool
    ├── claude_code.tool.blocked_on_user
    ├── claude_code.tool.execution
    └── subagent claude_code.llm_request / claude_code.tool

Bash/PowerShell receive TRACEPARENT when tracing is on. Custom providers do not receive it by default; explicitly enable propagation when required:

export CLAUDE_CODE_PROPAGATE_TRACEPARENT=1

#Analytics dashboard

Contribution metrics require GitHub integration and organization settings. They cover assisted PRs, lines, acceptance and users. ZDR organizations see usage only.

Console analytics includes accepted lines, acceptance rate, activity, spend and user insights. Spend is an estimate; billing remains authoritative.

#Caching and cost effects

Optimize Passion8 costs with caching, cost controls and the Passion8 console, not only Anthropic analytics.

#Official references

• Monitoring with OpenTelemetry
• Track team usage with analytics
• Status line
• Manage costs effectively