Compartir vía

Controlar el registro de .NET Framework

  • Artículo

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:

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

  1. 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ón QueryPerformanceCounter se utilizará para registrar la marca de tiempo para cada evento.

  2. 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

  1. 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).

  2. 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.

Consulte también