Visualizar eventos EventSource como marcadores

El Visualizador de simultaneidad puede mostrar eventos EventSource como marcadores y se puede controlar cómo se muestran los marcadores.Para ver losmarcadores EventSource, registre la GUID del proveedor ETW mediante el cuadro de diálogo Configuración avanzada.El Visualizador de simultaneidad tiene convenciones predeterminadas para representar eventos EventSource como Marcadores de marca, Marcadores de intervalo y Marcadores de mensaje.Se puede personalizar cómo se muestran los eventos EventSource agregando campos personalizados a los eventos.Para obtener más información sobre los marcadores, consulte Marcadores del Visualizador de simultaneidad.Para obtener más información sobre los eventos EventSourcce, consulte System.Diagnostics.Tracing.

Visualización predeterminada de eventos EventSource

De forma predeterminada, el Visualizador de simultaneidad usa las siguientes convenciones para representar los eventos EventSource.

Tipo de marcador

1. Los eventos que tienen Opcode win:Start o win:Stop se tratan como el principio o el fin de un periodo, respectivamente.Los periodos anidados o solapados no se pueden mostrar.Los pares de eventos que comienzan en un subproceso y terminan en otro no se pueden mostrar.

2. Un evento cuyo Opcode no es ni win:Start ni win:Stop se trata como un flag de marcador a menos que su Nivel (campo de EVENT_RECORD.EVENT_HEADER.EVENT_DESCRIPTOR) sea win:Verbose o mayor.

3. En todos los demás casos, el evento se trata como un mensaje.

Importancia

En la tabla siguiente se define cómo asigna el nivel del evento la importancia del marcador.

El nombre de la serie.

El nombre de la tarea del evento se usa para el nombre de la serie.El nombre de la serie está vacío si no se definió ninguna tarea para el evento.

Categoría

Si el nivel es win:Critical o win:Error, entonces la categoría es Alert (-1).De lo contrario, la categoría es la predeterminada (0).

Texto

Si un mensaje de texto con formato de tipo printf se definió para el evento, se muestra como una descripción del marcador.De lo contrario, la descripción es el nombre del evento y el valor de cada campo de carga.

Personalizar la visualización de los eventos EventSource

Se puede personalizar cómo se muestran los eventos EventSource añadiendo los campos apropiados al evento, como se describe en las siguientes secciones.

Tipo de marcador

Use el campo cvType, un byte, para controlar el tipo de marcador que se usa para representar el evento.Los valores disponibles para estos cvType::

Importancia

Se puede usar el campo cvImportance, un byte, para controlar la configuración más importante para un evento EventSource.Sin embargo, se recomienda que se controle la importancia mostrada de un evento mediante su nivel.

Nombre de la serie

Use el campo de evento cvSeries, una cadena, para controlar el nombre de la serie que el Visualizador de simultaneidad da a un evento EventSource.

Categoría

Use el campo cvCategory, un byte, para controlar la categoría que el Visualizador de simultaneidad da a un evento EventSource.

Texto

Use el campo cvTextW, una cadena, para controlar la descripción que el Visualizador de simultaneidad da a un evento EventSource.

SpanID

Use el campo cvSpanID, un entero, para enlazar pares de eventos.El valor para cada par de eventos inicio/parada que representan un periodo debe ser único.Normalmente para código concurrente, esto requiere el uso de primitivas de sincronización como Exchange para asegurar que la clave (el valor que se usa para CvSpanID) es correcta.

[!NOTA]

El uso de SpanID para anidar periodos, que les permite solaparse parcialmente en el mismo subproceso, o les permite empezar en un subproceso y terminar en otro, no está admitido.

Vea también

Conceptos

Marcadores del Visualizador de simultaneidad