Controlar el registro de .NET Framework
Se puede utilizar el seguimiento de eventos para Windows (ETW) para registrar los eventos de Common Language Runtime (CLR). Es posible crear y ver los seguimientos mediante las siguientes herramientas:
Las herramientas de línea de comandos Logman y Tracerpt, que se incluyen con el sistema operativo Windows.
Las herramientas Xperf del Kit de herramientas de rendimiento de Windows. Para obtener más información sobre Xperf, vea el blog de rendimiento de Windows.
Para capturar información de eventos de CLR, el proveedor de CLR debe estar instalado en el equipo. Para confirmar que el proveedor está instalado, escriba logman query providers
en el símbolo del sistema. Se muestra una lista de proveedores. Esta lista debería contener una entrada para el proveedor de CLR, del modo siguiente.
Provider GUID
-------------------------------------------------------------------------------
.NET Common Language Runtime {E13C0D23-CCBC-4E12-931B-D9CC2EEE27E4}.
Si el proveedor de CLR no aparece en la lista, puede instalarlo en Windows Vista y sistemas operativos posteriores mediante la herramienta de línea de comandos Wevtutil de Windows. Abra una ventana del símbolo del sistema como administrador. Cambie del directorio del símbolo del sistema a la carpeta de .NET Framework 4 (%WINDIR%\Microsoft.NET\Framework[64]\v4.<.versión de .NET>\ ). Esta carpeta contiene el archivo CLR-ETW.man. En el símbolo del sistema, escriba el siguiente comando para instalar el proveedor de CLR.
wevtutil im CLR-ETW.man
Capturar eventos ETW de CLR
Puede usar las herramientas de línea de comandos Logman y Xperf para capturar eventos ETW y las herramientas Tracerpt y Xperf para descodificar eventos de seguimiento.
Para activar el registro, el usuario debe especificar tres cosas:
El proveedor con el que comunicarse.
Número de 64 bits que representa un conjunto de palabras clave. Cada palabra clave representa un conjunto de eventos que el proveedor puede activar. El número representa un conjunto combinado de palabras clave que se pueden activar.
Un número pequeño que representa el nivel (de detalle) con que se realiza el registro. El nivel 1 es el menos detallado y el nivel 5, el más detallado. El nivel 0 es un valor predeterminado cuyo significado es específico del proveedor.
Para capturar eventos ETW de CLR mediante Logman
En el símbolo del sistema, escriba:
logman start clrevents -p {e13c0d23-ccbc-4e12-931b-d9cc2eee27e4} 0x1CCBD 0x5 -ets -ct perf
donde:
El parámetro
-p
identifica el GUID del proveedor.0x1CCBD
especifica las categorías de eventos que se van a producir.0x5
establece el nivel de registro (en este caso, detallado (5)).El parámetro
-ets
indica a Logman que envíe los comandos a las sesiones de seguimiento de eventos.El parámetro
-ct perf
especifica que la funciónQueryPerformanceCounter
se utilizará para registrar la marca de tiempo para cada evento.
Para dejar de registrar los eventos, escriba:
logman stop clrevents -ets
Este comando crea un archivo de seguimiento binario denominado clrevents.etl.
Para capturar eventos ETW de CLR mediante Xperf
En el símbolo del sistema, escriba:
xperf -start clr -on e13c0d23-ccbc-4e12-931b-d9cc2eee27e4:0x1CCBD:5 -f clrevents.etl
donde el GUID es el GUID del proveedor de ETW de CLR y
0x1CCBD:5
realiza la traza de todo en el nivel 5 y por debajo de este (detallado).Para detener el seguimiento, escriba:
Xperf -stop clr
Este comando crea un archivo de seguimiento denominado clrevents.etl.
Ver eventos ETW de CLR
Utilice los comandos enumerados a continuación para ver los eventos ETW de CLR. Para obtener una descripción de los eventos, vea Eventos ETW de CLR.
Para ver los eventos ETW de CLR mediante Tracerpt
En el símbolo del sistema, escriba:
tracerpt clrevents.etl
Este comando crea dos archivos: dumpfile.xml y summary.txt. El archivo dumpfile.xml muestra todos los eventos y summary.txt proporciona un resumen de ellos.
Para ver los eventos ETW de CLR mediante Xperf
En el símbolo del sistema, escriba:
xperf clrevents.etl
Este comando abre el visor de archivos ETL Xperf. En este visor, los eventos de CLR se presentan en la vista Eventos genéricos. Para mostrar una cuadrícula de datos de eventos clasificados por tipos, seleccione un área de tiempo en esta vista y, después, haga clic con el botón derecho del mouse y seleccione Resumen.
Para convertir el archivo .etl en un archivo de valores separados por comas
En el símbolo del sistema, escriba:
xperf -i clrevents.etl -f clrevents.csv
Este comando hace que XPerf vuelque los eventos en un archivo de valores separados por comas (CSV) que se puede consultar. Dado que los distintos eventos tienen campos distintos, este archivo CSV contiene más de una línea de encabezado antes de los datos. El primer campo de cada línea es el tipo de evento, que indica qué encabezado se debería utilizar para determinar el resto de los campos.