ETW Tracing
L’exemple AnalyticTrace montre comment implémenter le suivi de bout en bout (E2E) à l’aide du suivi d’événements pour Windows (ETW, Event Tracing for Windows) et du ETWTraceListener fourni dans cet exemple. L’exemple est basé sur la Prise en main et intègre le suivi ETW.
Notes
La procédure d'installation ainsi que les instructions de génération correspondant à cet exemple figurent en fin de rubrique.
Cet exemple part du principe que vous connaissez le suivi et la journalisation des messages.
Chaque source de suivi du modèle de suivi System.Diagnostics peut disposer de plusieurs écouteurs de suivi qui déterminent où et comment les données sont suivies. Le type de ces écouteurs définit le format auquel les données de suivi sont enregistrées. L'exemple de code suivant indique comment ajouter un écouteur à la configuration.
<system.diagnostics>
<sources>
<source name="System.ServiceModel"
switchValue="Verbose,ActivityTracing"
propagateActivity="true">
<listeners>
<add type=
"System.Diagnostics.DefaultTraceListener"
name="Default">
<filter type="" />
</add>
<add name="ETW">
<filter type="" />
</add>
</listeners>
</source>
</sources>
<sharedListeners>
<add type=
"Microsoft.ServiceModel.Samples.EtwTraceListener, ETWTraceListener"
name="ETW" traceOutputOptions="Timestamp">
<filter type="" />
</add>
</sharedListeners>
</system.diagnostics>
Avant d'utiliser cet écouteur, une session de suivi ETW doit être démarrée. Pour ce faire, Logman.exe ou Tracelog.exe peut être utilisé. Cet exemple contient un fichier SetupETW.bat vous permettant de configurer une session de suivi ETW ainsi qu'un fichier CleanupETW.bat vous permettant de fermer la session et de compléter le fichier journal.
Notes
La procédure d'installation ainsi que les instructions de génération relatives à cet exemple figurent à la fin de cette rubrique. Pour plus d’informations sur ces outils, consultez https://go.microsoft.com/fwlink/?LinkId=56580.
Lorsque l'écouteur ETWTraceListener est utilisé, les suivis sont enregistrés dans des fichiers .etl binaires. Si le suivi ServiceModel est activé, tous les suivis générés apparaissent dans le même fichier. Utilisez Service Trace Viewer Tool (SvcTraceViewer.exe) pour afficher les fichiers journaux .etl et .svclog. La visionneuse affiche une vue de bout en bout du système, ce qui permet de suivre un message de sa source à ses destination et point de consommation.
L'écouteur de suivi ETW prend en charge l'enregistrement circulaire. Pour activer cette fonctionnalité, sélectionnez Démarrer, Exécuter, puis tapez cmd pour démarrer une console de commande. Dans la commande suivante, remplacez le paramètre <logfilename> par le nom de votre fichier journal.
logman create trace Wcf -o <logfilename> -p "{411a0819-c24b-428c-83e2-26b41091702e}" -f bincirc -max 1000
Les commutateurs -f et -max sont facultatifs. Ils spécifient respectivement le format circulaire binaire et la taille maximale du journal, à savoir 1 000 Mo. Le commutateur -p est utilisé pour spécifier le fournisseur du suivi. Dans notre exemple, "{411a0819-c24b-428c-83e2-26b41091702e}" correspond au GUID du fournisseur d'exemples ETW XML.
Pour démarrer la session, tapez la commande suivante.
logman start Wcf
L'enregistrement terminé, vous pouvez arrêter la session à l'aide de la commande suivante.
logman stop Wcf
Ce processus génère des journaux circulaires binaires que vous pouvez traiter à l’aide de l’outil de votre choix, notamment avec Service Trace Viewer Tool (SvcTraceViewer.exe) ou Tracerpt.
Vous pouvez également consulter l’exemple Traçage circulaire pour plus d’informations sur les autres écouteurs permettant de générer également des journaux circulaires.
Pour configurer, générer et exécuter l'exemple
Assurez-vous d’avoir effectué la Procédure d’installation unique pour les exemples Windows Communication Foundation.
Pour générer la solution, suivez les instructions indiquées dans la rubrique Génération des exemples Windows Communication Foundation.
Notes
Pour exécuter les commandes RegisterProvider.bat, SetupETW.bat et CleanupETW.bat, vous devez utiliser un compte d'administrateur local. Si vous utilisez Windows Vista ou version ultérieure, vous devez également exécuter l’invite de commandes avec des privilèges élevés. Pour ce faire, cliquez avec le bouton droit sur l’icône de l’invite de commandes, puis cliquez sur Exécuter en tant qu’administrateur.
Avant d'exécuter l'exemple, exécutez RegisterProvider.bat sur le client et le serveur. Cette opération installe le fichier ETWTracingSampleLog.etl qui permet de générer les suivis que vous pourrez ensuite afficher dans Service Trace Viewer. Ce fichier se trouve dans le dossier C:\logs. Si ce dossier n'existe pas, il doit être créé. Si vous ne respectez pas cette consigne, aucun suivi ne pourra être généré. Exécutez ensuite SetupETW.bat sur le client et le serveur pour démarrer la session de suivi ETW. Le fichier SetupETW.bat se trouve sous le dossier CS\Client.
Pour exécuter l’exemple dans une configuration à un ou plusieurs ordinateurs, suivez les instructions figurant dans Exécution des exemples Windows Communication Foundation.
L'exécution de l'exemple terminée, exécutez CleanupETW.bat pour compléter la création du fichier ETWTracingSampleLog.etl.
Ouvrez le fichier ETWTracingSampleLog.etl dans Service Trace Viewer. Vous serez alors invité à enregistrer ce fichier au format binaire comme fichier .svclog.
Ouvrez ce nouveau fichier .svclog dans Service Trace Viewer pour afficher les suivis ETW et ServiceModel.