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