Condividi tramite

Uso di Event Tracing for Windows

  • Articolo

L'adapter Microsoft BizTalk per PeopleSoft Enterprise registra i messaggi di errore, avviso e informazione nel Visualizzatore eventi di Windows. È possibile visualizzare ulteriori messaggi di traccia utilizzando lo strumento Event Tracing for Windows (ETW). Quando si abilita ETW, viene creato un file con estensione etl per la ricezione dei messaggi. Il file è in formato binario e, per poter essere letto, deve essere convertito. A tale scopo, è necessario disporre di un'applicazione consumer per interpretare il file ETL, ad esempio tracerpt.exe o tracedmp.exe.

Componenti ETW

Event Tracing for Windows include tre componenti:

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

    Configurare la variabile di ambiente PATH in modo che faccia riferimento al percorso di tracelog.exe. In questo modo, le BTAPeopleSoftTrace chiamate possono individuare tracelog.exe nel sistema. Per impostazione predefinita, BTAPeopleSoftTrace cerca il file nel percorso corrente.

    Nota

    tracelog.exe è incluso nell'SDK Microsoft ed è compatibile con i comandi forniti dall'adapter Microsoft BizTalk per PeopleSoft Enterprise. Per utilizzare logman.exe, vedere la documentazione relativa.

  • Applicazione consumer: legge gli eventi registrati.

    Per consentire all'applicazione consumer di leggere l'evento nel file con estensione etl, Event Tracing for Windows deve eseguirne il dump in tale file. Questa operazione viene in genere eseguita quando il controller disattiva la traccia.

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

  • Provider: Fornisce l'evento .

    L'adapter BizTalk per PeopleSoft Enterprise include cinque provider diversi, che vengono registrati in Strumentazione gestione Windows (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, che consentono di registrare tipi di messaggi diversi:

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

  • Ricevitore CastDetails Provider: l'opzione elemento <Trace> è -castDetailsReceive.

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

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

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

Comando BTAPeopleSoftTrace

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

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

Dove:

  • <L'elemento> Trace (obbligatorio) è il tipo di provider.

    Le opzioni sono le seguenti:

    • -castDetailsTransmit

    • -Trasmettitore

    • -castDetailsReceive

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

    Ad esempio:

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

Vedere anche

Risoluzione dei problemi relativi a PeopleSoft