Pipelineablaufverfolgung in Exchange 2013

Gilt für: Exchange Server 2013

Für die Pipelineablaufverfolgung werden Kopien von E-Mail-Nachrichten eines bestimmten Absenders erfasst, während diese den Transportdienst auf Postfachservern, den Postfachtransport-Zustellungsdienst auf Postfachservern und Edge-Transport-Server durchlaufen. Die Pipelineablaufverfolgung erfasst ausführliche Informationen zu den Änderungen, die von jedem Transport-Agent an Nachrichten in der Transportpipeline vorgenommen werden, in Nachrichten-Snapshotdateien. Durch Untersuchen des Inhalts der Nachrichten-Snapshotdateien können Sie herausfinden, ob die Transport-Agents die Änderungen an den Nachrichten in der Transportpipeline erwartungsgemäß vorgenommen haben. Bei der Behandlung eines Problems müssen Sie herausfinden, welcher Transport-Agent fehlerhaft ist. Erst dann können Sie sich auf die Behandlung der Problematik dieses Agents konzentrieren, um das Problem zu beheben. Anschließend können Sie erneut Nachrichten-Snapshotdateien anzeigen, um sicherzustellen, dass Ihre Lösung erfolgreich war.

Warnung

  • Die Pipelineablaufverfolgung kopiert den vollständigen Inhalt von E-Mail-Nachrichten, die von der E-Mail-Adresse des Absenders gesendet werden. Um die unerwünschte Preisgabe vertraulicher Informationen zu vermeiden, müssen Sie für den Ordner der Pipelineablaufverfolgung geeignete Sicherheitsberechtigungen festlegen.
  • Aktivieren Sie die Pipelineablaufverfolgung nicht für längere Zeiträume. Bei der Pipelineablaufverfolgung werden Dateien erstellt, die schnell sehr groß werden können. Überwachen Sie bei aktivierter Pipelineablaufverfolgung immer den auf dem Datenträger verfügbaren Speicherplatz.

Konfigurieren der Pipelineablaufverfolgung

Bevor Sie die Pipelineablaufverfolgung aktivieren, müssen Sie die E-Mail-Adresse des Absenders angeben, die Sie überwachen möchten. Die Pipelineablaufverfolgung dient zum Protokollieren von Nachrichten, die von einer bestimmten E-Mail-Adresse gesendet werden. Die E-Mail-Adresse des Absenders kann intern oder extern für Ihre Exchange-Organisation sein. Alternativ können Sie die Pipelineablaufverfolgung für Systemnachrichten aktivieren, die vom Transportdienst auf dem angegebenen Postfach- oder Edge-Transport-Server generiert werden, z. B. automatische Antworten, DSN-Nachrichten (Delivery Status Notification), Journalberichte und andere vom System generierte Nachrichten. Sie können auch den Speicherort des Pipelineablaufverfolgungsordners ändern.

Die Parameter, die Sie zum Konfigurieren der Pipelineablaufverfolgung verwenden, sind in der folgenden Tabelle zusammengefasst:

Cmdlet Parameter Standardwert Beschreibung
Set-TransportService

Set-MailboxTransportService

PipelineTracingSenderAddress Leer ($null) Geben Sie die E-Mail-Adresse des Absenders an, die Sie überwachen möchten.

Geben Sie den Wert "<>" an, um vom System generierte Nachrichten zu überwachen, die vom angegebenen Transportdienst auf dem Server gesendet werden.

Set-TransportService

Set-MailboxTransportService

PipelineTracingPath Transportdienst: %ExchangeInstallPath%TransportRoles\Logs\Hub\PipelineTracing

Postfachtransportdienst: %ExchangeInstallPath%TransportRoles\Logs\Mailbox\PipelineTracing

Der Pfad muss sich auf dem lokalen Server befinden. UNC-Pfade werden nicht unterstützt.

Der angegebene Pfad enthält den MessageSnapshots Ordner, in dem Pipelineablaufverfolgungsdateien gespeichert sind.

Set-TransportService

Set-MailboxTransportService

PipelineTracingEnabled $false Sie können die Pipelineablaufverfolgung nur für den angegebenen Transportdienst auf dem Server aktivieren, nachdem Sie die zu überwachende Absenderadresse konfiguriert haben.

Weitere Informationen zum Aktivieren der Pipelineablaufverfolgung sowie zum Konfigurieren der Absenderadresse für die Pipelineablaufverfolgung finden Sie unter Konfigurieren der Pipelineablaufverfolgung.

Nachrichten-Snapshotdateien

Nachrichtensnapshots sind Dateien zum Erfassen von Änderungen an einer Nachricht durch Transport-Agents im Transportdienst oder Postfachtransport-Übermittlungsdienst. Diese Dateien werden im MessageSnapshots Ordner im entsprechenden Pipelineablaufverfolgungspfad für den Transportdienst gespeichert.

MessageSnapshots Im Ordner erstellt Exchange einen Ordner für jede Nachricht, die vom überwachten Absender gesendet wird, der über den angegebenen Transportdienst fließt. Jeder Ordner wird nach einer GUID benannt, die der Nachricht zugewiesen ist. Wenn Sie die Pipelineablaufverfolgung für den Transportdienst und den Postfachtransportdienst auf demselben Postfachserver aktivieren, wird der gleichen Nachricht von jedem Transportdienst eine andere GUID zugewiesen. Der Ordnername für eine Nachricht im Ordner für den MessageSnapshots Transportdienst unterscheidet sich also vom Ordnernamen für dieselbe Nachricht im MessageSnapshots Ordner für den Postfachtransportdienst. Wenn Sie die Pipelineablaufverfolgung auf mehr als einem Exchange-Server aktivieren, wird derselben Nachricht eine andere GUID zugewiesen, die durch den angegebenen Transportdienst auf jedem Exchange-Server übertragen wird.

