Passer au contenu principal

Surveiller l'activité Claude Cowork avec OpenTelemetry

Cet article explique comment utiliser OpenTelemetry (OTel) pour surveiller l'activité Claude Cowork dans votre organisation. Avec OTel, vos équipes de sécurité et d'exploitation peuvent diffuser les événements Cowork dans les outils d'observabilité que vous utilisez déjà pour suivre l'utilisation, enquêter sur les incidents et analyser les performances.

Disponibilité

La surveillance OpenTelemetry pour Claude Cowork est disponible sur les plans Team et Enterprise. Elle couvre les sessions Cowork qui s'exécutent dans le cloud (sur desktop, web et mobile) ainsi que les sessions desktop locales. La surveillance des sessions dans le cloud nécessite Claude Desktop version 1.22209.3 ou ultérieure, et la surveillance des sessions desktop locales nécessite Claude Desktop version 1.1.4173 ou ultérieure.

La nouvelle expérience Claude, qui combine chat et Cowork, est déployée sur les plans Pro, Max et Ultra. Sur les plans Team et Enterprise, elle est disponible où Chat et Cowork unifiés est activé. Les organisations qui ne l'ont pas activé conservent chat et Cowork comme options séparées, donc cet article s'applique toujours. Les propriétaires peuvent en savoir plus dans l'article qui s'applique à votre plan :


Ce que vous pouvez surveiller

Lorsque vous connectez Claude Cowork à un collecteur OpenTelemetry, Cowork diffuse des événements couvrant :

  • Invites utilisateur. Lorsque la capture de contenu inclut les invites utilisateur, le texte complet des invites que les utilisateurs soumettent à Cowork. Sinon, chaque invite est enregistrée sans son texte.

  • Invocations d'outils et MCP. Chaque appel d'outil que Claude effectue pendant une session, y compris le nom de l'outil, le succès ou l'échec, et le temps d'exécution. Lorsque la capture de contenu inclut les détails de l'outil, les événements portent également les paramètres de l'outil (pour les outils MCP, y compris les noms du serveur MCP et de l'outil) et le message d'erreur en cas d'échec de l'outil.

  • Accès aux fichiers. Les dossiers que les utilisateurs connectent à une session. Lorsque la capture de contenu inclut les détails de l'outil, les événements portent également les chemins de fichiers que Claude lit, modifie ou touche autrement, y compris les fichiers accessibles via les MCP.

  • Compétences et plugins. Les compétences et plugins que Claude utilise au sein d'une session. À moins que la capture de contenu n'inclue les détails de l'outil, les compétences et plugins qui ne proviennent pas d'Anthropic apparaissent sous un nom générique.

  • Décisions d'approbation humaine. Si chaque action d'outil a été approuvée par l'utilisateur, rejetée par l'utilisateur ou initiée automatiquement en fonction des autorisations existantes.

  • Requêtes API et erreurs. Par requête : modèle, nombre de jetons, coût estimé, durée et toute erreur renvoyée.

Un attribut prompt.id partagé relie chaque événement déclenché par une seule invite utilisateur, ce qui vous permet de reconstruire tout ce que Claude a fait en réponse à une entrée.

Pour la liste complète des types d'événements et des attributs, consultez la référence de surveillance Cowork sur claude.com/docs.


Quand utiliser OpenTelemetry

OpenTelemetry vous offre un flux en temps réel d'événements Cowork structurés que vous pouvez acheminer vers vos outils SIEM et d'observabilité existants. C'est le bon choix pour la surveillance de la sécurité et l'enquête sur les incidents, le suivi des modèles d'accès aux outils et fichiers dans votre organisation, l'analyse des coûts et des performances, et la création de tableaux de bord et d'alertes dans votre pipeline existant.

Destinations compatibles

La sortie OpenTelemetry de Cowork fonctionne avec n'importe quel collecteur OTel standard. Les destinations courantes incluent :

  • Plateformes SIEM comme Splunk et Cribl

  • Systèmes d'agrégation de journaux comme Elasticsearch et Loki

  • Magasins colonnaires comme ClickHouse

  • Plateformes d'observabilité comme Honeycomb et Datadog

