Skip to main content
La primera pregunta ante un pico de latencia o de errores suele ser si se ha desplegado algo. Los gráficos temporales del dashboard pueden responderla directamente: active los marcadores de versiones y cada tile dibujará una línea vertical discontinua en el momento en que una versión de un servicio aparezca por primera vez en su telemetría. Las versiones proceden de la telemetría que ya envía y se leen mediante una expresión en la fuente del tile. No hay ninguna integración de CI que configurar ni nada que enviar al desplegar.

​
Activar marcadores

Los marcadores de versiones están desactivados de forma predeterminada. Abra el menú de desbordamiento de un dashboard y seleccione Mostrar marcadores de versiones. El interruptor añade releaseMarkers=true a la URL del dashboard, por lo que los enlaces que comparta se abrirán con los marcadores ya activados. Es un estado de visualización, no una configuración del dashboard: no se guarda con el dashboard y, al desactivarlo, el parámetro vuelve a eliminarse. Los marcadores se muestran en tiles de series temporales cuya fuente es una fuente de logs o trazas. Las anotaciones de alertas proceden del mismo menú y pueden mostrarse a la vez: ambos conjuntos de marcadores se muestran juntos y cada uno conserva sus propias etiquetas.

​
Configurar el origen de la versión

De forma predeterminada, ClickStack lee ResourceAttributes['service.version'], el atributo de recurso de OpenTelemetry. Si tus servicios siguen las convenciones semánticas de recursos de servicio, los marcadores funcionan sin necesidad de configuración. Para leer la versión desde otro lugar, establece Expresión de versión del servicio en la fuente de logs o fuente de traza. Edita la fuente en Configuración del equipo → Sources. En una fuente de logs, el campo se encuentra en Configurar campos opcionales; en una fuente de traza, aparece directamente en el formulario, debajo de Expresión de nombre del servicio. El valor es una expresión SQL, no un nombre de atributo, lo que permite cubrir dos casos habituales:
  • El identificador de la versión está en otro atributo. En GitOps, lo que suele identificar una versión es la etiqueta de la imagen de contenedor, que llega como container.image.tag. Configurar la fuente para usar ResourceAttributes['container.image.tag'] resulta considerablemente más económico que cambiar la instrumentación de toda una flota.
  • Los servicios de una misma tabla no coinciden. Recurre a los atributos mediante coalesce:
El campo también está disponible como serviceVersionExpression en las fuentes de logs y traces de la API de fuentes, por lo que puede configurarlo al aprovisionar fuentes mediante programación. Consulte la lista completa de configuraciones de fuentes para logs y traces.

​
Qué significa un marcador

Un marcador registra que un valor de versión apareció por primera vez en los datos del tile dentro de la ventana visible. Es similar a un despliegue, pero deliberadamente no indica lo mismo; por eso son marcadores de versión y no marcadores de despliegue:
  • Un despliegue que no cambia la cadena de versión no genera ningún marcador.
  • Un servicio que permanece inactivo durante más tiempo que el período de búsqueda retrospectiva muestra un marcador cuando vuelve a escalar.
La versión que ya se estaba ejecutando cuando se abrió la ventana se identifica y se descarta, en lugar de mostrarse como una versión que nunca se publicó. Para ello, la consulta retrocede desde el inicio de la ventana —30 minutos o el 10 % de la ventana, si este período es mayor— para encontrar la versión vigente.

​
Qué versiones muestra un tile

La consulta de versiones se ejecuta sobre la propia fuente del tile y con sus propios predicados: su cláusula WHERE, el filtro de cada serie y cualquier filtro de dashboard. Lo que muestra un tile depende de lo que representa: En el tercer caso, el servicio de un marcador no tiene ninguna línea con la que coincidir en el gráfico, por lo que los marcadores se omiten. Si todas las versiones de la ventana proceden de un único servicio, se dibujan con el color predeterminado de los marcadores.

​
Leer marcadores en un gráfico con muchas series

Pasa el cursor sobre la etiqueta de un marcador para ver todas las versiones en ese punto, cada una con el servicio que la publicó, su versión y la hora. El color vincula un marcador con su serie, pero la leyenda de un gráfico muestra como máximo cuatro entradas antes de contraer el resto tras “+N more”, momento en el que no hay nada en pantalla con lo que relacionar el color. La información emergente indica directamente el servicio, por lo que funciona independientemente de cuántas series muestre el tile. Los marcadores demasiado cercanos entre sí como para etiquetarlos individualmente se agrupan en un único anclaje con la etiqueta N releases; al pasar el cursor sobre él se muestran todos. Un cluster que abarca varios servicios se dibuja en un color neutro en lugar de usar el de uno de ellos, de modo que el recuento sea preciso sin sugerir un propietario. Arrastrar horizontalmente sobre el gráfico sigue aplicando zoom mientras se muestran los marcadores.

​
Limitaciones

  • Solo tiles de series temporales. Las tablas, los indicadores numéricos y los mapas de calor no muestran marcadores.
  • Solo fuentes de logs y trazas. Una fuente de métricas resuelve su tabla según el tipo de métrica, por lo que no hay una única tabla que volver a agregar ni forma de que los filtros de un tile tengan sentido al aplicarse a ella. Para anotar datos de métricas, coloque un tile de logs o traces junto a ella en el mismo dashboard.
  • Se omiten los valores de versión vacíos. Un servicio que no emite ninguna versión no aporta marcadores. Si un tile no encuentra ningún cambio de versión, ClickStack muestra No releases found en lugar de hacerle preguntarse si la función no funciona.
  • Se leen hasta 500 versiones distintas por ventana.
Última modificación el 26 de agosto de 2026