TraceProcessor の拡張

多くの種類のトレース データには TraceProcessor の組み込みのサポートがありますが、分析を行う必要があるその他のプロバイダー (独自のカスタム プロバイダーを含む) がある場合は、そのデータを処理が発生している間にトレースからリアルタイムで使用することもできます。

注意

API のこの部分はプレビュー段階で、積極的に開発が進められています。 これは、将来のリリースで変更される可能性があります。

たとえば、トレース内のプロバイダーの ID の一覧を簡単に取得する方法がこちらです。

// Open a trace with TraceProcessor.Create() and call Run...

static void Run(ITraceProcessor trace)
{
    HashSet<Guid> providerIds = new HashSet<Guid>();
    trace.Use((e) => providerIds.Add(e.ProviderId));
    trace.Process();

    foreach (Guid providerId in providerIds)
    {
        Console.WriteLine(providerId);
    }
}

次の例は、簡略化されたカスタム データ ソースを示しています。

// Open a trace with TraceProcessor.Create() and call Run...

static void Run(ITraceProcessor trace)
{
    CustomDataSource customDataSource = new CustomDataSource();
    trace.Use(customDataSource);

    trace.Process();

    Console.WriteLine(customDataSource.Count);
}

class CustomDataSource : IFilteredEventConsumer
{
    public IReadOnlyList<Guid> ProviderIds { get; } = new Guid[] { new Guid("your provider ID") };

    public int Count { get; private set; }

    public void Process(EventContext eventContext)
    {
        ++Count;
    }
}

次のステップ

このチュートリアルでは、TraceProcessor を拡張する方法について説明しました。

次の手順では、トレースのシンボルを読み込む方法について説明します。