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 mensajes, respuestas ni argumentos de herramienta. Puede optar por capturar este contenido, pero puede contener información confidencial, como el código, el contenido del archivo y las indicaciones del usuario.
Habilitación de OpenTelemetry
Para recopilar datos de OTel de los clientes de los usuarios Copilot:
- 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, consulte 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. Esta configuración se aplica a los clientes de los usuarios y no se puede invalidar. La telemetry propiedad incluye claves para habilitar y configurar OpenTelemetry.
Para obtener más información, vea Configuración de opciones administradas 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: