跳至主要內容

使用 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 方案上,當聊天和 Cowork 統一已開啟時可用。尚未開啟此功能的組織會將聊天和 Cowork 保持為個別選項,因此本文仍適用。擁有者可以在適用於您方案的文章中深入瞭解:


您可以監控的內容

當您將 Claude Cowork 連接到 OpenTelemetry 收集器時,Cowork 會串流涵蓋以下內容的事件:

  • 使用者提示。當內容擷取包含使用者提示時,使用者提交給 Cowork 的提示的完整文字。否則,每個提示都會在沒有其文字的情況下記錄。

  • 工具和 MCP 叫用。Claude 在工作階段期間進行的每個工具呼叫,包括工具名稱、成功或失敗,以及執行時間。當內容擷取包含工具詳細資訊時,事件也會包含工具的參數(對於 MCP 工具,包括 MCP 伺服器和工具名稱)以及工具失敗時的錯誤訊息。

  • 檔案存取。使用者連接到工作階段的資料夾。當內容擷取包含工具詳細資訊時,事件也會包含 Claude 讀取、修改或以其他方式接觸的檔案路徑,包括透過 MCP 存取的檔案。

  • 技能和外掛程式。Claude 在工作階段中使用的技能和外掛程式。除非內容擷取包含工具詳細資訊,否則非 Anthropic 提供的技能和外掛程式會以預留位置名稱顯示。

  • 人工核准決定。每個工具動作是由使用者核准、由使用者拒絕,還是根據現有權限自動啟動。

  • API 請求和錯誤。每個請求的模型、權杖計數、估計成本、持續時間和任何傳回的錯誤。

共用的 prompt.id 屬性會連結由單一使用者提示觸發的每個事件,因此您可以重建 Claude 為回應一個輸入而執行的所有操作。

如需完整的事件類型和屬性清單,請參閱 claude.com/docs 上的 Cowork 監控參考。


何時使用 OpenTelemetry

OpenTelemetry 為您提供結構化 Cowork 事件的即時串流,您可以將其路由到現有的 SIEM 和可觀測性工具中。它是安全監控和事件調查、追蹤整個組織的工具和檔案存取模式、成本和效能分析,以及在現有管道中建立儀表板和警示的正確選擇。

相容的目的地

Cowork 的 OpenTelemetry 輸出適用於任何標準 OTel 收集器。常見的目的地包括:

  • SIEM 平台,例如 Splunk 和 Cribl

  • 日誌聚合系統,例如 Elasticsearch 和 Loki

  • 欄式存放區,例如 ClickHouse

  • 可觀測性平台,例如 Honeycomb 和 Datadog

您可以透過相應地設定收集器,同時將事件路由到多個目的地。


設定 OpenTelemetry 監控

若要設定 Cowork 以將事件匯出到您的收集器:

  1. 前往組織設定 > 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 設定為空清單(寫成兩個字元 [])來在此之前關閉內容。

  • 該原則適用於從 Claude Desktop 啟動的 Cowork 工作階段,無論它們是在使用者的電腦上還是在雲端執行。它不適用於在雲端執行的排程工作,或者在聊天和 Cowork 統一的情況下,Claude 移至雲端的聊天。這些工作階段只包含中繼資料。在網頁或行動應用程式上啟動的 Cowork 工作階段只包含中繼資料,該原則不會改變這一點。

  • 工具參數可能包含敏感值。當內容擷取包含工具詳細資訊時,檔案路徑、命令引數和其他工具輸入會在 tool_input 和 tool_parameters 欄位中匯出。相應地規劃您的保留和存取原則。

  • 無論內容擷取設定為何,使用者電子郵件地址、連接資料夾的路徑和 API 錯誤訊息都會包含在內。API 錯誤訊息有時可能會重複導致它的請求的一部分,因此如果這是一個問題,請在您的收集器處篩選或編輯。

  • 只有當管理員設定 OTLP 端點時,事件才會匯出。預設情況下不會流動任何資料。


使用 Compliance API 加入 OpenTelemetry 資料

Compliance API 涵蓋 Cowork(透過 Claude、Claude Desktop 和 Claude Mobile)和 Claude Code(透過 CLI 和 Claude Desktop)以及 Claude 聊天,為您提供一個稽核軌跡,每個工作階段都可歸因於個別使用者。已在使用 OpenTelemetry 的組織可以同時執行兩者,OTel 涵蓋範圍也包括網頁和行動裝置上的 Cowork。深入瞭解 在 Compliance API 中擷取遠端工作階段。

是否回答了您的問題?