Vai al contenuto principale

Monitora l'attività di Claude Cowork con OpenTelemetry

Questo articolo spiega come utilizzare OpenTelemetry (OTel) per monitorare l'attività di Claude Cowork nell'intera organizzazione. Con OTel, i team di sicurezza e operazioni possono trasmettere gli eventi di Cowork negli strumenti di osservabilità che già utilizzi per tracciare l'utilizzo, investigare gli incidenti e analizzare le prestazioni.

Disponibilità

Il monitoraggio OpenTelemetry per Claude Cowork è disponibile nei piani Team ed Enterprise. Copre le sessioni di Cowork eseguite nel cloud (su desktop, web e mobile) nonché le sessioni desktop locali. Il monitoraggio delle sessioni nel cloud richiede Claude Desktop versione 1.22209.3 o successiva, mentre il monitoraggio delle sessioni desktop locali richiede Claude Desktop versione 1.1.4173 o successiva.

La nuova esperienza Claude, che combina chat e Cowork, è in fase di rollout per i piani Pro, Max e Ultra. Nei piani Team ed Enterprise, è disponibile dove Chat e Cowork unificati è attivato. Le organizzazioni che non l'hanno attivato mantengono chat e Cowork come opzioni separate, quindi questo articolo rimane applicabile. I proprietari possono saperne di più nell'articolo che si applica al tuo piano:


Cosa puoi monitorare

Quando colleghi Claude Cowork a un collector OpenTelemetry, Cowork trasmette eventi che coprono:

  • Prompt degli utenti. Quando l'acquisizione di contenuti include i prompt degli utenti, il testo completo dei prompt che gli utenti inviano a Cowork. Altrimenti, ogni prompt viene registrato senza il suo testo.

  • Invocazioni di strumenti e MCP. Ogni chiamata di strumento che Claude effettua durante una sessione, inclusi il nome dello strumento, il successo o il fallimento e il tempo di esecuzione. Quando l'acquisizione di contenuti include i dettagli dello strumento, gli eventi includono anche i parametri dello strumento (per gli strumenti MCP, inclusi i nomi del server MCP e dello strumento) e il messaggio di errore quando uno strumento non riesce.

  • Accesso ai file. Le cartelle che gli utenti collegano a una sessione. Quando l'acquisizione di contenuti include i dettagli dello strumento, gli eventi includono anche i percorsi dei file che Claude legge, modifica o tocca in altro modo, inclusi i file accessibili tramite MCP.

  • Competenze e plugin. Quali competenze e plugin Claude utilizza all'interno di una sessione. A meno che l'acquisizione di contenuti non includa i dettagli dello strumento, le competenze e i plugin che non provengono da Anthropic vengono visualizzati con un nome segnaposto.

  • Decisioni di approvazione umana. Se ogni azione dello strumento è stata approvata dall'utente, rifiutata dall'utente o avviata automaticamente in base alle autorizzazioni esistenti.

  • Richieste API ed errori. Per ogni richiesta: modello, conteggio dei token, costo stimato, durata e eventuali errori restituiti.

Un attributo prompt.id condiviso collega ogni evento attivato da un singolo prompt dell'utente, in modo da poter ricostruire tutto ciò che Claude ha fatto in risposta a un input.

Per l'elenco completo dei tipi di evento e degli attributi, consulta il riferimento di monitoraggio di Cowork su claude.com/docs.


Quando utilizzare OpenTelemetry

OpenTelemetry ti fornisce un flusso in tempo reale di eventi Cowork strutturati che puoi instradare nei tuoi strumenti SIEM e di osservabilità esistenti. È la scelta giusta per il monitoraggio della sicurezza e l'investigazione degli incidenti, il tracciamento dei modelli di accesso ai file e agli strumenti nell'intera organizzazione, l'analisi dei costi e delle prestazioni e la creazione di dashboard e avvisi nella tua pipeline esistente.

Destinazioni compatibili