Vous pouvez acheminer les événements vers plusieurs destinations à la fois en configurant votre collecteur en conséquence.


Configurer la surveillance OpenTelemetry

Pour configurer Cowork afin d'exporter les événements vers votre collecteur :

  1. Allez à Paramètres de l'organisation > Cowork.

  2. Entrez votre point de terminaison OTLP (l'URL de votre collecteur OpenTelemetry).

  3. Sélectionnez le protocole OTLP que votre collecteur utilise : HTTP/JSON ou HTTP/protobuf.

  4. Ajoutez tous les en-têtes OTLP requis pour l'authentification, comme un jeton porteur.

  5. Enregistrez vos paramètres.

Les événements commencent à circuler vers votre collecteur immédiatement. Les en-têtes d'authentification sont chiffrés au repos sur les serveurs Anthropic.


Considérations de sécurité et de confidentialité

Quelques points à connaître avant d'activer l'export OpenTelemetry :

  • Le texte de l'invite, les réponses de Claude et les entrées d'outil sont désactivés par défaut dans les versions actuelles de Claude Desktop. Les événements ne portent que des métadonnées à moins que vous n'activiez la capture de contenu avec la politique d'appareil otlpContentCapture, que vous déployez avec votre outil de gestion d'appareils. Si vous l'activez, acheminez les événements via un collecteur qui respecte les politiques de votre organisation pour la journalisation de ce contenu. En savoir plus sur la capture de contenu dans la référence de surveillance Cowork.

  • Certaines versions plus anciennes de Claude Desktop envoient du contenu lorsque la politique n'est pas définie. Ce contenu peut inclure le texte de l'invite, les réponses de Claude et les entrées d'outil. Ces versions passent à métadonnées uniquement une fois qu'elles se mettent à jour. Sur les versions qui supportent la politique, vous pouvez désactiver le contenu avant cela en définissant otlpContentCapture sur une liste vide, écrite comme les deux caractères [].

  • La politique s'applique aux sessions Cowork démarrées à partir de Claude Desktop, qu'elles s'exécutent sur l'ordinateur de l'utilisateur ou dans le cloud. Elle ne s'applique pas aux tâches planifiées qui s'exécutent dans le cloud, ni, où chat et Cowork sont unifiés, aux chats que Claude déplace vers le cloud. Ces sessions ne portent que des métadonnées. Les sessions Cowork démarrées sur le web ou dans l'application mobile ne portent que des métadonnées, et la politique ne change pas cela.

  • Les paramètres d'outil peuvent inclure des valeurs sensibles. Lorsque la capture de contenu inclut les détails de l'outil, les chemins de fichiers, les arguments de commande et autres entrées d'outil sont exportés dans les champs tool_input et tool_parameters. Planifiez vos politiques de rétention et d'accès en conséquence.

  • Les adresses e-mail des utilisateurs, les chemins des dossiers connectés et les messages d'erreur API sont inclus quel que soit le paramètre de capture de contenu. Un message d'erreur API peut parfois répéter une partie de la requête qui l'a causé, donc filtrez ou rédigez au niveau de votre collecteur si c'est une préoccupation.

  • Les événements ne sont exportés que lorsqu'un administrateur configure un point de terminaison OTLP. Aucune donnée ne circule par défaut.


Joindre les données OpenTelemetry avec l'API de conformité

L'API de conformité couvre Cowork (via Claude, Claude Desktop et Claude Mobile) et Claude Code (via CLI et Claude Desktop) aux côtés des chats Claude, vous donnant une piste d'audit unique avec chaque session attribuable à un utilisateur individuel. Les organisations utilisant déjà OpenTelemetry peuvent exécuter les deux en parallèle, et la couverture OTel inclut également Cowork sur web et mobile. En savoir plus sur la récupération des sessions distantes dans l'API de conformité.

Avez-vous trouvé la réponse à votre question ?