Skip to content

docs: explain managed telemetry upgrade and safe health checks - #335

Closed
ivke995 wants to merge 1 commit into
claude-hook-trace-propagationfrom
docs/telemetry-upgrade
Closed

ivke995 wants to merge 1 commit into
claude-hook-trace-propagationfrom
docs/telemetry-upgrade

Conversation

@ivke995

@ivke995 ivke995 commented Oct 20, 2026

Copy link
Copy Markdown
Contributor

Existing installations with an auth DB but no telemetry-ready.json silently stop managed OTLP export after upgrading to #330. Doctor intentionally reports this as PASS / not_configured, so a general health check can miss the interruption.

Add a user-facing README upgrade procedure: rerun sce auth login even for an existing session, check provisioning failures separately from authentication success, and verify the Managed telemetry row or managed_telemetry JSON state. Explain safe diagnostics, doctor --fix limitations, and the separate Claude-native settings/enrollment requirements. Link the existing telemetry reference for implementation and security details.

Only README.md changes; readiness gating and credential handling are unchanged.

Validation:

  • Cross-checked against PR caude hook trace propagation #330 head 2e40a25: readiness state, runtime admission, login provisioning, doctor rendering/JSON, and header-helper behavior.
  • Reviewed existing tests covering missing readiness with a real credential, no credential lookup before readiness, stored-session reprovisioning, readiness persistence failures, secret-free doctor output, and helper fail-closed behavior.
  • git diff --check passed.
  • Local nix flake check could not run: Nix is not installed in this environment. The inspected caude hook trace propagation #330 head has successful Nix CI, CodeQL, Dependency Review, and Quint workflows; these are upstream results, not a local test run.

This draft targets claude-hook-trace-propagation so the documentation can accompany #330 before release.

@davidabram davidabram closed this Oct 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants