Skip to content

Commit d7c8857

Browse files
authored
Merge branch 'undera:master' into master
2 parents 19342a9 + 17add3c commit d7c8857

3 files changed

Lines changed: 68 additions & 54 deletions

File tree

site/dat/repo/blazemeter.json

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -722,8 +722,8 @@
722722
},
723723
{
724724
"id": "bzm-http2",
725-
"name": "BlazeMeter - HTTP/2 Plugin",
726-
"description": "HTTP/2 protocol sampler",
725+
"name": "BlazeMeter - HTTP Plugin",
726+
"description": "BlazeMeter HTTP (HTTP/1.1, HTTP/2, HTTP/3)",
727727
"helpUrl": "https://github.com/Blazemeter/jmeter-http2-plugin/blob/master/README.md",
728728
"screenshotUrl": "https://raw.githubusercontent.com/Blazemeter/jmeter-http2-plugin/master/docs/addHTTP2Sampler.png",
729729
"vendor": "BlazeMeter",
@@ -1022,6 +1022,13 @@
10221022
"depends": [
10231023
"jmeter-http"
10241024
]
1025+
},
1026+
"3.0.1": {
1027+
"changes": "Plugin renamed to BlazeMeter HTTP. Protocol support: HTTP/1.x, HTTP/2 and HTTP/3. Recording support and many other improvements.",
1028+
"downloadUrl": "https://github.com/Blazemeter/jmeter-http2-plugin/releases/download/v3.0.1/jmeter-bzm-http2-3.0.1.jar",
1029+
"depends": [
1030+
"jmeter-http"
1031+
]
10251032
}
10261033
}
10271034
},

site/dat/repo/various.json

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3190,6 +3190,10 @@
31903190
"2.0.0": {
31913191
"changes": "Added headless CLI mode for CI/CD pipelines and GitHub Actions. Added P95 metric column. Auto-creates output directory if missing. Empty prefix now includes all transactions.",
31923192
"downloadUrl": "https://github.com/rishavsawarn/jmeter-jtl-xls-report-plugin/releases/download/v2.0.0/jmeter-jtl-xls-report-plugin-2.0.0-jar-with-dependencies.jar"
3193+
},
3194+
"3.0.0": {
3195+
"changes": "Baseline JTL comparison support. The Excel report now contains three sheets: Current, Baseline, and Comparison. Added 'Baseline Directory' field in the GUI listener.",
3196+
"downloadUrl": "https://github.com/rishavsawarn/jmeter-jtl-xls-report-plugin/releases/download/v3.0.0/jmeter-jtl-xls-report-plugin-v3.0.0.jar"
31933197
}
31943198
}
31953199
},

site/dat/wiki/HttpSimpleTableServer.md

Lines changed: 55 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,8 @@ Unfortunately the dataset and csv files aren't transferred from the controller t
99

1010
The main idea is to use a tiny http server in JMeter Plugins to manage the dataset files with simple commands to get / find / add rows of data in files.
1111

