Aceder a dados de rastreio

O .NET TraceProcessing está disponível NuGet com a seguinte ID de pacote:

Microsoft.Windows.EventTracing.Processing.All

Este pacote permite que você acesse dados em um arquivo de rastreamento. Se ainda não tiveres um ficheiro de rastreamento, podes usar o Gravador de Desempenho do Windows para criar um.

O aplicativo de console de exemplo a seguir mostra como acessar as linhas de comando de todos os processos contidos no rastreamento:

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

Usando o TraceProcessor

Para processar um traço, chame TraceProcessor.Create. A interface principal é ITraceProcessor, e usar essa interface envolve o seguinte padrão:

1. Primeiro, indique ao processador quais dados deseja utilizar a partir de um traço
2. Em segundo lugar, processe o rastreio; e
3. Por fim, acesse os resultados.

Informar ao processador que tipos de dados você deseja antecipadamente significa que você não precisa gastar tempo processando grandes volumes de todos os tipos possíveis de dados de rastreamento. Em vez disso, o TraceProcessor apenas faz o trabalho necessário para fornecer os tipos específicos de dados solicitados.

Configurações recomendadas do projeto

Há algumas configurações de projeto que recomendamos usar com o TraceProcessor:

1. Recomendamos executar exes como 64 bits.

   O padrão do Visual Studio para um novo aplicativo de console do C# .NET Framework é Qualquer CPU com opção Preferir 32 bits marcada. O padrão para .NET já pode ter a configuração recomendada.

   O processamento de rastreamentos pode exigir muita memória, especialmente com rastreamentos maiores, e recomendamos alterar a configuração da plataforma para x64 (ou desmarcar "Preferir 32 bits") em executáveis que utilizam o TraceProcessor. Para alterar essas configurações, consulte a guia Construir em Propriedades do projeto. Para alterar essas definições para todas as configurações, certifique-se de que a lista suspensa de Configuração esteja definida como Todas as Configurações, em vez de apenas a configuração atual por padrão.

2. Sugerimos usar o NuGet com o modo PackageReference de estilo mais recente em vez do modo packages.config mais antigo.

   Para alterar o padrão para novos projetos, consulte Ferramentas, Gerenciador de Pacotes NuGet, Configurações do Gerenciador de Pacotes, Gerenciamento de Pacotes, Formato de gerenciamento de pacotes padrão.

Fontes de dados incorporadas

Um arquivo .etl pode capturar muitos tipos de dados em um rastreamento. Observe que quais dados estão em um arquivo .etl dependem de quais provedores foram habilitados quando o rastreamento foi capturado. A lista a seguir mostra os tipos de dados de rastreamento disponíveis no TraceProcessor:

Consulte igualmente os métodos de extensão de ITraceSource para todos os dados de rastreamento disponíveis, ou examine o método disponível no "trace" conforme mostrado pelo IntelliSense.

Próximas Etapas

Nesta visão geral, você aprendeu como acessar dados de rastreamento usando o TraceProcessor e as fontes de dados internas que ele pode acessar.

A próxima etapa é aprender como estender TraceProcessor para acessar dados de rastreamento personalizados.