Versionen im Vergleich

Alte Version 3

changes.mady.by.user Benjamin Albanese

Gespeichert am

verglichen mit

Neue Version 4

changes.mady.by.user Benjamin Albanese

Gespeichert am

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.
Kommentar: zurückgeholt von v. 2

⯇ Vorheriges Tutorial

Nächstes Tutorial ⯈

Im ersten Tutorial beginnen wir mit der Einrichtung unseres Projekts. Am Ende dieses Teils haben wir das Projekt vollständig aufgesetzt und sind bereit, den ersten Test zu schreiben. In den folgenden Tutorials definieren wir dann verschiedene Szenarien, um unsere Beispielintegration aus Getting Started - jadice web toolkit hinsichtlich seiner Performance zu testen.

Info

Wir empfehlen den Code bereits vor der Durchführung des Tutorials hier herunterzuladen.

Gatling

Gatling ist ein Framework, das in der Lage ist, komplexes Nutzerverhalten nachzustellen und zu simulieren. Die während des Performancetests gesammelten Daten werden aufbereitet und in übersichtlicher Form als HTML-Datei bereitgestellt. Tests innerhalb von Gatling werden in der Programmiersprache Scala geschrieben.

Begriffe

Bevor wir uns den ersten Tests zuwenden, machen wir uns mit den in diesem Tutorial Gatling genutzten Begriffen vertraut:

  • Szenario
    Ein Szenario beschreibt eine Abfolge von Interaktionen des Nutzers mit der Anwendung. Bspw. könnte ein Szenario folgendermaßen aussehen:
    1. Nutzer authentifiziert sich
    2. Nutzer ruft Dokument auf
    3. Nutzer scrollt 3 Seiten nach unten
    4. Nutzer exportiert das Dokument als PDF
  • User
    In einer realen Umgebung wird die Anwendung nicht nur von einer Person genutzt, sondern von mehreren auf einmal. Unter JMeter Gatling ist es ebenfalls möglich, mehrere Nutzer gleichzeitig oder zeitlich versetzt auf die Anwendung zugreifen zu lassen, indem zufällig erzeugte client Ids verwendet werden.
  • Verbindungsmethode
    Für aussagekräftige Tests sollte idealerweise die Verbindungsmethode die Verbindungsmethode gewählt werden, welche bei Ihrer jadice web toolkit Implementierung standardmäßig aktiviert ist. Zur  Zur Auswahl stehen hierbei:
    • Longpoll
    • Server-Sent Events
    • WebSockets

Der wesentliche Teil der Last, die auf dem Server erzeugt wird, entsteht allerdings durch das Tile Rendering, sprich das Erzeugen der Bilddaten, die auf dem Client nachher für die Darstellung einer Seite oder eines Thumbnails verwendet werden. Dieses ist komplett unabhängig von der Verbindungsmethode, da für das Tile Rendering ein separates Servlet zur Verfügung steht, was durch ein simples HTTP GET vom Client angesprochen wird.

  • Thread Group
In JMeter wird mit ThreadGroups gearbeitet, die eine einstellbare Anzahl von Threads erzeugt, die wir in diesem Szenario nutzen, um verschiedene User zu simulieren, die alle das gleiche Szenario abarbeiten. In einer zweiten ThreadGroup werden wir dann zum Schluß überprüfen, ob die erzeugten Metriken der Erwartung entsprechen.
  • SetUp
    Über die setUp-Methode wird das Szenario vorkonfiguriert. Hier wird unter anderem die Nutzeranzahl eingestellt.

Projektstruktur

Für den Anfang erstellen wir ein neues Mavenprojekt mit folgender Projektstruktur:


Codeblock
languagexml
themeRDark
titleVerzeichnisstruktur
├── pom.xml
├── src/test/jmeterresources/ 
│   ├── bodies					- Wie der Name vermuten lässt, werden wir hier Request- Datei für die .jmx Datei, die den jmeter Testplan definiert
├──bodies ablegen. 
│   └── data					- Hier legen wir sonstige benötigte Daten ab
└── src/test/resourcesscala/
		- Anleitung falls die Performancetests per└── Micrometerorg/Prometheus/Grafana überwacht werden sollen.

Maven

Im Wesentlichen besteht dieses Maven Submodule aus einem Plugin, das in ein Maven-Profil gewickelt ist, und bei Bedarf die Tests ausführt. Dazu werden nach dem Testlauf im target Verzeichnis die Ergebnisse vorhanden sein. Bei Fehlern wird der Build abbrechen, sodass weitere Submodule nach diesem nicht mehr ausgeführt werden.

Der Testlauf lässt sich mit folgendem Befehl ausführen:

Codeblock
languagejava
mvn -P webtoolkit-jmeter verifyjwt/performance		- Hier landen unsere Scala-Tests

Maven

In den properties der pom.xml konfigurieren wir die aktuellen Gatling-Versionen:

Codeblock
languagexml
themeRDark
titlepom.xml - properties
<gatling.version>3.3.1</gatling.version>
<gatling-plugin.version>3.0.5</gatling-plugin.version>


