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 del agente enviada a Agent 365 directamente a través de OTLP. Se limita a la ruta directa de OTel; si usa el SDK de Agent 365 o la Distribución OpenTelemetry de Microsoft, consulte esas guías. Para conocer los límites de nivel de conexión, los códigos de error y las condiciones de eliminación silenciosa, consulte Límites y condiciones de eliminación.

Comprobación de la ingesta

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

  1. Compruebe el estado HTTP. 200 → continuar. 4xx → ver problemas comunes.
  2. Analice partialSuccess null significa que la API aceptó todo. Cualquier otro caso significa que al menos algunos segmentos se descartaron en el filtro por segmento.
  3. Espere ~5 minutos y luego ejecute la siguiente consulta de búsqueda avanzada de Defender.
  4. ¿No hay fila? Use el árbol de decisión debajo de No data in 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 obtener la lista completa de interfaces (vistas de actividad del agente en Defender, Centro de administración de Microsoft 365, Microsoft Purview) y lo que necesita cada una, consulte Dónde aparecen los datos.

No hay datos en Defender

  • partialSuccess.rejectedSpans == totalSpans → todos sus tramos tenían un gen_ai.operation.name incorrecto. Corrección: use uno de invoke_agent, execute_tool, , chatoutput_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). Corrección: confirme que al menos un usuario del tenant tiene la licencia asignada (no solo disponible en el tenant); de lo contrario, póngase en contacto con el equipo de onboarding 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

Dificultades habituales

Síntoma Causa más probable Corregir
401 Unauthorized Error en aud del token. Use 9b975845-388f-4429-889e-eab1ef63949c (o api://9b975845-...).
403 Forbidden, falta el rol o el ámbito El token no lleva Agent365.Observability.OtelWrite. Integre la aplicación de Microsoft Entra en el rol (S2S) o el ámbito delegado, según Ámbitos y consentimiento. Para S2S, el token debe adquirirse con <resource>/.default.
403 Forbidden, la identidad del agente no coincide {agentId} en URL ≠ appid / azp del token, o un tramo lleva un gen_ai.agent.id que no coincide con el agente autenticado. La ruta agentId debe ser el appId de la aplicación que llama. Para las identidades derivadas de plantillas, este es el appId de la identidad del agente, no el appId de la plantilla. Asegúrese de que cada gen_ai.agent.id span coincida.
200 OK pero partialSuccess.rejectedSpans == totalSpans Todos los tramos tenían un gen_ai.operation.name incorrecto. Use una de las propiedades invoke_agent, execute_tool, chat, output_messages. Es chat, no inference.
200 OK con partialSuccess: null pero no aparece ningún dato en Defender Ningún usuario del tenant del cliente tiene asignada ninguna licencia de Microsoft 365 E7 o Microsoft Agent 365 (Límites y condiciones de descarte). Confirme que al menos un usuario del inquilino tiene asignada una licencia Microsoft 365 E7 o Microsoft Agent 365 (la SKU que está presente no es suficiente). Comprobar con el KQL en Comprobación de la ingesta; si no llega nada tras 5 minutos, póngase en contacto con el equipo de Agent 365.
Los tramos aparecen en CloudAppEvents, pero no aparece la ejecución en las vistas de actividad del agente de Defender y en el Centro de administración de Microsoft 365 La ejecución no tiene ningún tramo invoke_agent. Ambas superficies desactivan la clave invoke_agent. Emita exactamente un tramo invoke_agent en la raíz de cada pasada; haga que chat / execute_tool / output_messages sean secundarios de este mediante parentSpanId.
El árbol de ejecución está roto o los tramos de herramientas aparecen huérfanos Faltan parentSpanId o difieren traceId en tramos secundarios. Consulte Jerarquía de intervalos y agrupación de ejecución. Cada tramo no raíz establece parentSpanId y comparte el traceId de la ejecución.
Los tramos de herramientas aparecen vacíos ChannelName / ConversationId en las consultas Canal o conversación no establecido en el tramo de herramientas y el elemento primario invoke_agent no estaba en la misma solicitud de OTLP. Establezca microsoft.channel.name y gen_ai.conversation.id en cada intervalo.
413 Payload Too Large Cuerpo de la solicitud > 1 MB. Divida los intervalos entre varias solicitudes.
429 Too Many Requests Se alcanzó el límite de velocidad. Honor Retry-After: 1 y regreso con vibración.
El agente aparece no identificado en los paneles gen_ai.agent.id está vacío o no es un GUID. Use el appId de Entra del agente. Si el agente no tiene registro de Entra, vea Selección de valores.

Pasos siguientes

  • Last updated on