Fehlerbehebung für direkte OTel-Observability

Verwenden Sie dieses Handbuch, um die Telemetrieaufnahme zu überprüfen und Probleme mit Agent-Telemetrie zu diagnostizieren, die direkt über OTLP an Agent 365 gesendet werden. Sie bezieht sich auf den direkten OTel-Pfad – wenn Sie das Agent 365 SDK oder die Microsoft OpenTelemetry Distro verwenden, lesen Sie stattdessen die entsprechenden Anleitungen. Informationen zu Grenzwerten auf Übertragungsebene, Fehlercodes und Bedingungen für stillschweigendes Verwerfen finden Sie unter Grenzwerte und Bedingungen für das Verwerfen.

Überprüfen der Aufnahme

Ein 200 OK ist kein Beweis für die Aufnahme. Einige Bedingungen zum Verwerfen geben 200 mit partialSuccess: null zurück, und Ihre Daten erscheinen einfach nicht (siehe Grenzwerte und Bedingungen zum Verwerfen). Überprüfen Sie immer ihre ersten Ausführungen:

  1. Http-Status überprüfen. 200 → fortfahren. 4xx → siehe häufige Fallstricke.
  2. partialSuccessAnalysieren . null bedeutet, dass die API alles akzeptiert hat. Alles andere bedeutet, dass mindestens einige Spannweiten beim Filter pro Spanne verworfen wurden.
  3. Warten Sie etwa 5 Minuten und führen Sie dann die unten stehende Defender-Abfrage für die erweiterte Suche aus.
  4. Keine Zeile vorhanden? Verwenden Sie den Entscheidungsbaum unter Keine Daten in Defender.

Defender Erweiterte Suchabfrage

Die kanonische Suche (Verknüpfung über die von Ihnen gesendete Agentenidentität):

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

Eine vollständige Liste der Oberflächen (Defender Agentaktivitätsansichten, Microsoft 365 Admin Center, Microsoft Purview) und die anforderungen der einzelnen Oberflächen finden Sie unter Wo ihre Daten angezeigt werden.

Keine Daten in Defender

  • partialSuccess.rejectedSpans == totalSpans → alle deine Spans wiesen ein fehlerhaftes gen_ai.operation.name auf. Fix: Verwenden Sie eines von invoke_agent, execute_tool, , chatoutput_messages (es ist chat, nicht inference).
  • 200 mit partialSuccess: null, aber keine Defender-Zeile nach 5 Min. → Kein Benutzer im Kundenmandanten verfügt über eine Microsoft 365 E7- oder Microsoft Agent 365-Lizenz zugewiesen (Grenzwerte und Abbruchbedingungen, Abbruchbedingung 2). Lösung: Stellen Sie sicher, dass mindestens einem Benutzer im Mandanten die Lizenz zugewiesen ist (nicht nur im Mandanten verfügbar); andernfalls wenden Sie sich an das Agent 365-Onboarding-Team.
  • Spans erscheinen, aber der Run-Tree ist beschädigt / einige untergeordnete Elemente sind verwaist → parentSpanId fehlt, traceId ist unterschiedlich oder gen_ai.conversation.id ist nicht für jeden Span gesetzt. Fix: Überprüfen Sie die Span-Hierarchie, und führen Sie die Gruppierung aus.

Häufige Fallstricke

Symptom Wahrscheinlichste Ursache Beheben
401 Unauthorized Ungültig aud beim Token. Verwenden 9b975845-388f-4429-889e-eab1ef63949c (oder api://9b975845-...).
403 Forbidden, fehlende Rolle/Bereich Das Token enthält Agent365.Observability.OtelWrite nicht. Registrieren Sie Ihre Microsoft Entra-App gemäß Scopes and consent für die Rolle (S2S) bzw. den Bereich (delegiert). Für S2S muss das Token mit <resource>/.default abgerufen werden.
403 Forbidden, Nichtübereinstimmung der Agent-Identität {agentId} in der URL ≠ appid / azp des Tokens, oder ein Span trägt eine gen_ai.agent.id, die nicht mit dem authentifizierten Agenten übereinstimmt. Die Route agentId muss die App-ID der aufrufenden App sein. Bei vom Blueprint abgeleiteten Identitäten ist dies die Agent-Identitäts-AppId, nicht die Blueprint-AppId. Stellen Sie sicher, dass das gen_ai.agent.id jedes span übereinstimmt.
200 OK Aber partialSuccess.rejectedSpans == totalSpans Alle Spans hatten ein fehlerhaftes gen_ai.operation.name. Verwenden Sie eines von invoke_agent, execute_tool, chat, output_messages. Es ist chat, nicht inference.
200 OK mit partialSuccess: null, aber in Defender werden keine Daten angezeigt Keinem Benutzer im Kundenmandanten ist eine Microsoft 365 E7- oder Microsoft Agent 365-Lizenz zugewiesen (Grenzwerte und Abbruchbedingungen). Vergewissern Sie sich, dass mindestens ein Benutzer im Mandanten über eine Microsoft 365 E7- oder Microsoft Agent 365-Lizenz verfügt (die derzeit vorhandene SKU ist nicht ausreichend). Überprüfen Sie dies mit der KQL-Abfrage unter Überprüfen der Datenerfassung; wenn nach 5 Minuten keine Daten eingehen, wenden Sie sich an das Agent-365-Team.
Spans werden in CloudAppEvents angezeigt, aber der Lauf fehlt in den Agent-Aktivitätsansichten in Defender und im Microsoft 365 Admin Center Die Ausführung hat keine invoke_agent Spanne. Beide Oberflächen sind ausgeschaltet invoke_agent. Geben Sie bei jedem Durchlauf genau ein invoke_agent-Span an der Wurzel aus; machen Sie chat / execute_tool / output_messages über parentSpanId zu dessen untergeordneten Elementen.
Ausführungsbaum ist fehlerhaft / Tool-Spans erscheinen verwaist Fehlt parentSpanId oder anders traceId auf untergeordneten Klammern. Siehe Span-Hierarchie und Run-Gruppierung. Jeder Nicht-Root-Span setzt parentSpanId und teilt sich das traceId des Laufs.
Tool-Spannen zeigen leere ChannelName / ConversationId in Abfragen an Kanal/Konversation war auf dem Tool-Span nicht festgelegt, und das übergeordnete Element invoke_agent befand sich nicht in derselben OTLP-Anfrage. Legen Sie microsoft.channel.name und gen_ai.conversation.id für jede Spanne fest.
413 Payload Too Large Anfragetextkörper > 1 MB. Teilen Sie die Spannweiten über mehrere Anforderungen hinweg.
429 Too Many Requests Ratenlimit erreicht. Beachten Sie Retry-After: 1, und führen Sie einen Backoff mit Jitter durch.
Agent wird in Dashboards nicht identifiziert gen_ai.agent.id ist leer oder ist keine GUID. Verwenden Sie die Entra-AppId des Agents. Wenn der Agent keine Entra-Registrierung hat, siehe Werte auswählen.

Nächste Schritte

  • Last updated on