Zugreifen auf Ablaufverfolgungsdaten

.NET TraceProcessing ist über NuGet mit der folgenden Paket-ID verfügbar:

Microsoft.Windows.EventTracing.Processing.All

Mit diesem Paket können Sie auf Daten in einer Ablaufverfolgungsdatei zugreifen. Wenn Sie noch keine Ablaufverfolgungsdatei besitzen, können Sie Windows Performance Recorder verwenden, um eine zu erstellen.

Die folgende Beispielkonsolen-App zeigt, wie Sie auf die Befehlszeilen aller Prozesse zugreifen, die in der Ablaufverfolgung enthalten sind:

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

Verwenden von TraceProcessor

Rufen Sie TraceProcessor.Create auf, um eine Ablaufverfolgung zu verarbeiten. Die Kernschnittstelle ist ITraceProcessor, und die Verwendung dieser Schnittstelle umfasst das folgende Muster:

1. Teilen Sie dem Prozessor zunächst mit, welche Daten Sie aus einer Ablaufverfolgung verwenden möchten.
2. Als zweiten Schritt verarbeiten Sie die Ablaufverfolgung.
3. Und schließlich greifen Sie auf die Ergebnisse zu.

Wenn Sie dem Prozessor im Voraus mitteilen, welche Arten von Daten Sie benötigen, müssen Sie keine Zeit damit verbringen, große Mengen aller möglichen Arten von Ablaufverfolgungsdaten zu verarbeiten. Stattdessen übernimmt TraceProcessor einfach die Arbeit, die erforderlich ist, um die spezifischen Arten von Daten, die Sie anfordern, zur Verfügung zu stellen.

Empfohlenen Projekteinstellungen

Es gibt einige Projekteinstellungen, die wir für die Verwendung von TraceProcessor empfehlen:

1. Wir empfehlen, EXE-Dateien im 64-Bit-Format auszuführen.

   Die Visual Studio-Standardeinstellung für eine neue C#-.NET Framework-Konsolenanwendung ist „Beliebige CPU“ mit aktivierter Option „32-Bit bevorzugen“. Der Standardwert für .NET verfügt möglicherweise bereits über die empfohlene Einstellung.

   Die Verarbeitung von Ablaufverfolgungen kann speicherintensiv sein, insbesondere bei größeren Ablaufverfolgungen. Es wird daher empfohlen, das Plattformziel in EXE-Dateien, die TraceProcessor verwenden, in x64 zu ändern (oder die Option „32-Bit bevorzugen“ zu deaktivieren). Informationen zum Ändern dieser Einstellungen finden Sie auf der Registerkarte „Erstellen“ unter „Eigenschaften“ für das Projekt. Um diese Einstellungen für alle Konfigurationen zu ändern, stellen Sie sicher, dass die Dropdownliste „Konfiguration“ auf „Alle Konfigurationen“ und nicht nur auf die Standardeinstellung der aktuellen Konfiguration festgelegt ist.

2. Wir empfehlen, NuGet mit dem neueren PackageReference-Modus anstelle des älteren packages.config-Modus zu verwenden.

   Informationen zum Ändern der Standardeinstellung für neue Projekte finden Sie unter Tools, NuGet-Paket-Manager, Paket-Manager-Einstellungen, Paketverwaltung, Standardformat für Paketverwaltung.

Integrierte Datenquellen

Eine ETL-Datei kann viele Arten von Daten in einer Ablaufverfolgung erfassen. Beachten Sie, dass die in einer ETL-Datei enthaltenen Daten davon abhängig sind, welche Anbieter beim Erfassen der Ablaufverfolgung aktiviert waren. In der folgenden Liste sind die Arten von Ablaufverfolgungsdaten aufgeführt, die von TraceProcessor verfügbar sind:

Siehe auch die Erweiterungsmethoden auf ITraceSource für alle verfügbaren Ablaufverfolgungsdaten, oder untersuchen Sie die von IntelliSense verfügbare Methode.

Nächste Schritte

In dieser Übersicht haben Sie erfahren, wie Sie mit TraceProcessor und den integrierten Datenquellen, auf die er zugreifen kann, auf Ablaufverfolgungsdaten zugreifen.

Im nächsten Schritt erfahren Sie, wie Sie TraceProcessor für den Zugriff auf benutzerdefinierte Ablaufverfolgungsdaten erweitern.