Claude Cowork-Aktivität mit OpenTelemetry überwachen

Dieser Artikel erklärt, wie Sie OpenTelemetry (OTel) verwenden, um Claude Cowork-Aktivitäten in Ihrer Organisation zu überwachen. Mit OTel können Ihre Sicherheits- und Betriebsteams Cowork-Ereignisse in die Observability-Tools streamen, die Sie bereits zur Verfolgung der Nutzung, Untersuchung von Vorfällen und Analyse der Leistung verwenden.

Verfügbarkeit

OpenTelemetry-Überwachung für Claude Cowork ist in Team- und Enterprise-Plänen verfügbar. Sie umfasst Cowork-Sitzungen, die in der Cloud ausgeführt werden (auf Desktop, Web und Mobilgeräten) sowie lokale Desktop-Sitzungen. Die Überwachung von Sitzungen in der Cloud erfordert Claude Desktop Version 1.22209.3 oder später, und die Überwachung lokaler Desktop-Sitzungen erfordert Claude Desktop Version 1.1.4173 oder später.

Die neue Claude-Erfahrung, die Chat und Cowork kombiniert, wird für Pro- und Max-Pläne eingeführt. In Team-Plänen (in Beta) und Enterprise-Plänen ist sie verfügbar, wenn Chat und Cowork vereinheitlicht aktiviert ist. Organisationen, die dies nicht aktiviert haben, behalten Chat und Cowork als separate Optionen, daher gilt dieser Artikel weiterhin. Enterprise-Eigentümer können mehr erfahren in Einrichtung und Verwaltung der neuen einheitlichen Claude-Erfahrung für Ihre Enterprise-Organisation.

Was Sie überwachen können

Wenn Sie Claude Cowork mit einem OpenTelemetry-Collector verbinden, streamt Cowork Ereignisse, die Folgendes abdecken:

Benutzereingaben. Wenn die Inhaltserfassung Benutzereingaben enthält, der vollständige Text der Eingaben, die Benutzer an Cowork übermitteln. Andernfalls wird jede Eingabe ohne ihren Text aufgezeichnet.
Tool- und MCP-Aufrufe. Jeder Tool-Aufruf, den Claude während einer Sitzung tätigt, einschließlich des Tool-Namens, Erfolg oder Fehler und Ausführungszeit. Wenn die Inhaltserfassung Tool-Details enthält, enthalten Ereignisse auch die Parameter des Tools (für MCP-Tools einschließlich des MCP-Servers und der Tool-Namen) und die Fehlermeldung, wenn ein Tool fehlschlägt.
Dateizugriff. Die Ordner, die Benutzer mit einer Sitzung verbinden. Wenn die Inhaltserfassung Tool-Details enthält, enthalten Ereignisse auch die Dateipfade, die Claude liest, ändert oder anderweitig berührt, einschließlich Dateien, auf die über MCPs zugegriffen wird.
Fähigkeiten und Plugins. Welche Fähigkeiten und Plugins Claude innerhalb einer Sitzung verwendet. Sofern die Inhaltserfassung keine Tool-Details enthält, werden Fähigkeiten und Plugins, die nicht von Anthropic stammen, unter einem Platzhalternamen angezeigt.
Genehmigungsentscheidungen durch Menschen. Ob jede Tool-Aktion vom Benutzer genehmigt, vom Benutzer abgelehnt oder automatisch basierend auf bestehenden Berechtigungen eingeleitet wurde.
API-Anfragen und Fehler. Pro Anfrage Modell, Token-Anzahl, geschätzte Kosten, Dauer und alle zurückgegebenen Fehler.

Ein gemeinsames prompt.id-Attribut verknüpft jedes Ereignis, das durch eine einzelne Benutzereingabe ausgelöst wird, sodass Sie alles rekonstruieren können, was Claude als Reaktion auf eine Eingabe getan hat.

Die vollständige Liste der Ereignistypen und Attribute finden Sie in der Cowork-Überwachungsreferenz auf claude.com/docs.

Wann OpenTelemetry verwendet werden sollte

OpenTelemetry bietet Ihnen einen Echtzeit-Stream strukturierter Cowork-Ereignisse, die Sie in Ihre bestehenden SIEM- und Observability-Tools leiten können. Es ist die richtige Wahl für Sicherheitsüberwachung und Vorfalluntersuchung, Verfolgung von Tool- und Dateizugriffsmustern in Ihrer Organisation, Kosten- und Leistungsanalyse sowie zum Erstellen von Dashboards und Warnungen in Ihrer bestehenden Pipeline.

Kompatible Ziele

Die OpenTelemetry-Ausgabe von Cowork funktioniert mit jedem Standard-OTel-Collector. Häufige Ziele sind:

