Ir al contenido

Etiquetas de lanzamiento y anotaciones de ejecución

Una etiqueta de lanzamiento es una etiqueta corta, normalmente un número de versión como v2.3.1, adjunta a una ejecución de una prueba de carga. Las ejecuciones etiquetadas destacan en los gráficos de la pestaña Trend, así que cuando los tiempos de respuesta o las tasas de error cambian entre ejecuciones, puedes ver de un vistazo con qué lanzamiento coincide el cambio.

Cada anotación tiene dos partes:

  • un Release tag: obligatorio, hasta 64 caracteres
  • un Link: opcional, una URL http:// o https://, por ejemplo las notas de lanzamiento, el pull request o el build de CI

Las etiquetas de lanzamiento funcionan en los tres motores: Pruebas de Carga en la Nube, Pruebas de Carga con JMeter y Pruebas de Carga con k6.

  1. Abre un resultado de prueba y cambia a la pestaña Trend.
  2. Completa el campo Release tag (marcador de posición: e.g. v2.3.1) y, si quieres, el campo Link (optional).
  3. Haz clic en Save. El estado junto al botón confirma con "Saved".

El formulario siempre anota la ejecución que estás viendo en este momento. Para etiquetar una ejecución anterior, abre primero la página de resultados de esa ejecución y luego guarda la etiqueta desde su pestaña Trend.

Para cambiar una etiqueta, edita los campos y guarda de nuevo. Para eliminarla, borra el campo Release tag y guarda; una etiqueta vacía elimina la anotación.

Un pipeline puede etiquetar cada ejecución que inicia con la API de pruebas de carga. Inicia la prueba, espera a que el nuevo número de ejecución aparezca en la lista de pruebas y envía testrunname, testrunid, label (la etiqueta de la versión) y, si quieres, url como campos de formulario a POST /api/test/general/run-annotation para una prueba en la nube, o a /api/test/jmeter/run-annotation o /api/test/k6/run-annotation, con tu clave API en la cabecera loadfocus-auth y el id de tu equipo en team-id. Un label vacío elimina la etiqueta. Las peticiones de ejecución también aceptan releaseTag y releaseUrl, pero solo tienen efecto si la petición lleva además el testrunid de la ejecución, que una ejecución nueva todavía no tiene.

Cómo aparecen las ejecuciones etiquetadas en los gráficos

Sección titulada «Cómo aparecen las ejecuciones etiquetadas en los gráficos»

La pestaña Trend representa tres gráficos a lo largo de tus ejecuciones recientes: Tiempo de respuesta P95, Tasa de error y Rendimiento. En cada gráfico:

  • una ejecución con una etiqueta de lanzamiento se dibuja como un marcador de diamante más grande, mientras que las ejecuciones sin etiquetar son puntos simples
  • al pasar el cursor sobre una ejecución etiquetada se muestra la etiqueta en el tooltip, con "click to open" cuando se guardó un enlace
  • al hacer clic en un punto etiquetado se abre su enlace en una pestaña nueva

Los colores de los marcadores mantienen su significado habitual según los umbrales de aprobado/fallido; la forma de diamante es lo que marca un lanzamiento.

Las anotaciones se almacenan por equipo, así que todos los miembros del equipo ven las mismas etiquetas en las mismas ejecuciones. Los miembros del equipo con un rol de solo lectura pueden ver las etiquetas, pero no pueden guardarlas ni eliminarlas.

  1. Tu pipeline ejecuta una prueba de carga en cada despliegue y etiqueta la ejecución con la versión que despliega, por ejemplo v2.4.0.
  2. Una semana después, la tendencia P95 da un salto. En la pestaña Trend, el salto empieza exactamente en el diamante v2.4.0.
  3. Haz clic en el marcador para abrir las notas de lanzamiento y encontrar el cambio que lo causó, y luego compara las dos ejecuciones con una comparación de línea base.