[DOCS] OpenTelemetry log-event reference omits new message correlation and tool provenance attributes

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

“Standard attributes,” “Event correlation attributes,” and the individual OpenTelemetry log-event schemas.

Current Documentation

The page currently says:

All metrics and events share these standard attributes:

It then says:

Events additionally include the following attributes. These are never attached to metrics because they would cause unbounded cardinality:

The event-correlation section documents prompt.id, and the event schemas generally say “All standard attributes,” but the event reference does not list message.uuid, client_request_id, or tool_source as log-event attributes.

What's Wrong or Missing?

Claude Code 2.1.214 adds message.uuid, client_request_id, and tool_source to OpenTelemetry log events. The current reference does not define these fields, identify which event types carry them, explain how they differ from prompt.id and the server-side request_id, or show how to use them for message-level correlation and tool provenance.

The page does mention client_request_id in the tracing/span material, but that does not document its new presence on log events. Users building dashboards, audit trails, or cross-signal correlation will not know that the new fields are available or what their stable semantics are.

Suggested Improvement

Update the event reference to:

• add all three fields to the appropriate standard/event attribute tables;
• define the source and scope of each identifier, including whether it is present on retries or only the final request;
• distinguish message.uuid from prompt.id and the API request_id;
• explain tool_source values and whether it is emitted only when tool details are enabled; and
• add a short example showing how to correlate a log event with its message, API request, and tool result.

Keep the tracing/span documentation and log-event documentation consistent.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/monitoring-usage | OpenTelemetry event attributes and event correlation |
| https://code.claude.com/docs/en/agent-sdk/observability | Agent SDK observability cross-reference and content/logging behavior |

Release: Claude Code 2.1.214.