Data streaming

For your test run, you can integrate an InfluxDB time series database (beta) to stream raw and aggregated data, or stream script raw error messages to a Splunk Cloud system.

Time series database streaming

Integration with a time series database allows you to stream aggregated or raw data and view your testing metrics in real time.

The integration is done by adding a streaming data agent to the LoadRunner Cloud assets. This agent lets you communicate with a time series database. Then you can view the test's progress using the monitoring tool of your choice, such as Grafana.

Currently, the streaming of raw data is only supported on cloud-based load generators and is limited to runs with a maximum of 5,000 concurrent Vusers.

Note: To use data streaming, you must open a support ticket and submit a request to enable data streaming for your tenant.

Back to top

Install InfluxDB

The first step in integrating with InfluxDB, is installing the database and a LoadRunner Cloud agent. The agent connects your InfluxDB time series database to your LoadRunner Cloud tenant.

System requirements and prerequisites

Supported OS Windows x64
Supported InfluxDB versions

1.7.x - 1.8.x, 2.x
Note: See below for details how to work with the InfluxDB v2 token.

Installation of InfluxDB Influxdata downloads page

Install and configure the agent

Install the downloaded installation. After you finish installing the database, do the following to configure the LoadRunner Cloud Streaming agent:

Action How to

Download and install the agent

To download and install the agent:

  1. Download the Streaming agent from the LoadRunner Cloud 's Home > Get tools > Agents tab.
  2. Extract the downloaded package and run LRCStreamingAgent.exe to install the agent.

Configure the agent

The Streaming Agent Configuration tool opens automatically after the agent installation.

To manually run the configuration tool at any time, go to Start > LoadRunner Cloud – Streaming Agent , right click Configure Streaming agent, and select Run as administrator.

On the General tab enter:

  1. An agent name
  2. The LoadRunner Cloud username/password or client ID/secret key. For details, see API access keys.
  3. A tenant id
  4. A project id

In the Misc tab:

  1. To use a proxy other than the one shown, enter your proxy URL.

    If your proxy requires authentication, select the Advanced tab to enter your credentials.

  2. Enter the URL of the LoadRunner Cloud server.

  3. Select a log level.

In the Streaming tab:

  1. Enter the InfluxDB URL.

  2. Enter the user name and password for the database.

  3. Specify the name of the database.

In the Options tab, enter any additional arguments and their values.

Click Save or Save & Test. Make sure that the connection to the database is successful.

Add the InfluxDB token (for version 2.x)

To configure a version 2.x token:

