Data streaming (Beta)

You can integrate an InfluxDB time series database to stream raw or aggregated data and view metrics during a test run.

Data streaming overview

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 steps in integration are installing the database and a LoadRunner Cloud agent. The agent connects your InfluxDB time series database to your LoadRunner Cloud tenant.

Prerequisites

Supported OS

Windows x64

Install InfluxDB InfluxDB download

Install and configure the agent

Once you have installed the database, do the following to install and configure the LoadRunner Cloud Streaming agent:

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

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

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

  2. 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

  3. 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.

    4. Select the interval in milliseconds at which the LoadRunner Cloud agent will poll the server: every 5000 milliseconds (5 seconds), every 10000 milliseconds (10 seconds), or every 20000 milliseconds (20 seconds).

  4. 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.

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

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

    Once the agent starts running, it will appear in the Assets > Agents page.
Launch the agent

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

To manage the streaming agent in LoadRunner Cloud, go to Assets > Agents.

For details about editing or deleting agents from LoadRunner Cloud, see LoadRunner Cloud agents.

 

Back to top

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

See also: