Een Apache JMeter Load Test uitvoeren vanuit de opdrachtregelmodus (Beginner/Middenniveau)

AaronLopez

Waarom Testplannen uitvoeren vanuit Command-line modus? <\/H1>De belangrijkste reden om een loadtest uit te voeren vanuit Command-line (CLI) modus en niet via de GUI-modus is dat laatstgenoemde de mogelijkheden van JMeter kan verminderen. Het gebruik van de GUI om de test uit te voeren kan extra CPU en geheugen verbruiken, wat een negatieve invloed kan hebben op de testresultaten. De CLI-modus omgeving is de optimale keuze voor het uitvoeren van tests en is de aanbevolen methode door het Apache JMeter-team.<\/P>Een test uitvoeren via een commandovenster is misschien een beetje old school<\/EM>, maar het is nog steeds zeer effectief.<\/P>Controleren van de Pre-Test Checklist<\/H1>Het is een goede testpraktijk om een pre-test checklist te gebruiken om het meest effectieve gebruik van je testtijd te garanderen.<\/P>Aanbevolen checklistitems zijn onder andere:<\/P>Het coördineren van de starttijd en duur van de loadtest met administratief personeelZorgt voor minimale impact van de test op gebruikers en andere collega’s voor de ArcGIS Enterprise Site<\/LI>Helpt voorkomen dat system noise<\/EM> van andere activiteiten en gebruik de testresultaten "vervuilt"<\/LI><\/UL><\/LI>Bij het testen van een traditionele (bijv. dedicated) ArcGIS Service, zorg ervoor dat het minimum en maximum aantal instanties correct zijn ingesteldDit is noodzakelijk als je testdoel is om de maximaal haalbare doorvoer van de service te begrijpenVoor maximale doorvoer is een algemene vuistregel om het maximum aantal instanties in te stellen op het aantal CPU-kernen<\/LI>Voor voorspelbare prestaties stel je het minimum aantal instanties in op het aantal maximum instanties<\/LI><\/UL><\/LI>Het aanpassen van instanties zal ertoe leiden dat een service opnieuw wordt gestart (plan hierop)Het verhogen van het minimum aantal instanties van een service vereist extra fysiek geheugen van de ArcGIS Server-machine<\/LI><\/UL><\/LI><\/UL><\/LI><\/UL><\/span><\/P>Als het Test Plan een Listener bevat zoals View Results Tree, zorg er dan voor dat deze in de GUI is uitgeschakeldActieve Listeners kunnen het verbruik van testclientbronnen verhogen en mogelijk invloed hebben op de test<\/LI><\/UL><\/LI><\/UL><\/span><\/P>Valideer de Thread Group voor stapsgewijze loadlogica en testduurAls de test gepland staat voor een specifiek tijdvenster, zorg er dan voor dat de test wordt ingesteld om de verwachte duur uit te voeren<\/LI><\/UL><\/LI>Zorg ervoor dat het ArcGIS Server Log Level niet is ingesteld op DEBUG of VERBOSE. Hoewel deze logniveaus nuttig kunnen zijn voor probleemoplossing, kunnen ze de prestaties en schaalbaarheid van de geteste service(s) beïnvloeden<\/LI><\/UL><\/LI><\/UL>Batch Script Doorloop<\/H1>Aangezien de command-line wordt gebruikt voor het uitvoeren van de Apache JMeter loadtest, is het voordelig om de acties en voorbereidingen van de omgeving samen te voegen in een batchscript (bijv. *.bat-bestand in Windows). Dit bevordert herhaalbaarheid en onderhoud.<\/P>Variabelen<\/H2>Het gebruik van variabelen is handig om het onderhoud van een script te verbeteren. Hoewel hard-coded waarden technisch gezien prima zijn, kan dit de leesbaarheid belemmeren als paden voor bepaalde items erg lang zijn. De volgende secties bevatten de belangrijkste componenten waarvoor onze batch variabelen zal gebruiken.<\/P>Geheugen<\/H3>Standaard draait Apache JMeter (versie 5.4.1) met minimaal en maximaal 1GB geheugen. Dit is voldoende voor eenvoudige tests die draaien op oudere hardware, maar sommige tests vereisen complexere logica of meerdere databestanden en er kan meer geheugen nodig zijn om ervoor te zorgen dat de testresultaten niet worden beïnvloed.<\/P>Opmerking: Veel loadtests richten zich op het resourcegebruik van de serverhardware. Echter, ook de mogelijkheden van de testclient kunnen een bottleneck vormen die het behalen van testdoelen beperkt.<\/P>Het verhogen van het standaardgeheugen kan eenvoudig met het volgende:<\/P>set heap=-Xms4g -Xmx4g -xyz:MaxMetaspaceSize=256m<\/LI><\/UL>JMeter- en Projectpaden<\/H3>We willen aan het batchscript vertellen waar Apache JMeter en ons Test Plan te vinden zijn.<\/P>Het instellen van het pad naar de JMeter bin-map is eenvoudig:<\/P>set jmeterbin=C:\apache-jmeter-5.4.1\bin<\/LI><\/UL>Evenals de (handmatig aangemaakte) projectmap waar het jmx-bestand (bijv. het Test Plan) zich bevindt:<\/P>set projectdir=C:\JMeter Tests\sampleworldcities3<\/LI><\/UL>Voor wat uitbreidbaarheid wordt een variabele gemaakt voor de naam van het jmx-bestand apart van de projectmap (zonder jmx-extensie en zelfs als ze dezelfde naam gebruiken)<\/P>set testname=sampleworldcities3<\/LI><\/UL>Voor meer gemak wordt een variabele gemaakt die aan elke run wordt toegevoegd. Om meerdere redenen kan een typische loadtest meerdere keren worden uitgevoerd, waarbij elke keer een iets andere optie binnen het Test Plan is ingeschakeld. Dit helpt bij het bijhouden van verschillende runs van dezelfde test.<\/P>set runname=run1<\/LI><\/UL>Testuitvoering en Schakelaars<\/H3>Dankzij het gebruik van bovengenoemde variabelen kan de uitvoering van JMeter met een meegegeven Test Plan als command-line schakelaar gemakkelijk worden bekeken in slechts enkele regels:<\/P>%jmeterbin%\\jmeter -n -f -t "%projectdir%\\%testname%.jmx" ^
-l "%projectdir%\\results\\results_%testname%_%runname%.jtl" ^
-j "%projectdir%\\logs\\debug_%testname%_%runname%.log" ^
-e -o "%projectdir%\\reports\\%testname%_%runname%" ^<\/> <\/> <\/> <\/> <\/> <\/> <\/> <\/> <\/> <\/> <\/> <\/> <\/> <\/> <\/> <\/> <\/> <\/> <\/> <\/> <\/> <\/> <\/> <\/> <\/> < LI >De -n schakelaar laat JMeter draaien in command-line modus< / LI >< LI >De -t "pad_naar_jmx" schakelaar vertelt JMeter waar op het bestandssysteem het jmx-bestand te vinden is.< / LI >< LI >De -l "pad_naar_jtl" schakelaar vertelt JMeter waar samples gelogd moeten worden, dit is het resultatenbestand en het belangrijkste artefact van de testrun. < / LI >< LI >De -j "pad_naar_log" schakelaar geeft aan waar het JMeter run log opgeslagen moet worden (bijv. omgevingsinformatie). De -e schakelaar vertelt JMeter om na afloop van de test een testrapport (dashboard) te genereren.< / LI >< LI >De -o "pad_naar_rapportmap" schakelaar vertelt JMeter waar het rapport (dashboard) gegenereerd moet worden.< / LI >< LI >De -f schakelaar vertelt JMeter om bestaande resultatenbestanden en rapportmappen geforceerd te verwijderen als ze aanwezig zijn voordat de test start. Het wijzigen van de "runname" variabele in het script is de gemakkelijkste manier om ervoor te zorgen dat er bij elke testrun een nieuw resultatenbestand en rapport worden aangemaakt.< / LI >< LI >Het caret-teken of ^ is een "escape" teken en wordt toegevoegd aan het Windows batchscript zodat het volgende teken (nieuwe regel) wordt geïnterpreteerd als een gewoon teken. Dit helpt bij leesbaarheid.< / LI >< / UL >Alles Samenvoegen< P >Het volledige batchscript ziet er als volgt uit:< / P >< P > < / P >< P > < / P >< P > < / P >< P > < / P >< P > < / P >< pre class = "lia-code-sample language-php">< code >echo off
rem Gescripte JMeter Test Plan uitvoering
rem Gebruikmakend van jmeter.bat voor aanroep
rem
rem 2021/06/07.1
rem