In jedem Nachrichtenordner erstellt Exchange mehrere Nachrichten-Snapshotdateien mit der Erweiterung "EML". Diese Nachrichten-Snapshotdateien enthalten den Inhalt der Nachricht, wenn sie mit dem jeweiligen SMTP-Ereignis und Transport-Agent in Kontakt kommt.

Wenn ein Transport-Agent für ein SMTP-Ereignis registriert ist, erstellt Exchange einen Nachrichtensnapshot der Nachricht, bevor die Nachricht mit einem Transport-Agent in Kontakt kommt. Auf diese Weise erhalten Sie eine Kopie der Nachricht, bevor diese mit Transport-Agents in Kontakt kommt, die für dieses Ereignis registriert sind. Danach wird für jeden Transport-Agent, mit dem die Nachricht in Kontakt kommt, ein neuer Nachrichtensnapshot erstellt, unabhängig davon, ob ein Transport-Agent den Inhalt der Nachricht verändert. Wenn jedoch keine Agents für ein Ereignis registriert sind, erstellt Exchange keine Nachrichtensnapshots für das Ereignis.

Wenn beispielsweise drei Agents für das Ereignis OnEndofData registriert sind, aber nur zwei der Transport-Agents eine Nachricht ändern, werden vier Nachrichtensnapshots erstellt. Der erste Nachrichtensnapshot erfasst die Nachricht, wenn sie mit dem OnEndofData -Ereignis in Kontakt kommt, bevor eine Änderung von den Transport-Agents vorgenommen wurde, die für dieses Ereignis registriert sind. Danach wird für jeden Transport-Agent ein Nachrichtensnapshot erstellt, unabhängig davon, ob ein Transport-Agent die Nachricht verändert.

Die erstellten Nachrichten-Snapshotdateien werden in der folgenden Liste beschrieben:

  • Original.eml: Diese Datei enthält den ursprünglichen unveränderten Inhalt der E-Mail-Nachricht, bevor smtp-Ereignisse oder Transport-Agents auftreten.

  • routingnnnn.eml: Diese Dateien enthalten den Inhalt der E-Mail-Nachricht, während sie auf den Transport der SMTP-Ereignisse und Transport-Agents trifft, die für diese Ereignisse im Kategorisierungsteil des Transportdiensts registriert sind. Der Platzhalter nnnn stellt einen ganzzahligen Wert dar, der mit 0001beginnt. Der Wert wird bei allen SMTP-Ereignissen und Transport-Agents, die für diese Ereignisse registriert sind, in der Reihenfolge erhöht, in der die Ereignisse und Agents auf die Nachricht einwirken. Der Postfachtransport-Zustellungsdienst generiert diese Routing -Snapshotdateien nicht.

  • SmtpReceivennnnn.eml: Diese Dateien enthalten den Inhalt der E-Mail-Nachricht, wenn sie auf die SMTP-Ereignisse OnEndofData und OnEndOfHeaders SMTP-Ereignisse und Transport-Agents trifft, die während des SMTP-Empfangsteils des Transportdiensts oder des Postfachtransportübermittlungsdiensts für diese Ereignisse registriert sind. Der Platzhalter nnnn stellt einen ganzzahligen Wert dar, der mit 0001beginnt. Der Wert wird bei allen SMTP-Ereignissen und Transport-Agents, die für diese Ereignisse registriert sind, in der Reihenfolge erhöht, in der die Ereignisse und Agents auf die Nachricht einwirken.

Die Nachrichten-Snapshotdateien können mithilfe eines Text-Editors wie Editor geöffnet werden.

Jede Nachrichten-Snapshotdatei beginnt mit Kopfzeilen, die dem Nachrichteninhalt hinzugefügt werden, und listet das SMTP-Ereignis zusammen mit dem Transport-Agent auf, auf die sich die Nachrichtensnapshotdatei bezieht. Diese Header beginnen mit X-CreatedBy: MessageSnapshot-Begin injected headers und enden mit X-EndOfInjectedXHeaders: MessageSnapshot-End injected headers. Sie werden in jeder Nachrichten-Snapshotdatei durch die des nachfolgenden Transport-Agents und SMTP-Ereignisses ersetzt. Es folgt ein Beispiel der Kopfzeilen, die einer E-Mail-Nachrichtendatei hinzugefügt werden:

X-CreatedBy: MessageSnapshot-Begin injected headers
X-MessageSnapshot-UTC-Time: 2013-01-23T23:20:18.138Z
X-MessageSnapshot-Record-Id: 21474836486
X-MessageSnapshot-Source: OnSubmittedMessageX-Sender: michelle@nwtraders.com
X-Receiver: chris@contoso.com
X-EndOfInjectedXHeaders: MessageSnapshot-End injected headers

Hinter den Nachrichtensnapshot-Kopfzeilen befindet sich der Inhalt der Nachricht, einschließlich aller ursprünglichen Nachrichtenkopfzeilen. Wenn ein Transport-Agent den Inhalt der Nachricht ändert, werden die Änderungen in die Nachricht integriert angezeigt. Während die Nachricht von jedem Transport-Agent verarbeitet wird, werden die Änderungen des jeweiligen Agents an dem Nachrichteninhalt vorgenommen. Wenn ein Transport-Agent keine Änderungen am Nachrichteninhalt vornimmt, ist der Nachrichtensnapshot, der von diesem Agent erstellt wird, mit dem Nachrichtensnapshot identisch, der von dem vorangehenden Transport-Agent erstellt wurde.