Enable the NeoLoad module for qTest

qTest Manager organizes tests by projects and then by release. Each release contains test cycles. Each test cycle includes several functional tests.

NeoLoad integrates with qTest Manager to create automatically a test run in qTest containing the information of the performance test result.

  1. In the NeoLoad menu bar, click Edit > Preferences > Project settings > qTest.
  2. Select Enable qTest integration.


Configure the NeoLoad module for qTest

Once you have enabled the qTest module in NeoLoad GUI, you can proceed with the configuration of the integration with a "default.yaml" as-code file or in NeoLoad GUI.

Each preference of the project related to qTest can be overwritten individually thanks to the as-code properties as documented in Github.

Example of an as-code "default.yaml" file containing the rest of the configuration:

  qtest.url: https://myCompany.qtestnet.com
  qtest.token: clearTokenOrTokenEncryptedByNeoload
  qtest.auth_method: TOKEN
  qtest.project_id: 101762
  qtest.cycle_id: 3761630

  1. In the NeoLoad menu bar, click Edit > Preferences > Project settings > qTest.


  2. In the Server URL field, enter the URL of the qTest SaaS or on-premise environment.
  3. Select the type of authentication you want to use.
  4. If you need a proxy to go to qTest, you can configure a proxy in NeoLoad General settings by clicking the Proxy configuration in general settings link. See Use a proxy for more details.
  5. Choose if you want that a new qTest defect be created for each qTest test step with a failed status. The defects created will be tagged as “Performance” category and “Bug” type if possible. These values exist by default in qTest field settings. If you update or remove them, the integration will not select it. For more details, please refer to the qTest documentation of Field Settings.
  6. Click the Test button to verify the connection is well established between NeoLoad and qTest.
  7. In the Context panel, the Project drop-down menu enables you to select the project and node where you want your NeoLoad performance test to be inserted.

    You can click and scroll in the menu or directly type and search the name of the project.

  8. Click Apply to save your configuration.

The link to the item created in qTest is available:

If the transfer to NeoLoad Web is enabled, the link to the NeoLoad Web Test Result is available in qTest in the “Test Log Details”, and in the execution history “Build URL” column. By default this column is hidden, you have to add it to the table by clicking the Gear button: