Solución de problemas de observabilidad directa de OTel

Utilice esta guía para verificar la ingesta de telemetría y diagnosticar problemas con la telemetría de agentes enviada directamente a Agent 365 a través de OTLP. Está limitado a la ruta directa de OTel; si estás usando el Agent 365 SDK o el Microsoft OpenTelemetry Distro, consulte esas guías en su lugar. Para límites en el nivel de transmisión, códigos de error y condiciones de caída silenciosa, consulte Límites y condiciones de anulación.

Verificación de la ingesta

Un 200 OK no es prueba de ingesta. Algunas condiciones de anulación devuelven 200 con partialSuccess: null y sus datos simplemente no aparecen (consulte Límites y condiciones de anulación). Compruebe siempre sus primeras ejecuciones:

1. Comprobar estado HTTP. 200 → continuar. 4xx → consulte Errores comunes.
2. Analice partialSuccess null significa que la API lo aceptó todo. Cualquier otro valor significa que al menos algunos spans fueron descartados en el filtro por span.
3. Espere ~5 minutos y luego ejecute la consulta de búsqueda avanzada de Defender a continuación.
4. ¿No hay fila? Use el árbol de decisiones en No hay datos en Defender.

Consulta de búsqueda avanzada de Defender

La búsqueda canónica (unión a la identidad del agente que envió):

let agentIdToFind = "YOUR-AGENT-APP-ID-HERE";
CloudAppEvents
| where Timestamp > ago(1d)
| where ActionType in ("InvokeAgent", "InferenceCall", "ExecuteToolBySDK", "ExecuteToolByGateway", "ExecuteToolByMCPServer")
| extend resData = parse_json(tostring(RawEventData))
| extend AgentId = resData.AgentId
| extend TargetAgentId = resData.TargetAgentId
| extend AlternateId = resData.PlatformTargetAgentId
| where AgentId == agentIdToFind or TargetAgentId == agentIdToFind or AlternateId == agentIdToFind
| project Timestamp, ActionType, resData
| order by Timestamp desc

Para la lista completa de interfaces (vistas de actividad de agentes de Defender, Centro de administración de Microsoft 365, Microsoft Purview) y lo que requiere cada una, consulte Dónde se muestran sus datos.

No hay datos en Defender

• partialSuccess.rejectedSpans == totalSpans → todos sus tramos tenían un gen_ai.operation.name incorrecto. Solución: use uno de invoke_agent, execute_tool, chat, output_messages (es chat, no inference).
• 200 con partialSuccess: null pero ninguna fila de Defender después de 5 min → ningún usuario del inquilino del cliente tiene una licencia de Microsoft 365 E7 o de Microsoft Agent 365 asignada (Límites y condiciones de anulación, condición de anulación 2). Solución: confirme que al menos un usuario en el inquilino tenga la licencia asignada (no solo presente en el inquilino); de lo contrario, contacta con el equipo de incorporación de Agent 365.
• Los tramos aparecen, pero el árbol de ejecución está roto o algunos secundarios están huérfanos → falta parentSpanId, traceId es diferente o gen_ai.conversation.id no está establecido en cada tramo. Solución: revise Jerarquía de intervalos y agrupación de ejecución

Errores comunes

Pasos siguientes

• Conceptos de observabilidad de Agent 365 - Flujo de datos, modelos de identidad, autenticación, ámbitos y límites.
• Guía de integración - Prerrequisitos, métodos de autenticación, configuración del SDK y lista de verificación para la incorporación.
• Referencia de atributos: especificación por atributo y guía para seleccionar valores.