"Tough Day 2"ist eine Anwendung, mit der Sie die Grenzwerte Ihrer AEM testen können. Sie kann mit der standardmäßigen Test-Suite vorkonfiguriert oder entsprechend Ihren Testanforderungen konfiguriert werden. Du kannst zusehen diese Aufzeichnung für eine Darstellung des Antrags.
Für Tough Day 2 ist Java™ 8 erforderlich.
Laden Sie die aktuelle Version von Tough Day 2 aus dem Adobe-Repository herunter. Nach dem Download können Sie die Anwendung direkt ausführen. Sie müssen lediglich den Parameter host
angeben. Beim folgenden Beispiel wird die AEM-Instanz lokal ausgeführt. Daher wird der Wert localhost
verwendet:
java -jar toughday2.jar --host=localhost
Die Standard-Suite, die nach dem Hinzufügen des Parameters ausgeführt wird, heißt toughday
. Es enthält die folgenden Anwendungsfälle:
Die Suite enthält 15 % Schreibaktionen und 85 % Leseaktionen.
Um die Suite-Tests auszuführen, installiert Tough Day 2 das Standard-Inhaltspaket. Um dies zu vermeiden, können Sie den Parameter installsamplecontent
auf false
festlegen. Denken Sie aber daran, auch die Standardpfade für die Tests zu ändern, die Sie ausführen möchten. Wenn die JAR ohne Parameter ausgeführt wird, zeigt Tough Day 2 die Hilfe-Informationen an.
Als Regel können Sie die Anwendung wie folgt verwenden:
java -jar toughday2.jar [--help | --help_full | --help_tests | --help_publish] [<global arguments> | <actions> | --runmode | --publishmode]
Tough Day 2 verfügt über keinen Bereinigungsschritt. Daher wird empfohlen, Tough Day 2 auf einer geklonten Staging-Instanz und nicht auf der Hauptproduktionsinstanz auszuführen. Die Staging-Instanz sollte nach den Tests abgelegt werden.
Tough Day 2 bietet eine breite Palette von Hilfeoptionen, auf die über die Befehlszeile zugegriffen werden kann. Beispiel:
java -jar toughday2.jar --help_full
In der folgenden Tabelle finden Sie die relevanten Hilfsparameter.
Parameter | Beschreibung | Beispiel |
--help | Druckt globale Informationen aus, z. B.: die verfügbaren Aktionen, vordefinierte Suites, Ausführungsmodi und globale Parameter. | |
--help_publish | Druckt alle verfügbaren Publisher aus. | |
--help_tests | Druckt die Testklassen und deren Beschreibung. | |
--help_full | Druckt alle oben genannten Elemente sowie Tests, Herausgeber und Suite-Komponenten. | |
--help --runmode/publishmode type=<Mode> | Listet Informationen zum angegebenen Ausführungs- oder Veröffentlichungsmodus auf. | Java™ -jar toughday2.jar —help —runmode type=conantload Java™ -jar toughday2.jar —help —publishmode type=interval |
--help --suite=<SuiteName> | Listet alle Tests einer bestimmten Suite und ihre jeweiligen konfigurierbaren Eigenschaften auf. | Java™ -jar toughday2.jar —help —suite=get_tests |
--help --tag=<Tag> | Listet alle Elemente mit dem angegebenen Tag auf. |
Java™ -jar toughday2.jar —help —tag=publish |
--help <TestClass/PublisherClass> | Listet alle konfigurierbaren Eigenschaften für den jeweiligen Test oder Publisher auf. |
Java™ -jar toughday2.jar —help UploadPDFTest Java™ -jar toughday2.jar —help CSVPublisher |
Tough Day 2 bietet globale Parameter, die die Umgebung für die Tests festlegen oder ändern. Dazu gehören der Host, der als Ziel ausgewählt wird, die Portnummer, das verwendete Protokoll, der Benutzer und das Kennwort für die Instanz und vieles mehr. Beispiel:
java -jar toughday2.jar --host=host --protocol=https --port=4502 --duration=30m --dryrun=true
Die relevanten Parameter finden Sie in der folgenden Liste:
Parameter | Beschreibung | Standardwert | Mögliche Werte |
---|---|---|---|
--installsamplecontent=<Val> |
Das standardmäßige Inhaltspaket „Tough Day 2“ wird entweder installiert oder übersprungen. | Ja | „true“ oder „false“ |
--protocol=<Val> |
Das für den Host verwendete Protokoll. | http | http oder https |
--host=<Val> |
Der Hostname oder die IP-Adresse, die als Ziel ausgewählt wird. | ||
--port=<Val> |
Der Port des Hosts. | 4502 | |
--user=<Val> |
Der Benutzername für die Instanz. | admin | |
--password=<Val> |
Kennwort für den angegebenen Benutzer. | admin | |
--duration=<Val> |
Die Dauer der Tests. Kann in Sekunden (s), Minuten (m), Stunden (h) und Tagen (d) angegeben werden. | 1d | |
--timeout=<Val> |
Gibt an, wie lange ein Test ausgeführt wird, bevor er unterbrochen und als fehlgeschlagen markiert wird. In Sekunden angegeben. | 180 | |
--suite=<Val> |
Der Wert kann eine oder eine Liste (durch Kommas getrennt) von vordefinierter Test-Suites sein. | toughday | |
--configfile=<Val> |
Die angesprochene yaml-Konfigurationsdatei. | ||
--contextpath=<Val> |
Kontextpfad der Instanz. | ||
--loglevel=<Val> |
Die Protokollebene für die Tough Day 2-Engine. | INFO | ALL, DEBUG, INFO, WARN, ERROR, FATAL, OFF |
--dryrun=<Val> |
Wenn „true“, wird die resultierende Konfiguration gedruckt und es werden keine Tests ausgeführt. | Nein | „true“ oder „false“ |
Die Anpassung kann auf zwei Arten erfolgen: Befehlszeilenparameter oder YAML-Konfigurationsdateien. Konfigurationsdateien werden für große benutzerdefinierte Suites verwendet und überschreiben die Standardparameter von Tough Day 2. Befehlszeilenparameter überschreiben sowohl Konfigurationsdateien als auch die Standardparameter.
Die einzige Möglichkeit, eine Testkonfiguration zu speichern, besteht darin, sie in das YAML-Format zu kopieren.
Wenn Sie die standardmäßige toughday
-Suite nicht verwenden möchten, können Sie mit dem Parameter add
einen Test Ihrer Wahl hinzufügen. Die folgenden Beispiele zeigen, wie Sie die CreateAssetTreeTest
Testen Sie entweder mithilfe von Befehlszeilenparametern oder einer YAML-Konfigurationsdatei.
Mithilfe von Befehlszeilenparametern:
java -jar toughday2.jar --host=localhost --add CreateAssetTreeTest
Verwenden Sie eine YAML-Konfigurationsdatei:
globals:
host : localhost
tests:
- add : CreateAssetTreeTest
Sie können auch mehrere Instanzen desselben Tests hinzufügen und ausführen, aber jede Instanz muss über einen eindeutigen Namen verfügen. Die folgenden Beispiele zeigen, wie Sie zwei Instanzen desselben Tests entweder mithilfe von Befehlszeilenparametern oder einer YAML-Konfigurationsdatei hinzufügen.
Mithilfe von Befehlszeilenparametern:
java -jar toughday2.jar --host=localhost --add CreateAssetTreeTest name=FirstAssetTree --add CreateAssetTreeTest name=SecondAssetTree
Verwenden Sie eine YAML-Konfigurationsdatei:
globals:
host : localhost
tests:
- add : CreateAssetTreeTest
properties:
name : FirstAssetTree
- add : CreateAssetTreeTest
properties:
name : SecondAssetTree
Falls Sie eine oder mehrere der Testeigenschaften ändern müssen, können Sie diese Eigenschaft der Befehlszeile oder der YAML-Konfigurationsdatei hinzufügen. Um alle verfügbaren Testeigenschaften anzuzeigen, fügen Sie den Parameter --help <TestClass/PublisherClass>
zur Befehlszeile hinzu, z. B.:
java -jar toughday2.jar --help CreatePageTreeTest
Beachten Sie, dass die YAML-Konfigurationsdateien die Standardparameter von Tough Day 2 überschreiben und die Befehlszeilenparameter sowohl die Konfigurationsdateien als auch die Standardwerte überschreiben.
Die folgenden Beispiele zeigen, wie Sie die template
-Eigenschaft für CreatePageTreeTest
Testen Sie entweder mithilfe von Befehlszeilenparametern oder einer YAML-Konfigurationsdatei.
Mithilfe von Befehlszeilenparametern:
java -jar toughday2.jar --host=localhost --add CreatePageTreeTest template=/conf/toughday-templates/settings/wcm/templates/toughday-template
Verwenden Sie eine YAML-Konfigurationsdatei:
globals:
host : localhost
tests:
- add : CreatePageTreeTest
properties:
template : /conf/toughday-templates/settings/wcm/templates/toughday-template
Die folgenden Beispiele zeigen, wie Sie einen Test zu einer vordefinierten Suite hinzufügen und einen vorhandenen Test neu konfigurieren und aus einer vordefinierten Suite ausschließen.
Um einen neuen Test zu einer vordefinierten Suite hinzuzufügen, verwenden Sie den Parameter add
und geben die gewünschte Suite an.
Mithilfe von Befehlszeilenparametern:
java -jar toughday2.jar --host=localhost --suite=toughday --add CreatePageTreeTest
Verwenden Sie eine YAML-Konfigurationsdatei:
globals:
host : localhost
suite : toughday
tests:
- add : CreatePageTreeTest
Sie können vorhandene Tests in einer bestimmten Suite mit dem Parameter* *config
auch neu konfigurieren. Geben Sie auch den Suite-Namen und den tatsächlichen Namen des Tests an (nicht den Namen der Testklasse). Den Testnamen finden Sie in der Eigenschaft name
der Testklasse. Weitere Informationen zum Finden von Testeigenschaften finden Sie im Abschnitt Ändern von Testeigenschaften.
Im nachfolgenden Beispiel wird der Standardtitel des Assets für den Test CreatePageTreeTest
(namens UploadAsset
) in „NewAsset“ geändert.
Mithilfe von Befehlszeilenparametern:
java -jar toughday2.jar --host=localhost --suite=toughday --config UploadAsset title=NewAsset
Verwenden Sie eine YAML-Konfigurationsdatei:
globals:
host : localhost
suite : toughday
tests:
- config : UploadAsset
properties :
title : NewAsset
Sie können Tests auch aus vordefinierten Suites oder Herausgebern aus der Standardkonfiguration entfernen, indem Sie exclude
-Parameter. Geben Sie auch den Suite-Namen und den tatsächlichen Namen des Tests an (nicht den Test C lass
name). Den Testnamen finden Sie in der Eigenschaft name
der Testklasse. Im nachfolgenden Beispiel wird der Test CreatePageTreeTest
(namens UploadAsset
) von der Tough Day-Suite entfernt.
Mithilfe von Befehlszeilenparametern:
java -jar toughday2.jar --host=localhost --suite=toughday --exclude UploadAsset
Verwenden Sie eine YAML-Konfigurationsdatei:
globals:
host : localhost
suite : toughday
tests:
- exclude : UploadAsset
Bei Tough Day 2 stehen zwei Ausführungsmodi zur Verfügung: normal und constant load.
Für den Ausführungsmodus normal gibt es zwei Parameter:
concurrency
– Gleichzeitigkeit repräsentiert die Anzahl an Threads, die Tough Day 2 für die Testausführung erstellt. Auf diesen Threads werden die Tests ausgeführt, bis entweder die Dauer abgelaufen ist oder es keine weiteren Tests zur Durchführung mehr gibt.
waittime
– Dieser Parameter legt die Wartezeit zwischen zwei aufeinanderfolgenden Testausführungen auf demselben Thread fest. Der Wert muss in Millisekunden angegeben werden.
Das folgende Beispiel zeigt, wie Sie die Parameter über die Befehlszeile hinzufügen:
java -jar toughday2.jar --host=localhost --add CreateAssetTreeTest --runmode=normal concurrency=20
oder mithilfe einer YAML-Konfigurationsdatei:
runmode:
type : normal
waittime : 300
concurrency : 200
Der Ausführungsmodus constant load unterscheidet sich vom normalen Ausführungsmodus dadurch, dass er eine konstante Anzahl an gestarteten Testausführungen erzeugt statt einer konstanten Zahl an Threads. Sie können die Last über den Ausführungsmodus-Parameter „load“ festlegen.
Der Testauswahlvorgang ist bei beiden Ausführungsmodi gleich und läuft wie folgt ab: Alle Tests verfügen über die Eigenschaft weight
, die die Wahrscheinlichkeit der Ausführung in einem Thread bestimmt. Wenn Sie beispielsweise zwei Tests mit einer Gewichtung von 5 und einer mit einer Gewichtung von 10 haben, ist die Wahrscheinlichkeit, dass Letzterer ausgeführt wird, doppelt so hoch wie der erste.
Außerdem können Tests die Eigenschaft count
aufweisen, die die Anzahl an Ausführungen auf eine bestimmte Zahl einschränkt. Nachdem diese Zahl erreicht wurde, werden keine weiteren Ausführungen des Tests durchgeführt. Alle Testinstanzen, die bereits ausgeführt werden, beenden die Ausführung wie konfiguriert. Das folgende Beispiel zeigt, wie Sie diese Parameter entweder in der Befehlszeile oder mithilfe einer YAML-Konfigurationsdatei hinzufügen.
java -jar toughday2.jar --host=localhost --add CreateAssetTreeTest weight=5 --add CreatePageTreeTest weight=10 count=100 --runmode=normal concurrency=20
oder
- add : CreateAssetTreeTest
properties :
name : UploadAsset
weight : 5
base : 3
foldertitle : IAmAFolder
assettitle : IAmAnAsset
count : 100
Wegen parallel stattfindender Ausführungen entspricht die tatsächliche Anzahl an Testausführungen nicht exakt der Anzahl, die mit dem Parameter count
konfiguriert wurde. Rechnen Sie daher mit einer Abweichung, die proportional zur Anzahl der ausgeführten Threads ausfällt (gesteuert durch den concurrency parameter
).
Ein Trockenlauf analysiert alle angegebenen Eingaben (Befehlszeilenparameter oder Konfigurationsdateien), führt sie mit den Standardwerten zusammen und gibt dann die Ergebnisse aus. Es werden keine der Tests ausgeführt.
java -jar toughday2.jar --host=localhost --suite=toughday --add CreatePageTreeTest --dryrun=true
Tough Day 2 gibt sowohl Testmetriken als auch Protokolle aus. Weitere Informationen finden Sie in den folgenden Abschnitten.
Tough Day 2 meldet derzeit neun Testmetriken, die Sie auswerten können. Mit dem Symbol * gekennzeichnete Metriken werden nur nach erfolgreichen Ausführungen gemeldet:
Name | Beschreibung |
---|---|
Timestamp | Zeitstempel des letzten abgeschlossenen Testlaufs. |
Bestanden | Anzahl erfolgreicher Ausführungen. |
Fehlgeschlagen | Anzahl fehlgeschlagener Ausführungen. |
Min* | Kürzeste Dauer der Testausführung. |
Maximal* | Längste Dauer der Testausführung. |
Median* | Berechnete mittlere Dauer aller Testausführungen. |
Durchschnitt* | Berechnete durchschnittliche Dauer aller Testausführungen. |
StdDev* | Die Standardabweichung. |
90p* | 90 Perzentil. |
99p* | 99 Perzentil. |
99.9p* | 99,9 Perzentil. |
Tatsächlicher Durchsatz* | Anzahl an Ausführungen geteilt durch die verstrichene Ausführungszeit |
Diese Metriken werden mithilfe von Publishern geschrieben, die mit dem Parameter add
hinzugefügt werden können (ähnlich wie beim Hinzufügen von Tests). Aktuell gibt es zwei Optionen:
Standardmäßig werden beide Herausgeber aktiviert.
Außerdem gibt es zwei Modi, in denen die Metriken gemeldet werden:
Das folgende Beispiel zeigt, wie Sie den Parameter intervals
mit der Befehlszeile oder mit einer YAML-Konfigurationsdatei konfigurieren.
Mithilfe von Befehlszeilenparametern:
java -jar toughday2.jar --host=localhost --add CreatePageTreeTest --publishmode type=intervals interval=10s
Verwenden Sie eine YAML-Konfigurationsdatei:
publishmode:
type : intervals
interval : 10s
tests:
-add : CreatePageTreeTest
Tough Day 2 erstellt einen Protokollordner im selben Verzeichnis, in dem Sie Tough Day 2 ausgeführt haben. Dieser Ordner enthält zwei Typen von Protokollen:
Die Protokolle werden nicht überschrieben, nachfolgende Ausführungen hängen Meldungen an die vorhandenen Protokolle an. Für die Protokolle gibt es mehrere Ebenen. Weitere Informationen hierzu finden Sie unter [loglevel parameter](/docs/experience-manager-65/developing/testing/tough-day.md#global-parameters)
.