OTEL_LOG_TOOL_DETAILS

変更前

OTEL_LOG_TOOL_DETAILS=1 を設定しても、コスト・トークンメトリクスの属性にカスタム由来のエージェント・スキル・プラグイン・MCPサーバーの実際の名前は含まれず、custom などに置き換えられた値しか記録されない。

変更後

OTEL_LOG_TOOL_DETAILS=1 を設定した場合のコスト・トークンメトリクスに、カスタム由来のエージェント・スキル・プラグイン・MCPサーバーの実際の名前が含まれるようになる。

ユーザーへの恩恵

カスタム由来のコンポーネントがコストやトークン消費の実態を把握・可視化できるようになる。

変更前

OpenTelemetry のメトリクスやイベントには、どのリポジトリで作業しているかを示す属性が付与されていなかった。そのため、複数のリポジトリのテレメトリを同じバックエンドに集約しても、リポジトリ単位での絞り込みや集計ができなかった。

変更後

OTEL_METRICS_INCLUDE_REPOSITORY を設定すると、OpenTelemetry のメトリクスやイベントに vcs.* 形式のリポジトリ属性が付与されるようになる。また OTEL_LOG_TOOL_DETAILS が有効な場合、コミットを伴うツール実行イベントには vcs.ref.head.* の属性も含まれる。

ユーザーへの恩恵

利用者はテレメトリをリポジトリ別にフィルタリング・集計できるようになり、どのリポジトリでの活動かを把握しやすくなる。

変更前

テレメトリデータにおいて、Claude がどのツールを呼び出したかは分かっても、具体的な引数やコマンドの内容までは把握できませんでした。

変更後

OpenTelemetry を通じて、実行された Bash コマンドや MCP ツールの詳細な引数までログとして記録・分析できるようになります。

ユーザーへの恩恵

組織内での Claude Code の利用実態をより詳細に可視化し、セキュリティ監査やコスト最適化に役立てられます。

変更前

テレメトリデータにおいて、どのコマンドから実行されたかや、モデルの「思考の深さ(Effort)」がコストにどう影響しているかを詳細に分析することが困難でした。

変更後

コマンド名やソース、および effort 属性が各イベントに付与され、組織レベルでの詳細な利用状況の可視化が可能になります。

ユーザーへの恩恵

開発チーム全体での Claude Code の利用効率やコストパフォーマンスを、より正確なデータに基づいて最適化できます。

変更前

OpenTelemetryによるトレース情報の出力時、秘匿すべき情報が設定に関わらず出力されてしまうリスクがありました。

変更後

ユーザーが明示的に許可した情報(プロンプトやツールの引数など)のみがトレースに含まれるようになり、機密情報の保護が強化されました。

ユーザーへの恩恵

組織のセキュリティポリシーに合わせて、安心して利用状況のモニタリングを行えるようになります。

変更前

OpenTelemetry経由でログを収集する際、ツールの引数などの詳細なパラメータが常に送信され、機密情報の漏洩やログサイズの増大が懸念されていました。

変更後

デフォルトではパラメータが伏せられるようになり、詳細なログが必要な場合にのみ明示的な設定で有効化できるようになりました。

ユーザーへの恩恵

テレメトリ収集のプライバシー制御が強化され、組織のセキュリティポリシーに合わせた柔軟な運用が可能になります。