Partilhar via

Controlando o log do .NET Framework

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. Esta lista deve incluir uma entrada para o fornecedor CLR, como segue.

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 numa sessão de administrador. Altere o diretório de prompt para a pasta do .NET Framework 4 (%WINDIR%\Microsoft.NET\Framework[64]\v4.<.NET versão>\ ). 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 CLR ETW

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 com quem 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 CLR ETW através do 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 acionadas.

    • 0x5 define o nível de registo (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 logar o timestamp 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 (verboso) e abaixo dele.

  2. Para interromper o rastreamento, digite:

    Xperf -stop clr

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

Ver 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 visualizar eventos CLR ETW com o 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.

Ver também

  • Last updated on