Ir para conteúdo principal

Monitorar atividade do Claude Cowork com OpenTelemetry

Este artigo explica como usar OpenTelemetry (OTel) para monitorar atividade do Claude Cowork em sua organização. Com OTel, suas equipes de segurança e operações podem transmitir eventos do Cowork para as ferramentas de observabilidade que você já usa para rastrear uso, investigar incidentes e analisar desempenho.

Disponibilidade

O monitoramento OpenTelemetry para Claude Cowork está disponível nos planos Team e Enterprise. Ele cobre sessões do Cowork executadas na nuvem (em desktop, web e mobile) bem como sessões locais de desktop. O monitoramento de sessões na nuvem requer Claude Desktop versão 1.22209.3 ou posterior, e o monitoramento de sessões locais de desktop requer Claude Desktop versão 1.1.4173 ou posterior.

A nova experiência Claude, que combina chat e Cowork, está sendo lançada para os planos Pro, Max e Ultra. Nos planos Team e Enterprise, está disponível onde Chat and Cowork unified está ativado. Organizações que não ativaram mantêm chat e Cowork como opções separadas, portanto este artigo ainda se aplica. Os proprietários podem saber mais no artigo que se aplica ao seu plano:


O que você pode monitorar

Quando você conecta Claude Cowork a um coletor OpenTelemetry, o Cowork transmite eventos cobrindo:

  • Prompts do usuário. Quando a captura de conteúdo inclui prompts do usuário, o texto completo dos prompts que os usuários enviam para o Cowork. Caso contrário, cada prompt é registrado sem seu texto.

  • Invocações de ferramentas e MCP. Cada chamada de ferramenta que Claude faz durante uma sessão, incluindo o nome da ferramenta, sucesso ou falha e tempo de execução. Quando a captura de conteúdo inclui detalhes da ferramenta, os eventos também carregam os parâmetros da ferramenta (para ferramentas MCP, incluindo os nomes do servidor MCP e da ferramenta) e a mensagem de erro quando uma ferramenta falha.

  • Acesso a arquivos. As pastas que os usuários conectam a uma sessão. Quando a captura de conteúdo inclui detalhes da ferramenta, os eventos também carregam os caminhos de arquivo que Claude lê, modifica ou de outra forma acessa, incluindo arquivos acessados através de MCPs.

  • Habilidades e plugins. Quais habilidades e plugins Claude usa dentro de uma sessão. A menos que a captura de conteúdo inclua detalhes da ferramenta, habilidades e plugins que não vêm da Anthropic aparecem sob um nome de espaço reservado.

  • Decisões de aprovação humana. Se cada ação da ferramenta foi aprovada pelo usuário, rejeitada pelo usuário ou iniciada automaticamente com base em permissões existentes.

  • Solicitações e erros de API. Por solicitação: modelo, contagens de tokens, custo estimado, duração e quaisquer erros retornados.

Um atributo prompt.id compartilhado vincula cada evento acionado por um único prompt do usuário, para que você possa reconstruir tudo o que Claude fez em resposta a uma entrada.

Para a lista completa de tipos de eventos e atributos, consulte a referência de monitoramento do Cowork em claude.com/docs.


Quando usar OpenTelemetry

OpenTelemetry oferece um fluxo em tempo real de eventos estruturados do Cowork que você pode rotear para suas ferramentas SIEM e de observabilidade existentes. É a escolha certa para monitoramento de segurança e investigação de incidentes, rastreamento de padrões de acesso a ferramentas e arquivos em sua organização, análise de custo e desempenho, e construção de painéis e alertas em seu pipeline existente.

Destinos compatíveis

A saída OpenTelemetry do Cowork funciona com qualquer coletor OTel padrão. Os destinos comuns incluem:

  • Plataformas SIEM como Splunk e Cribl

  • Sistemas de agregação de logs como Elasticsearch e Loki

  • Armazenamentos colunares como ClickHouse

  • Plataformas de observabilidade como Honeycomb e Datadog

Você pode rotear eventos para vários destinos simultaneamente configurando seu coletor adequadamente.


Configurar monitoramento OpenTelemetry

Para configurar o Cowork para exportar eventos para seu coletor:

  1. Vá para Configurações da organização > Cowork.

  2. Digite seu endpoint OTLP (URL do seu coletor OpenTelemetry).

  3. Selecione o protocolo OTLP que seu coletor usa: HTTP/JSON ou HTTP/protobuf.

  4. Adicione quaisquer cabeçalhos OTLP necessários para autenticação, como um token de portador.

  5. Salve suas configurações.

Os eventos começam a fluir para seu coletor imediatamente. Os cabeçalhos de autenticação são criptografados em repouso nos servidores da Anthropic.


Considerações de segurança e privacidade

Algumas coisas a ter em mente antes de ativar a exportação OpenTelemetry:

  • Texto de prompt, respostas do Claude e entradas de ferramentas estão desativados por padrão nas versões atuais do Claude Desktop. Os eventos carregam apenas metadados a menos que você ative a captura de conteúdo com a política de dispositivo otlpContentCapture, que você implanta com sua ferramenta de gerenciamento de dispositivos. Se você ativar, rotear eventos através de um coletor que atenda às políticas de sua organização para registrar esse conteúdo. Saiba mais sobre captura de conteúdo na referência de monitoramento do Cowork.

  • Algumas versões mais antigas do Claude Desktop enviam conteúdo quando a política não está definida. Esse conteúdo pode incluir texto de prompt, respostas do Claude e entradas de ferramentas. Essas versões mudam para apenas metadados assim que são atualizadas. Em versões que suportam a política, você pode desativar o conteúdo antes disso definindo otlpContentCapture para uma lista vazia, escrita como os dois caracteres [].

  • A política se aplica a sessões do Cowork iniciadas no Claude Desktop, independentemente de serem executadas no computador do usuário ou na nuvem. Não se aplica a tarefas agendadas executadas na nuvem ou, onde chat e Cowork são unificados, a chats que Claude move para a nuvem. Essas sessões carregam apenas metadados. Sessões do Cowork iniciadas na web ou no aplicativo móvel carregam apenas metadados, e a política não muda isso.

  • Os parâmetros da ferramenta podem incluir valores sensíveis. Quando a captura de conteúdo inclui detalhes da ferramenta, caminhos de arquivo, argumentos de comando e outras entradas de ferramentas são exportados nos campos tool_input e tool_parameters. Planeje suas políticas de retenção e acesso adequadamente.

  • Endereços de email do usuário, caminhos de pastas conectadas e mensagens de erro de API são incluídos independentemente da configuração de captura de conteúdo. Uma mensagem de erro de API às vezes pode repetir parte da solicitação que a causou, portanto filtre ou edite em seu coletor se isso for uma preocupação.

  • Os eventos são exportados apenas quando um administrador configura um endpoint OTLP. Nenhum dado flui por padrão.


Unir dados OpenTelemetry com a API de Conformidade

A API de Conformidade cobre Cowork (via Claude, Claude Desktop e Claude Mobile) e Claude Code (via CLI e Claude Desktop) junto com chats Claude, oferecendo um trilho de auditoria com cada sessão atribuível a um usuário individual. Organizações que já usam OpenTelemetry podem executar ambos em paralelo, e a cobertura OTel inclui Cowork em web e mobile também. Saiba mais sobre recuperação de sessões remotas na API de Conformidade.

Isto respondeu à sua pergunta?