Condividi tramite

Utilizzo di Event Tracing for Windows

L'adapter Microsoft BizTalk per PeopleSoft Enterprise registra messaggi di errore, avviso e informazioni nel Visualizzatore eventi di Windows. È possibile visualizzare altri messaggi di traccia usando lo strumento Event Tracing for Windows (ETW). Quando ETW è abilitato, crea un file *.etl per ricevere i messaggi. Il file è in formato binario e deve essere convertito per essere letto. A tale scopo, è necessario disporre di un'applicazione consumer disponibile per interpretare il file *.etl; ad esempio tracerpt.exe o tracedmp.exe.

Componenti ETW

Event Tracing for Windows ha tre componenti:

  • Applicazione controller: attiva e disattiva un provider (ad esempio, tracelog.exe o logman.exe).

    Impostare la variabile di ambiente PATH in modo che punti alla posizione di tracelog.exe. In questo modo, le BTAPeopleSoftTrace chiamate possono individuare tracelog.exe nel sistema. Per impostazione predefinita, BTAPeopleSoftTrace cerca il percorso corrente.

    Annotazioni

    tracelog.exe è disponibile in Microsoft SDK ed è compatibile con i comandi forniti dall'adapter BizTalk per PeopleSoft Enterprise. Per usare logman.exe, vedere la documentazione di Logman.

  • Applicazione consumer: legge gli eventi registrati.

    Affinché l'applicazione consumer sia in grado di leggere l'evento nel file con estensione etl, Event Tracing for Windows deve eseguirne il dump in tale file. In genere, questa operazione viene eseguita quando il controller disattiva il tracciamento.

    Per usare il consumer senza disattivare la traccia, il controller deve attivare la traccia con l'opzione in tempo reale Real <Time> = -rt.

  • Provider: Fornisce l'evento .

    L'adapter BizTalk per PeopleSoft Enterprise ha cinque provider diversi. Vengono registrati in Windows Management Instrumentation (WMI). Per trovare i provider registrati nel percorso root\WMI\EventTrace , è possibile usare strumenti come WMI CIM Studio.

    L'adapter BizTalk per PeopleSoft Enterprise include cinque provider, consentendo di registrare diversi tipi di messaggi:

  • Provider di registrazione ricevitore: l'opzione elemento <Trace> è -receiver.

  • Ricevitore del Provider CastDetails: l'interruttore dell'elemento Trace è -castDetailsReceive.

  • Provider di registrazione del trasmettitore: l'interruttore dell'elemento di traccia <> è -trasmettitore.

  • Trasmettitore Provider CastDetails: l'interruttore dell'elemento <Trace> è -castDetailsTransmit.

  • Provider di registrazione della gestione: l'elemento di commutazione <Trace> è -management.

Comando BTAPeopleSoftTrace

Per usare ETW, eseguire il comando adapter BTAPeopleSoftTrace.cmd. Usare questo comando come indicato di seguito:

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

Dove:

  • <Elemento traccia> (obbligatorio) è il tipo di provider.

    Le opzioni sono le seguenti:

    • -castDetailsTransmit

    • -trasmettitore

    • -castDettagliRicevere

    • -ricevitore

    • -gestione

    • -start, -stop: attivare o disattivare il provider.

  • -Cir <MB>: dimensioni e tipo di file. -cir è un file circolare. <MB>: dimensioni in megabyte.

  • -Seq <MB>: dimensioni e tipo di file. -seq è un file sequenziale. <MB>: dimensioni in megabyte.

  • -rt: impostare la modalità in tempo reale attivata.

  • Logfile: nome del file di log (C:\rtlog.etl è l'impostazione predefinita).

    Per esempio:

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

Vedere anche

Risoluzione dei problemi di PeopleSoft