トレース データへのアクセス

.NET TraceProcessing は、NuGet から次のパッケージ ID を使用して入手できます。

Microsoft.Windows.EventTracing.Processing.All

このパッケージを使用すると、トレース ファイル内のデータにアクセスできます。 まだトレース ファイルがない場合は、Windows パフォーマンス レコーダーを使用して作成できます。

次のコンソール アプリの例では、トレースに含まれるすべてのプロセスのコマンド ラインにアクセスする方法を示します。

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

TraceProcessor の使用

トレースを処理するには、TraceProcessor.Create を呼び出します。 コア インターフェイスは ITraceProcessor であり、このインターフェイスを使用するには次のパターンが関与します。

1. まず、トレースから使用する必要があるデータをプロセッサに伝え、
2. 次にトレースを処理し、そして
3. 最後に、結果にアクセスします。

必要なデータの種類をプロセッサに前もって伝えるということは、考えられるあらゆる種類の大量のトレース データの処理に時間を費やす必要がないことを意味します。 代わりに、TraceProcessor では要求された特定の種類のデータを提供するのに必要な作業のみを実行します。

推奨されるプロジェクト設定

TraceProcessor で使用することを推奨している、プロジェクト設定をいくつか紹介します。

1. exe を 64 ビットとして実行することをお勧めします。

   新しい C# .NET Framework コンソール アプリケーション向けの Visual Studio の既定値は、[任意の CPU] で [32 ビットを優先] がオンになっています。 .NET の既定値には、既に推奨設定が設定されている可能性があります。

   トレース処理は、特にトレースのサイズが大きいとメモリ消費が大きくなることがあるため、TraceProcessor が使用される exe の [プラットフォーム ターゲット] を [x64] (または [32 ビットを優先] をオフにする) ことをお勧めします。 これらの設定を変更するには、プロジェクトの [プロパティ] の下にある [ビルド] タブを確認してください。 すべての構成に対してこれらの設定を変更するには、[構成] ドロップダウンが既定値の現在の構成のみではなく、[すべての構成] に設定されている必要があります。

2. NuGet は、以前の packages.config モードではなく、新しいスタイルの PackageReference モードで使用することをお勧めします。

   新しいプロジェクトの既定値を変更するには、[ツール]、[NuGet パッケージ マネージャー]、[パッケージ マネージャー設定]、[パッケージ管理]、[既定のパッケージ管理形式] を確認してください。

組み込みデータ ソース

.etl ファイルでは、トレース内の多くの種類のデータをキャプチャできます。 .etl ファイル内のデータは、トレースのキャプチャ時に有効になっていたプロバイダーによって異なります。 次の一覧は、TraceProcessor から使用できるトレース データの種類を示しています。

さらに、使用可能なすべてのトレース データについて ITraceSource の拡張メソッドを参照するか、IntelliSense によって示される "trace." から使用可能なメソッドを確認してください。

次の手順

この概要では、TraceProcessor を使用してトレース データにアクセスする方法と、アクセスできる組み込みのデータ ソースについて説明しました。

次の手順では、TraceProcessor を拡張してカスタム トレース データにアクセスする方法について説明します。