Partager via

Utilisation de l’outil Suivi des événements pour Windows

  • Article

L'adaptateur BizTalk pour PeopleSoft Enterprise consigne les erreurs, avertissements et messages d'information dans l'Observateur d'événements Windows. Vous pouvez visualiser des messages de suivi supplémentaires à l'aide de l'outil Suivi d’événements pour Windows (ETW). Lorsqu'ETW est activé, l'outil crée un fichier *.etl pour recevoir les messages. Le fichier est au format binaire et doit être converti pour être lu. Pour ce faire, vous devez disposer d'une application consommateur capable d'interpréter le fichier *.etl, par exemple tracerpt.exe ou tracedmp.exe.

Composants ETW

Le Suivi d'événements pour Windows comporte trois composants :

  • Application contrôleur : active et désactive un fournisseur (par exemple, tracelog.exe ou logman.exe).

    Définissez la variable d'environnement PATH de sorte qu'elle pointe vers l'emplacement de tracelog.exe. Cela permet de s’assurer que BTAPeopleSoftTrace les appels peuvent localiser tracelog.exe dans le système. Par défaut, BTAPeopleSoftTrace recherche le chemin d'accès actuel.

    Notes

    tracelog.exe est disponible dans le Kit de développement Microsoft (SDK) et il est compatible avec les commandes fournies par l'adaptateur BizTalk pour PeopleSoft Enterprise. Pour utiliser logman.exe, consultez la documentation logman.

  • Application consommateur : lit les événements journalisés.

    Pour que l'application consommateur puisse lire les événements du fichier .etl, le Suivi d'événements pour Windows doit les vider dans ce fichier. Généralement, cette opération est effectuée lorsque le contrôleur désactive le suivi.

    Pour utiliser le consommateur sans désactiver la trace, le contrôleur doit activer la trace avec l’option temps réel, <Temps> réel = -rt.

  • Fournisseur: Fournit l’événement.

    L'adaptateur BizTalk pour PeopleSoft Enterprise dispose de cinq fournisseurs différents. Ceux-ci sont enregistrés dans WMI (Windows Management Instrumentation). Pour rechercher les fournisseurs inscrits dans le chemin root\WMI\EventTrace , vous pouvez utiliser des outils tels que WMI CIM Studio.

    L'adaptateur BizTalk pour PeopleSoft Enterprise dispose de cinq fournisseurs, vous permettant ainsi de consigner plusieurs sortes de messages :

  • Fournisseur de journalisation du récepteur : le <commutateur d’élément> trace est -receiver.

  • Récepteur CastDetails Provider : le <commutateur d’élément> Trace est -castDetailsReceive.

  • Fournisseur de journalisation de l’émetteur : le <commutateur d’élément> Trace est -transmitter.

  • Fournisseur CastDetails de l’émetteur : le <commutateur d’élément> trace est -castDetailsTransmit.

  • Fournisseur de journalisation de gestion : le <commutateur d’élément> trace est -management.

Commande BTAPeopleSoftTrace

Pour utiliser ETW, exécutez la commande d’adaptateur BTAPeopleSoftTrace.cmd. Utilisez-la comme suit :

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

Où :

  • <L’élément> trace (obligatoire) est le type de fournisseur.

    Les options disponibles sont les suivantes :

    • -castDetailsTransmit

    • -Émetteur

    • -castDetailsReceive

    • -Récepteur

    • -Managment

    • -start, -stop : activez ou désactivez le fournisseur.

  • -Cir <Mo> : taille et type de fichier. -cir signifie qu'il s'agit d'un fichier circulaire. <Mo> : taille en mégaoctets.

  • -Suiv <Mo> : taille et type de fichier. -seq signifie qu'il s'agit d'un fichier séquentiel. <Mo> : taille en mégaoctets.

  • -rt : définissez le mode temps réel sur.

  • Logfile : nom du fichier journal (C :\rtlog.etl est la valeur par défaut).

    Par exemple :

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

Voir aussi

Résolution des problèmes de PeopleSoft