Release-Tags und Run-Annotationen

Was Release-Tags sind

Ein Release-Tag ist eine kurze Kennzeichnung, meist eine Versionsnummer wie v2.3.1, die an einen einzelnen Lauf eines Lasttests angehängt wird. Markierte Läufe heben sich in den Diagrammen des Trend-Tabs ab, sodass Sie auf einen Blick erkennen, mit welchem Release eine Änderung bei Antwortzeiten oder Fehlerraten zusammenhängt.

Jede Annotation besteht aus zwei Teilen:

• ein Release tag: erforderlich, bis zu 64 Zeichen
• ein Link: optional, eine http://- oder https://-URL, zum Beispiel die Release-Notes, der Pull Request oder der CI-Build

Release-Tags funktionieren bei allen drei Engines: Cloud-Lasttests, JMeter-Lasttests und k6-Lasttests.

Den aktuell angezeigten Lauf taggen

1. Öffnen Sie ein Testergebnis und wechseln Sie zum Trend-Tab.
2. Füllen Sie das Feld Release tag aus (Platzhalter: e.g. v2.3.1) und, wenn gewünscht, das Feld Link (optional).
3. Klicken Sie auf Save. Der Status neben der Schaltfläche bestätigt dies mit "Saved".

Das Formular versieht immer den Lauf, den Sie gerade ansehen, mit einer Annotation. Um einen älteren Lauf zu taggen, öffnen Sie zuerst die Ergebnisseite dieses Laufs und speichern Sie den Tag dann über dessen Trend-Tab.

Um einen Tag zu ändern, bearbeiten Sie die Felder und speichern Sie erneut. Um ihn zu entfernen, leeren Sie das Feld Release tag und speichern Sie; ein leerer Tag löscht die Annotation.

Beim Start aus der CI taggen

Wenn Sie einen Test über die CI/CD-API starten, übergeben Sie releaseTag und optional releaseUrl mit der Execute-Anfrage. Der neue Lauf wird ab dem Moment, in dem er startet, ohne manuellen Schritt annotiert. Dies funktioniert bei den Execute-Endpunkten aller drei Engines, sodass eine Deployment-Pipeline jeden Performance-Lauf mit der getesteten Version versehen kann.

Wie getaggte Läufe in den Diagrammen erscheinen

Der Trend-Tab zeichnet drei Diagramme über Ihre letzten Läufe: P95 response time, Error rate und Throughput. In jedem Diagramm:

• ein Lauf mit einem Release-Tag wird als größerer Rauten-Marker dargestellt, während nicht getaggte Läufe einfache Punkte sind
• das Bewegen der Maus über einen getaggten Lauf zeigt den Tag im Tooltip an, mit "click to open", wenn ein Link gespeichert wurde
• ein Klick auf einen getaggten Punkt öffnet dessen Link in einem neuen Tab

Die Markerfarben behalten ihre übliche Bedeutung aus den Pass/Fail-Schwellenwerten; die Rautenform kennzeichnet ein Release.

Freigabe und Berechtigungen

Annotationen werden pro Team gespeichert, sodass alle Teammitglieder dieselben Tags bei denselben Läufen sehen. Teammitglieder mit einer reinen Ansichtsrolle können Tags sehen, aber nicht speichern oder löschen.

Typischer Workflow

1. Ihre Pipeline führt bei jedem Deploy einen Lasttest aus und übergibt releaseTag=v2.3.1.
2. Eine Woche später springt der P95-Trend nach oben. Im Trend-Tab beginnt der Sprung genau bei der v2.4.0-Raute.
3. Klicken Sie auf den Marker, um die Release-Notes zu öffnen und die Änderung zu finden, die dies verursacht hat, und vergleichen Sie dann die beiden Läufe mit einem Baseline-Vergleich.