OpenTelemetry LLM Observabilidad: fija el esquema antes de ser verde

La observabilidad de OpenTelemetry LLM sólo es útil si la telemetría tiene un significado declarado. Antes de tratar un rastro de GenAI como evidencia operativa, fije la revisión de la convención semántica, valide los campos requeridos para cada operación, rechace la captura de contenido no aprobado, pruebe que las operaciones esperadas están presentes y luego evalúe por separado la frescura, el estado de trabajo y el resultado externo. Esa orden es importante en julio de 2026. El sitio web de OpenTelemetry ahora apunta las convenciones de GenAI a un repositorio dedicado. En la revisión de la fuente inspeccionada para este artículo, 434c91dcc34ed038e3048c07720ddfed2c6bddfc , el README todavía enumera su URL de esquema como TODO del repositorio y el documento generativo de duración del cliente están marcados Development . Esta no es una razón para evitar OpenTelemetry. Es una razón para hacer explícita la compatibilidad. Un panel que contiene extensiones de GenAI todavía puede combinar un viejo productor, un coleccionista actual y una consulta escrita para una tercera forma de atributo. El defecto seguro es un pequeño perfil de aceptación versionado junto a la configuración de su colector. Pinta el contrato que realmente operas El repositorio GenAI de OpenTelemetry cubre clientes, agentes, ejecución de herramientas, evaluación, memoria, recuperación y MCP de LLM. Sus documentos se generan en parte a partir de modelos YAML, lo que es valioso porque la fuente es inspectables y testables. También significa que "usamos OTel" es demasiado vago para ser una afirmación de compatibilidad. Registrar cuatro identidades con cada implantación de instrumentos: Identidad Ejemplo ¿Por qué es importante? Fuente del Convenio Repositorio más compromiso SHA Define el contrato de atributo y operación que revisó Paquete de instrumentos Nombre y versión del paquete Identifica lo que emitió el espacio El gasoducto de colectores Configurar el registro y la identificación de despliegue Identifica transformadores, filtros y exportadores Contrato de consulta Tabla de control o versión de alerta Identifica los campos que el veredicto espera No deduzcan la revisión de la convención a partir de los campos que ocurran llegar. Eso convierte la deriva silenciosa en aparente compatibilidad. Si un productor no puede declarar su revisión, clasifique el lote como schema drift hasta que realice el ensayo y registre esa forma de productor. Esto es especialmente importante cuando coexisten instrumentos de marco nativos y externos. El Orientación sobre la observabilidad del agente de OpenTelemetry describe los compromisos de mantenimiento de los instrumentos incorporados y advierte de que los paquetes externos pueden chocar con ellos. El mismo modelo de llamada puede ser observado dos veces, o una ruta puede permanecer en una convención anterior después de una actualización parcial. La regla práctica es simple: un productor de telemetría esperado por ruta de operación, una revisión declarada de la convención por cohorte de despliegue y un rastro canario que debe pasar antes de que la cohorte sea promovida. Valida un pequeño perfil operativo antes del esquema completo Se puede generar un validador de convenciones semánticas completo a partir de los modelos de repositorios. Una puerta operativa debería comenzar más pequeña. Aplique sólo los campos que afectan a sus decisiones actuales, luego expanda el perfil a medida que usa más operaciones. En la revisión fijada, las marcas tabla de extensión de la inferencia: gen ai.operation.name según sea necesario; gen ai.provider.name según sea necesario; error.type , según lo requerido condicionalmente cuando la operación termine en un error; gen ai.request.model según se requiera condicionalmente cuando esté disponible; los mensajes de entrada, los mensajes de salida, las instrucciones del sistema y las definiciones de las herramientas como opt in. Estos niveles de requisitos no deben ser aplanados en "campo presente o ausente". Un intervalo de error sin error.type ha perdido una clase de evidencia que la convención espera. Un modelo de solicitud faltante puede ser legítimo cuando no estaba disponible. El contenido de respuesta inmediata y de respuesta debe permanecer ausente a menos que una política explícita permita la recogida. La auditoría acompañante implementa este perfil estrecho: La verificación de contenido sólo mira el atributo Key . No lee ni almacena texto inmediato, texto de respuesta, instrucciones del sistema o argumentos de herramientas. Eso es suficiente para capturar una captura accidental de opt in sin convertir el validador en otro depósito de datos sensibles. Hay una limitación deliberada aquí: este perfil no es toda la especificación de OpenTelemetry. Prueba un contrato revisable utilizado para un veredicto operativo. Cuando la fuente ascendente cambie, actualice la revisión fijada, compare las definiciones generadas, ajuste la fijación y vuelva a ejecutarla antes de actualizar a los productores. Cobertura de auditoría antes de interpretar un rastro limpio Un lapso conformante puede ser todavía una evidencia incompleta. Si la solicitud esperaba invoke agent , chat y execute tool , pero el rastro contiene solo los dos primeros, el veredicto correcto es coverage gap , no saludable. Construir las operaciones esperadas a partir de la topología del flujo de trabajo en lugar de a partir de intervalos observados: Esto evita una prueba circular en la que la telemetría define su propia integridad. El conjunto esperado puede provenir de un manifiesto de liberación, ruta de herramienta registrada o definición de flujo de trabajo. Debe ser lo suficientemente pequeño como para mantenerse y lo suficientemente específico como para exponer una ruta de instrumentación que falta. Los retemplajes automáticos necesitan cuidado. La prosa actual del cliente dice que un período lógico debe cubrir la duración de la operación incluyendo retemplajes automáticos. Su solicitud también puede conservar períodos de transporte a nivel de intento. No contes esas dos capas como trabajo de agente duplicado. Decide si la cobertura se expresa en la operación lógica, intento, o ambos, y luego hacer la relación explícita. Del mismo modo, un nombre de proveedor no es necesariamente el propietario final del modelo. La convención señala que la instrumentación puede conocer una plataforma de proxy o de hosting en lugar del proveedor de upstream transparente. Tratar a gen ai.provider.name como un discriminador de formato y un hecho de enrutamiento dentro de su ámbito documentado, no como un oráculo de facturación o de origen de modelo. Mantenga el esquema, la salud y el resultado como veredictos separados Una vez que el esquema y la cobertura hayan pasado, el rastro puede informar una decisión de salud. No es la decisión por sí misma. Utilice una prioridad explícita: 1. Schema identity ¿El productor coincide con la revisión fijada? 2. Valididad del esquema ¿Se requieren y los campos condicionales son válidos? 3. Política de contenido ¿Se permiten campos de acceso para esta ruta? 4. Coverage ¿Se representan todas las operaciones esperadas? 5. Freshness ¿Es la evidencia lo suficientemente reciente para el flujo de trabajo? 6. Estado de trabajo ¿El agente está trabajando, esperando, atascado, incierto o completo? 7. Outcome ¿Existe el resultado prometido en su destino? La fijación de diez casos para este artículo mantiene esas capas incómodas a propósito. Incluye: un productor no autorizado y un productor heredado; un intervalo de inferencia que carezca de gen ai.provider.name ; un intervalo de error faltante de error.type ; una clave de contenido de opción sin permiso; un flujo de trabajo que carezca de su duración esperada de la herramienta; un rastro completo sin recibo de resultado; un rastro verificado pero anticuado; una espera legítima de aprobación humana; un caso nuevo, cubierto y verificado por resultados. Ejecutar el artefacto con: El resultado ejecutado clasificó exactamente diez casos: El caso complete no receipt es el límite clave. Su revisión del productor coincide. Sus extensiones contienen los campos requeridos por el perfil. Existen las operaciones de agente y modelo esperadas. La telemetría está fresca. Todavía devuelve unverified porque ningún recibo de destino prueba que el boleto, archivo, despliegue u otro resultado prometido existe. El caso waiting for approval conserva un límite diferente. Las extensiones recientes y conformes se detienen en una aprobación humana nombrada con un propietario y fecha límite. Eso no es un puesto. Pagar a un operador como si el agente hubiera fallado destruiría información útil del estado. Transformar la auditoría en un control de liberación e incidentes Realice esta prueba en tres momentos. Antes de actualizar la instrumentación , captura la revisión actual, las versiones del paquete, el digesto del colector y las operaciones esperadas. Reproduce la fijación fija contra la pila propuesta. Un veredicto cambiado debe explicarse antes de ser ascendido. Durante el lanzamiento , emita un canario libre de contenido a través de cada modelo registrado, agente y ruta de herramienta. Compruebe si cada canario llega una vez, lleva la identidad de productor esperada, pasa el perfil operativo y se puede buscar dentro de la ventana de frescura. Durante un incidente , conserve las cuatro capas en lugar de colapsarlas en "la observabilidad se rompe". Una brecha de cobertura requiere la reparación de los instrumentos. La telemetría estática requiere el diagnóstico del coleccionista o exportador. waiting llama por el propietario nombrado. unverified pide una verificación de destino, no otra prueba de modelo. No reparar automáticamente un agente porque un campo de telemetría haya cambiado. La deriva de las convenciones puede hacer que las pruebas sean inciertas sin hacer que el trabajo subyacente sea insalubre. Congelar la recuperación activa, identificar la capa de evidencia fallida, y utilizar la prueba reversible más pequeña que restablezca la confianza. El perfil del esquema también necesita un propietario. Mantener un compromiso para siempre no es seguridad; es un estancamiento final. Asigna una cadencia de revisión, vigila el repositorio GenAI y requiere una diferencia de fijación al mover el pin. Si OpenTelemetry publica una URL estable de esquema de GenAI más tarde, adoptala cuando sus productores y consultas la apoyen, pero mantenga la cobertura, la frescura, la espera y las comprobaciones de resultados independientes. Sidewisp se encuentra actualmente en versión preliminar privada. Su experiencia pública es un sitio web de acceso temprano y una demostración interactiva; la recopilación de agentes de producción y salud, los adaptadores de host y la recuperación no se envían en el repositorio actual del sitio web. La dirección del producto es una capa de salud en torno a los tiempos de ejecución existentes, no un colector OpenTelemetry, rastreo de backend o fijación autónoma. Si la evidencia de revisión y la verificación de resultados separados coinciden con los fallos que necesita detectar, puede describir Únete a la vista previa privada de Sidewisp y describir el tiempo de ejecución del agente y la trayectoria de telemetría que opera.