Working with Diagnostics

Note: Integration with HPE Diagnostics is supported for the following protocols: Web - HTTP/HTML, Java over HTTP, Oracle - Web, SAP - Web, Siebel - Web, TruClient - Web, Web Services, and Flex.

The HPE Diagnostics integration with Performance Center enables you to monitor and analyze metrics of Java 2 Enterprise Edition (J2EE), .NET-connected, and other complex environments in a performance test.

During a performance test, you can drill down into HPE Diagnostics data for the whole test or for a particular transaction. After the test, you can use Analysis to analyze offline diagnostics data generated during the test.

Monitor server requests

When configuring a performance test to use J2EE/.NET Diagnostics, you can instruct Performance Center to capture server requests which occur outside the context of a Vuser transaction.

The benefit of this functionality is that it can capture calls into a back-end virtual machine even when:

  • The probe is not capturing RMI calls
  • RMI calls cannot be captured (perhaps because an unsupported application container is being used)
  • The application uses some other mechanism for communications between multiple virtual machines

For more information about working with diagnostics for J2EE and .NET, see the HPE Diagnostics User Guide available on the Diagnostics installation media.

Back to top

Enable and configure J2EE/.NET diagnostics

Note: This task is part of a higher-level task. For details, see How to Design a Performance Test.

  1. On the My Performance Center navigation bar, select Test Management > Test Plan.

  2. Select a performance test in the test plan tree and click Edit Test.

  3. In the Performance Test Designer window, click Diagnostics.

  4. Select Enable the following diagnostics for X% of all relevant Vusers in the test.

  5. Select Enable by J2EE/.NET Application Diagnostics, then click the Configure button .

    For user interface details, see Understand the Diagnostics page.

Back to top

View diagnostics results

You view results for J2EE/.NET diagnostics in LoadRunner Analysis.

  1. Open Analysis

    1. Navigate to <HPE Performance Center Host directory> Applications > Analysis.

    2. Open the desired results file from the following location:

    3. <LTS installation>\orchidtmp\Results\<Domain Name+Project Name>\Run_<Run number>\res<Run number>\res<Run number>.lrr

  2. View results in the Analysis diagnostics graphs

    You can use the Analysis diagnostics graphs and reports to view the performance data and drill down to pinpoint problem areas in any layer of the application.

    For information about specific diagnostics graphs, see the LoadRunner Help Center (select the relevant version).

Back to top

Understand the Diagnostics page

This view enables you to enable and define the J2EE/.NET diagnostics modules for a performance test.

To access
  1. On the My Performance Center navigation bar, select Test Management > Test Plan.

  2. Select a performance test in the test plan tree and click Edit Test.

  3. In the Performance Test Designer window, click Diagnostics.

Important information
  • The contents of the tab are disabled while the performance test is running. You must enable and configure the diagnostics modules before running the test.

  • The settings that you configure are per performance test. All scripts in the performance test run under the same diagnostics configuration.

User interface elements are described below:

UI Elements Description
Enable the following Diagnostics for X% of all relevant Vusers in the test

Specify the percentage of Vusers for which you want to collect diagnostics data. This value determines how many of the transactions on the application server are reported to the Controller. Reducing this percentage will reduce the overhead on the application server for Web Page, Oracle 11i, and J2EE & .NET Diagnostics.

Example: If you enter a sampling value of 25% and run 12 Vusers in group1, 8 Vusers in group2, and 1 Vuser in group3, diagnostics data will be collected for 3 Vusers in group1, 2 Vusers in group2, and 1 Vuser in group3.

Note: The minimum percentage of Vuser sampling allowed is 1%, or 1 Vuser per group, whichever is more.

The maximum percentage allowed is the lowest of the Max. Vuser Sampling values of all the selected diagnostics types.

Configure

Click the button to configure the J2EE/.NET diagnostics type.

Max Vuser Sampling

The maximum percentage of the amount of Vusers specified in the Enable the following Diagnostics for X% ... that can be collected.

Back to top

J2EE/.NET Configuration Dialog Box

This dialog box enables you to set up the J2EE/.NET diagnostics module.

To access
  1. On the My Performance Center navigation bar, select Test Management > Test Plan.

  2. Select a performance test in the test plan tree and click Edit Test.

  3. In the Performance Test Designer window, click Diagnostics.

  4. Select Enable the following diagnostics for X% of all relevant Vusers in the test.

  5. Select Enable by J2EE/.NET Application Diagnostics, then click the Configure button .

Important information

The dialog box is read only while the performance test is running.

See also

J2EE & .NET Diagnostics Graphs in the LoadRunner Help Center (select the relevant version).

User interface elements are described below:

UI Elements

Description

Monitor server requests

Select to capture a percentage of server requests which occur outside the context of any Vuser transaction. For details, see the ALM Lab Management Guide.

Note:

  • The server requests will be captured at the same percentage that was selected for the percentage of Vusers in the Diagnostics Distribution dialog box.

  • Enabling this option imposes an additional overhead on the probe.

Select Probes Table
  • . Selects a probe for monitoring. At least one probe must be selected.

  • Name. The name of the probe.

  • Group. The probe group.

  • Host Name. The host the probe is running on (or the application server on which the probe is installed).

  • Status. The probe's status. Either Available or Not Available.

Note: If you upgraded your Diagnostics installation, probes from existing performance tests may appear with a red status. Clear any probes that appear in red.

There is a firewall between the Mediator and the Controller. Use the MI Listener for collating results.

Select if the Diagnostics server (or a Diagnostics server in Mediator mode in a distributed environment) is located behind a firewall.

Note: If there is a firewall between the Controller and the Diagnostics Server involved in a performance test, you must configure the Controller and the Diagnostics Server to use the MI Listener to enable the transfer of the offline analysis file. For details, refer to the HPE Diagnostics Installation and Configuration Guide.

Troubleshoot diagnostics for J2EE/.NET connectivity

Click to open the HPE Diagnostics System Health Monitor to enable you to investigate any connectivity issues between the Diagnostics components.

Back to top