Uzyskiwanie dostępu do danych śledzenia

TraceProcessing dla platformy .NET jest dostępne w NuGet pod następującym identyfikatorem pakietu:

Microsoft.Windows.EventTracing.Processing.All

Ten pakiet umożliwia dostęp do danych w pliku śledzenia. Jeśli nie masz jeszcze pliku śledzenia, możesz go utworzyć za pomocą narzędzia Windows Performance Recorder .

W poniższej przykładowej aplikacji konsolowej pokazano, jak uzyskać dostęp do wierszy poleceń wszystkich procesów zawartych w śladzie:

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);
            }
        }
    }
}

Korzystanie z narzędzia TraceProcessor

Aby przetworzyć ślad, wywołaj metodę TraceProcessor.Create. Podstawowy interfejs to ITraceProcessor, a użycie tego interfejsu obejmuje następujący wzorzec:

1. Najpierw poinformuj podmiot przetwarzający, jakich danych chcesz użyć ze śledzenia
2. Po drugie, przetwórz ślad; i
3. Na koniec uzyskaj dostęp do wyników.

Informowanie procesora o rodzajach danych, które mają być z góry, oznacza, że nie trzeba poświęcać czasu na przetwarzanie dużych ilości wszystkich możliwych rodzajów danych śledzenia. Zamiast tego funkcja TraceProcessor po prostu wykonuje pracę wymaganą do dostarczenia określonych rodzajów żądanych danych.

Zalecane ustawienia projektu

Istnieje kilka ustawień projektu, których zalecamy używać z modułem TraceProcessor:

1. Zalecamy uruchamianie plików exe jako 64-bitowych.

   Domyślnym ustawieniem w Visual Studio dla nowej aplikacji konsolowej .NET Framework w języku C# jest Any CPU z zaznaczonym Preferuj 32-bitowe. Domyślne ustawienie w .NET może już być zgodne z zaleceniami.

   Przetwarzanie śledzenia może być znacznie obciążające pamięć, szczególnie w przypadku większych śladów, i zalecamy zmianę celu platformy na x64 (lub usunięcie zaznaczenia opcji Preferuj 32-bitowe) w plikach wykonywalnych korzystających z narzędzia TraceProcessor. Aby zmienić te ustawienia, zobacz kartę Kompilacja w obszarze Właściwości projektu. Aby zmienić te ustawienia dla wszystkich konfiguracji, upewnij się, że lista rozwijana Konfiguracja jest ustawiona na Wszystkie konfiguracje, a nie na wartość domyślną tylko bieżącej konfiguracji.

2. Zalecamy użycie narzędzia NuGet z nowszym trybem PackageReference, a nie starszym trybem packages.config.

   Aby zmienić ustawienie domyślne dla nowych projektów, zobacz Narzędzia, Menedżer pakietów NuGet, Ustawienia Menedżera pakietów, Zarządzanie pakietami, Domyślny format zarządzania pakietami.

Wbudowane źródła danych

Plik .etl może przechwytywać wiele rodzajów danych w śledzeniu. Należy pamiętać, że dane w pliku .etl zależą od tego, którzy dostawcy zostali włączeni podczas rejestrowania śladu. Na poniższej liście przedstawiono rodzaje danych śledzenia dostępnych w narzędziu TraceProcessor:

Zobacz również metody rozszerzeń dla ITraceSource dla wszystkich dostępnych danych śledzenia, lub sprawdź metodę dostępną poprzez 'trace', pokazanej przez IntelliSense.

Dalsze kroki

W tym omówieniu przedstawiono sposób uzyskiwania dostępu do danych śledzenia przy użyciu narzędzia TraceProcessor i wbudowanych źródeł danych, do których może uzyskiwać dostęp.

Następnym krokiem jest dowiedzieć się, jak rozszerzyć TraceProcessor w celu uzyskania dostępu do niestandardowych danych śledzenia.