Controllo della registrazione di .NET Framework

  • Articolo

È possibile utilizzare Traccia eventi per Windows (ETW) per registrare eventi CLR (Common Language Runtime). Tramite i seguenti strumenti si possono creare e visualizzare tracce:

Per acquisire informazioni sugli eventi CLR, è necessario installare il provider CLR nel computer in uso. Per confermare la corretta installazione del provider, digitare logman query providers al prompt dei comandi. Verrà visualizzato un elenco di provider. L'elenco deve contenere una voce relativa al provider CLR, come riportato di seguito.

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

Se il provider CLR non compare nell'elenco, è possibile installarlo in Windows Vista e nei sistemi operativi successivi tramite lo strumento da riga di comando Wevtutil di Windows. Aprire la finestra del prompt dei comandi come amministratore. Impostare la directory del prompt sulla cartella di .NET Framework 4 (%WINDIR%\Microsoft.NET\Framework[64]\v4.<versione .NET>\ ). Questa cartella contiene il file CLR-ETW.man. Al prompt dei comandi digitare il comando seguente per installare il provider CLR:

wevtutil im CLR-ETW.man

Acquisizione di eventi ETW CLR

È possibile usare gli strumenti da riga di comando Logman e Xperf per acquisire gli eventi ETW e gli strumenti Tracerpt e Xperf per decodificare gli eventi di traccia.

Per attivare la registrazione, un utente deve specificare tre impostazioni:

  • Il provider a cui comunicare.

  • Un numero a 64 bit che rappresenta un set di parole chiave. Ogni parola chiave rappresenta un set di eventi che il provider può attivare. Il numero rappresenta un set combinato di parole chiave da attivare.

  • Un numero piccolo che rappresenta il livello (livello di dettaglio) a cui registrare. Il livello 1 è il livello di dettaglio minore e il livello 5 è il livello dettaglio maggiore. Il livello 0 è un'impostazione predefinita il cui significato è specifico del provider.

Per acquisire eventi ETW CLR tramite Logman

  1. Al prompt dei comandi digitare:

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

    dove:

    • Il parametro -p identifica il GUID del provider.

    • 0x1CCBD specifica le categorie degli eventi che saranno generati.

    • 0x5 imposta il livello di registrazione, in questo caso Verbose (5).

    • Il parametro -ets indica a Logman di inviare comandi alle sessioni di traccia degli eventi.

    • Il parametro -ct perf specifica che la funzione QueryPerformanceCounter verrà utilizzata per registrare il timestamp per ogni evento.

  2. Per interrompere la registrazione degli eventi, digitare:

    logman stop clrevents -ets

    Questo comando crea un file di traccia binario denominato clrevents.etl.

Per acquisire eventi ETW CLR tramite Xperf

  1. Al prompt dei comandi digitare:

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

    dove il GUID è il GUID del provider ETW CLR e 0x1CCBD:5 traccia qualsiasi evento appartenente al livello 5 (verbose) e ai livelli inferiori.

  2. Per interrompere la traccia, digitare:

    Xperf -stop clr

    Questo comando crea un file di traccia denominato clrevents.etl.

Visualizzazione di eventi ETW CLR

Utilizzare i comandi elencati di seguito per visualizzare gli eventi ETW CLR. Per una descrizione degli eventi, vedere Eventi ETW di CLR.

Per visualizzare gli eventi ETW CLR tramite Tracerpt

  • Al prompt dei comandi digitare:

    tracerpt clrevents.etl

    Questo comando crea due file: dumpfile.xml e summary.txt. Nel file dumpfile.xml sono elencati tutti gli eventi, mentre summary.txt fornisce un riepilogo degli eventi.

Per visualizzare gli eventi ETW CLR tramite Xperf

  • Al prompt dei comandi digitare:

    xperf clrevents.etl

    Questo comando apre il visualizzatore di file ETL Xperf. In questo visualizzatore, gli eventi CLR compaiono nella vista Eventi generici. Per visualizzare una griglia dei dati di eventi suddivisi in categorie in base al tipo, selezionare un'area temporale in questa visualizzazione e quindi fare clic con il pulsante destro del mouse e selezionare Riepilogo.

Per convertire il file con estensione etl in un file con valori delimitati da virgole

  • Al prompt dei comandi digitare:

    xperf -i clrevents.etl -f clrevents.csv

    Questo comando fa in modo che XPerf esegua il dump degli eventi come un file (CSV) con valori delimitati da virgole visualizzabile. Poiché eventi diversi dispongono di campi diversi, questo file con estensione CSV contiene più di una riga di intestazione prima dei dati. Il primo campo di ogni riga è il tipo di evento che indica quale intestazione deve essere utilizzata per determinare gli altri campi.

Vedi anche