[DOCS] BETA_TRACING_ENDPOINT and ENABLE_BETA_TRACING_DETAILED are undocumented (monitoring-usage)

Documentation Type

Unclear/confusing documentation

Documentation Location

https://code.claude.com/docs/en/monitoring-usage

Section/Topic

https://code.claude.com/docs/en/monitoring-usage#traces-beta

Current Documentation

_No response_

What's Wrong or Missing?

Page

https://code.claude.com/docs/en/monitoring-usage#claude_code-hook

Issue

ENABLE_BETA_TRACING_DETAILED and BETA_TRACING_ENDPOINT are only mentioned once on the page, in a single sentence under the claude_code.hook span description:

"This span is emitted only when detailed beta tracing is active, which requires ENABLE_BETA_TRACING_DETAILED=1 and BETA_TRACING_ENDPOINT in addition to the trace exporter configuration above... In interactive CLI sessions, this also requires your organization to be allowlisted for the feature."

Neither variable appears in the "Traces (beta)" table above it, unlike every other trace-related variable (e.g. CLAUDE_CODE_ENHANCED_TELEMETRY_BETA, OTEL_TRACES_EXPORTER).

Specific gaps

1. No table row/description for either variable — no example value, no accepted format.
2. BETA_TRACING_ENDPOINT's expected format is never stated. Is it a URL like OTEL_EXPORTER_OTLP_TRACES_ENDPOINT? A separate endpoint from the standard OTLP trace endpoint, or just a feature-gate value?
3. Relationship to OTEL_EXPORTER_OTLP_TRACES_ENDPOINT is unclear — same collector, or a distinct one specifically for detailed/hook data?
4. The "allowlisted for the feature" requirement has no link or process for requesting access.
5. No worked example, unlike other beta features on this page (SIEM export, mTLS, multi-team attributes all get full bash snippets).

Suggested Improvement

Suggested fix

• Add both variables as rows in the "Traces (beta)" table with example values and short descriptions.
• Add a short "Detailed hook tracing" subsection with a minimal working example, e.g.:

  export CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1
  export ENABLE_BETA_TRACING_DETAILED=1
  export BETA_TRACING_ENDPOINT=<value>

• Clarify the allowlisting process or link to where it can be requested.

Impact

Medium - Makes feature difficult to understand

Additional Context

_No response_