Marcadores del Visualizador de simultaneidad

  • Artículo

En el visualizador de simultaneidad, los marcadores son iconos que representan los eventos que se producen en una aplicación. Normalmente, la aplicación genera estos eventos para designar las fases o las instancias de una aplicación. Los eventos se pueden generar mediante la aplicación o las bibliotecas y los runtimes que utiliza la aplicación.

Tipos de marcadores

El visualizador de simultaneidad utiliza tres tipos de marcadores para representar eventos de aplicación: marcas, mensajes e intervalos.

  1. Utilice una marca para indicar un punto interesante de tiempo en la aplicación. Por ejemplo, podría utilizar una marca para representar que un valor variable ha alcanzado un umbral determinado o que se produjo una excepción.

  2. Un mensaje también marca un punto de tiempo, pero puede utilizarlo para hacer un seguimiento de estilo de registro. Por ejemplo, lo que se podría haber volcado en un archivo de registro ahora puede encapsularlo en una llamada de mensaje para que le pueda hacer un seguimiento y verlo en el visualizador de simultaneidad. También puede utilizar el visualizador de simultaneidad para exportar estos datos a un archivo CSV.

  3. Un intervalo representa un intervalo de tiempo en la aplicación, por ejemplo, una de sus fases.

Vinculación de marcadores para los subprocesos

Cada subproceso que genera marcadores tiene un canal de escala de tiempo independiente. El identificador del subproceso que es responsable de generar los eventos de marcador se muestra junto a la descripción del canal de marcador. El identificador que se muestra en el lado izquierdo del canal de marcador coincide con el de otro subproceso en el proceso actual.

Importancia de los marcadores

Los marcadores pueden tener uno de cuatro niveles de importancia: baja, normal, alta y crítica. Los orígenes de los marcadores se pueden filtrar según el nivel de importancia. Por ejemplo, si solo quiere ver los marcadores de un origen concreto que tenga importancia crítica o normal, puede configurar el filtro en el cuadro de diálogo Configuración avanzada. La importancia de un marcador aparece en la información sobre herramientas y en el informe Marcadores.

Categoría de los marcadores

Una categoría de marcador indica un grupo de eventos de marcador que proceden del mismo origen. El visualizador de simultaneidad usa colores para distinguir las diferentes categorías de marcas e intervalos. El visualizador de simultaneidad se puede configurar para que use categorías con las que filtrar los eventos de marcador de un proveedor de eventos determinado. Utilice el cuadro de diálogo Configuración avanzada para configurar el filtro.

Orígenes conocidos de marcadores

Cualquier proveedor de ETW puede generar marcadores, siempre y cuando el proveedor observe determinadas restricciones. Puede configurar el visualizador de simultaneidad para que escuche orígenes de eventos adicionales para los marcadores. De forma predeterminada, escucha estos orígenes de eventos:

Marcadores de EventSource

El visualizador de simultaneidad también puede mostrar eventos EventSource. Para obtener más información, vea Visualizar eventos EventSource como marcadores.

Marcadores de marca

Un marcador de marca representa algo que se ha producido en un momento determinado en una aplicación. Una marca puede representar muchos tipos de eventos de aplicación. Por ejemplo, una marca puede mostrar cuándo se ha programado un elemento de trabajo determinado o cuándo se ha producido una excepción. Los runtimes, como la biblioteca TPL, también pueden generar marcas.

Importancia de la marca

Las marcas se muestran en diferentes tamaños según su importancia. Al igual que cualquier marcador, la importancia puede ser baja, normal, alta o crítica. En esta ilustración se muestra el aspecto de los marcadores por nivel de importancia:

Illustration of Low, Normal, High, and Critical importance markers.

Categoría de la marca

Una marca se muestra en uno de cinco colores diferentes, según su categoría. Los colores se reutilizan si hay más de cinco categorías. No puede elegir el color. Al igual que cualquier marcador, la categoría puede ser cualquier número entero. En la ilustración siguiente se muestran los colores de las cinco primeras categorías.

Illustration of five colors of category markers.

Alertas

Una alerta es una marca de color rojo que representa un evento de aplicación crítico, como una excepción. Esta es una alerta:

Illustration of the Concurrency Visualizer alert marker.

Marcas de agregación

En ocasiones, las marcas están tan cerca de otras en el visualizador de simultaneidad que no se pueden dibujar individualmente. Cuando esto ocurre, se muestra una marca de agregación gris que representa las marcas subyacentes. Cuando coloca el puntero en uno de estos iconos, una información sobre herramientas muestra el número de marcas subyacentes que se representan. Para ver las marcas, amplíe. Si amplía completamente y sigue recibiendo una marca de agregación, puede ver las marcas subyacentes en el Informe de marcadores.

Las marcas de agregación se dibujan en diferentes tamaños. El tamaño depende del nivel de importancia de la marca más importante en la agregación. En la ilustración siguiente se muestran las marcas de agregación en orden creciente de importancia.

Illustration of aggregate flags showing four levels of importance.

Marcadores de mensaje

Un marcador de mensaje representa el resultado del registro. Un mensaje es una cadena emitida por un subproceso concreto en un momento determinado. Los mensajes se pueden exportar a un archivo de texto para su uso con otras herramientas. Al colocar el puntero sobre un mensaje en el visualizador de simultaneidad, se ve la cadena del mensaje. En el Informe de marcadores se pueden ver todos los marcadores de mensaje. En la siguiente ilustración se muestra un marcador de mensajes.

Marcadores de agregación de mensajes

En ocasiones, los mensajes aparecen tan cerca unos de otros en el visualizador de simultaneidad que no se pueden extraer individualmente. Cuando esto ocurre, se muestra un marcador de agregación de mensajes que representa los mensajes subyacentes. Al colocar el puntero en uno de estos iconos, se muestra información sobre el número de mensajes subyacentes que se representan. Para ver los mensajes, amplíe la imagen. Si amplía completamente y sigue recibiendo un marcador de agregación, puede ver los mensajes subyacentes en el Informe de marcadores.

Marcadores de intervalo

Un marcador de intervalo representa una fase significativa de una aplicación. Por ejemplo, puede usar un intervalo para representar un intervalo de tiempo durante el cual se está procesando un elemento de trabajo determinado. Su longitud representa la duración de la fase de la aplicación correspondiente. Esta ilustración muestra un intervalo en el visualizador de simultaneidad:

Illustration of a span marker in Concurrency Visualizer.

Categoría de intervalo

Se muestra un marcador de intervalo en uno de los cinco colores diferentes, dependiendo de su categoría. Los colores se repiten si hay más de cinco categorías. La categoría puede ser cualquier número entero. Esta ilustración muestra los cinco colores posibles:

Illustration of five spans in different categories.

Marcadores de agregación de intervalo

En ocasiones los marcadores de intervalo se producen tan cerca de otros en el visualizador de simultaneidad que no se pueden dibujar individualmente. Cuando esto ocurre, se muestra un marcador de agregación de intervalo gris que representa los intervalos subyacentes. Cuando coloca el puntero en uno de estos iconos, una información sobre herramientas muestra el número de intervalos subyacentes que se representan. Amplíe para ver los intervalos. Si amplía completamente y sigue recibiendo un marcador de agregación de intervalo, puede ver los marcadores de intervalo subyacentes en el Informe de marcadores. Esta ilustración muestra un marcador de agregación de intervalo:

Illustration of an aggregate span marker in Concurrency Visualizer.

Contenido relacionado