Observability support

Available in versions: 25.3 and later

You can configure OpenText Enterprise Performance Engineering to push observability metrics and data from performance test runs to an OpenTelemetry Collector. The observability data can be sent for scripts of all protocols.

In this topic:

Add an OpenTelemetry Collector

To enable observability support, you need to add OpenTelemetry Collectors and assign them to different projects.

To add an OpenTelemetry Collector:

1. In Administration, go to Configuration > Integrations > Observability.

2. In the Observability pane, expand OpenTelemetry, and click the Add button to open the New Collector page.

3. Configure the OpenTelemetry Collector settings.

   UI Elements	Description
   Name	Logical name for the OpenTelemetry Collector. Note: The logical name must not already exist, and cannot contain empty spaces or the following special characters: \ / : " ? ' < > | * % "
   Full URL	Name and port number of the collector, beginning with grpc://, http://, or https://.
   Authentication Header	Authorization header to send data to the collector (if required). There are two types: Basic followed by a Base-64 encoded username and password. For example: Basic dXNlcjpwYXNz Bearer followed by a token. For example: Bearer randomtoken1234
   TLS CA certificate	The public key value of the TLS CA certificate to connect to the collector (if required). Note: Not required for non-TLS users.

4. Assign an OpenTelemetry Collector to projects.

   1. In the Linked Projects area, click the Assign Projects button to open the Assign Projects dialog box.

   2. Select the projects you want to assign to the OpenTelemetry Collector, and click Assign. The selected projects are added to the Linked Projects grid.

   3. In the Linked Projects grid, you can view project details, including project ID, name, and domain, and add or remove linked projects as needed.

Back to top

Push data to an OpenTelemetry Collector

Configure performance test run data to be pushed to an OpenTelemetry Collector.

To push data to an OpenTelemetry Collector:

1. Prerequisite. An OpenTelemetry Collector must be added and assigned to the project. For details, see Add an OpenTelemetry Collector.

2. In Test Management > Tests & Scripts, select the test for which you want to push data and click Edit Test.

3. In the Groups and Workload tab, click the Test Options button , and configure the following.

   1. In the General tab, select Enable OpenTelemetry.

   2. In For % of all relevant Vusers in the test, enter the percentage of Vusers whose data should be sent to the collector.

      Note:  

      • Data is sent from at least 1 Vuser. If the specified percentage is equal to less than 1 Vuser in the current test, then data is sent from 1 Vuser.

      • Setting a high percentage may impact load generator performance.

When the performance test is run, telemetry data is sent per transaction to the collector. Transactions are tagged with details such as the transaction name, Vuser number, and other information.

For Web - HTTP/HTML scripts, a traceparent HTTP header is also added automatically. For details, see Traceparent header in Web - HTTP/HTML scripts.

Back to top

Traceparent header in Web - HTTP/HTML scripts

When you run a Web - HTTP/HTML script with observability metrics enabled, each HTTP request is reported to the collector as a transaction. A traceparent header is automatically added to each request, enabling you to track the request's flow and correlate related observability data.

Back to top