For your test run, you can integrate an InfluxDB time series database (beta) to stream raw and aggregated data, or stream 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.
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 InfluxDB versions||
1.7.x - 1.8.x
|Installation of InfluxDB||Influxdata downloads page|
Install and configure the agent
Once you have installed the database, do the following to install and configure the LoadRunner Cloud Streaming agent:
|Download and install the agent||
|Configure the agent||
|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.
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:
- In the Load Tests page, open the Streaming pane (only visible after integration).
- Click + Add from Assets.
- Select an agent and click Add.
- 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
|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
|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|
You can stream script errors to a Splunk Cloud system during a test run. To stream script errors to Splunk, do the following:
|Configure your Splunk account||
In your Splunk account, configure the following for the HTTP Event Collector.
For details on configuring the HTTP Event Collector, refer to the Splunk documentation.
|Configure you Splunk account details in LoadRunner Cloud||
In LoadRunner Cloud:
|Enable script error streaming for a load test||
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.