https://github.com/xray-app/tutorial-maven-scala-gatling
https://github.com/xray-app/tutorial-maven-scala-gatling
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/xray-app/tutorial-maven-scala-gatling
- Owner: Xray-App
- Created: 2021-10-12T08:30:43.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2026-04-07T10:10:02.000Z (4 months ago)
- Last Synced: 2026-04-07T12:11:58.192Z (4 months ago)
- Language: Python
- Size: 38.1 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# tutorial-maven-scala-gatling
[](https://github.com/Xray-App/tutorial-maven-scala-gatling/actions/workflows/build.yml)
[](https://opensource.org/licenses/BSD-3-Clause)
[](https://gitter.im/Xray-App/community)
## Overview
Code that supports the tutorial [Performance and load testing with Gatling](https://docs.getxray.app/display/XRAYCLOUD/Performance+and+load+testing+with+Gatling) showcasing the integration between [Xray Test Management](https://www.getxray.app/) on Jira and Gatling.
## Prerequisites
In order to run this tutorial, you need to have Gatling with the Maven plugin installed.
If you want to use the converter to generate Xray Json you should have pythn installed as well.
## Running
Tests can be run using `maven`.
```bash
mvn gatling:test
```
## Generate Xray Json
Gatling does not produce results that can be imported to Xray directly, for that use the python tool `convert2XrayJson.py` (available in this repo) that will take one of the Gatling results file and convert it to Xray Json. You can also add another evidence file to be uploaded together with the results file inorder to provide more information on the results.
The tool have a helper function that explains its use and can be executed with the following command:
```bash
python convert2XrayJson.py -h
```
One example of a command usage can be found below:
```bash
python convert2XrayJson.py --gatlingFile /target/gatling/mysimulation-20211007103948126/js/assertions.json --outputFile xrayJson.json --testKey 'XT-246' --testPlan 'XT-245' --jiraProject XT --evidenceFile /target/gatling/mysimulation-20211007103948126/js/stats.json
```
## Submitting results to Jira
Results can be submitted to Jira so that they can be shared with the team and their impacts be easily analysed.
This can be achieved using [Xray Test Management](https://www.getxray.app/) as shown in further detail in this [tutorial](https://docs.getxray.app/display/XRAYCLOUD/Performance+and+load+testing+with+Gatling).
## Contact
Any questions related with this code, please raise issues in this GitHub project. Feel free to contribute and submit PR's.
For Xray specific questions, please contact [Xray's support team](https://jira.getxray.app/servicedesk/customer/portal/2).
## LICENSE
[BSD 3-Clause](LICENSE)