Utiliser le suivi d’événements pour Windows
L'adaptateur Microsoft BizTalk pour JD Edwards OneWorld 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'il est activé, cet outil crée un fichier *.etl pour recevoir les messages. Ce fichier au format binaire doit être converti pour être lu. Pour ce faire, vous devez disposer d’une application consommateur pour interpréter le fichier *.etl : par exemple, tracerpt.exe ou tracedmp.exe.
Composants ETW
Le Suivi d'événements pour Windows comporte trois composants :
Une application de 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 les appels BTAJDEdwardsOneWorldTrace sont en mesure de localiser tracelog.exe dans le système. Par défaut, BTAJDEdwardsOneWorldTrace recherche le chemin d'accès actuel.
Notes
tracelog.exe est disponible dans le kit de développement Microsoft et il est compatible avec les commandes fournies par l'adaptateur BizTalk pour JD Edwards OneWorld. Pour utiliser logman.exe, consultez la documentation de logman.
Une application consommateur : lit les événements enregistré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. Normalement, cette opération est effectuée lorsque le contrôleur désactive le suivi.
Pour utiliser l’application consommateur sans désactiver la trace, le contrôleur doit activer la trace avec l’option en temps réel, <Temps> réel = -rt.
Fournisseur : fournit l'événement.
L'adaptateur BizTalk pour JD Edwards OneWorld inclut cinq fournisseurs différents. Ceux-ci sont enregistrés dans WMI (Windows Management Instrumentation). Pour accéder aux fournisseurs enregistrés via le chemin d'accès root\WMI\EventTrace, vous pouvez utiliser des outils tels que WMI CIM Studio.
L'adaptateur BizTalk pour JD Edwards OneWorld dispose de cinq fournisseurs, vous permettant ainsi de consigner plusieurs sortes de messages :
Fournisseur Logging pour le récepteur : Le <commutateur d’élément> Trace est -receiver.
Fournisseur CastDetails pour le récepteur : Le <commutateur d’élément> Trace est -castDetailsReceive.
Fournisseur Logging pour l'émetteur : Le <commutateur d’élément> Trace est -transmetteur.
Fournisseur CastDetails pour l'émetteur : Le <commutateur d’élément> Trace est -castDetailsTransmit.
Fournisseur Logging pour la gestion : Le <commutateur d’élément> Trace est -management.
Commande BTAJDEOneWorldTrace
Pour utiliser le Suivi d'événements pour Windows, exécutez la commande d'adaptateur BizTalk pour JD Edwards OneWorld, à savoir BTAJDEOneWorldTrace.cmd. Utilisez-la comme suit :
BTAJDEOneWorldTrace <Trace element> -start [-cir <MB>|
-seq <MB>] [-rt] logfile
BTAJDEOneWorldTrace <Trace element> -stop
Où :
<L’élément> trace (obligatoire) est le type de fournisseur.
Ses options 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 meg.
-Suiv <Mo> : taille et type de fichier. -seq signifie qu'il s'agit d'un fichier séquentiel. <Mo> : taille en meg.
-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 :
BTAJDEOneWorldTrace -transmitter -start -cir 10 -rt c:\log\mylog.etl
BTAJDEOneWorldTrace -transmitter -stop