Comment utiliser le suivi d’événements pour Windows
L'adaptateur Microsoft BizTalk pour TIBCO Enterprise Message Service consigne des messages d'erreur, d'avertissement et d'informations 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. Par exemple, l’application tracerpt.exe convertit le fichier *.etl en deux fichiers texte : summary.txt et dumpfile.csv.
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 les appels BTATIBCO EMSTrace peuvent localiser tracelog.exe dans le système. Par défaut, BTATIBCO EMSTrace recherche le chemin d'accès actuel.
Notes
tracelog.exe est disponible dans le Kit de développement logiciel Microsoft (SDK) et est compatible avec les commandes fournies par l'adaptateur Microsoft BizTalk pour TIBCO Enterprise Message Service. 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 dans le fichier .etl, l'outil 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 l’application 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 TIBCO Enterprise Message Service inclut trois fournisseurs distincts, 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 TIBCO Enterprise Message Service inclut des fournisseurs qui permettent de consigner plusieurs types de messages :
Fournisseur de journalisation du récepteur : le <commutateur d’élément> trace est -receiver.
Utilisez -receiver pour obtenir tous les messages du journal qui ont été reçus par l’adaptateur au moment de l’exécution.
Fournisseur de journalisation de l’émetteur : le <commutateur d’élément> trace est -transmitter.
Utilisez -transmetteurpour obtenir tous les messages du journal qui ont été transmis par l’adaptateur au moment de l’exécution.
Commande BTATIBCOEMSTrace
Pour utiliser ETW, exécutez la commande BizTalk Adapter for TIBCO Enterprise Message Service, BTATIBCOEMSTrace.cmd. Utilisez-la comme suit :
BTATIBCOEMSTrace <Trace element> -start [-cir <MB>|
-seq <MB>] [-rt] logfile
BTA TIBCOEMSTrace <Trace element> -stop
Où :
<L’élément> trace (obligatoire) est le type de fournisseur.
Les options associées sont les suivantes :
-Émetteur
-Récepteur
-start, -stop : activez ou désactivez le fournisseur.
-Cir <Mo> : taille et type de fichier. -cir est un fichier circulaire. <Mo> : taille en mégaoctets.
-Suiv <Mo> : taille et type de fichier. -seq est 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 :
BTATIBCOEMSTrace -transmitter -start -cir 10 -rt c:\log\mylog.etl
BTATIBCOEMSTrace -transmitter -stop