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:
Vai a Impostazioni organizzazione > Cowork.
Inserisci il tuo endpoint OTLP (l'URL del tuo collector OpenTelemetry).
Seleziona il protocollo OTLP che utilizza il tuo collector: HTTP/JSON o HTTP/protobuf.
Aggiungi eventuali header OTLP richiesti per l'autenticazione, come un token bearer.
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
otlpContentCapturesu 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_inputetool_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à.