Manually edit the agent configuration file, data_streaming_conf.json located by default in the C:\LRCStreamingAgent\testexec.server folder.

  1. Manually add your InfluxDB token. For example,
    " token ": "tZxPPMWhP_ZEsDB6BihbLECCYT0YYE..."
  2. Set the password field to an empty string: "password": ""

    For example,

    "streaming": {
    "url": "http://localhost:8086",
    "user": "abc",
    "password": "",
    "database": "test-db",
    "token":"tZxPPMWhP_ ZEsDB6BihbLECCYT0YYE..."

  3. Enable InfluxDB dbrp. For details, see the InfluxDB documentation. For example,

    influx v1 dbrp create --db test-db --rp test-rp --bucket-id ced4b0b583a895c8 --default -o test-org -t tZxPPMWhP_ZEsDB6BihbLE...

  4. Navigate to Start > LoadRunner Cloud – Streaming Agent . Right-click Configure Streaming agent, and select Run as administrator. The Streaming Agent Configuration tool opens.
  5. Click Save & Test. Make sure that the connection to the database is successful.

Launch the agent

Go to Start > LoadRunner Cloud – Streaming Agent > Start Streaming Agent.

When the agent starts running, it will appear in the Assets > Agents tab.

For details about managing the agents in LoadRunner Cloud, see LoadRunner Cloud agents.

Back to top

Add the InfluxDB streaming agent

You can view metrics of streaming data during the test run using the integration of LoadRunner Cloud with the InfluxDB database. You can stream either raw or aggregated data.

Note: The streaming of raw data is a technical preview and limited to 5000 Vusers, not including Vusers running on on-premises load generators.

For information on how to set up the integration, see Install InfluxDB. Once your integration is complete, you can configure the streaming agent.

To add an InfluxDB streaming agent:

  1. In the Load Tests page, open the Streaming pane (only visible after integration).
  2. Click + Add from Assets.
  3. Select an agent and click Add.
  4. in the Data Type column, choose Raw or Aggregated. (If only one of the data types is enabled for your tenant, the dropdown will be disabled and the relevant data type will be displayed.)

Once you begin the test run, you can check the streaming data in the InfluxDB database using a monitoring tool such as Grafana.

InfluxDB database measurements

This section lists the measurements added to the InfluxDB database when the streaming agent is configured.

Aggregated data measurements

Measurement Description Tags Fields
agg_running_vusers Vusers running in the load test emulationId, locationId, runId, scriptId value
agg_failed_vusers Vusers that failed in the load test emulationId, locationId, runId, scriptId value
agg_errors Error messages emulationId, locationId, runId, scriptId value
agg_datapoints Data, such as http_200 and http_302 dataName, emulationId, locationId, runId, scriptId count, value
agg_transactions Transaction related information emulationId, locationId, runId, scriptId, txName, txStatus count, max, min, sum, sumSqr, value

Raw data measurements

Measurement Description Tags Fields
Transaction Raw transactions Name, ScriptName, GroupName, VuserID, Status, RunID, Product, Emulation, Region StartTime, EndTime, ThinkTime, WastedTime
DataPoint Raw datapoints Name, ScriptName, GroupName, VuserID, RunID, Product, Emulation, Region Value
Error Raw error messages Code, VuserID, GroupName, ScriptName, ActionName, Host, RunID, Product, Emulation, Region Message, Iteration, FileLine

Back to top

Stream script errors to Splunk

You can stream script errors to a Splunk Cloud system during a test run. To stream script errors to Splunk, do the following:

Action How to
Configure your Splunk account

In your Splunk account, configure the following for the HTTP Event Collector.

  1. Create a new token
    1. Enter a name for the HTTP Event Collector.
    2. Set the Source type to _json.

    When the new token is created, note the token value that is displayed (you will need this when configuring LoadRunner Cloud).

  2. Enable the token

    Note the HTTP port number that is displayed (you will need this when configuring LoadRunner Cloud).

For details on configuring the HTTP Event Collector, refer to the Splunk documentation.

Configure you Splunk account details in LoadRunner Cloud

In LoadRunner Cloud:

  1. Navigate to Menu bar > Your user name > Splunk account.
  2. In the dialog box that opens, configure:
    • Your HTTP Event Collector URL that was sent to you by Splunk when you created your Splunk instance.
    • The HTTP Event Collector port number.
    • The HTTP Event Collector token.

    • The option to mark a Managed Splunk account was deprecated, beginning with LoadRunner Cloud version 2021.08.
  3. Click Apply.
Enable script error streaming for a load test
  1. Select the Load Test tab and select a load test.
  2. Click to open the General settings page.
  3. In the Data and logs section, select Stream script errors to Splunk. For details, see Data streaming.

Notes and Limitations

  • Streaming script errors to Splunk is enabled only for tests run in the cloud.
  • You can stream script errors to a Splunk Cloud account only.
  • Only one Splunk account can be configured for a LoadRunner Cloud tenant.
  • During a load test run, only the first 500,000 script errors are sent to the Splunk account.
  • If your Splunk account was already configured before LoadRunner Cloud version 2021.08, the URL shown in the Splunk Account dialog box will contain a prefix of input- or http-inputs, depending on if you had a managed Splunk account.
  • From LoadRunner Cloud version 2021.08, whenever you configure a Splunk account through LoadRunner Cloud, a message is sent to the Splunk account for validation.

Back to top

See also: