Häufig gestellte Fragen zum REST-API-Protokoll für Office 365 Message Trace

Haben Sie eine Frage? Lesen Sie diese häufig gestellten Fragen und Antworten, um mehr über das Message Trace-Protokoll zu erfahren, mit dem Daten über die Microsoft Graph-API aus Exchange Online abgerufen werden.

Welche Berechtigungen sind erforderlich, um Protokolle aus der Office 365 Message Trace-REST-API zu erfassen?

Verwenden Sie die Anwendungsberechtigungen, die Ihrem Dienstprinzipal in Microsoft Entra ID gewährt wurden, um auf Message-Trace-Daten in Exchange Online zuzugreifen. Weitere Informationen finden Sie unter: Berechtigungen für die Message Trace API ( https://learn.microsoft.com/en-us/exchange/monitoring/trace-an-email-message/graph-api-message-trace#permissions-required ).

Welche Informationen sind in den Ereignissen enthalten, die von einem Microsoft Office 365 Message Trace REST-API-Protokoll erfasst werden?

Das Microsoft Message Trace REST-API-Protokoll gibt die Trace-Informationen für eine E-Mail-Nachricht zurück, während diese die Exchange Online-Organisation durchläuft. Mithilfe der Nachrichtenverfolgung können Mandantenadministratoren den Lebenszyklus einer E-Mail nachverfolgen, ihren Zustellstatus ermitteln – ob zugestellt, ausstehend, fehlgeschlagen oder in Quarantäne – und die darauf angewendeten Maßnahmen nachvollziehen. Für jede Nachricht gibt sie Felder wie Absender, Empfänger, Betreff, Empfangsdatum und -zeit, Status sowie zugehörige Nachrichtenverfolgungsereignisse zurück

Eine vollständige Liste der verfügbaren Felder finden Sie in der Ressource „Message Trace“ ( https://learn.microsoft.com/en-us/graph/api/resources/exchangemessagetrace?view=graph-rest-1.0 ).

Hinweis: Erweiterte oder detailliertere Berichte hängen von den Berechtigungen der Anwendung und der Zustimmung des Administrators ab.

Wofür wird die Ereignisverzögerungsoption verwendet?

Die Ereignisverzögerungsoption wird verwendet, um zu verhindern, dass Ereignisse übersehen werden. Verpasste Ereignisse treten in diesem Kontext auf, weil sie verfügbar werden, nachdem das Protokoll den Abfragebereich auf einen neueren Zeitrahmen aktualisiert hat als die Ankunftszeit des Ereignisses. Wenn ein Ereignis aufgetreten ist, aber nicht an die Microsoft Message Trace REST-API übermittelt wurde, erhält das Protokoll dieses Ereignis nicht, wenn es nach dem Erstellungszeitpunkt dieses Ereignisses fragt.

Beispiel 1: Das folgende Beispiel zeigt, wie ein Ereignis verloren gehen kann.

Das Protokoll fragt um 14:00 Uhr die Microsoft Message Trace API ab, um Ereignisse aus dem Zeitraum von 13:00 bis 13:59 Uhr zu erfassen. Die Antwort der Microsoft Message Trace API gibt die Ereignisse zurück, die zwischen 13:00 Uhr und 13:59 Uhr in der Microsoft Message Trace API verfügbar sind. Das Protokoll verhält sich so, als würden alle Ereignisse gesammelt, und sendet dann um 15:00 Uhr die nächste Abfrage an die Microsoft Message Trace API, um Ereignisse abzurufen, die zwischen 13:45 Uhr und 14:59 Uhr aufgetreten sind. Das Problem bei diesem Szenario ist, dass die Microsoft Message Trace API möglicherweise nicht alle Ereignisse enthält, die zwischen 13:00 Uhr und 13:59 Uhr aufgetreten sind. Wenn ein Ereignis um 13:58 Uhr eingetreten ist, ist dieses Ereignis möglicherweise erst ab 14:03 Uhr in der Microsoft Message Trace API verfügbar. Das Protokoll hat jedoch bereits den Zeitraum von 13:00 Uhr bis 13:59 Uhr abgefragt und kann diesen Bereich nicht erneut abfragen, ohne doppelte Ereignisse zu erhalten. Diese Verzögerung kann zwischen 1 Minute und 24 Stunden variieren.

Beispiel 2: Das folgende Beispiel zeigt Beispiel 1, außer in diesem Szenario wird eine Verzögerung von 15 Minuten hinzugefügt.

In diesem Beispiel wird eine Verzögerung von 15 Minuten verwendet, wenn das Protokoll Abfrageaufrufe ausgibt. Wenn das Protokoll um 14:00 Uhr eine Abfrage an die Microsoft Message Trace API sendet, erfasst es die Ereignisse, die zwischen 13:00 und 13:45 Uhr aufgetreten sind. Das Protokoll verhält sich so, als ob alle Ereignisse erfasst würden, sendet die nächste Abfrage um 15:00 Uhr an die Microsoft Message Trace API und erfasst alle Ereignisse, die zwischen 13:45 Uhr und 14:45 Uhr aufgetreten sind. Anstatt das Ereignis zu verpassen (wie in Beispiel 1), wird es im nächsten Abfrageaufruf zwischen 13:45 Uhr und 14:45 Uhr aufgenommen.

Beispiel 3:Das folgende Beispiel zeigt Beispiel 2. In diesem Szenario sind die Ereignisse jedoch einen Tag später verfügbar.

Wenn das Ereignis um 13:58 Uhr stattfand, aber erst am nächsten Tag um 13:57 Uhr für die Microsoft Message Trace API verfügbar wurde, wird dieses Ereignis von der in Beispiel 2 beschriebenen Ereignisverzögerung nicht mehr erfasst. Stattdessen muss die Ereignisverzögerung auf einen höheren Wert gesetzt werden, in diesem Fall 24 Stunden.

Wie funktioniert die Ereignisverzögerungsoption?

Anstatt eine Abfrage vom Zeitpunkt des letzten empfangenen Ereignisses ( last received event time ) bis zum aktuellen Zeitpunktauszuführen, werden die Protokollabfragen vom Zeitpunkt des letzten empfangenen Ereignisses ( last received event time ) bis zum aktuellen Zeitpunkt (current time) -<Ereignisverzögerung>. Die Ereignisverzögerung wird in Sekunden angegeben. Eine Verzögerung von 15 Minuten (900 Sekunden) bedeutet beispielsweise, dass Abfragen nur bis zu 15 Minuten zurückliegen. Diese Abfrage räumt der Microsoft Message Trace API 15 Minuten Zeit ein, um ein Ereignis bereitzustellen, bevor es verloren geht. Wenn die aktuelle Zeit – < Ereignisverzögerung > – kleiner ist als die Zeit des zuletzt empfangenen Ereignisses, fragt das Protokoll die Microsoft Message Trace API nicht ab; es wartet, bis diese Bedingung nicht mehr zutrifft, bevor es die Abfrage durchführt.

Welchen Wert verwende ich für die Ereignisverzögerungsoption?

Die Microsoft Message Trace API kann die Verfügbarkeit des Ereignisses um bis zu 24 Stunden verzögern. Um zu verhindern, dass Ereignisse verpasst werden, kann der Wert der Parameteroption Ereignisverzögerung auf 24 Stunden gesetzt werden. Je größer die Ereignisverzögerung ist, desto weniger Echtzeit sind die Ergebnisse. Bei einer Ereignisverzögerung von 24 Stunden werden Ereignisse nur 24 Stunden nach ihrem Auftreten angezeigt. Der Wert hängt davon ab, wie hoch Ihr Risiko ist und wie wichtig Echtzeitdaten sind. Diese Standardverzögerung von 15 Minuten stellt einen Wert bereit, der in Echtzeit festgelegt wird und verhindert, dass die meisten Ereignisse übersehen werden.

Weitere Informationen zur Nachrichtenverfolgungsfunktion, einschließlich häufig gestellter Fragen, Szenarien zur Fehlerbehebung und zum Datenverhalten, finden Sie in den Microsoft Message Trace-FAQ ( https://learn.microsoft.com/en-us/exchange/monitoring/trace-an-email-message/message-trace-FAQ ).

(Zurück nach oben)