環境変数

OTEL_LOG_MANAGED_SETTINGS

1 に設定すると、マスク処理済みの管理設定と、マスク前の設定の SHA-256 ダイジェストを、managed_settings_resolved OpenTelemetry ログイベントに追加します。既定では無効です。シェル、ユーザー設定、または管理設定に設定します。プロジェクト設定やローカル設定に値を設定しても有効にはなりません。Claude Code v2.1.274 以降が必要です。Monitoring を参照してください。

使い方・用途

  • claude_code.managed_settings_resolved OTel イベントに、マスクされた管理設定とマスク前の設定の SHA-256 ダイジェストを含めるための環境変数(既定は無効、=1 で有効化)
  • エンタープライズ管理者が OpenTelemetry ログから、どの管理設定ソースが適用されたか・ポリシーヘルパーの状態を検証でき、機密性の高い設定値はマスクされたまま安全に診断できる
  • 値はシェル、ユーザー設定、管理設定でのみ設定でき、プロジェクト設定やローカル設定では無効。要 v2.1.274 以降
英語原文(公式ドキュメントより)

Set to 1 to add the redacted managed settings, and a SHA-256 digest of the settings before redaction, to managed_settings_resolved OpenTelemetry log events. Disabled by default. Set it in your shell, user settings, or managed settings; a value in project or local settings doesn't turn it on. Requires Claude Code v2.1.274 or later. See Monitoring

関連ドキュメント

関連する変更履歴

v2.1.274(1件)

Added
claude_code.managed_settings_resolved OTel イベントを追加:管理設定のソースとポリシーヘルパーの状態を含む。OTEL_LOG_MANAGED_SETTINGS=1 を設定すると、マスクされた設定とダイジェストが出力される
英語原文を表示
Added claude_code.managed_settings_resolved OTel event: managed-settings sources and policy helper state; redacted settings and digests with OTEL_LOG_MANAGED_SETTINGS=1

変更前

claude_code.managed_settings_resolved という OTel イベントが存在せず、企業管理設定のソースやポリシーヘルパーの状態をテレメトリから確認できなかった。OTEL_LOG_MANAGED_SETTINGS=1 を設定しても設定のマスクやダイジェストはログに出力されなかった。

変更後

claude_code.managed_settings_resolved OTel イベントが新たに追加され、企業管理設定のどのソースが適用されたか、ポリシーヘルパーの状態をテレメトリで確認できるようになった。OTEL_LOG_MANAGED_SETTINGS=1 を設定した場合は、秘匿情報はマスクされたうえで設定のダイジェストもあわせてログに出力される。

ユーザーへの恩恵

エンタープライズ管理者が OpenTelemetry ログから管理設定の解決結果とポリシーヘルパーの状態を検証でき、機密性の高い設定値はマスクされたまま安全に診断できる。

関連ドキュメント