Apache JMeter

Transkript

1 Apache JMeter Ausarbeitung von: Oliver Zink Matrikel-Nr.: Apache JMeter 1

2 Inhalt Allgemeines Installation» Systemvoraussetzungen» Kompilieren des Source-Code Inbetriebnahme» Skript-Datei» Kommandozeile» jmeter.properties Betrieb» SamplerController» Delay» ThreadGroups» Visualizer Apache JMeter 2

3 Allgemeines Apache JMeter ist eine Java-Anwendung, mit der die Performance von Web-Anwendungen bzw. deren statischen oder dynamischen Ressourcen (z.b. HTML-Dateien, CGI-Programme, Servlets, Perl-Skripts und DB s) getestet werden kann. Die generierte Anfragen (HTTPSamples) können gespeichert und bei Bedarf wiederverwendet werden. Apache JMeter bietet verschiedene Darstellungsmöglichkeiten der Performance-Messungen. Es stehen grafische und textbasierte Auswertungen zur Verfügung. Entpacken der Datei ApacheJMeter_1.5.1.tar.gz gunzip ApacheJMeter_1.5.1.tar.gz tar -xvf ApacheJMeter.tar Apache JMeter 3

4 Installation Systemvoraussetzungen» Java JRE: ab Java 1.2» Java JFC: Swing-Komponenten (javax.swing) ab Java 1.2» Java Compiler [optional]: Nur notwendig, wenn die Source-Dateien kompiliert werden sollen, da ein kompiliertes Java-Archiv mitgeliefert wird.» SAX 1.0 XML Parser [optional]: Notwendig für das Speichern und Laden von HTTPSamples oder die Kompilierung der Source-Dateien. Der Xerces-Parser von Apache wird standardmäßig mitgeliefert.» Java Mail & javax.activation [optional]: Notwendig für den MailVisualizer oder die Kompilierung der Source-Dateien.» JSSE [optional]: Für Anfragen über das HTTPS-Protokoll. Apache JMeter 4

