Freigeben über

Verwenden der Ereignisablaufverfolgung für Windows

  • Artikel

Der Microsoft BizTalk-Adapter für PeopleSoft Enterprise 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, wird eine *.etl-Datei erstellt, um die Nachrichten zu empfangen. Die Datei ist im Binärformat und muss konvertiert werden, um gelesen zu werden. Dazu müssen Sie über eine Consumeranwendung zum Interpretieren der ETL-Datei verfügen, 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 BTAPeopleSoftTrace Aufrufe tracelog.exe im System finden können. Standardmäßig durchsucht BTAPeopleSoftTrace 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 PeopleSoft Enterprise kompatibel. Informationen zur Verwendung logman.exe finden Sie in der Logman-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. In der Regel erfolgt dies, wenn der Controller die Ablaufverfolgung deaktiviert.

    Um den Consumer 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 PeopleSoft Enterprise verfügt über fünf verschiedene Anbieter. Diese Anbieter sind in der Windows-Verwaltungsinstrumentation (WMI, Windows Management Instrumentation) registriert. Um die registrierten Anbieter im Pfad root\WMI\EventTrace zu finden, können Sie Tools wie WMI CIM Studio verwenden.

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

  • Empfängerprotokollierungsanbieter: Der Schalter des Ablaufverfolgungselements <> ist -receiver.

  • Empfänger CastDetails-Anbieter: Der <Trace-Elementschalter> ist -castDetailsReceive.

  • Senderprotokollierungsanbieter: Der <Schalter des Ablaufverfolgungselements> ist -transmitter.

  • Transmitter CastDetails-Anbieter: Der <Trace-Elementschalter> ist -castDetailsTransmit.

  • Verwaltungsprotokollierungsanbieter: Der Schalter für das Ablaufverfolgungselement <> lautet -management.

Befehl „BTAPeopleSoftTrace“

Um ETW zu verwenden, führen Sie den Adapterbefehl BTAPeopleSoftTrace.cmd aus. Verwenden Sie diesen Befehl wie folgt:

BTAPeopleSoftTrace <Trace element> -start [-cir <MB>|   
    -seq <MB>] [-rt] logfile  
BTAPeopleSoftTrace <Trace element> -stop

Hierbei gilt:

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

    Folgende Optionen stehen zur Verfügung:

    • -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 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 die Standardeinstellung).

    Beispiel:

BTAPeopleSoftTrace -transmitter -start -cir 10 -rt C:\log\mylog.etl  
BTAPeopleSoftTrace -transmitter -stop

Weitere Informationen

Problembehandlung bei PeopleSoft