Verwenden der Ereignisablaufverfolgung für Windows

Der Microsoft BizTalk-Adapter für TIBCO Enterprise Message Service protokolliert Fehler-, Warn- und Informationsmeldungen in der Windows-Ereignisanzeige. Weitere Ablaufverfolgungsmeldungen lassen sich mithilfe des Tools Ereignisablaufverfolgung für Windows (Event Tracing for Windows, ETW) anzeigen. Wenn ETW aktiviert ist, erstellt das Tool eine ETL-Datei für den Empfang der Nachrichten. Diese Datei liegt in Binärformat vor und muss zum Lesen konvertiert werden. Dazu muss eine Consumeranwendung verfügbar sein, um die *.etl-Datei zu interpretieren, z. B. tracerpt.exe oder tracedmp.exe. Beispielsweise konvertiert die tracerpt.exe-Anwendung die Datei *.etl in zwei Textdateien: summary.txt und dumpfile.csv.

ETW-Komponenten

Die Ereignisablaufverfolgung für Windows (ETW) hat drei Komponenten:

• Controlleranwendung: Aktiviert und deaktiviert einen Anbieter (z. B. tracelog.exe oder logman.exe).

  Sie legen die PATH-Umgebungsvariable so fest, dass sie auf den Speicherort der Datei „tracelog.exe“ verweist. Dadurch wird sichergestellt, dass BTATIBCO EMSTrace-Aufrufe tracelog.exe im System finden können. Standardmäßig durchsucht BTATIBCO EMSTrace den aktuellen Pfad.

  Hinweis

  Der Anbieter tracelog.exe steht im Microsoft SDK zur Verfügung und ist mit den Befehlen des Microsoft BizTalk-Adapters für TIBCO Enterprise Message Service kompatibel. Informationen zur Verwendung logman.exe finden Sie in der Logman-Dokumentation.

• Consumeranwendung: Liest protokollierte Ereignisse.

  Damit die Consumeranwendung das Ereignis in der etl-Datei lesen kann, muss die Ereignisablaufverfolgung für Windows sie in dieser Datei speichern. In der Regel geschieht dies, wenn der Controller die Ablaufverfolgung deaktiviert.

  Um die Consumeranwendung zu verwenden, ohne die Ablaufverfolgung zu deaktivieren, muss der Controller die Ablaufverfolgung mit der Echtzeitoption <Echtzeit> = -rt aktivieren.

• Anbieter: Stellt das Ereignis bereit.

  Der BizTalk-Adapter für TIBCO Enterprise Message Service enthält drei verschiedene Anbieter. Diese Anbieter sind in der Windows-Verwaltungsinstrumentation (WMI, Windows Management Instrumentation) registriert. Sie können mit Tools wie WMI-CIM-Studio die registrierten Anbieter im Pfad root\WMI\EventTrace suchen.

  Mit den Anbietern des BizTalk-Adapters für TIBCO Enterprise Message Service können Sie verschiedene Arten von Meldungen protokollieren:

• Empfängerprotokollierungsanbieter: Der Schalter für das <Ablaufverfolgungselement> lautet -receiver.

  Verwenden Sie -receiver , um alle Nachrichten aus dem Protokoll abzurufen, die vom Adapter zur Laufzeit empfangen wurden.

• Senderprotokollierungsanbieter: Der Schalter für das <Ablaufverfolgungselement> ist -transmitter.

  Verwenden Sie -transmitter, um alle Nachrichten aus dem Protokoll abzurufen, die vom Adapter zur Laufzeit übertragen wurden.

BTATIBCOEMSTrace-Befehl

Um ETW zu verwenden, führen Sie den BizTalk-Adapter für TIBCO Enterprise Message Service-Befehl BTATIBCOEMSTrace.cmd aus. Verwenden Sie diesen Befehl wie folgt:

BTATIBCOEMSTrace <Trace element> -start [-cir <MB>|   
    -seq <MB>] [-rt] logfile  
BTA TIBCOEMSTrace <Trace element> -stop  

Hierbei gilt:

• <Ablaufverfolgungselement> (erforderlich) ist die Art des Anbieters.

  Die Optionen sind wie folgt:

• -transmitter

• -Empfänger

• -start, -stop: Aktivieren oder deaktivieren Sie den Anbieter.

• -Cir <MB>: Größe und Art der Datei. -cir ist eine kreisförmige Datei. <MB>: Größe in Megabyte.

• -Seq <MB>: Größe und Art der Datei. -seq ist eine sequenzielle Datei. <MB>: Größe in Megabyte.

• -rt: Legen Sie den Echtzeitmodus ein.

• Logfile: Name der Protokolldatei (c:\rtlog.etl ist der Standardwert).

  Beispiel:

BTATIBCOEMSTrace -transmitter -start -cir 10 -rt c:\log\mylog.etl  
BTATIBCOEMSTrace -transmitter -stop  

Weitere Informationen

Fehlerbehebung für TIBCO Enterprise Message Service