Rastreamento de eventos

Finalidade

O Rastreamento de Eventos para Windows (ETW) 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 análises de capacidade e desempenho.

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

Quando aplicável

Use o ETW quando quiser instrumentar seu 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 escrevem aplicativos de 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 o de API .NET TraceProcessing do para analisar rastreamentos ETW para seus aplicativos e outros componentes de software. Essa API é usada internamente na Microsoft para analisar dados ETW produzidos no sistema de engenharia do Windows e também é usada para alimentar várias tabelas no Windows Performance Analyzer. Esta API está disponível como um pacote NuGet.

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

Nesta secção