[DOCS] Cowork emits metrics despite documentation stating only events are enabled
Documentation Type
Unclear/confusing documentation
Documentation Location
https://claude.com/docs/cowork/monitoring
Section/Topic
Cowork
Current Documentation
- https://claude.com/docs/cowork/monitoring#events
- https://support.claude.com/en/articles/14477985-monitor-claude-cowork-activity-with-opentelemetry#:~:text=1.1.4173%20or%20later.-,What%20you%20can%20monitor,-When%20you%20connect
What's Wrong or Missing?
The Cowork monitoring documentation explicitly states that events are enabled for Cowork telemetry. However, we are observing that metrics are also being emitted to the configured OTLP endpoint, even though Cowork telemetry is configured for events and metrics are not documented.
The emitted metric names start with claude_code_*, which makes them appear to be Claude Code metrics at first glance. However, based on the custom headers and the job attribute, we can see that these metrics are associated with Cowork. See screenshot below:
<img width="571" height="266" alt="Image" src="https://github.com/user-attachments/assets/b5ba36c5-35e4-4549-886f-aa8bf45003cd" />
<img width="361" height="678" alt="Image" src="https://github.com/user-attachments/assets/29fdea49-5140-4c28-8fad-f0d363935e67" />
This creates ambiguity around the expected behavior:
- If metrics are intentionally emitted, the documentation should clearly disclose this.
- If Cowork telemetry is intended to emit only events in this configuration, then metrics emission appears to be an implementation bug.
Configuration
Both Claude Code and Cowork telemetry are active for the same Enterprise organization.
- Claude Code telemetry
- Configured via Managed Settings
- Pushed org-wide through the Claude.ai admin console
- Cowork telemetry
- Configured via Cowork Telemetry admin settings
- Set up according to the Cowork monitoring documentation
- Documentation indicates telemetry is configured for events only
Suggested Improvement
The documentation should clarify the full telemetry behavior for Cowork.
Suggested updates:
- State whether Cowork telemetry emits metrics in addition to events.
- Document the expected metric names, including any metrics using the
claude_code_*prefix. - Explain how to distinguish Cowork telemetry from Claude Code telemetry
- Clarify whether metrics emission can be disabled independently from events.
Impact
Medium - Makes feature difficult to understand
Additional Context
_No response_
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