Skip to main content
Version: 2.1.X

Integrations

Integrations allow to configure connections with various data sources such as Grafana, InfluxDB, and so forth. It's crucial to properly set up these connections, as this tool operates closely with them.

InfluxDB​

The InfluxDB configuration allows you to connect to InfluxDB, modify it, and utilize it in reporting.

How to add​

  1. First, open the "Integrations" tab.
  2. Choose "InfluxDB" tab.
  3. Then click on "Add new config".
  4. Fill in all necessary fields.
  5. Click "Save" button.
info

Currently, PerForge supports four backend listeners so you can query either InfluxDB v2 or InfluxDB 1.8 schemes:

  • org.apache.jmeter.visualizers.backend.influxdb.InfluxdbBackendListenerClient_v2.7 – standard JMeter listener for InfluxDB v2.7 installations.
  • sitespeed_influxdb_v2.7 – Sitespeed.io queries that expect data published via the InfluxDB plugin to an InfluxDB v2.7 bucket.
  • org.apache.jmeter.visualizers.backend.influxdb.InfluxdbBackendListenerClient_v1.8 – JMeter listener variant tailored for legacy InfluxDB 1.8 instances.
  • sitespeed_influxdb_v1.8 – Sitespeed.io queries aligned with the plugin output stored in InfluxDB 1.8 bucket.

Backend listeners determine the data structure in InfluxDB, so choose the one that matches both your tool (JMeter or Sitespeed.io) and the InfluxDB version you are running. If you use a different backend listener/plugin, you won't be able to use this tool.

info

A significant portion of the communication logic depends on InfluxDB tags. In the integration configuration, there's an option called 'Test Title Tag Name' where you can specify any tag to be sent along with JMeter or Sitespeed.io test data. This tag should be unique to ensure that the results are grouped correctly for each test.

Note: In JMeter, you need to explicitly define the test title tag, such as TAG_testTitle.

info

You have the option to filter Requests or Transactions. For instance, if you only want to analyze requests, you can use "R.*" as a filter, provided all your requests follow this pattern. This largely depends on your naming convention. If you don’t want to apply any filtering, simply leave the field empty.

info

Additionally, it's possible to retrieve custom values from InfluxDB. For instance, when saving a build, you can specify a custom tag, which can then be queried and used as a parameter. For example, if you define a build in the report, you can reference it using variables like ${current_build} or ${baseline_build}.

Docs Version Dropdown

Grafana​

The Grafana configuration enables us to establish a connection with a rendering plugin. This plugin is capable of rendering Grafana screenshots. Which then will be used in reports.

How to add​

  1. First, open the "Integrations" tab.
  2. Choose "Grafana" tab.
  3. Then click on "Add new config".
  4. Fill in all necessary fields.
  5. Click "Save" button.
info

Alongside PerForge, we provide several Grafana dashboards that should be used for reporting (you can find them here). Indeed, you can use your own dashboards and add them as well. However, to ensure they work correctly, it's crucial to utilize the same variables and names as in the provided dashboards.

warning

If you're using your own Grafana instance, you'll need to install the rendering plugin. Learn more about it here: grafana-image-renderer

To render a Grafana screenshot, please specify the appropriate tag names for the test title and baseline test title used on your dashboards. If you are using our default dashboards, you can leave the default values. If you are using custom dashboards, ensure that the current test title has the same tag name across all dashboards.

The dashboard URL can be taken from the Grafana URL:

https://10.10.10.10:3000/d/jmeter-test-results-standard-listener/jmeter-test-results-standard-listener

  • /d/jmeter-test-results-standard-listener/jmeter-test-results-standard-listener is the Dashboard URL.

Docs Version Dropdown

SMTP Mail​

Mail is one of the target sources where the tool can create a report.

How to add​

  1. First, open the "Integrations" tab.
  2. Choose "SMTP Mail" tab.
  3. Then click on "Add new config".
  4. Fill in all necessary fields.
  5. Click "Save" button.
info

