[DOCS] Cowork emits metrics despite documentation stating only events are enabled

Resolved 💬 1 comment Opened May 6, 2026 by vjofusha Closed Jun 3, 2026

Documentation Type

Unclear/confusing documentation

Documentation Location

https://claude.com/docs/cowork/monitoring

Section/Topic

Cowork

Current Documentation

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:

  1. State whether Cowork telemetry emits metrics in addition to events.
  2. Document the expected metric names, including any metrics using the claude_code_* prefix.
  3. Explain how to distinguish Cowork telemetry from Claude Code telemetry
  4. Clarify whether metrics emission can be disabled independently from events.

Impact

Medium - Makes feature difficult to understand

Additional Context

_No response_

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