Partager via

Contrôle de la journalisation .NET Framework

Vous pouvez utiliser le suivi d’événements pour Windows (ETW) pour enregistrer les événements CLR (Common Language Runtime). Vous pouvez créer et afficher des traces à l’aide des outils suivants :

Pour capturer les informations d’événement CLR, le fournisseur CLR doit être installé sur votre ordinateur. Pour vérifier que le fournisseur est installé, tapez logman query providers à l’invite de commandes. Une liste de fournisseurs s’affiche. Cette liste doit contenir une entrée pour le fournisseur CLR, comme suit.

Provider                                 GUID
-------------------------------------------------------------------------------
.NET Common Language Runtime    {E13C0D23-CCBC-4E12-931B-D9CC2EEE27E4}.

Si le fournisseur CLR n’est pas répertorié, vous pouvez l’installer sur Windows Vista et les systèmes d’exploitation ultérieurs à l’aide de l’outil en ligne de commande Windows Wevtutil . Ouvrez la fenêtre d’invite de commande en tant qu’administrateur. Remplacez le répertoire d’invite par le dossier .NET Framework 4 (%WINDIR%\Microsoft.NET\Framework[64]\v4.<. NET version>\ ). Ce dossier contient le fichier CLR-ETW.man. À l’invite de commandes, tapez la commande suivante pour installer le fournisseur CLR :

wevtutil im CLR-ETW.man

Capture d’événements ETW CLR

Vous pouvez utiliser les outils en ligne de commande Logman et Xperf pour capturer les événements ETW, ainsi que les outils Tracerpt et Xperf pour décoder les événements de trace.

Pour activer la journalisation, un utilisateur doit spécifier trois éléments :

  • Fournisseur à communiquer.

  • Nombre 64 bits qui représente un ensemble de mots clés. Chaque mot clé représente un ensemble d’événements que le fournisseur peut activer. Le nombre représente un ensemble combiné de mots clés à activer.

  • Petit nombre représentant le niveau (verbosity) auquel se connecter. Le niveau 1 est le moins détaillé, et le niveau 5 est le plus détaillé. Le niveau 0 est une valeur par défaut dont la signification est spécifique au fournisseur.

Pour capturer des événements ETW CLR à l’aide de Logman

  1. À l’invite de commandes, tapez :

    logman start clrevents -p {e13c0d23-ccbc-4e12-931b-d9cc2eee27e4} 0x1CCBD 0x5 -ets -ct perf

    où:

    • Le -p paramètre identifie le GUID du fournisseur.

    • 0x1CCBD spécifie les catégories d’événements qui seront déclenchés.

    • 0x5 définit le niveau de journalisation (dans ce cas, détaillé (5)).

    • Le -ets paramètre indique à Logman d’envoyer des commandes aux sessions de suivi d’événements.

    • Le -ct perf paramètre spécifie que la QueryPerformanceCounter fonction sera utilisée pour consigner l’horodatage de chaque événement.

  2. Pour arrêter la journalisation des événements, tapez :

    logman stop clrevents -ets

    Cette commande crée un fichier de trace binaire nommé clrevents.etl.

Pour capturer des événements ETW CLR à l’aide de Xperf

  1. À l’invite de commandes, tapez :

    xperf -start clr -on e13c0d23-ccbc-4e12-931b-d9cc2eee27e4:0x1CCBD:5 -f clrevents.etl

    où le GUID est le GUID du fournisseur CLR ETW et 0x1CCBD:5 trace tout au niveau 5 (détaillé).

  2. Pour arrêter le suivi, tapez :

    Xperf -stop clr

    Cette commande crée un fichier de trace nommé clrevents.etl.

Affichage des événements ETW CLR

Utilisez les commandes répertoriées ci-dessous pour afficher les événements ETW CLR. Pour obtenir une description des événements, consultez Événements ETW CLR.

Pour afficher les événements ETW CLR à l’aide de Tracerpt

  • À l’invite de commandes, tapez :

    tracerpt clrevents.etl

    Cette commande crée deux fichiers : dumpfile.xml et summary.txt. Le fichier dumpfile.xml répertorie tous les événements et summary.txt fournit un résumé des événements.

Pour afficher les événements ETW CLR à l’aide de Xperf

  • À l’invite de commandes, tapez :

    xperf clrevents.etl

    Cette commande ouvre la visionneuse de fichiers ETL Xperf. Dans cette visionneuse, les événements CLR s’affichent dans la vue Événements génériques . Pour afficher une grille de données d’événements classés par type, sélectionnez une région de temps dans cette vue, puis cliquez avec le bouton droit et sélectionnez Résumé.

Pour convertir le fichier .etl en fichier de valeurs séparées par des virgules

  • À l’invite de commandes, tapez :

    xperf -i clrevents.etl -f clrevents.csv

    Cette commande permet à XPerf de vider les événements sous la forme d’un fichier de valeurs séparées par des virgules (CSV) que vous pouvez afficher. Étant donné que différents événements ont des champs différents, ce fichier CSV contient plusieurs lignes d’en-tête avant les données. Le premier champ de chaque ligne est le type d’événement, qui indique l’en-tête à utiliser pour déterminer le reste des champs.

Voir aussi

  • Last updated on