L'output OpenTelemetry di Cowork funziona con qualsiasi collector OTel standard. Le destinazioni comuni includono:

  • Piattaforme SIEM come Splunk e Cribl

  • Sistemi di aggregazione dei log come Elasticsearch e Loki

  • Archivi colonnari come ClickHouse

  • Piattaforme di osservabilità come Honeycomb e Datadog

Puoi instradare gli eventi a più destinazioni contemporaneamente configurando il tuo collector di conseguenza.


Configura il monitoraggio OpenTelemetry

Per configurare Cowork per esportare gli eventi nel tuo collector:

  1. Vai a Impostazioni organizzazione > Cowork.

  2. Inserisci il tuo endpoint OTLP (l'URL del tuo collector OpenTelemetry).

  3. Seleziona il protocollo OTLP che utilizza il tuo collector: HTTP/JSON o HTTP/protobuf.

  4. Aggiungi eventuali header OTLP richiesti per l'autenticazione, come un token bearer.

  5. Salva le tue impostazioni.

Gli eventi iniziano a fluire nel tuo collector immediatamente. Gli header di autenticazione sono crittografati a riposo sui server Anthropic.


Considerazioni sulla sicurezza e la privacy

Alcuni aspetti di cui essere consapevole prima di attivare l'esportazione OpenTelemetry:

  • Il testo del prompt, le risposte di Claude e gli input degli strumenti sono disattivati per impostazione predefinita nelle versioni attuali di Claude Desktop. Gli eventi contengono solo metadati a meno che non attivi l'acquisizione di contenuti con il criterio del dispositivo otlpContentCapture, che distribuisci con il tuo strumento di gestione dei dispositivi. Se lo attivi, instrada gli eventi attraverso un collector che soddisfi le politiche della tua organizzazione per la registrazione di quel contenuto. Scopri di più sull'acquisizione di contenuti nel riferimento di monitoraggio di Cowork.

  • Alcune versioni precedenti di Claude Desktop inviano contenuto quando il criterio non è impostato. Quel contenuto può includere testo del prompt, risposte di Claude e input degli strumenti. Queste versioni passano a metadati solo una volta aggiornate. Nelle versioni che supportano il criterio, puoi disattivare il contenuto prima di allora impostando otlpContentCapture su un elenco vuoto, scritto come i due caratteri [].

  • Il criterio si applica alle sessioni di Cowork avviate da Claude Desktop, indipendentemente dal fatto che vengano eseguite sul computer dell'utente o nel cloud. Non si applica alle attività pianificate eseguite nel cloud o, dove chat e Cowork sono unificati, alle chat che Claude sposta nel cloud. Quelle sessioni contengono solo metadati. Le sessioni di Cowork avviate sul web o nell'app mobile contengono solo metadati e il criterio non cambia questo.

  • I parametri dello strumento possono includere valori sensibili. Quando l'acquisizione di contenuti include i dettagli dello strumento, i percorsi dei file, gli argomenti dei comandi e altri input degli strumenti vengono esportati nei campi tool_input e tool_parameters. Pianifica di conseguenza le tue politiche di conservazione e accesso.

  • Gli indirizzi email degli utenti, i percorsi delle cartelle collegate e i messaggi di errore dell'API sono inclusi indipendentemente dall'impostazione di acquisizione dei contenuti. Un messaggio di errore dell'API a volte può ripetere parte della richiesta che l'ha causato, quindi filtra o redigi nel tuo collector se è una preoccupazione.

  • Gli eventi vengono esportati solo quando un amministratore configura un endpoint OTLP. Nessun dato fluisce per impostazione predefinita.


Unisci i dati OpenTelemetry con l'API di conformità

L'API di conformità copre Cowork (tramite Claude, Claude Desktop e Claude Mobile) e Claude Code (tramite CLI e Claude Desktop) insieme alle chat Claude, fornendoti un audit trail unico con ogni sessione attribuibile a un singolo utente. Le organizzazioni che già utilizzano OpenTelemetry possono eseguire entrambi in parallelo e la copertura OTel include anche Cowork su web e mobile. Scopri di più su come recuperare sessioni remote nell'API di conformità.

Hai ricevuto la risposta alla tua domanda?