ETW Tracing

Article
09/12/2008

Cet exemple illustre comment implémenter le suivi de bout en bout (E2E) à l'aide du suivi d'événement pour Windows (Event Tracing for Windows, ETW) et du ETWTraceListener fourni dans cet exemple. L'exemple est basé sur Getting Started, exemple et intègre le suivi ETW.

Remarque :
La procédure d'installation ainsi que les instructions de génération relatives à cet exemple figurent en fin de rubrique.

Cet exemple part du principe que vous êtes familiarisé avec Tracing and Message Logging et que vous avez lu la documentation relative à Tracing and Message Logging.

Chaque source de suivi du modèle de suivi System.Diagnostics peut disposer de plusieurs écouteurs de suivis 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.

Remarque :
La procédure d'installation ainsi que les instructions de génération relatives à cet exemple figurent en fin de rubrique. Pour plus d'informations sur ces outils, consultez https://go.microsoft.com/fwlink/?LinkId=56580 (page pouvant être en anglais)

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 pour consulter 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 fonction, 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.

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 ou Tracerpt.

Vous pouvez également consulter l'exemple Circular Tracing 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 figurant à la section Procédure d'installation unique pour les exemples Windows Communication Foundation.
Pour générer la solution, conformez-vous instructions figurant dans la rubrique Génération des exemples Windows Communication Foundation.
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, conformez-vous aux instructions figurant dans la rubrique 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.

Partager via

ETW Tracing

Pour configurer, générer et exécuter l'exemple

Ressources supplémentaires