メインコンテンツにスキップ

OpenTelemetryでClaude Coworkアクティビティを監視する

この記事では、OpenTelemetry(OTel)を使用して組織全体のClaude Coworkアクティビティを監視する方法について説明します。OTelを使用すると、セキュリティチームと運用チームは、Coworkイベントを既に使用している可観測性ツールにストリーミングして、使用状況の追跡、インシデントの調査、パフォーマンスの分析ができます。

利用可能性

Claude CoworkのOpenTelemetry監視は、TeamプランとEnterpriseプランで利用できます。クラウド(デスクトップ、ウェブ、モバイル)で実行されるCoworkセッションと、ローカルデスクトップセッションの両方に対応しています。クラウドでのセッション監視にはClaude Desktopバージョン1.22209.3以降が必要で、ローカルデスクトップセッション監視にはClaude Desktopバージョン1.1.4173以降が必要です。

チャットとCoworkを組み合わせた新しいClaudeエクスペリエンスは、Pro、Max、Ultraプランにロールアウト中です。Teamプラン(ベータ版)とEnterpriseプランでは、Chat and Cowork unifiedがオンになっている場所で利用できます。オンにしていない組織は、チャットとCoworkを別々のオプションとして保持しているため、この記事は引き続き適用されます。Enterpriseオーナーは、Set up and manage the new unified Claude experience for your Enterprise organizationで詳細を確認できます。


監視できる内容

Claude CoworkをOpenTelemetryコレクターに接続すると、Coworkは以下をカバーするイベントをストリーミングします:

  • ユーザープロンプト。コンテンツキャプチャにユーザープロンプトが含まれている場合、ユーザーがCoworkに送信したプロンプトの完全なテキスト。それ以外の場合、各プロンプトはテキストなしで記録されます。

  • ツールとMCP呼び出し。セッション中にClaudeが行うすべてのツール呼び出し。ツール名、成功または失敗、実行時間を含みます。コンテンツキャプチャにツール詳細が含まれている場合、イベントはツールのパラメーター(MCPツールの場合、MCPサーバーとツール名を含む)とツール失敗時のエラーメッセージも含みます。

  • ファイルアクセス。ユーザーがセッションに接続するフォルダー。コンテンツキャプチャにツール詳細が含まれている場合、イベントはClaudeが読み取り、変更、またはその他の方法で操作するファイルパス(MCPを通じてアクセスされるファイルを含む)も含みます。

  • スキルとプラグイン。セッション内でClaudeが使用するスキルとプラグイン。コンテンツキャプチャにツール詳細が含まれていない限り、Anthropic以外から提供されるスキルとプラグインはプレースホルダー名の下に表示されます。

  • ユーザー承認決定。各ツールアクションがユーザーによって承認されたか、ユーザーによって拒否されたか、または既存の権限に基づいて自動的に開始されたか。

  • APIリクエストとエラー。リクエストごとのモデル、トークン数、推定コスト、期間、および返されたエラー。

共有prompt.id属性は、単一のユーザープロンプトによってトリガーされたすべてのイベントをリンクするため、1つの入力に応じてClaudeが行ったすべてのことを再構築できます。

イベントタイプと属性の完全なリストについては、claude.com/docsのCowork監視リファレンスを参照してください。


OpenTelemetryを使用する場合

OpenTelemetryは、既存のSIEMおよび可観測性ツールにルーティングできる、構造化されたCoworkイベントのリアルタイムストリームを提供します。セキュリティ監視とインシデント調査、組織全体のツールおよびファイルアクセスパターンの追跡、コストとパフォーマンス分析、既存のパイプラインでのダッシュボードとアラートの構築に最適です。

互換性のある宛先

CoworkのOpenTelemetry出力は、標準的なOTelコレクターと互換性があります。一般的な宛先は以下の通りです:

  • SIEMプラットフォーム(SplunkやCriblなど)

  • ログ集約システム(ElasticsearchやLokiなど)

  • カラムナーストア(ClickHouseなど)

  • 可観測性プラットフォーム(HoneycombやDatadogなど)

コレクターを適切に設定することで、イベントを複数の宛先に同時にルーティングできます。


OpenTelemetry監視を設定する

Coworkをコレクターにイベントをエクスポートするように設定するには:

  1. Organization settings > Coworkに移動します。

  2. OTLPエンドポイント(OpenTelemetryコレクターURL)を入力します。

  3. コレクターが使用するOTLPプロトコルを選択します:HTTP/JSONまたはHTTP/protobuf。

  4. ベアラートークンなど、認証に必要なOTLPヘッダーを追加します。

  5. 設定を保存します。

イベントはすぐにコレクターへのフローを開始します。認証ヘッダーはAnthropicサーバーで保存時に暗号化されます。


セキュリティとプライバシーに関する考慮事項

OpenTelemetryエクスポートをオンにする前に注意すべき点がいくつかあります:

  • プロンプトテキスト、Claudeの応答、ツール入力は、現在のバージョンのClaude Desktopではデフォルトでオフになっています。コンテンツキャプチャをotlpContentCaptureデバイスポリシーでオンにしない限り、イベントはメタデータのみを含みます。このポリシーはデバイス管理ツールでデプロイします。オンにする場合は、イベントを組織のポリシーに準拠したコレクターを通じてルーティングしてください。Cowork監視リファレンスのコンテンツキャプチャについて詳しく学んでください。

  • Claude Desktopの一部の古いバージョンは、ポリシーが設定されていない場合にコンテンツを送信します。そのコンテンツには、プロンプトテキスト、Claudeの応答、ツール入力が含まれる可能性があります。これらのバージョンは、更新されるとメタデータのみに切り替わります。ポリシーをサポートするバージョンでは、otlpContentCaptureを空のリスト(2文字[]として記述)に設定することで、その前にコンテンツをオフにできます。

  • ポリシーは、Claude Desktopから開始されたCoworkセッションに適用されます。ユーザーのコンピューターで実行されるか、クラウドで実行されるかに関わらず。クラウドで実行されるスケジュール済みタスク、またはチャットとCoworkが統合されている場合、Claudeがクラウドに移動するチャットには適用されません。これらのセッションはメタデータのみを含みます。ウェブまたはモバイルアプリで開始されたCoworkセッションはメタデータのみを含み、ポリシーはそれを変更しません。

  • ツールパラメーターには機密値が含まれる可能性があります。コンテンツキャプチャにツール詳細が含まれている場合、ファイルパス、コマンド引数、およびその他のツール入力はtool_inputおよびtool_parametersフィールドでエクスポートされます。保持とアクセスポリシーを適切に計画してください。

  • ユーザーメールアドレス、接続されたフォルダーのパス、およびAPIエラーメッセージは、コンテンツキャプチャ設定に関わらず含まれます。APIエラーメッセージは、それを引き起こしたリクエストの一部を繰り返すことがあるため、必要に応じてコレクターでフィルタリングまたは編集してください。

  • イベントは、管理者がOTLPエンドポイントを設定した場合にのみエクスポートされます。デフォルトではデータは流れません。


OpenTelemetryデータをCompliance APIと結合する

Compliance APIはCowork(Claude、Claude Desktop、Claude Mobileを経由)とClaude Code(CLIおよびClaude Desktopを経由)をClaudeチャットと共にカバーし、すべてのセッションが個々のユーザーに帰属する1つの監査証跡を提供します。既にOpenTelemetryを使用している組織は両方を並行して実行でき、OTelカバレッジにはウェブとモバイルのCoworkも含まれます。Compliance APIでリモートセッションを取得するについて詳しく学んでください。

こちらの回答で解決しましたか?