otelHeadersHelper failures now carry a specific error type and are reported to telemetry
When otelHeadersHelper (a user-supplied command that generates rotating OpenTelemetry headers) fails, Claude Code now records exactly why. Errors are classified into one of eight kinds: timeout, bad exit code, killed, failed to spawn, empty output, invalid JSON, output that isn't an object, or a non-string value inside it. Each failure is reported through a new event, tengu_otel_headers_helper_failed, that includes the failure kind and exit code, and is also broadcast so anything watching can react to it. The helper is now also fetched in the background ahead of time rather than only on demand.
This makes it much easier to diagnose why a custom OpenTelemetry header command isn't working, since the failure is now categorized instead of surfacing as a generic error.
The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.
| `otelHeadersHelper failed; telemetry is not being exported. See /status: ...` | [Configuration warnings](#otelheadershelper-failed) |errors see the edit
Anthropic's documentation has since written up otelHeadersHelper, on Error reference.
Added a startup warning when a configured otelHeadersHelper fails, so sessions that silently export no telemetry are noticed