LoadNinja Tests in Jenkins

To run LoadNinja in Jenkins, you need to install the LoadNinja Load Testing Plugin:

1. In your Jenkins instance, go to Manage Jenkins > Manage Plugins.

   

   Click the image to enlarge it.

2. On the Available page, type LoadNinja in the Filter field, then select the check box next to LoadNinja Load Testing Plugin once it appears in the list.

   

   Click the image to enlarge it.

3. Click either Install without restart or Download now and install after restart.

To run a LoadNinja test as part of your build, configure the needed build:

1. Make sure the LoadNinja Load Testing Plugin is installed.

2. In Jenkins, select a job and click Configure.

   

   Click the image to enlarge it.

3. In the Build section, click Add build step > LoadNinja. This step is added by the LoadNinja Load Testing Plugin.

   

   Click the image to enlarge it.

4. Specify the LoadNinja settings for this build:

   

   Click the image to enlarge it.

   • apiKey — The unique LoadNinja API key of your account that is available in the LoadNinja settings dialog.

     After you enter the key, click Validate API key to check whether Jenkins can access LoadNinja using the key.

     How to get an API key

     1. In LoadNinja, go to  > Settings.

     2. Switch to the API Keys tab.

     3. Click Generate.

     4. Confirm this action in the subsequent dialog.

     5. After you do this, LoadNinja will generate an API key.

        • To copy the key to the clipboard, click .

        • To view the key, click .

        • To stop using this key and create a new one, click Regenerate, then confirm this action in the subsequent dialog.

   • scenarioId — The unique ID of the load test scenario you want to run. You can get it from the API or scenario URL:

     

     Click the image to enlarge it.

5. (Optional) To command Jenkins to mark a test as passed only if the percentage of errors in this test is less than some value, select the Enable pass criteria for performance test errors check box and specify the desired value in the edit box that appears.

6. (Optional) To command Jenkins to mark a test as passed only if the average duration of a test step during the run is less than some value (in seconds), select the Enable pass criteria for performance test step duration check box and specify the desired value in the edit box that appears.

7. In the Post-build Actions section, click Add post-build action to select the type of reports you want to receive after the test run is over.

8. Select Publish JUnit test result report to receive a JUnit XML report.

   

   Click the image to enlarge it.

   Make sure to specify the name of the target file for reports in the Test report XMLs field.

   After the build is finished, you will find the file in the workspace directory. To open the directory, click the Workspace link on the job page.

9. Click Save.

• When a LoadNinja test is running, the plugin posts the current status of the test run to the Jenkins console output every 1 minute.