Ir al contenido principal

Monitorear la actividad de Claude Cowork con OpenTelemetry

Este artículo explica cómo usar OpenTelemetry (OTel) para monitorear la actividad de Claude Cowork en tu organización. Con OTel, tus equipos de seguridad y operaciones pueden transmitir eventos de Cowork a las herramientas de observabilidad que ya utilizas para rastrear el uso, investigar incidentes y analizar el rendimiento.

Disponibilidad

El monitoreo de OpenTelemetry para Claude Cowork está disponible en planes Team y Enterprise. Cubre sesiones de Cowork que se ejecutan en la nube (en escritorio, web y móvil) así como sesiones de escritorio local. El monitoreo de sesiones en la nube requiere Claude Desktop versión 1.22209.3 o posterior, y el monitoreo de sesiones de escritorio local requiere Claude Desktop versión 1.1.4173 o posterior.

La nueva experiencia de Claude, que combina chat y Cowork, se está implementando en los planes Pro, Max y Ultra. En los planes Team y Enterprise, está disponible donde Chat and Cowork unified está activado. Las organizaciones que no lo han activado mantienen chat y Cowork como opciones separadas, por lo que este artículo sigue siendo aplicable. Los propietarios pueden obtener más información en el artículo que se aplica a tu plan:


Qué puedes monitorear

Cuando conectas Claude Cowork a un recopilador de OpenTelemetry, Cowork transmite eventos que cubren:

  • Indicaciones del usuario. Cuando la captura de contenido incluye indicaciones del usuario, el texto completo de las indicaciones que los usuarios envían a Cowork. De lo contrario, cada indicación se registra sin su texto.

  • Invocaciones de herramientas y MCP. Cada llamada de herramienta que Claude realiza durante una sesión, incluido el nombre de la herramienta, éxito o fracaso, y tiempo de ejecución. Cuando la captura de contenido incluye detalles de herramientas, los eventos también incluyen los parámetros de la herramienta (para herramientas MCP, incluidos los nombres del servidor MCP y de la herramienta) y el mensaje de error cuando una herramienta falla.

  • Acceso a archivos. Las carpetas que los usuarios conectan a una sesión. Cuando la captura de contenido incluye detalles de herramientas, los eventos también incluyen las rutas de archivo que Claude lee, modifica o de otra manera toca, incluidos los archivos accedidos a través de MCP.

  • Habilidades y complementos. Qué habilidades y complementos utiliza Claude dentro de una sesión. A menos que la captura de contenido incluya detalles de herramientas, las habilidades y complementos que no provienen de Anthropic aparecen bajo un nombre de marcador de posición.

  • Decisiones de aprobación humana. Si cada acción de herramienta fue aprobada por el usuario, rechazada por el usuario o iniciada automáticamente según los permisos existentes.

  • Solicitudes de API y errores. Por solicitud: modelo, conteos de tokens, costo estimado, duración y cualquier error devuelto.

Un atributo prompt.id compartido vincula cada evento desencadenado por una única indicación del usuario, para que puedas reconstruir todo lo que Claude hizo en respuesta a una entrada.

Para la lista completa de tipos de eventos y atributos, consulta la referencia de monitoreo de Cowork en claude.com/docs.


Cuándo usar OpenTelemetry

OpenTelemetry te proporciona un flujo en tiempo real de eventos de Cowork estructurados que puedes enrutar a tus herramientas SIEM y de observabilidad existentes. Es la opción correcta para monitoreo de seguridad e investigación de incidentes, rastreo de patrones de acceso a herramientas y archivos en tu organización, análisis de costos y rendimiento, y construcción de paneles y alertas en tu canalización existente.

Destinos compatibles

La salida de OpenTelemetry de Cowork funciona con cualquier recopilador OTel estándar. Los destinos comunes incluyen:

  • Plataformas SIEM como Splunk y Cribl

  • Sistemas de agregación de registros como Elasticsearch y Loki

  • Almacenes columnares como ClickHouse

  • Plataformas de observabilidad como Honeycomb y Datadog

Puedes enrutar eventos a múltiples destinos simultáneamente configurando tu recopilador en consecuencia.


Configurar el monitoreo de OpenTelemetry

Para configurar Cowork para exportar eventos a tu recopilador:

  1. Ve a Configuración de la organización > Cowork.

  2. Ingresa tu punto final OTLP (la URL de tu recopilador de OpenTelemetry).

  3. Selecciona el protocolo OTLP que utiliza tu recopilador: HTTP/JSON o HTTP/protobuf.

  4. Añade cualquier encabezado OTLP requerido para la autenticación, como un token de portador.

  5. Guarda tu configuración.

Los eventos comienzan a fluir a tu recopilador inmediatamente. Los encabezados de autenticación se cifran en reposo en los servidores de Anthropic.


Consideraciones de seguridad y privacidad

Algunas cosas a tener en cuenta antes de activar la exportación de OpenTelemetry:

  • El texto de indicaciones, las respuestas de Claude y las entradas de herramientas están desactivados por defecto en las versiones actuales de Claude Desktop. Los eventos solo incluyen metadatos a menos que actives la captura de contenido con la política de dispositivo otlpContentCapture, que implementas con tu herramienta de administración de dispositivos. Si la activas, enruta eventos a través de un recopilador que cumpla con las políticas de tu organización para registrar ese contenido. Obtén más información sobre captura de contenido en la referencia de monitoreo de Cowork.

  • Algunas versiones anteriores de Claude Desktop envían contenido cuando la política no está configurada. Ese contenido puede incluir texto de indicaciones, respuestas de Claude y entradas de herramientas. Estas versiones cambian a solo metadatos una vez que se actualizan. En versiones que admiten la política, puedes desactivar el contenido antes de eso configurando otlpContentCapture en una lista vacía, escrita como los dos caracteres [].

  • La política se aplica a sesiones de Cowork iniciadas desde Claude Desktop, ya sea que se ejecuten en la computadora del usuario o en la nube. No se aplica a tareas programadas que se ejecutan en la nube, o, donde chat y Cowork están unificados, a chats que Claude mueve a la nube. Esas sesiones solo incluyen metadatos. Las sesiones de Cowork iniciadas en la web o en la aplicación móvil solo incluyen metadatos, y la política no cambia eso.

  • Los parámetros de herramientas pueden incluir valores sensibles. Cuando la captura de contenido incluye detalles de herramientas, las rutas de archivo, argumentos de comandos y otras entradas de herramientas se exportan en los campos tool_input y tool_parameters. Planifica tus políticas de retención y acceso en consecuencia.

  • Las direcciones de correo electrónico de los usuarios, las rutas de las carpetas conectadas y los mensajes de error de API se incluyen independientemente de la configuración de captura de contenido. Un mensaje de error de API a veces puede repetir parte de la solicitud que lo causó, así que filtra o redacta en tu recopilador si eso es una preocupación.

  • Los eventos solo se exportan cuando un administrador configura un punto final OTLP. No hay flujo de datos por defecto.


Unir datos de OpenTelemetry con la API de Cumplimiento

La API de Cumplimiento cubre Cowork (a través de Claude, Claude Desktop y Claude Mobile) y Claude Code (a través de CLI y Claude Desktop) junto con chats de Claude, dándote un registro de auditoría único con cada sesión atribuible a un usuario individual. Las organizaciones que ya utilizan OpenTelemetry pueden ejecutar ambos en paralelo, y la cobertura de OTel incluye Cowork en web y móvil también. Obtén más información sobre recuperación de sesiones remotas en la API de Cumplimiento.

¿Ha quedado contestada tu pregunta?