Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vdaburon/elastic-apm-jmeter-plugin
A JMeter plugin to integrate the Elastic APM into JMeter script
https://github.com/vdaburon/elastic-apm-jmeter-plugin
apm elastic-apm elasticsearch elasticsearch-apm jmeter jmeter-plugin jmeter-plugins monitoringx
Last synced: about 18 hours ago
JSON representation
A JMeter plugin to integrate the Elastic APM into JMeter script
- Host: GitHub
- URL: https://github.com/vdaburon/elastic-apm-jmeter-plugin
- Owner: vdaburon
- Created: 2024-01-29T17:30:09.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-01-14T13:12:04.000Z (10 days ago)
- Last Synced: 2025-01-14T14:23:06.594Z (10 days ago)
- Topics: apm, elastic-apm, elasticsearch, elasticsearch-apm, jmeter, jmeter-plugin, jmeter-plugins, monitoringx
- Language: Java
- Homepage:
- Size: 224 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Apache JMeter tool plugin to Manage the integration of Elastic Application Performance Monitoring in a JMeter script.
Link to github project elastic-apm-jmeter-plugin
# Apache JMeter tool plugin to manage the Elastic Application Performance Monitoring (ELASTIC APM) in JMeter script
An article "Why and How To Integrate Elastic APM in Apache JMeter" about this plugin and some advices:
https://dzone.com/articles/integrating-elastic-apm-in-apache-jmeter
## GUI interface in the JMeter Tools Menu
This tool is present in the Menu Tools > vdn@github - ELASTIC APM Integration Tool
When you click and the menu line "ELASTIC APM Integration Tool", the tool GUI is display
### Parameters
Parameters are :
* file_in the JMeter script to read
* file_out the file result, if the text field is empty then the file_out is the file name of file_in without the extension with suffix "_modif.jmx"
e.g. file_in = script1.jmx, file_out is empty then file_out will be script1_modif.jmx
* action = ADD or REMOVE,
* ADD = Add "User Defined Variables for ELASTIC APM" and add "JSR223 groovy api apm call"
* REMOVE = remove "User Defined Variables for ELASTIC APM" and remove "JSR223 groovy api apm call", the script will be as before action ADD
* regex the regular expression matches the "Transaction Controller" label, if the label doesn't match the regular expression then **NO** "JSR223 groovy api apm" surround the "Transaction Controller"
* default all = .* (this regular expression matches all labels)
* e.g. regex = SC\d+_P.+ matches labels "SC01_P01_LOGIN" or "SC20_P12B_LOGOUT" or SC01_P01_LOGIN|SC02_P02_FIND|SC02_P012_LOGOUT for some Transaction Controllers
Button "MODIFY SCRIPT", this button launch the tool with parameters.
Button "MODIFY SCRIPT AND LOAD NEW SCRIPT", this button launch the tool with parameters and next if no error LOAD the generated script in the current JMeter.
Status, the status line contains the tool status or the tool result.
e.g. : Status Results **OK**
* Tool ELASTIC APM Integration Finished OK, ACTION = ADD, fileOut=C:\Temp\script1_add.jmx
* Tool ELASTIC APM Integration Finished OK, ACTION = REMOVE, fileOut=C:\Temp\script1_add_modif.jmx
e.g. : Status Results **KO**
* Tool ELASTIC APM Integration Finished KO, CAN'T READ jmx fileIn = C:\Temp\script1zzzz.jmx
* Tool ELASTIC APM Integration Finished KO, exception = java.util.regex.PatternSyntaxException: Unmatched closing ')' near index 1 .*)
* Tool ELASTIC APM Integration Finished KO, CAN'T CREATE or jmx file doesn't exist (look in the log file), fileOut = c:\toto (in log file : java.io.FileNotFoundException: c:\toto (Access denied)
)
## More documentation from jmeter-elastic-apm project
For more documentation (Architecture schema, kibana APM dashboard, JMeter script modified ...) look at README from [jmeter-elastic-apm](https://github.com/vdaburon/jmeter-elastic-apm)
## Command line tool (CLI)
This tool could be use with script shell Windows or Linux.
Scripts shell are in <JMETER_HOME>/bin
* elastic-apm-integrate.cmd for Windows OS
* elastic-apm-integrate.sh for Linux/Mac OS
Help to see all parameters :
C:\apache-jmeter\bin>elastic-apm-integrate.cmd -help
usage: io.gihub.vdaburon.jmeter.elasticapmxml.ElasticApmJMeterManager -action <action> [-extract_end <extract_end>]
[-extract_start <extract_start>] [-extract_udv <extract_udv>] -file_in <file_in> -file_out <file_out> [-help]
[-regex <regex>]
io.soprasteria.vdaburon.jmeter.elasticapmxml.ElasticApmJMeterManager
-action <action> action ADD or REMOVE, ADD : add groovy api call and REMOVE : remove groovy api call
-extract_end <extract_end> optional, file contains groovy end call api (e.g : extract_end.xml), default read file
in the jar
-extract_start <extract_start> optional, file contains groovy start call api (e.g : extract_start.xml), default read
file in the jar
-extract_udv <extract_udv> optional, file contains User Defined Variables (e.g : extract_udv.xml), default read
file in the jar
-file_in <file_in> JMeter file to read (e.g : script.jmx)
-file_out <file_out> JMeter file modified to write (e.g : script_add.jmx)
-help Help and show parameters
-regex <regex> regular expression matches Transaction Controller Label (default .*) (e.g : SC[0-9]+_.
for SC01_P01_HOME or SC09_P12_LOGOUT)
E.g : java -jar elastic-apm-jmeter-xml-<version>-jar-with-dependencies.jar -file_in script1.jmx -file_out script1_add.jmx
-action ADD -regex SC.*
E.g : java -jar elastic-apm-jmeter-xml-<version>-jar-with-dependencies.jar -file_in script1_add.jmx -file_out
script1_remove.jmx -action REMOVE -regex .*
e.g. action = ADD :
C:\apache-jmeter\bin>elastic-apm-integrate.cmd -file_in C:\temp\script1.jmx -file_out C:\temp\script1_add_cli.jmx -action ADD -regex SC.*
e.g. action = REMOVE :
/var/opt/apache-jmeter/bin>elastic-apm-integrate.sh -file_in /tmp/script1_add.jmx -file_out /tmp/script1_remove_cli.jmx -action REMOVE
## Tool installed with jmeter-plugins-manager
This tool could be installed with the jmeter-plugins-manager from jmeter.plugins.org.
The tool name is : "vdn@github - elastic-apm-tool"
## Usage Maven
The maven groupId, artifactId and version, this plugin is in the **Maven Central Repository** [](https://maven-badges.herokuapp.com/maven-central/io.github.vdaburon/elastic-apm-jmeter-plugin)
```xml
io.github.vdaburon
elastic-apm-jmeter-plugin
2.0
```
## Versions
Version 2.0 2025-01-14, Choose only a jmx file not a directory and add button "MODIFY SCRIPT AND LOAD NEW SCRIPT"
version 1.0 2024-02-06, First release