Release-Tags und Run-Annotationen
Was Release-Tags sind
Abschnitt betitelt „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://- oderhttps://-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
Abschnitt betitelt „Den aktuell angezeigten Lauf taggen“- Öffnen Sie ein Testergebnis und wechseln Sie zum Trend-Tab.
- Füllen Sie das Feld Release tag aus (Platzhalter:
e.g. v2.3.1) und, wenn gewünscht, das Feld Link (optional). - 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
Abschnitt betitelt „Beim Start aus der CI taggen“Eine Pipeline kann jeden Lauf taggen, den sie über die Lasttest-API startet. Starten Sie den Test, warten Sie, bis die neue Laufnummer in der Testliste erscheint, und senden Sie dann testrunname, testrunid, label (das Release-Tag) und optional url als Formularfelder an POST /api/test/general/run-annotation für einen Cloud-Test oder an /api/test/jmeter/run-annotation bzw. /api/test/k6/run-annotation, mit Ihrem API-Schlüssel im Header loadfocus-auth und Ihrer Team-ID in team-id. Ein leeres label entfernt das Tag. Die Execute-Anfragen akzeptieren auch releaseTag und releaseUrl, die aber nur wirken, wenn die Anfrage auch die testrunid des Laufs enthält, die ein neuer Lauf noch nicht hat.
Wie getaggte Läufe in den Diagrammen erscheinen
Abschnitt betitelt „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
Abschnitt betitelt „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
Abschnitt betitelt „Typischer Workflow“- Ihre Pipeline führt bei jedem Deploy einen Lasttest aus und taggt den Lauf mit der Version, die sie ausliefert, zum Beispiel
v2.4.0. - Eine Woche später springt der P95-Trend nach oben. Im Trend-Tab beginnt der Sprung genau bei der
v2.4.0-Raute. - 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.