rem ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
rem *** Variabelen ***

rem Stel JMeter geheugen in op min/max 4GB (pas aan op basis van je testclientbronnen)
set heap=-Xms4g -Xmx4g -xyz:MaxMetaspaceSize=256m

rem Locatie van %JAVA_HOME%\\bin (momenteel niet gebruikt)
rem set javadir=C:\jdk-16.0.1\bin

rem Locatie Apache JMeter bin
set jmeterbin=C:\apache-jmeter-5.4.1\bin

rem Locatie rootmap JMeter Test Plan (bijv. map waar Test Plan zich bevindt)
set projectdir=C:\JMeter Tests\sampleworldcities3

rem Naam JMeter Test Plan (zonder JMX bestandsextensie)
set testname=sampleworldcities3

rem String toegevoegd aan resultatenbestand bij elke testrun
set runname=run1
rem ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~





echo on
rem *** Test gestart ***
%jmeterbin%\\jmeter -n -f -t "%projectdir%\\%testname%.jmx" ^
-l "%projectdir%\\results\\results_%testname%_%runname%.jtl" ^
-j "%projectdir%\\logs\\debug_%testname%_%runname%.log" ^
-e -o "%projectdir%\\reports\\%testname%_%runname%" ^
rem *** Test voltooid ***
echo off< / code >< / pre >< P > < / P >< P > < / P >< P > < / P >< P > < / P >< P > < / P >< H1 id = "toc-hId--1217181122">Loadtest Uitvoeren< P >Voor je eerste runs wordt aanbevolen om deze uit te voeren vanuit een reeds geopend commandovenster. Op deze manier blijven eventuele directe problemen bij het aanroepen van commando’s in het batchscript zichtbaar op scherm zodat ze gemakkelijker kunnen worden gecorrigeerd (bijv. typefout).< / P >< UL >< LI >In Windows kun je een Command Prompt venster openen door Start te klikken en cmd te typen.< UL class = "lia-list-style-type-circle">< LI >Zodra dit venster verschijnt, voer je het pad naar je batchscript in:< UL class = "lia-list-style-type-square">< LI >"C:\JMeter Tests\sampleworldcities3\runMe.bat", druk op Enter< UL class = "lia-list-style-type-square">< LI >Het script draait gedurende de geconfigureerde duur en keert dan terug naar prompt.< / LI >< / UL >< / LI >< / UL >< / LI >< / UL >< / LI >< / UL >< P >< span class = "lia-inline-image-display-wrapper lia-image-align-inline" image-alt = "batfile_execution.png" style = "width: 979px;">< img src = "https:\/\/us.v-cdn.net\/6038851\/uploads\/images\/15370iC0611A307C75DA4B/batfile_execution.png" role = "button" title = "batfile_execution.png" alt = "batfile_execution.png" \/></ span >< / P >< P >Uitvoeren vanuit command-line modus doet niet voorzie de console van realtime statistieken van de testuitvoering. Dergelijke functionaliteit kan worden verkregen maar wordt niet behandeld in dit Artikel.<\/P>Test Artefacten<\/H1>Test artefacten zijn items die zijn gemaakt tijdens de load test en kunnen worden gebruikt voor analyse. Items zoals rapporten en de JMeter Text Logs (JTL) bestanden die de ruwe testresultaten bevatten, zijn doorgaans het belangrijkst om te bewaren. Het runlogboek kan ook nuttig zijn omdat de lijst kan worden gebruikt om het geconfigureerde geheugen van de omgeving voor de testrun te bevestigen, evenals updates over welke stap werd uitgevoerd en wanneer. Na meerdere runs van dezelfde test, waarbij een andere runnaam in het script werd gebruikt, is het gemakkelijk om veel jtl-bestanden en rapportmappen te hebben. Dit is waar het volgen van de teststrategie om een projectmap voor beheer te gebruiken cruciaal is.<\/P>Opmerking: Het rapport dat door JMeter wordt gegenereerd is gebaseerd op HTML en JavaScript. Als sommige onderdelen van het rapport leeg zijn of niet lijken te laden, probeer dan de beveiligingsinstellingen van de browser aan te passen of open het in een andere browser, indien beschikbaar.<\/STRONG><\/FONT><\/P>De initiële pagina en sectie Responstijden in de loop van de tijd van een door JMeter gegenereerd rapport<\/FONT><\/LI><\/UL><\/span><\/P><\/span><\/P>Om het Apache JMeter Test Plan te downloaden dat in dit Artikel wordt gebruikt, zie: <\/SPAN>sampleworldcities3.zip<\/A><\/P>

Deze test vereist dat de Custom Thread Groups plugin in JMeter is geïnstalleerd.<\/P>

Voorbereiden op Analyse<\/SPAN><\/H1>Het gegenereerde rapport is een van de beste startpunten voor het uitvoeren van analyse om te bepalen of de testdoelen zijn bereikt. <\/SPAN>Aangezien deze analyse van een load test een uitgebreid proces kan zijn dat het waard is om in detail te bespreken, verdient het een eigen Artikel.<\/SPAN><\/P>Voor een reeks aanvullende test tutorials (met toenemende complexiteit), zie: <\/SPAN>Performance Engineering: Load Testing ArcGIS Enterprise<\/A> <\/SPAN><\/P> <\/P> <\/P>Apache JMeter<\/A> uitgebracht onder de Apache<\/A> License 2.0.<\/A> Apache, Apache JMeter, JMeter, de Apache veer en het Apache JMeter logo zijn handelsmerken van de Apache Software Foundation.<\/SPAN><\/P>

 <\/P>