The BlazeMeter - DX APM integration enables users to run and investigate load tests, through the test metadata. Through this integration, DX APM users can incorporate performance test scenarios and their key performance metrics into their business analysis. This leads to better optimization, faster detection of issues and greater abilities to make decisions. Please note this integration will work if your DX APM agent is installed on the target server.

How to Use the DX APM - BlazeMeter Integration

1. In BlazeMeter, click on 'Create Test' and then on 'Performance Test'.
   
2. On the test creation page, choose DX APM in the APM Integration section.
   
3. Choose the desired integration:
   

"See BlazeMeter data in DX APM" is an outbound integration, which "decorates" outbound traffic with headers containing the test name, test step (label), geographic region, test engine IP and network emulation settings. This metadata enhances reporting of the test on the APM side. For example, test traffic will show up as business transactions in DX APM.

"Two way integration" adds an inbound integration that makes DX APM metrics available for overlay on the Timeline Report in BlazeMeter. Unlike previous inbound integrations, you do not need to know the list of relevant metrics before running your test and there is no need to update the integration if you make changes to your back-end infrastructure or app.  Simply point BlazeMeter at your DX APM instance once and the impacted systems and metrics are dynamically selected and made available to you in the BlazeMeter UI during each test run.

See BlazeMeter data in DX APM

Show BlazeMeter test details in the DX APM as a business transaction:

1. To use this option, click 'Apply' and run the test.
2. Make sure the application that is tested as part of the run is monitored with an appropriate APM agent. Check this link on how to configure an APM agent: https://techdocs.broadcom.com/content/broadcom/techdocs/us/en/ca-enterprise-software/it-operations-management/application-performance-management/11-1/implementing-agents.html
3. Open DX APM and view the metric results, like business segments and business transactions, on the DX APM dashboard.
4. The data sent and presented on the DX APM includes:
   1. Test name
   2. Label name
   3. Region
   4. Engine IP
   5. Network emulation
5. In the background, the integration is executed through HTTP headers. After clicking on the DX APM option, BlazeMeter configures and implants the relevant headers in the script, which are read by the DX APM and displayed on its dashboard.

Two way integration:

The following details are required to complete the integration:

1. Configuration name - A name for the configuration to be used in BlazeMeter
2. DX APM Security Token - The security token can be found and created in the DX APM Team Center under Settings -> Security
3. DX APM URL - The URL for accessing the DX APM Webview or the DX APM Team Center (without the port number)
4. You can validate the URL by clicking on the 'Validate' button.
   A correct response should like this:
   
5. Advanced Settings:
   
   1. Port number for DX APM Webview/DX APM Team Center - the port Number for DX APM Webview/Team Center. If the port is not provided, the default value 8080 will be used
   2. Port number for metrics API - Port number for DX APM metrics API. If no port number is provided, the default value will 8081 will be used
   3. Harbor ID - Leave empty
   4. Filter for DX APM Agents that show up in the BlazeMeter report - Enter a regular expression. If not, all agents will be selected

1. After choosing the desired integration, you can verify that the APM is selected for the test in the test configuration page, where it will appear directly under the APM Integration section.
2. Make sure the application that is tested as part of the run is monitored with an appropriate APM agent. Check this link on how to configure an APM agent: https://techdocs.broadcom.com/content/broadcom/techdocs/us/en/ca-enterprise-software/it-operations-management/application-performance-management/11-1/implementing-agents.html
3. Run the test, and you will be able to see the APM data in the "Timeline Report". To select your DX APM data, you will be able to choose your DX APM domain and the available agents under KPI Selection.