Étiquettes de version et annotations d'exécution

Ce que sont les étiquettes de version

Une étiquette de version est une courte étiquette, généralement un numéro de version comme v2.3.1, associée à une exécution d'un test de charge. Les exécutions étiquetées se démarquent sur les graphiques de l'onglet Trend, donc lorsque les temps de réponse ou les taux d'erreur changent entre les exécutions, vous pouvez voir en un coup d'œil à quelle version correspond le changement.

Chaque annotation comporte deux parties :

• Release tag : obligatoire, jusqu'à 64 caractères
• Link : optionnel, une URL http:// ou https://, par exemple les notes de version, la pull request ou le build CI

Les étiquettes de version fonctionnent pour les trois moteurs : les tests de charge cloud, les tests de charge JMeter et les tests de charge k6.

Étiqueter l'exécution que vous consultez

1. Ouvrez le résultat d'un test et passez à l'onglet Trend.
2. Renseignez le champ Release tag (indication : e.g. v2.3.1) et, si vous le souhaitez, le champ Link (optional).
3. Cliquez sur Save. Le statut à côté du bouton confirme avec "Saved".

Le formulaire annote toujours l'exécution que vous êtes en train de consulter. Pour étiqueter une exécution plus ancienne, ouvrez d'abord la page de résultat de cette exécution, puis enregistrez l'étiquette depuis son onglet Trend.

Pour modifier une étiquette, modifiez les champs et enregistrez à nouveau. Pour la supprimer, videz le champ Release tag et enregistrez ; une étiquette vide supprime l'annotation.

Étiqueter au lancement depuis la CI

Lorsque vous démarrez un test via l'API CI/CD, transmettez releaseTag et, en option, releaseUrl avec la requête d'exécution. La nouvelle exécution est annotée dès son démarrage, sans étape manuelle. Cela fonctionne sur les points de terminaison d'exécution des trois moteurs, si bien qu'un pipeline de déploiement peut associer à chaque exécution de test de performance la version qu'il a testée.

Comment les exécutions étiquetées apparaissent sur les graphiques

L'onglet Trend trace trois graphiques sur vos exécutions récentes : temps de réponse P95, taux d'erreur et débit. Sur chaque graphique :

• une exécution avec une étiquette de version est représentée par un marqueur en losange plus grand, tandis que les exécutions non étiquetées restent de simples points
• survoler une exécution étiquetée affiche l'étiquette dans l'infobulle, avec la mention "click to open" lorsqu'un lien a été enregistré
• cliquer sur un point étiqueté ouvre son lien dans un nouvel onglet

Les couleurs des marqueurs conservent leur signification habituelle issue des seuils de réussite/échec ; c'est la forme de losange qui signale une version.

Partage et permissions

Les annotations sont stockées par équipe, donc tout le monde dans l'équipe voit les mêmes étiquettes sur les mêmes exécutions. Les membres de l'équipe avec un rôle en lecture seule peuvent voir les étiquettes mais ne peuvent ni les enregistrer ni les supprimer.

Flux de travail typique

1. Votre pipeline exécute un test de charge à chaque déploiement et transmet releaseTag=v2.3.1.
2. Une semaine plus tard, la tendance P95 bondit. Dans l'onglet Trend, le saut commence exactement au losange v2.4.0.
3. Cliquez sur le marqueur pour ouvrir les notes de version et trouver le changement qui en est la cause, puis comparez les deux exécutions avec une comparaison de référence.