Étiquettes de version et annotations d'exécution
Ce que sont les étiquettes de version
Section intitulée « 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://ouhttps://, 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
Section intitulée « Étiqueter l'exécution que vous consultez »- Ouvrez le résultat d'un test et passez à l'onglet Trend.
- Renseignez le champ Release tag (indication :
e.g. v2.3.1) et, si vous le souhaitez, le champ Link (optional). - 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
Section intitulée « Étiqueter au lancement depuis la CI »Un pipeline peut étiqueter chaque exécution qu'il lance via l'API de tests de charge. Lancez le test, attendez que le nouveau numéro d'exécution apparaisse dans la liste des tests, puis envoyez testrunname, testrunid, label (l'étiquette de version) et éventuellement url en champs de formulaire à POST /api/test/general/run-annotation pour un test cloud, ou à /api/test/jmeter/run-annotation ou /api/test/k6/run-annotation, avec votre clé API dans l'en-tête loadfocus-auth et votre id d'équipe dans team-id. Un label vide supprime l'étiquette. Les requêtes d'exécution acceptent aussi releaseTag et releaseUrl, mais ils ne s'appliquent que si la requête contient aussi le testrunid de l'exécution, qu'une nouvelle exécution n'a pas encore.
Comment les exécutions étiquetées apparaissent sur les graphiques
Section intitulé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
Section intitulée « 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
Section intitulée « Flux de travail typique »- Votre pipeline lance un test de charge à chaque déploiement et étiquette l'exécution avec la version déployée, par exemple
v2.4.0. - Une semaine plus tard, la tendance P95 bondit. Dans l'onglet Trend, le saut commence exactement au losange
v2.4.0. - 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.