Instructions for using Google SMTP Server:

  1. Generate an App Password: You will first need to obtain an 'App Password' from your Google account. Use the 'App Password' in the password field when setting up the integration SMTP Mail.

  2. Enable POP and IMAP: Ensure that both POP and IMAP options are enabled on your Google account. This allows the application to communicate with your email account.

Detailed instructions for generating an App Password and enabling POP and IMAP can be found here: gmail-smtp.

  1. For the server, use the following address: smtp.gmail.com.

  2. Depending on your security requirements, you have the option to use either one of two ports:

  • Port 465 (if secure connection is required, set SSL: true, and TLS: false)

Docs Version Dropdown

Atlassian Confluence​

Atlassian Confluence is one of the target sources where the tool can create a report.

How to add​

  1. First, open the "Integrations" tab.
  2. Choose "Confluence" tab.
  3. Then click on "Add new config".
  4. Fill in all necessary fields.
  5. Click "Save" button.
info

There are two types of tokens: one is an API token, which acts as a password, and the other is a Personal Access Token, which acts as both an email and a password. Be careful when creating a token; make sure to specify which type of token it is.

To create a Personal Access Token, please follow these instructions: personal-access-token-to-authenticate.

To create a API token, please follow these instructions: api-token-to-authenticate.

All necessary parameters can be taken from the URL of the page where the reports will be created:

https://perforge.atlassian.net/wiki/spaces/MFS/pages/557057/JMeter+tests

  • https://perforge.atlassian.net is the Organization URL
  • MFS is the Space key
  • 557057 is the Parent ID

Docs Version Dropdown

Atlassian Jira​

Atlassian Jira is one of the target sources where the tool can create a report.

How to add​

  1. First, open the "Integrations" tab.
  2. Choose "Jira" tab.
  3. Then click on "Add new config".
  4. Fill in all necessary fields.
  5. Click "Save" button.
info

There are two types of tokens: one is an API token, which acts as a password, and the other is a Personal Access Token, which acts as both an email and a password. Be careful when creating a token; make sure to specify which type of token it is.

To create a Personal Access Token, please follow these instructions: personal-access-token-to-authenticate.

To create a API token, please follow these instructions: api-token-to-authenticate.

Project parameter can be taken from the URL of the projects board:

https://perforge.atlassian.net/jira/software/projects/PF/boards/1

  • PF is the Project

The Epic field and Epic name are used to link a ticket to a specific epic.

Docs Version Dropdown

Azure Wiki​

Azure Wiki is one of the target sources where the tool can create a report.

How to add​

  1. First, open the "Integrations" tab.
  2. Choose "Azure" tab.
  3. Then click on "Add new config".
  4. Fill in all necessary fields.
  5. Click "Save" button.
info

To create a personal access token, please follow these instructions: access-tokens-to-authenticate.

If the specified path does not exist, it will be automatically created.

All necessary parameters can be taken from the URL of the page where the reports will be created:

https://dev.azure.com/perfroge/PERFORGEPROJECT/_wiki/wikis/PERFORGEPROJECT.wiki/59/JMETER-REPORTS

  • https://dev.azure.com/perfroge is the Wiki Organization Url
  • PERFORGEPROJECT is the Wiki Project
  • PERFORGEPROJECT.wiki is the Wiki Identifier

Docs Version Dropdown

AI Support​

AI Support allows you to use AI to analyze performance test results, create summaries for aggregated data and graphs.

How to add​

  1. First, open the "Integrations" tab.
  2. Choose "AI Support" tab.
  3. Then click on "Add new config".
  4. Fill in all necessary fields.
  5. Click "Save" button.
info

We support the use of OpenAI, Azure OpenAI, Google Gemini and Anthropic providers. You can use any available models with your token.

Additoonaly there is possibility to use conversation memory, more about this feature can be found here: analysis-process.

warning
  • The "AI Image" model should support image inputs.
  • "Conversation memory" will at least double the token usage.
  • The "Default" integration is used automatically when reporting; if you have multiple integrations, be sure the correct one is set as the default.

Docs Version Dropdown