12-
An article about this tool : https://dzone.com/articles/jmeter-plugin-http-simple-table-server <br/>
12+
A dzone.com article about this tool : [https://dzone.com/articles/jmeter-plugin-http-simple-table-server](https://dzone.com/articles/jmeter-plugin-http-simple-table-server) <br/>
13+
1314
"Take an in-depth look to discover some of the possibilities of using the HTTP Simple Table Server a JMeter Plugin in this short manual."
1415

1516
## Configuration
@@ -27,9 +28,10 @@ jmeterPlugin.sts.charsetEncodingHttpResponse=UTF-8
2728
jmeterPlugin.sts.charsetEncodingReadFile=UTF-8
2829
jmeterPlugin.sts.charsetEncodingWriteFile=UTF-8
2930
31+
# Load files at startup
3032
jmeterPlugin.sts.initFileAtStartup=article.csv,users.csv
3133
jmeterPlugin.sts.initFileAtStartupRegex=false
32-
34+
# OR
3335
jmeterPlugin.sts.initFileAtStartup=file\d+\.csv
3436
jmeterPlugin.sts.initFileAtStartupRegex=true
3537
@@ -66,7 +68,9 @@ There are different ways to start the STS:
6668

6769
![](/img/wiki/http_simple_table_server.png)
6870

69-
2. With <code>simple-table-server.cmd</code> (.sh for UNIX) script located in your <code>JMETER_HOME/bin</code> directory. Parameters are read in the jmeter.properties or you could also set parameters like <code>simple-table-server.cmd -DjmeterPlugin.sts.addTimestamp=true -DjmeterPlugin.sts.datasetDirectory=D:/jmeter/dataset</code>, set jmeterPlugin.sts.daemon=true when you want launch the STS with the nohup linux command like process daemon, the STS will not waiting the <ENTER> key to stop.
71+
72+
2. With <code>simple-table-server.cmd</code> (.sh for UNIX) script located in your <code>JMETER_HOME/bin</code> directory. Parameters are read in the jmeter.properties or you could also set parameters like <code>simple-table-server.cmd -DjmeterPlugin.sts.addTimestamp=true -DjmeterPlugin.sts.datasetDirectory=D:/jmeter/dataset</code>, set <code>jmeterPlugin.sts.daemon=true</code> when you want launch the STS with the nohup linux command like process daemon, the STS will not waiting the &lt;ENTER&gt; key to stop.
73+
7074
3. On JMeter CLI startup (Windows : <code>jmeter-n.cmd</code> or Linux <code>jmeter -n</code>) following properties in jmeter.properties file or in user.properties :
7175

7276
```text
@@ -89,7 +93,7 @@ http://hostname:port/sts/
8993
```
9094
When the STS is running go to `http://<HOST>:<PORT>/sts/` to **see all available commands** and a short help.
9195

92-
Usually `http://localhost:9191/sts/`
96+
Usually Help at [http://localhost:9191/sts/](http://localhost:9191/sts/)
9397

9498
## INITFILE
9599

@@ -161,7 +165,7 @@ read all csv files in the dataset directory the jmeterPlugin.sts.initFileAtStart
161165

162166
**Get one line from list**
163167

164-
The charset use in the response is jmeterPlugin.sts.charsetEncodingHttpResponse=<charset>, default value = JMeter property : sampleresult.default.encoding
168+
The charset use in the response is jmeterPlugin.sts.charsetEncodingHttpResponse=&lt;charset&gt;, default value = JMeter property : sampleresult.default.encoding
165169

166170
```
167171
http://hostname:port/sts/READ?READ_MODE={FIRST, LAST, RANDOM}&KEEP={TRUE, FALSE}&FILENAME=logins.csv
@@ -177,10 +181,10 @@ HTML format:
177181

178182
Available options:
179183
- READ_MODE=FIRST => login1;password1
180-
- READ_MODE=LAST => login5;password5
181-
- READ_MODE=RANDOM => login?;password?
182-
- KEEP=TRUE => the data is kept and put to the end of list
183-
- KEEP=FALSE => the data is removed
184+
- READ_MODE=LAST => login5;password5
185+
- READ_MODE=RANDOM => login?;password?
186+
- KEEP=TRUE => the data is kept and put to the end of list
187+
- KEEP=FALSE => the data is removed
184188

185189
KEEP=TRUE, READ_MODE=FIRST => login1;password1
186190

@@ -256,12 +260,12 @@ login5;password5
256260
**Get multi lines from list in one request**
257261

258262
Available options:
259-
- NB_LINES=Number of lines to read : 1 \<= Nb lines (Integer) and Nb lines \<= list size
260-
- READ_MODE=FIRST =>start to read at the first line
261-
- READ_MODE=LAST => start to read at the last line (reverse)
262-
- READ_MODE=RANDOM => read n lines randomly
263-
- KEEP=TRUE => the data is kept and put to the end of list
264-
- KEEP=FALSE => the data is removed
263+
- NB_LINES=Number of lines to read : 1 \<= Nb lines (Integer) and Nb lines \<= list size
264+
- READ_MODE=FIRST =>start to read at the first line
265+
- READ_MODE=LAST => start to read at the last line (reverse)
266+
- READ_MODE=RANDOM => read n lines randomly
267+
- KEEP=TRUE => the data is kept and put to the end of list
268+
- KEEP=FALSE => the data is removed
265269

266270
GET Protocol
267271

@@ -332,11 +336,11 @@ HTML format:
332336
```
333337

334338
Available options:
335-
- ADD_MODE=FIRST => add to the top
336-
- ADD_MODE=LAST => add to the end
337-
- FILENAME=dossier.csv => if doesn't already exist it creates a LinkedList in memory
338-
- LINE=1234;98763 => the line to add
339-
- UNIQUE=TRUE => do not add line if the list already contains such line (if already exits then return title KO and don't add the same line)
339+
- ADD_MODE=FIRST => add to the top
340+
- ADD_MODE=LAST => add to the end
341+
- FILENAME=dossier.csv => if doesn't already exist it creates a LinkedList in memory
342+
- LINE=1234;98763 => the line to add
343+
- UNIQUE=TRUE => do not add line if the list already contains such line (if already exits then return title KO and don't add the same line)
340344

341345
POST Protocol with parameters
342346
![](/img/wiki/http_sts_add_request.png)
@@ -346,10 +350,10 @@ POST Protocol with parameters
346350
**Find a line in a file (GET OR POST HTTP protocol)**
347351

348352
The LINE to find is for FIND_MODE :
349-
- A string this SUBSTRING (Default, ALineInTheFile contains the stringToFind ) or EQUALS (stringToFind == ALineInTheFile)
350-
- A regular expression with REGEX\_FIND (contains) and REGEX\_MATCH (entire region the pattern)
351-
- KEEP=TRUE => the data is kept and put to the end of list
352-
- KEEP=FALSE => the data is removed
353+
- A string this SUBSTRING (Default, ALineInTheFile contains the stringToFind ) or EQUALS (stringToFind == ALineInTheFile)
354+
- A regular expression with REGEX\_FIND (contains) and REGEX\_MATCH (entire region the pattern)
355+
- KEEP=TRUE => the data is kept and put to the end of list
356+
- KEEP=FALSE => the data is removed
353357

354358
GET Protocol
355359

@@ -421,13 +425,13 @@ dossier.csv = 1<br />
421425

422426
**Save the specified linked list in a file to the specified location**
423427

424-
The charset use to write the file is set with jmeterPlugin.sts.charsetEncodingWriteFile=\<charset>, default value = System property : file.encoding
428+
The charset use to write the file is set with jmeterPlugin.sts.charsetEncodingWriteFile=&lt;charset&gt;, default value = System property : file.encoding
425429

426430
```
427431
http://hostname:port/sts/SAVE?FILENAME=logins.csv
428432
```
429433

430-
If jmeterPlugin.sts.addTimestamp is set to true then a timestamp will be add to the filename,<br/>
434+
If jmeterPlugin.sts.addTimestamp is set to true then a timestamp will be added to the filename,<br/>
431435
the file is stored in the custom directory specified by editing the jmeterPlugin.sts.datasetDirectory property or in JMETER_HOME/bin directory by default:
432436

433437
```
@@ -473,7 +477,7 @@ Always returns title OK even if the file did not exist
473477
http://hostname:port/sts/STOP
474478
```
475479

476-
When the jmeterPlugin.sts.daemon=true, you need to call `http://hostname:port/sts/STOP` or kill the process to stop the STS
480+
When the <code>jmeterPlugin.sts.daemon=true</code>, you need to call `http://hostname:port/sts/STOP` or kill the process to stop the STS
477481

478482
## CONFIG
479483

@@ -524,12 +528,12 @@ else {
524528

525529
## Examples
526530

527-
- Put the logins.csv file in your JMETER_HOME/bin directory:
531+
- Put the logins.csv file in your JMETER_HOME/bin directory:
528532

529533
[Download logins.csv file](/img/examples/logins.csv)
530534

531-
- Run the Simple Table Server manually with the simple-table-server.cmd file or automatically with groovy configuration.
532-
- Run one of the following scripts:
535+
- Run the Simple Table Server manually with the simple-table-server.cmd file or automatically with groovy configuration.
536+
- Run one of the following scripts:
533537

534538
In a loop, read random values from a file containing a login and a password at each row:
535539

@@ -548,26 +552,25 @@ Add rows in a new linked list and save it in a file when the test is done:
548552

549553

550554

551-
Read in a random mode a dataset located on the controller machine with severals slaves.
552-
The first injector loads the dataset in memory while the other injectors are waiting few seconds (you could also use jmeterPlugin.sts.initFileAtStartup=file1.csv,file2.csv and jmeterPlugin.sts.initFileAtStartupRegex=false to read files when STS startup)
553-
The different injectors read randomly the data containing logins and passwords.
554-
When the test is done the first injector save the values in a file with a timestamp as prefix:
555+
Read in a random mode a dataset located on the controller machine with severals slaves.<br/>
556+
The first injector loads the dataset in memory while the other injectors are waiting few seconds (you could also use jmeterPlugin.sts.initFileAtStartup=file1.csv,file2.csv and jmeterPlugin.sts.initFileAtStartupRegex=false to read files when STS startup)<br/>
557+
The different injectors read randomly the data containing logins and passwords.<br/>
558+
When the test is done the first injector save the values in a file with a timestamp as prefix:<br/>
555559

556560
[Download Example Test Plan 4](/img/examples/demo_sts_read_random_for2slaves.jmx) Multi JMeter injectors and save list examples
557561

558562
You can override STS settings using command-line options:
559-
- -DjmeterPlugin.sts.port=\<port number>
560-
- -DjmeterPlugin.sts.loadAndRunOnStartup=\<true/false>
561-
- -DjmeterPlugin.sts.datasetDirectory=\<path/to/your/directory>
562-
- -DjmeterPlugin.sts.addTimestamp=\<true/false>
563-
- -DjmeterPlugin.sts.daemon=\<true/false>
564-
- -DjmeterPlugin.sts.charsetEncodingHttpResponse=\<charset like UTF-8>
565-
- -DjmeterPlugin.sts.charsetEncodingReadFile=\<charset like UTF-8>
566-
- -DjmeterPlugin.sts.charsetEncodingWriteFile=\<charset like UTF-8>
567-
- -DjmeterPlugin.sts.initFileAtStartup=\<files to read when STS startup, e.g : article.csv,users.csv>
568-
- -DjmeterPlugin.sts.initFileAtStartupRegex=false=\<false : no regular expression, files with comma separator, true : read files matching the regular expression>
563+
- -DjmeterPlugin.sts.port=&lt;port number&gt;
564+
- -DjmeterPlugin.sts.loadAndRunOnStartup=&lt;true/false&gt;
565+
- -DjmeterPlugin.sts.datasetDirectory=&lt;path/to/your/directory&gt;
566+
- -DjmeterPlugin.sts.addTimestamp=&lt;true/false&gt;
567+
- -DjmeterPlugin.sts.daemon=&lt;true/false&gt;
568+
- -DjmeterPlugin.sts.charsetEncodingHttpResponse=&lt;charset like UTF-8&gt;
569+
- -DjmeterPlugin.sts.charsetEncodingReadFile=&lt;charset like UTF-8&gt;
570+
- -DjmeterPlugin.sts.charsetEncodingWriteFile=&lt;charset like UTF-8&gt;
571+
- -DjmeterPlugin.sts.initFileAtStartup=&lt;files to read when STS startup, e.g : article.csv,users.csv&gt;
572+
- -DjmeterPlugin.sts.initFileAtStartupRegex=&lt;true/false&gt; false : no regular expression, files with comma separator, true : read files matching the regular expression.
569573

570-
571574
```
572575
jmeter.bat -DjmeterPlugin.sts.loadAndRunOnStartup=true -DjmeterPlugin.sts.port=9191 -DjmeterPlugin.sts.datasetDirectory=d:/data -DjmeterPlugin.sts.charsetEncodingReadFile=UTF-8 -n –t testdemo.jmx
573576
```
@@ -576,11 +579,11 @@ When it's done see results in the Listener Tree View.
576579

577580
## JMETER MAVEN PLUGIN
578581
If you want to use the Http Simple Server with the **JMeter Maven plugin**, you could :
579-
- Put your csv files in <project>/src/test/jmeter directory (e.g : logins.csv)
580-
- Put the simple-table-server.groovy (groovy script) in <project>/src/test/jmeter directory
581-
- Put the your jmeter script in <project>/src/test/jmeter directory (e.g : test_login.jmx)
582-
- Declare in the maven build section, in the configuration > jmeterExtensions > declare the artifact kg.apc:jmeter-plugins-table-server:<version>
583-
- Declare user properties for STS configuration and automatic start
582+
- Put your csv files in <project>/src/test/jmeter directory (e.g : logins.csv)
583+
- Put the simple-table-server.groovy (groovy script) in <project>/src/test/jmeter directory
584+
- Put the your jmeter script in <project>/src/test/jmeter directory (e.g : test_login.jmx)
585+
- Declare in the maven build section, in the configuration > jmeterExtensions > declare the artifact kg.apc:jmeter-plugins-table-server:<version>
586+
- Declare user properties for STS configuration and automatic start
584587

585588
Extract pom.xml dedicated to Http Simple Table Server :
586589

@@ -610,11 +613,11 @@ Extract pom.xml dedicated to Http Simple Table Server :
610613
</build>
611614
```
612615

613-
Link to JMeter Maven plugin : https://github.com/jmeter-maven-plugin/jmeter-maven-plugin
616+
Link to JMeter Maven plugin : [https://github.com/jmeter-maven-plugin/jmeter-maven-plugin](https://github.com/jmeter-maven-plugin/jmeter-maven-plugin)
614617

615618
## STS ALONE
616619
The Http Simple Table Server (STS) exist in external tool (.jar) without the need of JMeter.<br/>
617-
https://github.com/vdaburon/simple-table-server-alone <br/>
620+
[Link to https://github.com/vdaburon/simple-table-server-alone](https://github.com/vdaburon/simple-table-server-alone) <br/>
618621
Alone because this tool don't need Apache JMeter, it works by itself or alone.
619622

620623
## VERSIONS

0 commit comments

Comments
 (0)