Die benötigten dependencies sind folgende:

Codeblock
languagexml
themeRDark
titlepom.xml - dependency
<dependency>
      <groupId>io.gatling.highcharts</groupId>
      <artifactId>gatling-charts-highcharts</artifactId>
      <version>${gatling.version}</version>
      <scope>test</scope>
</dependency>


Außerdem benötigen wir noch das Gatling-Maven-Plugin. Es ermöglicht die Ausführung von Gatling aus Maven heraus. Hier konfigurieren wir auch unsere oben erstellten Verzeichnisse:

Codeblock
languagexml
themeRDark
titlepom.xml - Gatling-Maven-Plugin
<profiles>
		<profile>
			<id>webtoolkit-jmeter</id>
			<activation>
				<activeByDefault>false</activeByDefault>
			</activation>
			<build>
				<plugins>
					<plugin>
						<groupId>com.lazerycode.jmeter</groupId>
						<artifactId>jmeter<plugin>
     <groupId>io.gatling</groupId>
     <artifactId>gatling-maven-plugin</artifactId>
						<version>3.6.0</version>
						<executions>
							<!-- Generate JMeter configuration -->
							<execution>
								<id>configuration</id>
								<goals>
									<goal>configure</goal>
								</goals>
							</execution>
							<!-- Run JMeter tests -->
							<execution>
								<id>jmeter-tests</id>
								<goals>
									<goal>jmeter</goal>
								</goals>
							</execution>
							<!-- Fail build on errors in test -->
							<execution>
								<id>jmeter-check-results</id>
								<goals>
									<goal>results</goal>
								</goals>
							</execution>
						</executions>
					</plugin>
				</plugins>
			</build>
		</profile>
	</profiles>  
     <version>${gatling-plugin.version}</version>
     <configuration>
           <configFolder>${project.basedir}/src/test/resources</configFolder>
           <dataFolder>${project.basedir}/src/test/resources/data</dataFolder>
           <requestBodiesFolder>${project.basedir}/src/test/resources/bodies</requestBodiesFolder>
           <simulationsFolder>${project.basedir}/src/test/scala</simulationsFolder>
           <resultsFolder>${project.build.directory}/reports/gatling</resultsFolder>
           <runMultipleSimulations>true</runMultipleSimulations>
     </configuration>
</plugin>


Unsere vollständige pom.xml sieht folgendermaßen aus:

Codeblock
languagexml
themeRDark
titlepom.xml - vollständig
collapsetrue
<project xmlns="http://maven.apache.org/POM/4.0.0"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

	<modelVersion>4.0.0</modelVersion>
	<artifactId>jwt-tutorial-performancetest</artifactId>
	<name>jwt-tutorial-performancetest</name>
	<description>Getting Started with Jadice Web Toolkit performancetest</description>
	<url>https://levigo.de/info/x/O4C-BQ</url>
	<packaging>jar</packaging>

	<parent>
		<artifactId>jwt-tutorial</artifactId>
		<groupId>org.jwt</groupId>
		<version>5.1110.1752.4<2</version>
	</parent>

	<profiles><properties>
		<profile><gatling.version>3.3.1</gatling.version>
			<id>webtoolkit-jmeter</id>
			<activation>
				<activeByDefault>false</activeByDefault>
			</activation>
			<build>
				<plugins>
					<plugin>
						<groupId>com.lazerycode.jmeter<<gatling-plugin.version>3.0.5</gatling-plugin.version>
	</properties>

	<dependencies>
		<dependency>
			<groupId>io.gatling.highcharts</groupId>
						<artifactId>jmeter-maven-plugin<<artifactId>gatling-charts-highcharts</artifactId>
						<version>3.6.0<<version>${gatling.version}</version>
						<executions>
	<scope>test</scope>
						<!-- Generate JMeter configuration -->
							<execution>
								<id>configuration</id>
								<goals>
									<goal>configure</goal>
								</goals></dependency>
	</dependencies>

	<build>
		<plugins>
			<plugin>
							</execution><groupId>io.gatling</groupId>
							<!<artifactId>gatling-maven- Run JMeter tests -->
plugin</artifactId>
							<execution>
								<id>jmeter-tests</id><version>${gatling-plugin.version}</version>
								<goals><configuration>
									<goal>jmeter</goal><configFolder>${project.basedir}/src/test/resources</configFolder>
								</goals><dataFolder>${project.basedir}/src/test/resources/data</dataFolder>
							</execution><bodiesFolder>${project.basedir}/src/test/resources/bodies</bodiesFolder>
							<!-- Fail build on errors in test --><simulationsFolder>${project.basedir}/src/test/scala</simulationsFolder>
							<execution>
								<id>jmeter-check-results</id>
								<goals>
									<goal>results</goal>
								</goals><resultsFolder>${project.build.directory}/reports/gatling</resultsFolder>
							<<runMultipleSimulations>true</execution>runMultipleSimulations>
						</executions>configuration>
					</plugin>
				</plugins>
			</build>
		</profile>
	</profiles>
</project>


Tutorials

Code

Dokumentation und Links