Condividi tramite

Controllo della registrazione di .NET Framework

È possibile usare la traccia eventi per Windows (ETW) per registrare eventi CLR (Common Language Runtime). È possibile creare e visualizzare tracce usando gli strumenti seguenti:

Per acquisire informazioni sugli eventi CLR, è necessario installare il provider CLR nel computer. Per verificare che il provider sia installato, digitare logman query providers al prompt dei comandi. Viene visualizzato un elenco di provider. Questo elenco deve contenere una voce per il provider CLR, come indicato di seguito.

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

Se il provider CLR non è elencato, è possibile installarlo in Windows Vista e nei sistemi operativi successivi usando lo strumento da riga di comando Windows Wevtutil . Aprire la finestra del prompt dei comandi come amministratore. Modificare la directory del prompt nella cartella .NET Framework 4 (%WINDIR%\Microsoft.NET\Framework[64]\v4.<. NET version>\ ). 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

Cattura 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 elementi:

  • Il provider a cui comunicare.

  • 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 ridotto che rappresenta il livello (dettaglio) a cui loggare. Il livello 1 è il meno verboso e il livello 5 è il più verboso. Il livello 0 è un valore predefinito il cui significato è specifico del provider.

Per acquisire eventi CLR ETW tramite Logman

  1. Al prompt dei comandi digitare:

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

    dove:

    • Il -p parametro identifica il GUID del provider.

    • 0x1CCBD specifica le categorie di eventi che verranno generati.

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

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

    • Il -ct perf parametro specifica che la QueryPerformanceCounter funzione verrà usata 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 CLR ETW 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 CLR ETW e 0x1CCBD:5 rileva tutto ai livelli 5 (dettagliato) e inferiori.

  2. Per arrestare il tracciamento, digitare:

    Xperf -stop clr

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

Visualizzazione di eventi ETW CLR

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

Per visualizzare gli eventi CLR ETW tramite Tracerpt

  • Al prompt dei comandi digitare:

    tracerpt clrevents.etl

    Questo comando crea due file: dumpfile.xml e summary.txt. Il file dumpfile.xml elenca tutti gli eventi e summary.txt fornisce un riepilogo degli eventi.

Per visualizzare gli eventi CLR ETW tramite Xperf

  • Al prompt dei comandi digitare:

    xperf clrevents.etl

    Questo comando apre il visualizzatore di file Xperf ETL. In questo visualizzatore gli eventi CLR vengono visualizzati nella visualizzazione Eventi generici . Per visualizzare una griglia di dati di eventi classificati per tipo, selezionare un'area temporale in questa visualizzazione, 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 sì che XPerf esempi gli eventi come file con valori delimitati da virgole (CSV) che è possibile visualizzare. Poiché eventi diversi hanno campi diversi, questo file CSV contiene più righe di intestazione prima dei dati. Il primo campo di ogni riga è il tipo di evento, che indica quale intestazione deve essere usata per determinare il resto dei campi.

Vedere anche

  • Last updated on