SIEM-Plattformen wie Splunk und Cribl
Log-Aggregationssysteme wie Elasticsearch und Loki
Spaltenbasierte Speicher wie ClickHouse
Observability-Plattformen wie Honeycomb und Datadog

Sie können Ereignisse gleichzeitig an mehrere Ziele leiten, indem Sie Ihren Collector entsprechend konfigurieren.

OpenTelemetry-Überwachung einrichten

So konfigurieren Sie Cowork zum Exportieren von Ereignissen zu Ihrem Collector:

Gehen Sie zu Organisationseinstellungen > Cowork.
Geben Sie Ihren OTLP-Endpunkt ein (Ihre OpenTelemetry-Collector-URL).
Wählen Sie das OTLP-Protokoll aus, das Ihr Collector verwendet: HTTP/JSON oder HTTP/protobuf.
Fügen Sie alle erforderlichen OTLP-Header für die Authentifizierung hinzu, z. B. ein Bearer-Token.
Speichern Sie Ihre Einstellungen.

Ereignisse beginnen sofort zu Ihrem Collector zu fließen. Authentifizierungs-Header werden auf Anthropic-Servern verschlüsselt gespeichert.

Sicherheits- und Datenschutzaspekte

Einige Dinge, die Sie beachten sollten, bevor Sie den OpenTelemetry-Export aktivieren:

Eingabetext, Claudes Antworten und Tool-Eingaben sind in aktuellen Versionen von Claude Desktop standardmäßig deaktiviert. Ereignisse enthalten nur Metadaten, es sei denn, Sie aktivieren die Inhaltserfassung mit der Geräterichtlinie otlpContentCapture, die Sie mit Ihrem Geräteverwaltungstool bereitstellen. Wenn Sie dies aktivieren, leiten Sie Ereignisse durch einen Collector, der den Richtlinien Ihrer Organisation für die Protokollierung dieses Inhalts entspricht. Erfahren Sie mehr über Inhaltserfassung in der Cowork-Überwachungsreferenz.
Einige ältere Versionen von Claude Desktop senden Inhalte, wenn die Richtlinie nicht festgelegt ist. Dieser Inhalt kann Eingabetext, Claudes Antworten und Tool-Eingaben enthalten. Diese Versionen wechseln zu Metadaten nur, sobald sie aktualisiert werden. In Versionen, die die Richtlinie unterstützen, können Sie Inhalte vorher deaktivieren, indem Sie otlpContentCapture auf eine leere Liste setzen, geschrieben als die zwei Zeichen [].
Die Richtlinie gilt für Cowork-Sitzungen, die von Claude Desktop gestartet werden, unabhängig davon, ob sie auf dem Computer des Benutzers oder in der Cloud ausgeführt werden. Sie gilt nicht für geplante Aufgaben, die in der Cloud ausgeführt werden, oder, wenn Chat und Cowork vereinheitlicht sind, für Chats, die Claude in die Cloud verschiebt. Diese Sitzungen enthalten nur Metadaten. Cowork-Sitzungen, die im Web oder in der mobilen App gestartet werden, enthalten nur Metadaten, und die Richtlinie ändert das nicht.
Tool-Parameter können sensible Werte enthalten. Wenn die Inhaltserfassung Tool-Details enthält, werden Dateipfade, Befehlsargumente und andere Tool-Eingaben in den Feldern tool_input und tool_parameters exportiert. Planen Sie Ihre Aufbewahrung und Zugriffsrichtlinien entsprechend.
Benutzer-E-Mail-Adressen, die Pfade verbundener Ordner und API-Fehlermeldungen sind unabhängig von der Inhaltserfassungseinstellung enthalten. Eine API-Fehlermeldung kann manchmal einen Teil der Anfrage wiederholen, die sie verursacht hat. Filtern oder redigieren Sie daher bei Bedarf bei Ihrem Collector.
Ereignisse werden nur exportiert, wenn ein Administrator einen OTLP-Endpunkt konfiguriert. Standardmäßig fließen keine Daten.

OpenTelemetry-Daten mit der Compliance-API verbinden

Die Compliance-API umfasst Cowork (über Claude, Claude Desktop und Claude Mobile) und Claude Code (über CLI und Claude Desktop) neben Claude-Chats und bietet Ihnen einen Audit-Trail mit jeder Sitzung, die einem einzelnen Benutzer zugeordnet ist. Organisationen, die bereits OpenTelemetry verwenden, können beide parallel ausführen, und die OTel-Abdeckung umfasst auch Cowork im Web und auf Mobilgeräten. Erfahren Sie mehr über Abrufen von Remote-Sitzungen in der Compliance-API.