5 Installation Kompilieren des Source-Code» Ant verwenden: Voraussetzung Ant ist installiert. In das jmeter-verzeichnis wechseln und ant install aufrufen.» Makefile verwenden: Voraussetzung javac und javadoc sind installiert. In das jmeter/src-verzeichnis wechseln und make aufrufen. (im makefile ist der Pfad zu Javadoc anzupassen JAVADOC=/usr/local/jdk1.2/bin/javadoc )» Über die Kommandozeile: jmeter/src/temp-verzeichnis anlegen. In das jmeter/src-verzeichnis wechseln und javac -d./temp./org/apache/jmeter/timers/*.java./org/apache/jmeter/visualizers/*.java./org/apache/jmeter/samplers/*.java./org/apache/jmeter/*.java aufrufen. Ressourcen mit cp./org/apache/jmeter/images/*./temp/org/apache/jmeter/images/* und cp./org/apache/jmeter/*.properties./temp/org/apache/jmeter/*.properties kopieren. Jar-Archiv mit jar -cmf0./manifest../bin/apachejmeter.jar./temp erzeugen. API-Dokumentation mit javadoc -d../docs/api org.apache.jmeter org.apache.jmeter.timers org.apache.jmeter.visualizers org.apache.jmeter.samplers erzeugen. Apache JMeter 5

6 Inbetriebnahme Skript-Datei» Voraussetzung: ApacheJMeter.jar und jmeter.properties sind im jmeter/bin-verzeichnis vorhanden und der CLASSPATH enthält die benötigten jar-dateien. (ApacheJMeter.jar, [xerces.jar oder jaxp.jar und parser.jar], [mail.jar, activation.jar], [jcert.jar, jnet.jar, jsse.jar]) In das jmeter/bin-verzeichnis wechseln und jmeter [-h proxyhost] [-p proxyport] [-f property-file] aufrufen.! Fehler in der Skript-Datei (UNIX): java -classpath $CLASSPATH:`dirname $0`/../lib/xerces.jar:`dirname $0`/ApacheJMeter.jar $JAVA_PROPS org.apache.jmeter.driver $PROPERTIES (vergl. jmeter.bat) Kommandozeile» Die Voraussetzungen sind die gleichen, wie beim starten per Skript-Datei. In das jmeter/bin-verzeichnis wechseln und java -classpath $CLASSPATH:ApacheJMeter.jar [-DhttpProxyHost= proxyhost] [-Dhttp.ProxyPort=proxyPort ] org.apache.jmeter.driver jmeter.properties aufrufen. Apache JMeter 6

7 Inbetriebnahme jmeter.properties» In dieser Datei sind skalierbare Konfigurationseinstellungen der Anwendung enthalten» threads.start=10 threads.max=20 bestimmen die Maximale und Default Anzahl der Threads einer ThreadGroup» startup.controller=org.apache.jmeter.protocol.http.control.simplehttpcontroller bestimmt den Default SamplerController» xml.parser=org.apache.xerces.parsers.saxparser bestimmt den verwendeten SAXParser» ssl.provider=com.sun.net.ssl.provider (default ssl.provider=none) falls HTTPS-Anfragen ausgeführt werden sollen (JSSE - Java Secure Socket Extension)» cookies=cookies bestimmt die Cookie-Datei die den Netscape-Konventionen entspricht authorization=authorization bestimmt die Authentifizierungs-Datei die bei einem Web-Server Login verwendet wird Format: URL \tuser\tpassword Apache JMeter 7

8 Betrieb SamplerController (Simple HTTP Tester)» Mit diesem SamplerController können einfache GET-Anfragen an eine URL gesendet werden.» Auf dem Run-Panel ist noch ein gewünschter Visualizer auszuwählen (alle SamplerController)» Start (alle SamplerController): Über das Menu Run+Start oder mit Crtl -s werden die Anfragen gestartet.» Stop (alle SamplerController): Die Anfragen können über das Menu Run+Stop oder mit Crtl -. beendet werden. Apache JMeter 8

9 Betrieb SamplerController (Advanced HTTP Tester)» Mit diesem SamplerController können skalierbare Anfragen an eine URL erstellt werden.» Werden Cookies zugelassen können Cookies erzeugt, gespeichert und zur Anfrage gesendet werden. Beim Start von ApacheJMeter kann eine Netscape Cookie-Datei geladen werden die in jmeter.properties angegeben wird» Wird die Authentifizierung zugelassen können diese Informationen verwaltet werden und zum entsprechenden Test Sample an den Web-Server (URL) gesendet werden.» Test Samples für URL s können erstellt werden und wenn ein SAX XML Parser eingebunden wurde auch gespeichert und geladen werden Apache JMeter 9

10 Betrieb WebPage Test Sample» Bei einem Test Sample wird die Anfrage-Methode und die URL angegeben.» Falls eine Authentifikation bei einer Anfrage nötig ist muss Hit URL once only gewählt werden, damit nur ein Login ausgeführt wird» Die Interleave-Option ist nur wichtig bei Parametern mit mehreren Value-Werten. JMeter generiert hieraus verschiedene Anfragen mit kombinationen der Value-Werte» Die Parameter für eine Anfrage können einfach hinzugefügt werden (Enter-Taste nach der Eingabe des Value-Wertes)» Mehere Value-Werte sind in Anführungszeichen und commasepareted zu speichern Apache JMeter 10

11 Betrieb SamplerController (JDBC Base Sampler)» Mit diesem SamplerController können SQL-Query s an eine Datenbank gesendet werden» Falls für die Datenbank ein Benutzername und Passwort nötig ist, können diese hier angegeben werden» Die URL zur Datenbank wird unter Connect String und der benötigte Datenbanktreiber unter Driver eingegeben» Der zur Datenbank gesendete SQL-Query wird in dem Eingabefeld Query angegeben Apache JMeter 11

12 Delay Delay» Bestimmt die Verzögerung in jedem Anfrage -Thread. durchschnittliche Verzögerungen mit Abweichungen in Millisekunden konstante Verzögerungen in Millisekunden» Delay-Module (Timers) adds a random delay with an uniform distribution (zufällige Verzögerung mit einer konstanten Verteilung) adds a random delay with an gaussian distribution (zufällige Verzögerung mit einer Gaußchen Verteilung) adds a constant delay between sampling (konstante Verzögerung zwischen den Anfragen) Apache JMeter 12

13 Thread Groups Thread Groups» JMeter startet mit einer Thread Group. Um eine weitere Thread Group hinzuzufügen ist nur ein neuer Thread Group Name einzugeben und die Enter-Taste zu betätigen.» Für jede Thread Group kann eine Anzahl von Threads gewählt werden. Die maximale Anzahl ist in der Datei jmeter.properties festgelegt. Das eigentliche Limit an Threads wird von dem Betriebssystem bestimmt.» Für jede Thread Group kann eine anderer Visualizer gewählt werden. Apache JMeter 13

14 Visualizer Visualizer» Die Visualizer stellen die Zeitabläufe der Anfragen grafisch oder textbasiert dar.» File Visualizer Datei öffnen bzw. anlegen, Open -Button betätigen und mit den Anfragen beginnen. Die Anfragen stoppen und den Close -Button betätigen. Zur Analyse kann die Datei mit JMeter über das Menu Reprt grafisch analysiert werden.» Notification Visualizer Sendet eine an eine oder mehrere Adressen falls eine URL-Anfrage fehlschlägt bzw. wieder antwortet. Apache JMeter 14

15 Visualizer Visualizer» Text Result Visualizer Zeigt die angefragte HTML-Seite als Text an. Nach jeder Anfrage wird gestoppt um die Anfrage zu analysieren. Mit dem Continue -Button wird dann eine weiter Anfrage gesendet» Grafische Visualizer Die grafischen Visualizer stellen auf der Y- Achse die Zeit der Anfragen und auf der X- Achse die Anfragen dar. Apache JMeter 15

16 Quellen Quellen» ApacheJMeter: Xerces (xerces.jar): JAXP (jaxp.jar & parser.jar): JavaMail (mail.jar): javax.activation (activation.jar): JSSE (jcert.jar & jnet.jar & jsse.jar): Apache JMeter 16