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 las primeras ejecuciones:

  1. Compruebe el estado HTTP. 200 → continuar. 4xx → ver problemas comunes.
  2. partialSuccessAnalizar . 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

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 → todas tus trazas 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 tenant del cliente tiene una licencia de Microsoft 365 E7 o de Microsoft Agent 365 asignada (Límites y condiciones de descarte, condición de descarte 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 spans aparecen, pero el árbol de ejecución está roto o algunos hijos están huérfanos → falta parentSpanId, traceId es diferente o gen_ai.conversation.id no está establecido en cada span. Corrección: revise la jerarquía de intervalos y ejecute la agrupació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 scope 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 span 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. En el caso de las identidades derivadas del plano técnico, es el appId de identidad del agente, no el appId del plano técnico. Asegúrese de que cada gen_ai.agent.id span coincida.
200 OK pero partialSuccess.rejectedSpans == totalSpans Todos los segmentos estaban mal en gen_ai.operation.name. 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 nada llega después de 5 minutos, póngase en contacto con el equipo del Agente 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 secuencia no tiene ningún invoke_agent tramo. Ambas superficies desactivan invoke_agentla tecla . Emita exactamente un span invoke_agent en la raíz de cada pasada; haga que chat / execute_tool / output_messages sean hijos de este mediante parentSpanId.
El árbol de ejecución está roto o los intervalos de herramientas aparecen huérfanos Faltan parentSpanId o difieren traceId en intervalos secundarios. Consulte Jerarquía de intervalos y agrupación de ejecución. Cada span no raíz establece parentSpanId y comparte el traceId de la ejecución.
Los spans de herramientas aparecen vacíos ChannelName / ConversationId en las consultas Canal o conversación no establecido en el intervalo 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 > de 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