OpenTelemetry (OTel) es un marco de observabilidad código abierto. Proporciona una manera estándar de recopilar eventos y métricas de telemetría y exportarlos a herramientas de observabilidad compatibles. Para obtener más información, consulte ¿Qué es OpenTelemetry? en el sitio web de OTel.
Al habilitar la supervisión de OTel, puede enviar datos de los clientes Copilot de los usuarios a un backend compatible con OTel. Esto le permite analizar las sesiones del agente y comprender el uso del agente en toda la empresa.
¿Qué datos envía Copilot?
Copilot envía tres tipos de datos:
- Los seguimientos muestran el flujo de una sesión del agente y conectan cada paso, incluidas las llamadas de modelo y el uso de herramientas. Por ejemplo, un seguimiento puede mostrar un agente que llama a un modelo mediante la
readFileherramienta y llamar al modelo de nuevo para generar una respuesta. - Las métricas son medidas numéricas que le ayudan a identificar patrones a lo largo del tiempo. Por ejemplo, las métricas de uso de tokens realizan un seguimiento del número de tokens de entrada y salida usados en las llamadas de modelo.
- Los eventos registran acciones individuales en un momento dado específico. Por ejemplo, un evento de retroalimentación sobre una edición registra si un usuario aceptó o rechazó una edición realizada por un agente.
De forma predeterminada, los datos no incluyen atributos de identificación directa, prompts, respuestas, argumentos de herramienta, resultados de herramientas o detalles de directiva sin procesar. Los administradores de empresa pueden habilitar de forma independiente las siguientes clases de captura mediante la configuración administrada:
- La identidad agrega el nombre de la cuenta autenticada Copilot , la cuenta del sistema operativo local y el nombre del equipo. Esto le permite atribuir la actividad a una fuente sin recopilar contenido de la conversación ni de la herramienta.
- Las indicaciones incluyen el contenido del mensaje del usuario, los mensajes del sistema y del desarrollador, y la entrada del modelo asociada.
- Las respuestas incluyen la respuesta del asistente y el contenido de razonamiento compatible.
- Los argumentos de la herramienta incluyen argumentos sin procesar, comandos, esquemas de herramientas e identificadores para herramientas, servidores MCP, complementos y hooks.
- La salida de la herramienta incluye los resultados de la herramienta y los detalles del error de ejecución.
- Los detalles de la directiva incluyen información de directiva no limitada, como rutas sin procesar del sistema de archivos del sandbox. La postura de directiva limitada y los resultados permanecen disponibles cuando esta clase está deshabilitada.
Los controles de captura detallados se admiten en las sesiones Copilot CLI, GitHub Copilot app y VS Code mediante Agent Host. El componente del agente local de VS Code admite la captura de identidad y la configuración heredada de captura de contenido de todo o nada, pero no aplica de forma independiente las cinco clases de captura de contenido.
El contenido capturado puede contener información confidencial, incluido el código fuente, el contenido del archivo, las indicaciones del usuario, los comandos, los resultados de la herramienta y las rutas de acceso de área de trabajo o perfil de usuario. Habilite solo las clases necesarias para el caso de uso.
Habilitación de OpenTelemetry
Para recopilar datos de OTel desde los clientes Copilot de los usuarios:
- Configure un back-end de observabilidad. Elija un back-end seguro que admita el protocolo OpenTelemetry (OTLP). Algunos backends pueden recibir datos OTLP directamente. Para otros back-end, implemente un recopilador de OpenTelemetry para recibir, procesar y reenviar los datos. Para ver ejemplos, consulta Uso con backends de observabilidad en la VS Code documentación.
- Configure los clientes de los usuarios. Establezca los valores de configuración para habilitar OTel en cada cliente y configurarlo para enviar datos al punto de conexión de OTLP mediante la configuración del punto de conexión, los encabezados y el token de autenticación.
- Interpretar datos. Use los datos recopilados para analizar las sesiones e identificar tendencias. Para obtener una implementación de ejemplo, consulte Supervisión de agentes de codificación de IA con Grafana en la documentación de Microsoft.
Configuración de clientes de usuarios
Las empresas pueden imponer la configuración de OTel en todos los clientes compatibles mediante ajustes administrados. Los valores administrados explícitos tienen prioridad sobre la configuración local, la configuración del SDK y las variables de entorno. La telemetry propiedad incluye claves para habilitar y enrutar OpenTelemetry y controlar de forma independiente la identidad y la captura de contenido confidencial.
Para obtener más información, vea Introducción a la configuración administrada por la empresa y Configuración administrada por la empresa.
Documentación del cliente
Para obtener más información sobre cómo se usa OpenTelemetry en todos los clientes, consulte: