Controllo della registrazione di .NET FrameworkControlling .NET Framework Logging

È possibile utilizzare Traccia eventi per Windows (ETW) per registrare eventi CLR (Common Language Runtime).You can use event tracing for Windows (ETW) to record common language runtime (CLR) events. Tramite i seguenti strumenti si possono creare e visualizzare tracce:You can create and view traces by using the following tools:

Per acquisire informazioni sugli eventi CLR, è necessario installare il provider CLR nel computer in uso.To capture CLR event information, the CLR provider must be installed on your computer. Per confermare la corretta installazione del provider, digitare logman query providers al prompt dei comandi.To confirm that the provider is installed, type logman query providers at the command prompt. Verrà visualizzato un elenco di provider.A list of providers is displayed. L'elenco deve contenere una voce relativa al provider CLR, come riportato di seguito.This list should contain an entry for the CLR provider, as follows.

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.If the CLR provider is not listed, you can install it on Windows Vista and later operating systems by using the Windows Wevtutil command-line tool. Aprire la finestra del prompt dei comandi come amministratore.Open the Command Prompt window as an administrator. Impostare la directory del prompt sulla cartella di .NET Framework 4.NET Framework 4 (%WINDIR%\Microsoft.NET\Framework[64]\v4.<versione .NET>\ ).Change the prompt directory to the .NET Framework 4.NET Framework 4 folder (%WINDIR%\Microsoft.NET\Framework[64]\v4.<.NET version>\ ). Questa cartella contiene il file CLR-ETW.man.This folder contains the CLR-ETW.man file. Al prompt dei comandi digitare il comando seguente per installare il provider CLR:At the command prompt, type the following command to install the CLR provider:

wevtutil im CLR-ETW.man

Acquisizione di eventi ETW CLRCapturing CLR ETW Events

È 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.You can use the Logman and Xperf command-line tools to capture ETW events, and the Tracerpt and Xperf tools to decode the trace events.

Per attivare la registrazione, un utente deve specificare tre impostazioni:To turn on logging, a user must specify three things:

  • Il provider a cui comunicare.The provider to communicate to.

  • Un numero a 64 bit che rappresenta un set di parole chiave.A 64-bit number that represents a set of keywords. Ogni parola chiave rappresenta un set di eventi che il provider può attivare.Each keyword represents a set of events that the provider can turn on. Il numero rappresenta un set combinato di parole chiave da attivare.The number represents a combined set of keywords to turn on.

  • Un numero piccolo che rappresenta il livello (livello di dettaglio) a cui registrare.A small number representing the level (verbosity) to log at. Il livello 1 è il livello di dettaglio minore e il livello 5 è il livello dettaglio maggiore.Level 1 is the least verbose, and level 5 is the most verbose. Il livello 0 è un'impostazione predefinita il cui significato è specifico del provider.Level 0 is a default whose meaning is provider-specific.

Per acquisire eventi ETW CLR tramite LogmanTo capture CLR ETW events using Logman

  1. Al prompt dei comandi, digitare:At the command prompt, type:

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

    dove:where:

    • Il parametro -p identifica il GUID del provider.The -p parameter identifies the provider GUID.

    • 0x1CCBD specifica le categorie degli eventi che saranno generati.0x1CCBD specifies the categories of events that will be raised.

    • 0x5 imposta il livello di registrazione, in questo caso Verbose (5).0x5 sets the level of logging (in this case, verbose (5)).

    • Il parametro -ets indica a Logman di inviare comandi alle sessioni di traccia degli eventi.The -ets parameter instructs Logman to send commands to event tracing sessions.

    • Il parametro -ct perf specifica che la funzione QueryPerformanceCounter verrà utilizzata per registrare il timestamp per ogni evento.The -ct perf parameter specifies that the QueryPerformanceCounter function will be used to log the time stamp for each event.

  2. Per interrompere la registrazione degli eventi, digitare:To stop logging the events, type:

    logman stop clrevents -ets

    Questo comando crea un file di traccia binario denominato clrevents.etl.This command creates a binary trace file named clrevents.etl.

Per acquisire eventi ETW CLR tramite XperfTo capture CLR ETW events using Xperf

  1. Al prompt dei comandi, digitare:At the command prompt, type:

    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.where the GUID is the CLR ETW provider GUID, and 0x1CCBD:5 traces everything at and below level 5 (verbose).

  2. Per interrompere la traccia, digitare:To stop tracing, type:

    Xperf -stop clr

    Questo comando crea un file di traccia denominato clrevents.etl.This command creates a trace file named clrevents.etl.

Visualizzazione di eventi ETW CLRViewing CLR ETW Events

Utilizzare i comandi elencati di seguito per visualizzare gli eventi ETW CLR.Use the commands listed below to view the CLR ETW events. Per una descrizione degli eventi, vedere Eventi ETW di CLR.For a description of the events, see CLR ETW Events.

Per visualizzare gli eventi ETW CLR tramite TracerptTo view CLR ETW events using Tracerpt

  • Al prompt dei comandi, digitare:At the command prompt, type:

    tracerpt clrevents.etl

    Questo comando crea due file: dumpfile.xml e summary.txt.This command creates two files: dumpfile.xml and summary.txt. Nel file dumpfile.xml sono elencati tutti gli eventi, mentre summary.txt fornisce un riepilogo degli eventi.The dumpfile.xml file lists all the events, and summary.txt provides a summary of the events.

Per visualizzare gli eventi ETW CLR tramite XperfTo view CLR ETW events using Xperf

  • Al prompt dei comandi, digitare:At the command prompt, type:

    xperf clrevents.etl

    Questo comando apre il visualizzatore di file ETL Xperf.This command opens the Xperf ETL file viewer. In questo visualizzatore, gli eventi CLR compaiono nella vista Eventi generici.In this viewer, the CLR events show up in the Generic Events view. 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.To display a data grid of events categorized by type, select a region of time in this view, and then right-click and select Summary.

Per convertire il file con estensione etl in un file con valori delimitati da virgoleTo convert the .etl file to a comma-separated value file

  • Al prompt dei comandi, digitare:At the command prompt, type:

    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.This command causes XPerf to dump the events as a comma separated value (CSV) file that you can view. Poiché eventi diversi dispongono di campi diversi, questo file con estensione CSV contiene più di una riga di intestazione prima dei dati.Because different events have different fields, this CSV file is contains more than one header line before the data. Il primo campo di ogni riga è il tipo di evento che indica quale intestazione deve essere utilizzata per determinare gli altri campi.The first field of every line is the event type, which indicates which header should be used to determine the rest of the fields.

Vedere ancheSee Also

Windows Performance ToolkitWindows Performance Toolkit
Eventi ETW in Common Language RuntimeETW Events in the Common Language Runtime