Rastreamento de eventos

Finalidade

O ETW (Rastreamento de Eventos para Windows) fornece aos programadores de aplicativos a capacidade de iniciar e parar sessões de rastreamento de eventos, instrumentar um aplicativo para fornecer eventos de rastreamento e consumir eventos de rastreamento. Os eventos de rastreamento contêm um cabeçalho de evento e dados definidos pelo provedor que descrevem o estado atual de um aplicativo ou operação. Você pode usar os eventos para depurar um aplicativo e executar a análise de capacidade e desempenho.

Esta documentação é para aplicativos do modo de usuário que desejam usar o ETW. Para obter informações sobre como instrumentar drivers de dispositivo executados no modo kernel, consulte Rastreamento de software WPP e Adicionar rastreamento de eventos a drivers de Kernel-Mode no WDK (Windows Driver Kit).

Quando aplicável

Use o ETW quando quiser instrumentar o aplicativo, registrar eventos de usuário ou kernel em um arquivo de log e consumir eventos de um arquivo de log ou em tempo real.

Público de desenvolvedores

O ETW foi projetado para desenvolvedores C e C++ que gravam aplicativos no modo de usuário.

Requisitos de tempo de execução

O ETW está incluído no Microsoft Windows 2000 e posterior. Para obter informações sobre quais sistemas operacionais são necessários para usar uma função específica, consulte a seção Requisitos da documentação da função.

Processar rastreamentos ETW no código .NET

Você pode usar a API de TraceProcessing do .NET para analisar rastreamentos etw para seus aplicativos e outros componentes de software. Essa API é usada internamente na Microsoft para analisar dados ETW produzidos pelo sistema de engenharia do Windows e também é usada para alimentar várias tabelas no Windows Performance Analyzer. Essa API está disponível como um pacote NuGet.

Para obter mais informações, consulte este artigo.

Nesta seção

Tópico	Descrição
Novidades no Rastreamento de Eventos	Novos recursos que foram adicionados ao Rastreamento de Eventos em cada versão.
Sobre o Rastreamento de Eventos	Informações gerais sobre o Rastreamento de Eventos.
Usando o Rastreamento de Eventos	Tópicos relacionados à tarefa que descrevem como usar a API ETW.
Referência de rastreamento de eventos	Descrições detalhadas de funções ETW e outros elementos de programação.