Tålig dag tough-day
Vad är Tom Dag 2? what-is-tough-day
"Tough Day 2" är ett program som gör att du kan stresstesta gränserna för din AEM. Den kan köras direkt med testsviten eller konfigureras för att passa dina testbehov. Du kan titta på den här inspelningen om du vill se en presentation av programmet.
Köra tuff dag 2 how-to-run-tough-day
Hämta den senaste versionen av Tough Day 2 från Adobe-databasen. När du har hämtat programmet kan du köra det direkt genom att ange parametern host
. I följande exempel körs den AEM instansen lokalt så att värdet localhost
används:
java -jar toughday2.jar --host=localhost
Standardsviten som körs när parametrarna har lagts till heter toughday
. Det innehåller följande användningsfall:
- Skapa sidor och live-kopior för dem (inklusive rollouts)
- Hämta hemsida
- Köra frågor i Query Builder
- Skapa resurshierarkier
- Ta bort resurser
Paketet innehåller 15 % skrivåtgärder och 85 % läsåtgärder.
För att köra testerna av sviten installerar Tough Day 2 standardinnehållspaketet. Detta kan undvikas genom att ställa in parametern installsamplecontent
på false
, men kom ihåg att du också bör ändra standardsökvägarna för de tester som du tänker köra. Om burken körs utan parametrar visas hjälpinformationen för Tough Day 2.
Du kan använda programmet enligt följande mönster:
java -jar toughday2.jar [--help | --help_full | --help_tests | --help_publish] [<global arguments> | <actions> | --runmode | --publishmode]
Få hjälp getting-help
Dag 2 erbjuder en mängd hjälpalternativ som du kan komma åt från kommandoraden. Till exempel:
java -jar toughday2.jar --help_full
I tabellen nedan hittar du relevanta hjälpparametrar.
Globala parametrar global-parameters
Tough Day 2 erbjuder globala parametrar som ställer in eller ändrar miljön för testerna. Bland dessa finns målvärden, portnummer, protokoll, användare och lösenord för instansen och många andra. Till exempel:
java -jar toughday2.jar --host=host --protocol=https --port=4502 --duration=30m --dryrun=true
Du hittar de relevanta parametrarna i listan nedan:
--installsamplecontent=<Val>
--protocol=<Val>
--host=<Val>
--port=<Val>
--user=<Val>
--password=<Val>
--duration=<Val>
--timeout=<Val>
--suite=<Val>
--configfile=<Val>
--contextpath=<Val>
--loglevel=<Val>
--dryrun=<Val>
Anpassa customizing
Anpassningen kan göras på två sätt: kommandoradsparametrar eller dynamiska konfigurationsfiler. Konfigurationsfiler används för stora anpassade programsviter och de åsidosätter standardparametrarna för Tough Day 2. Kommandoradsparametrar åsidosätter både konfigurationsfiler och standardparametrar.
Det enda sättet att spara en testkonfiguration är att kopiera den i yaml-format.
Lägga till ett nytt test adding-a-new-test
Om du inte vill använda standardsviten toughday
kan du lägga till ett test som du väljer med parametern add
. I exemplen nedan visas hur du lägger till CreateAssetTreeTest
-testet antingen med kommandoradsparametrar eller en gul konfigurationsfil.
Genom att använda kommandoradsparametrar:
java -jar toughday2.jar --host=localhost --add CreateAssetTreeTest
Genom att använda en dynamisk konfigurationsfil:
globals:
host : localhost
tests:
- add : CreateAssetTreeTest
Lägga till flera instanser av samma test adding-multiple-instances-of-the-same-test
Du kan också lägga till och köra flera instanser av samma test, men varje instans måste ha ett unikt namn. I exemplen nedan visas hur du lägger till två instanser av samma test med antingen kommandoradsparametrar eller en gul konfigurationsfil.
Genom att använda kommandoradsparametrar:
java -jar toughday2.jar --host=localhost --add CreateAssetTreeTest name=FirstAssetTree --add CreateAssetTreeTest name=SecondAssetTree
Genom att använda en dynamisk konfigurationsfil:
globals:
host : localhost
tests:
- add : CreateAssetTreeTest
properties:
name : FirstAssetTree
- add : CreateAssetTreeTest
properties:
name : SecondAssetTree
Ändra testegenskaper changing-the-test-properties
Om du behöver ändra en eller flera av testegenskaperna kan du lägga till den egenskapen på kommandoraden eller i yaml-konfigurationsfilen. Om du vill visa alla tillgängliga testegenskaper lägger du till parametern --help <TestClass/PublisherClass>
på kommandoraden, till exempel:
java -jar toughday2.jar --help CreatePageTreeTest
Kom ihåg att standardparametrarna Tough Day 2 skrivs över av standardkonfigurationsfilerna och kommandoradsparametrarna åsidosätter både konfigurationsfilerna och standardvärdena.
I exemplen nedan visas hur du ändrar egenskapen template
för testet CreatePageTreeTest
antingen med kommandoradsparametrar eller en gul konfigurationsfil.
Genom att använda kommandoradsparametrar:
java -jar toughday2.jar --host=localhost --add CreatePageTreeTest template=/conf/toughday-templates/settings/wcm/templates/toughday-template
Genom att använda en dynamisk konfigurationsfil:
globals:
host : localhost
tests:
- add : CreatePageTreeTest
properties:
template : /conf/toughday-templates/settings/wcm/templates/toughday-template
Arbeta med fördefinierade testsviter working-with-predefined-test-suites
I exemplen nedan visas hur du lägger till ett test i en fördefinierad svit och hur du konfigurerar om och exkluderar ett befintligt test från en fördefinierad svit.
Du kan lägga till ett nytt test i en fördefinierad svit med parametern add
och ange den fördefinierade målsviten.
Genom att använda kommandoradsparametrar:
java -jar toughday2.jar --host=localhost --suite=toughday --add CreatePageTreeTest
Genom att använda en dynamisk konfigurationsfil:
globals:
host : localhost
suite : toughday
tests:
- add : CreatePageTreeTest
Befintliga tester i en given programsvit kan även konfigureras om med parametern config
* *. Ange också Suite-namnet och testets faktiska namn (inte testklassens namn). Du hittar testnamnet i egenskapen name
i testklassen. Mer information om hur du söker efter testegenskaper finns i avsnittet Ändra testegenskaper.
I exemplet nedan ändras standardresurstiteln för CreatePageTreeTest
(med namnet UploadAsset
) till NewAsset.
Genom att använda kommandoradsparametrar:
java -jar toughday2.jar --host=localhost --suite=toughday --config UploadAsset title=NewAsset
Genom att använda en dynamisk konfigurationsfil:
globals:
host : localhost
suite : toughday
tests:
- config : UploadAsset
properties :
title : NewAsset
Du kan också ta bort test från fördefinierade sviter eller utgivare från standardkonfigurationen med hjälp av parametern exclude
. Ange också namnet på sviten och det faktiska namnet på testet (inte namnet på Test C lass
). Du kan hitta testnamnet i egenskapen name
i testklassen. I exemplet nedan tas testet CreatePageTreeTest
(med namnet UploadAsset
) bort från toughday-sviten.
Genom att använda kommandoradsparametrar:
java -jar toughday2.jar --host=localhost --suite=toughday --exclude UploadAsset
Genom att använda en dynamisk konfigurationsfil:
globals:
host : localhost
suite : toughday
tests:
- exclude : UploadAsset
Körningslägen run-modes
Dag 2 kan köras i något av följande lägen: normal och konstant belastning.
Körningsläget normal har två parametrar:
-
concurrency
- samtidighet representerar antalet trådar som Tough Day 2 skapar för testkörning. På dessa trådar kommer tester att utföras tills antingen varaktigheten är slut eller tills det inte finns fler tester att köra. -
waittime
- väntetiden mellan två på varandra följande testkörningar i samma tråd. Värdet måste anges i millisekunder.
I exemplet nedan visas hur du lägger till parametrar med kommandoraden:
java -jar toughday2.jar --host=localhost --add CreateAssetTreeTest --runmode=normal concurrency=20
eller genom att använda en dynamisk konfigurationsfil:
runmode:
type : normal
waittime : 300
concurrency : 200
Det konstanta load-körningsläget skiljer sig från det normala körningsläget genom att generera ett konstant antal startade testkörningar i stället för ett konstant antal trådar. Du kan ställa in inläsningen med parametern för körningsläge med samma namn.
Testa val test-selection
Testmarkeringsprocessen är densamma för båda körningslägena och den ser ut så här: alla tester har en weight
-egenskap som avgör sannolikheten för körning i en tråd. Om du till exempel har två tester, ett med en vikt på 5 och det andra med en vikt på 10, är det två gånger mer troligt att det senare utförs än det första.
Dessutom kan tester ha en count
-egenskap, vilket begränsar antalet körningar till ett visst antal. När detta antal har passerats kommer inga fler testkörningar att utföras. Alla testinstanser som redan körs kommer att slutföra körningen enligt konfigurationen. I följande exempel visas hur du lägger till de här parametrarna antingen på kommandoraden eller med hjälp av en dynamisk konfigurationsfil.
java -jar toughday2.jar --host=localhost --add CreateAssetTreeTest weight=5 --add CreatePageTreeTest weight=10 count=100 --runmode=normal concurrency=20
eller
- add : CreateAssetTreeTest
properties :
name : UploadAsset
weight : 5
base : 3
foldertitle : IAmAFolder
assettitle : IAmAnAsset
count : 100
count
. Förväntade en avvikelse i proportion till antalet pågående trådar (styrs av concurrency parameter
).Torr körning dry-run
En torr körning tolkar alla angivna indata (kommandoradsparametrar eller konfigurationsfiler), sammanfogar dem med standardvärdena och returnerar sedan resultatet. Den utför inte något av testerna.
java -jar toughday2.jar --host=localhost --suite=toughday --add CreatePageTreeTest --dryrun=true
Utdata output
Tough Day 2 outputs both test metrics and logs. Mer information finns i följande avsnitt.
Testmått test-metrics
Tuff dag 2 rapporterar för närvarande nio testvärden som du kan utvärdera. Mätvärden med symbolen * rapporteras endast efter lyckade körningar:
Dessa mått skrivs med hjälp av utgivare som kan läggas till med parametern add
(på samma sätt som när du lägger till tester). Det finns för närvarande två alternativ:
- CSVPublisher - utdata är en CSV-fil.
- ConsolePublisher - utdata visas i konsolen.
Som standard är båda utgivare aktiverade.
Det finns också två lägen där mätvärdena rapporteras:
- Publiceringsläget simple - rapporterar resultatet från körningens början till publiceringspunkten.
- Publiceringsläget interval - rapporterar resultatet i en given tidsram. Du kan ställa in tidsbildrutan med parametern interval för publiceringsläge.
I följande exempel visas hur du konfigurerar parametern intervals
antingen på kommandoraden eller genom att använda en dynamisk konfigurationsfil.
Genom att använda kommandoradsparametrar:
java -jar toughday2.jar --host=localhost --add CreatePageTreeTest --publishmode type=intervals interval=10s
Genom att använda en dynamisk konfigurationsfil:
publishmode:
type : intervals
interval : 10s
tests:
-add : CreatePageTreeTest
Loggning logging
Tough Day 2 skapar en loggmapp i samma katalog som du körde Tough Day 2. Den här mappen innehåller två typer av loggar:
- toughday.log: innehåller meddelanden som rör programtillståndet, felsökningsinformation och globala meddelanden.
- toughday_<testname>.log: meddelanden som är relaterade till det angivna testet.
Loggarna skrivs inte över, efterföljande körningar lägger till meddelanden i de befintliga loggarna. Loggarna har flera nivåer. Mer information finns i parametern loglevel..