Accéder aux données de trace

.NET TraceProcessing est disponible auprès de NuGet avec l’ID de package suivant :

Microsoft.Windows.EventTracing.Processing.All

Ce package vous permet d’accéder aux données d’un fichier de trace. Si vous n’avez pas encore de fichier de trace, vous pouvez utiliser l’Enregistreur de performances Windows pour en créer un.

L’exemple d’application console suivant montre comment accéder aux lignes de commande de tous les processus contenus dans la trace :

using Microsoft.Windows.EventTracing;
using Microsoft.Windows.EventTracing.Processes;
using System;

class Program
{
    static void Main(string[] args)
    {
        if (args.Length != 1)
        {
            Console.Error.WriteLine("Usage: <trace.etl>");
            return;
        }

        using (ITraceProcessor trace = TraceProcessor.Create(args[0]))
        {
            IPendingResult<IProcessDataSource> pendingProcessData = trace.UseProcesses();

            trace.Process();

            IProcessDataSource processData = pendingProcessData.Result;

            foreach (IProcess process in processData.Processes)
            {
                Console.WriteLine(process.CommandLine);
            }
        }
    }
}

Utilisation de TraceProcessor

Pour traiter une trace, appelez TraceProcessor.Create. L’interface principale est ITraceProcessor et l’utilisation de cette interface implique le modèle suivant :

1. Tout d’abord, indiquez au processeur les données que vous voulez utiliser dans une trace.
2. Ensuite, traitez la trace.
3. Enfin, accédez aux résultats.

En indiquant préalablement au processeur les types de données que vous voulez, vous n’avez pas besoin de passer du temps à traiter de gros volumes de tous les types de données de trace possibles. Au lieu de cela, TraceProcessor fait seulement le travail nécessaire pour fournir les types de données spécifiques que vous demandez.

Paramètres de projet recommandés

Il existe deux paramètres de projet que nous recommandons d’utiliser avec TraceProcessor :

1. Nous recommandons d’exécuter les fichiers .exe en 64 bits.

   L’option par défaut de Visual Studio pour une nouvelle application console C# .NET Framework est N’importe quelle UC avec « Préférer 32 bits » coché. La valeur par défaut pour .NET peut déjà avoir le paramètre recommandé.

   Le traitement des traces peut nécessiter beaucoup de mémoire, surtout avec des traces plus volumineuses : nous recommandons de changer la plateforme cible en x64 (ou de décocher « Préférer 32 bits ») dans les fichiers .exe qui utilisent TraceProcessor. Pour modifier ces paramètres, reportez-vous à l’onglet Créer sous Propriétés pour le projet. Pour changer ces paramètres pour toutes les configurations, vérifiez que la liste déroulante Configuration est définie sur Toutes les configurations, et non pas seulement sur la configuration par défaut.

2. Nous suggérons d’utiliser NuGet avec le mode PackageReference le plus récent au lieu de l’ancien mode packages.config.

   Pour changer la valeur par défaut pour les nouveaux projets, accédez à Outils, Gestionnaire de package NuGet, Paramètres du Gestionnaire de package, Gestion des packages, Format de gestion des packages par défaut.

Sources de données intégrées

Un fichier .etl peut capturer de nombreux types de données dans une trace. Notez que les données qui se trouvent dans un fichier .etl dépendent des fournisseurs qui ont été activés lors de la capture de la trace. La liste suivante montre les types de données de trace disponibles auprès de TraceProcessor :

Consultez également les méthodes d’extension sur ITraceSource pour toutes les données de trace disponibles, ou examinez la méthode disponible à partir de « trace ».

Étapes suivantes

Dans cette vue d’ensemble, vous avez découvert comment accéder aux données de trace en utilisant TraceProcessor et les sources de données intégrées auxquelles il peut accéder.

L’étape suivante est de découvrir comment étendre TraceProcessor pour accéder à des données de trace personnalisées.