Compartilhar via


Controlando.NET Framework log

Você pode usar o rastreamento de eventos do Windows (ETW) para registrar eventos de runtime (CLR) de idioma comum. Você pode criar e exibir os rastreamentos usando as seguintes ferramentas:

Para capturar informações de evento do CLR, o provedor do CLR deve ser instalado em seu computador. Para confirmar que o provedor está instalado, digite logman query providers no prompt de comando. É exibida uma lista de provedores. Essa lista deve conter uma entrada para o provedor do CLR, da seguinte maneira.

Provider                                 GUID
-------------------------------------------------------------------------------
.NET Common Language Runtime    {E13C0D23-CCBC-4E12-931B-D9CC2EEE27E4}
…………………………………………….

Se o provedor do CLR não estiver listado, você pode instalá-lo no Windows Vista e sistemas operacionais posteriores usando o Windows Wevtutil ferramenta de linha de comando. Abra a janela de Prompt de comando como administrador. Alterar o prompt do diretório para o .NET Framework versão 4 pasta (% WINDIR%\Microsoft.NET\Framework[64]\v4. <.NET versão > \). Esta pasta contém o arquivo ETW.man do CLR. No prompt de comando, digite o seguinte comando para instalar o provedor CLR:

wevtutil im CLR-ETW.man

Capturando eventos ETW CLR

Você pode usar o Logman e Xperf ferramentas de linha de comando para capturar eventos ETW e o Tracerpt e Xperf ferramentas para decodificar os eventos de rastreamento.

Para ativar o log de um usuário deve especificar três coisas:

  • O provedor para se comunicar com.

  • Um número de 64 bits que representa um conjunto de palavras-chave. Cada palavra-chave representa um conjunto de eventos que o provedor pode ativar. O número representa um conjunto combinado de palavras-chave para ativar.

  • Um pequeno número que representa o nível (verbosidade) para efetuar. Nível 1 é o menos detalhado e nível 5 é mais detalhada. Nível 0 é um padrão cujo significado é específica ao provedor.

Para capturar eventos ETW CLR, usando Logman

  1. No prompt de comando, digite:

    logman start clrevents -p {e13c0d23-ccbc-4e12-931b-d9cc2eee27e4} 0x1CCBD 0x5 -ets -ct perf

    Onde:

    • O -p parâmetro identifica o provedor GUID.

    • 0x1CCBDEspecifica as categorias de eventos serão gerados.

    • 0x5Define o nível de log (no caso, detalhado (5)).

    • O -ets parâmetro instrui o Logman para enviar comandos para sessões de rastreamento de eventos.

    • O -ct perf parâmetro especifica que o QueryPerformanceCounter função será usada para registrar o carimbo de hora para cada evento.

  2. Para finalizar o log de eventos, digite:

    logman stop clrevents -ets

    Este comando cria um arquivo de rastreamento binário chamado clrevents.etl.

Para capturar eventos ETW CLR, usando o Xperf

  1. No prompt de comando, digite:

    xperf -start clr -on e13c0d23-ccbc-4e12-931b-d9cc2eee27e4:0x1CCBD:5 -f clrevents.etl

    onde o GUID é o provedor de ETW CLR GUID, e 0x1CCBD:5 rastreia tudo e abaixo do nível 5 (verbose).

  2. Para parar o rastreamento, digite:

    Xperf -stop clr

    Este comando cria um arquivo de rastreamento chamado clrevents.etl.

Exibindo eventos ETW CLR

Use os comandos listados abaixo para exibir os eventos ETW CLR. Para obter uma descrição dos eventos, consulte Eventos ETW CLR.

Para visualizar os eventos ETW CLR usando Tracerpt

  • No prompt de comando, digite:

    tracerpt clrevents.etl

    Este comando cria dois arquivos: dumpfile e Summary. O arquivo dumpfile lista todos os eventos e Summary fornece um resumo dos eventos.

Para visualizar os eventos ETW CLR usando o Xperf

  • No prompt de comando, digite:

    xperf clrevents.etl

    Esse comando abre o Visualizador de arquivo Xperf ETL. Este visualizador de eventos CLR aparecem no Eventos genérico modo de exibição. Para exibir uma grade de dados de eventos categorizados por tipo, selecione uma região de tempo no modo de exibição e com o botão direito e selecione Resumo.

Para converter o arquivo. ETL para um arquivo de valores separados por vírgula

  • No prompt de comando, digite:

    xperf -i clrevents.etl -f clrevents.csv

    Esse comando faz com que o XPerf despejar os eventos como um arquivo de valores separados (CSV) vírgulas que você pode exibir. Como diferentes eventos têm campos diferentes, este arquivo CSV é contém mais de uma linha de cabeçalho antes dos dados. O primeiro campo de cada linha é o tipo de evento indica que o cabeçalho deve ser usado para determinar o restante dos campos.

Consulte também

Outros recursos

Toolkit de desempenho do Windows

Eventos ETW no Common Language Runtime