Verwenden der Ereignisablaufverfolgung für Windows
Der Microsoft BizTalk-Adapter für JD Edwards OneWorld protokolliert Fehler-, Warn- und Informationsmeldungen in der Windows-Ereignisanzeige. Weitere Ablaufverfolgungsmeldungen lassen sich mithilfe der 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 müssen Sie über eine Consumeranwendung verfügen, um die Etl-Datei *.etl interpretieren zu können: z. B. tracerpt.exe oder tracedmp.exe.
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 BTAJDEdwardsOneWorldTrace-Aufrufe tracelog.exe in Ihrem System finden können. Standardmäßig durchsucht BTAJDEdwardsOneWorldTrace den aktuellen Pfad.
Hinweis
Der Anbieter tracelog.exe steht im Microsoft SDK zur Verfügung und ist mit den Befehlen des BizTalk-Adapters für JD Edwards OneWorld kompatibel. Informationen zur Verwendung von logman.exe finden Sie in der zugehörigen Dokumentation.
Consumeranwendung. Liest protokollierte Ereignisse.
Damit die Consumeranwendung die Ereignisse in der ETL-Datei lesen kann, muss die Ereignisablaufverfolgung für Windows sie in dieser Datei sichern. Dies erfolgt in der Regel, 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.
BizTalk-Adapter für JD Edwards OneWorld umfasst fünf 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 fünf Anbietern des BizTalk-Adapters für JD Edwards OneWorld können Sie verschiedene Arten von Meldungen protokollieren:
Empfänger-Protokollierungsanbieter. Der <Schalter des Ablaufverfolgungselements> ist -receiver.
Empfänger-Umwandlungsdetailanbieter. Der <Schalter des Trace-Elements> ist -castDetailsReceive.
Sender-Protokollierungsanbieter. Der <Schalter des Trace-Elements> ist -transmitter.
Sender-Umwandlungsdetailanbieter. Der <Schalter des Trace-Elements> ist -castDetailsTransmit.
Verwaltungs-Protokollierungsanbieter. Der <Schalter "Trace"-Element> lautet "-management".
Befehl „BTAJDEOneWorldTrace“
Um ETW zu verwenden, führen Sie den BizTalk-Adapter für JD Edwards OneWorld-Befehl BTAJDEOneWorldTrace.cmd aus. Verwenden Sie diesen Befehl wie folgt:
BTAJDEOneWorldTrace <Trace element> -start [-cir <MB>|
-seq <MB>] [-rt] logfile
BTAJDEOneWorldTrace <Trace element> -stop
Hierbei gilt:
<Ablaufverfolgungselement> (erforderlich) ist die Art des Anbieters.
Folgende Optionen stehen zur Auswahl:
-castDetailsTransmit
-transmitter
-castDetailsReceive
-Empfänger
-Management
-start, -stop: Aktivieren oder deaktivieren Sie den Anbieter.
-Cir <MB>: Größe und Art der Datei. -cir ist eine Zirkulärdatei. <MB>: Größe in meg.
-Seq <MB>: Größe und Art der Datei. -seq ist eine sequenzielle Datei. <MB>: Größe in meg.
-rt: Legen Sie den Echtzeitmodus ein.
Logfile: Name der Protokolldatei (c:\rtlog.etl ist die Standardeinstellung).
Beispiel:
BTAJDEOneWorldTrace -transmitter -start -cir 10 -rt c:\log\mylog.etl
BTAJDEOneWorldTrace -transmitter -stop