Partilhar via

Controlando o log do .NET Framework

  • Artigo

Você pode usar o rastreamento de eventos para Windows (ETW) para gravar eventos CLR (Common Language Runtime). Você pode criar e exibir rastreamentos usando as seguintes ferramentas:

Para capturar informações de eventos CLR, o provedor CLR deve estar instalado no seu computador. Para confirmar se o provedor está instalado, digite logman query providers no prompt de comando. É apresentada uma lista de fornecedores. Essa lista deve conter uma entrada para o provedor CLR, da seguinte maneira.

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

Se o provedor CLR não estiver listado, você poderá instalá-lo no Windows Vista e em sistemas operacionais posteriores usando a ferramenta de linha de comando Wevtutil do Windows. Abra a janela da Linha de Comandos como administrador. Altere o diretório de prompt para a pasta .NET Framework 4 (%WINDIR%\Microsoft.NET\Framework[64]\v4.<. >NET\ ). Esta pasta contém o arquivo CLR-ETW.man. 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 as ferramentas de linha de comando Logman e Xperf para capturar eventos ETW e as ferramentas Tracerpt e Xperf para decodificar os eventos de rastreamento.

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

  • O provedor para se comunicar.

  • 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 fazer logon. O nível 1 é o menos detalhado e o nível 5 é o mais detalhado. O nível 0 é um padrão cujo significado é específico do provedor.

Para capturar eventos ETW CLR usando o Logman

  1. Na linha de comandos, escreva:

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

    onde:

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

    • 0x1CCBD Especifica as categorias de eventos que serão geradas.

    • 0x5 define o nível de registro em log (neste caso, detalhado (5)).

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

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

  2. Para parar de registrar os eventos, digite:

    logman stop clrevents -ets

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

Para capturar eventos ETW CLR usando Xperf

  1. Na linha de comandos, escreva:

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

    onde o GUID é o GUID do provedor ETW CLR e 0x1CCBD:5 rastreia tudo no nível 5 (detalhado) e abaixo dele.

  2. Para interromper o rastreamento, digite:

    Xperf -stop clr

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

Visualizando eventos ETW do CLR

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

Para exibir eventos ETW CLR usando Tracerpt

  • Na linha de comandos, escreva:

    tracerpt clrevents.etl

    Este comando cria dois ficheiros: dumpfile.xml e summary.txt. O arquivo dumpfile.xml lista todos os eventos e summary.txt fornece um resumo dos eventos.

Para exibir eventos ETW CLR usando Xperf

  • Na linha de comandos, escreva:

    xperf clrevents.etl

    Este comando abre o visualizador de ficheiros ETL Xperf. Neste visualizador, os eventos CLR aparecem na vista Eventos Genéricos . Para apresentar uma grelha de dados de eventos categorizados por tipo, selecione uma região de tempo nesta vista e, em seguida, clique com o botão direito do rato e selecione Resumo.

Para converter o arquivo .etl em um arquivo de valor separado por vírgulas

  • Na linha de comandos, escreva:

    xperf -i clrevents.etl -f clrevents.csv

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

Consulte também