Define a load test

You add and configure scripts, monitors, and SLAs to a load test definition.

Where do I find it?

To create a load test, perform one of the following steps:

  • Select Load Tests >
  • Select Home page >

Back to top

Get started

From your Home page, you can select a project or create and edit a test.

Action How to

Select a project

On the Home page, select a project from the menu bar.

Create a test

To create a test, perform one of the following steps:

  • On the Home page, click .
  • On the Load Tests page, click .
Edit a test
  • Highlight a test in the grid.
  • Click Edit or click the test name link in the test grid.
Duplicate a test

Click Duplicate to copy a test definition to a new test.

Note: To use this feature, the test name should contain 120 characters or less.

Back to top

Navigation bar

The Load Tests navigation bar provides the following options:

General. Configure basic, run configuration, log, and load generator settings. For details, see Define general test settings.

Scripts. Show a list of the scripts. For details, see Manage scripts in the repository or Add and manage scripts in a Git repository.
Monitors. Show a list of monitors. For details, see Add monitors.
Distribution. Choose the load generator machines for your Vusers. For details, see Vuser distribution locations.
Rendezvous. Set up a rendezvous for your Vusers. For details, see Configure rendezvous settings.
SLA. Show the SLA for the test. For details, see Configure SLAs.
Single user performance. Collect client side breakdown data. For details, see Single user performance data.
Streaming. Show a list of the streaming agents. For details, see Configure the Streaming agent. (This option is only visible when data streaming was enabled for your tenant via a support ticket.)
Schedules. Set a schedule for the test run. For details, see Schedule a test run.
Runs. Opens the Runs pane listing the runs for the selected test along with run statistics such as run status, regressions, and failed transactions. For details, see Find out the status of my test run.
Trends. For details, see Trends.

Back to top

Configure the script schedule

There are three modes of script schedules—Simple mode, Manual mode, and Advanced mode. For all modes, you configure basic settings described in the table below for each script included in the load test. Only those settings that are applicable to the load test configuration are displayed.

Action How to
Specify the number of VusersClosedA virtual user emulates user actions in your application. Define how many Vusers will perform the business process recorded in your script during the load test.
  1. Click the Vuser column.
  2. Enter the number of Vusers.

Note: For TruClient Native Mobile scripts, only one Vuser runs in the test.

Specify the percentage of VusersClosedA virtual user emulates user actions in your application. Define how many Vusers will perform the business process recorded in your script during the load test.

Note: This setting applies to scripts in a load test that is configured for Goal Oriented mode.

  1. Click the % of Vusers column.
  2. Enter the percentage of the total Vusers for the load test that you want to allocate to run the selected script.

Note: The total for all the scripts in the test must be 100%.

Define the Start time

Define the start time of each script in your test.

If you have several scripts associated with your test, you can set a different start time for each script.

If you do not enter a start time, the script runs at the start of the test.

  1. Click the Start time column.
  2. Enter the time to start running the script after the test begins to run.

Set test duration

Note: This setting applies to scripts in a load test that is configured for Duration mode.

  1. Click the Duration column.

  2. Enter hours, minutes, and seconds (hh:mm:ss).

Note: You cannot configure the test duration when using the Advanced scheduling mode as the duration is calculated automatically (the total time of all the ramp up, duration, and tear down steps).

Set the number of iterations

Note: This setting applies to scripts in a load test that is configured for Iterations mode.

Configure the number of iterations the script should run during the test.

  1. Click the Iterations column.

  2. Enter the number of iterations the script should run during the test.
Set the maximum duration

Note: This setting applies to scripts in a load test that is configured for Iterations mode.

Configure the maximum length of time in which the script should complete the number of configured iterations.

If the script has not completed the number of configured iterations within the maximum duration time, the Vusers for the script are terminated.

  1. Click the Maximum duration column.

  2. Enter hours, minutes, and seconds (hh:mm:ss).

Set the location

Location is the location of the load generators that run the script—Cloud or On Premise.

Select the required location from the drop-down menu.

For more details on configuring locations, see Configure load generator locations.

Note:

  • Only those locations that support the specific script type are enabled.
  • When you change the location for a script that is configured for On Premise, if the script is assigned to run on a specific load generator it will automatically be unassigned. For details, see On-premises locations.

You then configure additional settings, either general for all modes or specific to the selected mode, by clicking the arrow to the left of the script name. In the expanded schedule area that opens, select Simple, Manual, or Advanced.

A graph displays a visual representation of the script schedule showing the number of Vusers, duration, ramp up, and tear down. (A much smaller version of the graph is also displayed in the row of the selected script.)

Simple mode

This is the default schedule mode and enables you to configure a time during which the Vusers are started or stopped, at a consistent rate. For example, if you configure ten Vusers for the script and a Ramp up time of ten minutes, one Vuser is started each minute.

Configure the following additional settings directly in the row of the selected script:

Action How to
Define the ramp up

Specify the ramp up time to start Vusers at a consistent rate.

  1. Click the Ramp up column.
  2. Enter hours, minutes, seconds (hh:mm:ss).

Note: For TruClient Native Mobile scripts, only one Vuser runs, so there is no ramp up.

Define the tear down

Specify the tear down time to stop Vusers at a consistent rate.

  1. Click the Tear Down column.
  2. Enter hours, minutes, and seconds (hh:mm:ss).

Note: For TruClient Native Mobile scripts, only one Vuser runs, so there is no tear down.

Manual mode

Note: This mode is disabled for load tests configured for the Iterations run mode.

This mode enables you to simulate a slightly more complex scenario by configuring the ramp up and tear down for a configured number of users in time intervals. For example, you can configure three Vusers to be started every two minutes until all the Vusers for the test have been started.

Select the Manual radio button and configure the following additional settings in the expanded schedule area:

Action How to
Define the ramp up, the rate at which Vusers are added.

Specify how many Vusers are added and at what time intervals.

  1. Specify the time interval.
  2. Specify the number of Vusers to start in each time interval.
Define the tear down, the pace at which Vusers are stopped.

Specify how many Vusers are stopped and in what time intervals.

  1. Specify the time interval.
  2. Specify the number of Vusers to stop in each time interval.

Advanced mode

This mode enables you to configure a schedule that more accurately reflects a real life scenario, with multiple instances of Vusers starting and stopping during the test.

Select the Advanced radio button and then click . In the dialog box that opens, configure multiple steps using the following additional settings:

Action How to
Define the ramp up, the rate at which Vusers are added.

Click to add a Ramp up step and specify how many Vusers are added and in what time intervals.

  1. Specify the time interval.
  2. Specify the number of Vusers to start in each time interval.
  3. Specify to total number of Vusers to start in the step.

For example, you can configure two Vusers to be started every four minutes until a total of twelve Vusers have been started.

Set duration

Click to add a Duration step and specify the time the test will run before executing the next scheduling step.

Duration does not include ramp up and tear down times.

Define the tear down, the pace at which Vusers are stopped.

Click to add a Tear down step and specify how many Vusers are stopped and in what time intervals.

  1. Specify the time interval.
  2. Specify the number of Vusers to stop in each time interval.
  3. Specify to total number of Vusers to stop in the step.

For example, you can configure three Vusers to be stopped every two minutes until a total of nine Vusers have been stopped.

Note:  

  • Advanced mode is disabled for:
    • scripts in a load test configured for the iterations run mode.
    • TruClient native mobile scripts.
    • scripts with the General settings > Add Vusers option selected. For details, see Define general test settings.
  • The first step must be a Ramp up.
  • The last step must be a Tear down.
  • The schedule must include at least one Ramp up step, one Duration step, and one Tear down step.
  • You can include a maximum of twenty steps in the schedule.

Other additional settings

For any of the schedule modes, you can configure the following additional settings:

Action How to
Set pacing

Controls the time between iterations. The pace tells the Vuser how long to wait between iterations of your actions.

You can control pacing either from the Load test > Scripts tab or from Runtime settings > Pacing.

To set the pacing in the Load test > Scripts tab:

  1. Open the additional settings area for the script.
  2. Select the Local pacing check box.
  3. Enter time in seconds.

    Tip: To set the time in milliseconds, enter the time in decimals. For example, 250 milliseconds = 0.250.

    Pacing defaults to 1 second.

For LoadRunner scripts, if your script contains fixed pacing, pacing defaults to the script value. You can manually change the value.

To set the pacing using runtime settings, see the Runtime settings dialog box.

Note: If the Local pacing check box is not selected, the runtime settings values are used by default.

Show snapshots

Snapshots are a visual representation of the script. If snapshots are available for a script, the Show snapshots button is displayed. Click the button to view the available snapshots.

Note: Snapshots are only applicable for TruClient scripts.

Back to top

Configure a goal for a load test

You can configure a load test to run in Goal Oriented mode. If you select this option, you configure a goal for the test and when the test runs, it continues until the goal is reached. For more details, see How LoadRunner Cloud works with goals below.

To configure a goal oriented test:

  1. In the load test's General page, select Run Mode > Goal Oriented. For details, see Run mode.

  2. In the load test's Scripts page, configure the % of Vusers and Location for each script. For details, see Configure the script schedule.

  3. In the load test's Scripts page, click . In the Goal Settings dialog box that opens, configure the following:

    Setting Description
    Goal type

    Select the goal type:

    • Hits per second. The number of hits (HTTP requests) to the Web server per second.
    • Transactions per second. The number of transactions completed per second. Only passed transactions are counted.
    Transaction name If you selected Transactions per second as the goal type, select or input the transaction to use for the goal.
    Goal value Enter the number of hits per second or transactions per second to be reached, for the goal to be fulfilled.
    Vusers Enter the minimum and maximum number of Vusers to be used in the load test.
    Ramp up

    Select the ramp up method and time. This determines the amount of time in which the goal must be reached.

    • Ramp up automatically with a maximum duration of. Ramp up Vusers automatically to reach the goal as soon as possible. If the goal can’t be reached after the maximum duration, the ramp up will stop.

    • Reach target number of hits or transactions per second <time> after test is started. Ramp up Vusers to try to reach the goal in the specified duration.

    • Step up N hits or transactions per second every. Set the number of hits or transactions per second that are added and at what time interval to add them. Hits or transactions per second are added in these increments until the goal is reached.

    Action if target cannot be reached

    Select what to do if the target is not reached in the time frame set by the Ramp up setting.

    • Stop test run. Stop the test as soon as the time frame has ended.

    • Continue test run without reaching goal. Continue running the test for the duration time setting, even though the goal was not reached.

    Duration

    Set a duration time for the load test to continue running after the time frame set by the Ramp up setting has elapsed.

    Note: The total test time is the sum of the Ramp up time and the Duration.

The following do not support the Goal Oriented run mode:

  • Adding Vusers

  • Generating single user performance data

  • The Timeline tab when scheduling a load test

  • Network emulations for cloud locations

  • Changing the load in a running load test

  • TruClient - Native Mobile scripts

How LoadRunner Cloud works with goals

LoadRunner Cloud runs Vusers in batches to reach the configured goal value. Each batch has a duration of 2 minutes.

In the first batch, LoadRunner Cloud determines the number of Vusers for each script according to the configured percentages and the minimum and maximum number of Vusers in the goal settings.

After running each batch, LoadRunner Cloud evaluates whether the goal has been reached or not. If the goal has not been reached, LoadRunner Cloud makes a calculation to determine the number of additional Vusers to be added in the next batch.

If the goal has been reached, or there are no remaining Vusers to be added, the ramp up ends. Note that the value can be greater than the defined goal value. LoadRunner Cloud does not remove Vusers to reduce the load.

During run time, if the goal was reached, but subsequently dropped to below the configured value, LoadRunner Cloud will try to add Vusers (if there are any remaining to be added) to reach the goal again.

LoadRunner Cloud does not change think time and pacing configured for scripts.

Back to top

Add monitors

You can add monitors to monitor your load test.

  • Each load test can have only one type of monitoring: SiteScope on-premises, Dynatrace, New Relic, AppDynamics, or Application Insights.
  • If your test requires SiteScope on-premises or New Relic monitoring, you can add only one monitor per load test.

Click the Monitors pane and perform one of the following actions:

Action How to

Create

Click Create to open the New Monitor dialog box.

For details on creating and configuring monitors, see Monitors.

Add from assets
  1. Click Add from assets.
  2. Select one or more monitors to add to the test definition.
Edit
  1. Select a monitor.
  2. Click Edit and modify the monitor details.

Back to top

Configure load generator locations

For each script in the test, you configure a location—Cloud or On Premise. This is the location of the load generators that run the script. For details, see Configure the script schedule.

You configure the settings for each location type in the Distribution pane:

  1. In the Load Tests tab, open the Distribution pane .
  2. Click the tab for the location type you want to configure—Cloud or On Premise.

Back to top

Configure rendezvous settings

When performing load testing, you need to emulate heavy user load on your system. To help accomplish this, you can instruct Vusers to perform a task at exactly the same moment using a rendezvous point. When a Vuser arrives at the rendezvous point, it waits until the configured percentage of Vusers participating in the rendezvous arrive. When the designated number of Vusers arrive, they are released.

You can configure the way LoadRunner Cloud handles rendezvous points included in scripts.

If scripts containing rendezvous points are included in a load test, click the Rendezvous tab and configure the following for each relevant rendezvous point:

  • Enable or disable the rendezvous point. If you disable it, it is ignored by LoadRunner Cloud when the script runs. Other configuration options described below are not valid for disabled rendezvous points.

  • Set the percentage of currently running Vusers that must reach the rendezvous point before they can continue with the script.

  • Set the timeout (in seconds) between Vusers for reaching the rendezvous point. This means that if a Vuser does not reach the rendezvous point within the configured timeout (from when the previous Vuser reached the rendezvous point), all the Vusers that have already reached the rendezvous point are released to continue with the script.

Note:  

  • When you select a rendezvous point in the list, all the scripts in which that rendezvous point is included are displayed on the right (under the configuration settings). If the script is disabled, its name is grayed out.

  • If no rendezvous points are displayed for a script that does contain such points, go to Assets > Scripts and reload the script.

Back to top

Configure SLAs

You configure one of more SLAs (Service Level Agreements) for each load test:

To configure the SLA:

  1. In the Load Tests tab, Click the SLA pane .
  2. Set percentile settings:

    1. Select the percentage of transactions expected to complete successfully. The default value is 90%. For details, see Percentiles.

    2. Set the percentile TRT (seconds) (transaction response time) value. This is the expected time it takes the specified percent (from step 2) of transactions to complete.

      For example, in your script you have a transaction named "Login". The 90th percentile TRT (seconds) value for this transaction is set to 2.50 seconds. If more than 10% of successful transactions that ended during a 5 second window have a response time higher than 2.50 seconds, an SLA warning is recorded. This example uses the average over time algorithm. For details, see Percentiles.

      The default percentile TRT (Seconds) value is 3.00 seconds.

      Tip: If you have run your test more than once, LoadRunner Cloud will display a suggested percentile TRT value. Click the button to use the suggested value.

    3. Check Stop test to stop the test if the SLA is broken.
    4. You can clear the Enable option if you do not want the percentile TRT (seconds) value to be used during the test run.
  3. Set failed transaction settings:
    1. Set the Enable option if you want the Failed Trx (%) value to be used during the test run.
    2. Set the Failed Trx (%) value (default 10%). If the number of transaction failures exceeds this value, the SLA is assigned a status of Failed.

Tip: Select multiple SLAs at one time and use Bulk actions to apply one or more actions to the set.

Back to top

Generate single user performance data

Note: You cannot generate single user performance data for:

  • Load tests configured for the Iterations run mode.
  • Scripts configured to run on on-premises load generators.

When enabled, you can create client side breakdown data to analyze user experience for a specific business process.

Select from one or more of the following report types:

Report type How to
NV Insights

Generate a comprehensive report based on the selected script that provides information about how your application performs for a specific business process.

Generate an NV Insights report:

  1. Select the Single user performance pane.
  2. Under the Client Side Breakdown tab, select the NV Insights check box.
  3. Click Select Script and select a script for the report.

Note:

  • It can take several minutes for the NV Insights report to be generated when viewing it for the first time in a load test.

  • The NV Insights report does not support scripts in which WinInet is enabled.

See also:

TRT Breakdown

Generate TRT breakdown data:

  1. Select the Single user performance pane.
  2. Under the Client Side Breakdown tab, select the Transaction Response Time Breakdown check box.
  3. Click Select Scripts and select up to five scripts.
  4. To display the results, from the Dashboard > , select the Breakdown widget.

For details, see Transaction response time breakdown data.

WebPage

Generate a WebPage report:

  1. Select the Single user performance WebPageTest Report pane.
  2. Under the WebPage Test Report tab, enter a URL of your application. You can add up to 3 URLs.
  3. Select a network speed.

    Network speed Description

    Cable

    5/1 Mbps 28ms RTT
    DSL 1.5 Mbps/384 Kbps 50 ms RTT
    FIOS 20/5 Mbps 4 ms RTT
    56K Dial-Up 49/30 Kbps 120 ms RTT

    Mobile 3G

    1.6 Mbps/786Kbps 300ms RTT
    Mobile 3G- Fast 1.6 Mbps/786Kbps 150ms RTT
    Native Connection No traffic shaping

For details, see WebPage Test report data.

Back to top

Assign labels

Use labels to help you organize scripts in your repository, or to organize your load tests in the Load Tests and Results pages. The labels you create are common to both scripts and load tests.

Labels can be nested in sub-categories:

Click to expand the Labels pane.

You can perform the following actions for labels:

Action How to

Create a label

 

  1. From the Labels pane, select to open the new label dialog box.
  2. Give the label a name.
  3. Optionally, nest the label under another label.
  4. Click to select a label color.
Edit a label

From the Labels pane, highlight a label.

Click and select Edit.

Delete a label

From the Labels pane, highlight a label.

Click and select Remove.

Removing a label also removes any sub-labels.

Assign a color to the label

From the Labels pane, highlight a label.

Click and select Color.

Add a sub-label

From the Labels pane, highlight a label.

Click and select Add Sub-label.

Assign a label
  1. From the scripts or load tests grid, highlight one or more rows.
  2. Expand the drop down.
  3. Select the labels to assign to the selected scripts or load tests.

Use to search for a label name.

Filter by a label

Filter scripts or load tests by a specific label.

In the Labels pane, highlight the label to search for.

Use to search for a label name.

Back to top

Schedule a test run

Schedule a test to run on a specific date and time.

Caution: The most up-to-date test settings will be used when the test is launched.

To schedule a test:

  1. From Load Tests page, open the pane.
  2. Click the button.

    Note: You can configure up to 50 schedules for a load test.

  3. From the date picker, select a date to run the test.
  4. From the time picker, specify a time to run the test.
  5. To set the schedule, click .

    The button appears in the cart section indicating that a schedule is set for this load test.

Tip: In the Loads Test page, a test with a set schedule has the icon displayed next to its status.

On the lower part of the page, underneath the list of set schedules, the following two tabs show additional schedule information:

Runs tab

The Runs tab displays a list of previously scheduled runs and their launch status.

  • Launched. The test was launched successfully. Click the run ID to view results.

  • Failed to launch. The test was not launched successfully.

    Troubleshooting failed launches:

    • The number of Vusers scheduled in your test exceeds the amount remaining in your license.

    • A load generator or monitor that is defined in your test is down.

Timeline tab

Note:  

  • This tab is only displayed for tests whose license mode is set as VU.
  • This tab is not displayed for load tests configured for the Iterations run mode.

The Timeline tab displays the timeline for the selected schedule, as well as for any other schedule in the project that overlaps with the selected schedule.

If the current project uses global licenses (that is, it does not have dedicated licenses assigned to it), then schedules from other global license projects that overlap with the selected schedule are also displayed.

The timeline is colored according to its status, as follows:

  • OK (green). There are no conflicts and this schedule will run as planned.

  • Conflicting (orange). This schedule impacts another schedule and will cause it to breach your license count, but this schedule will still run as planned.

  • Blocked (red). This schedule will breach your license count and may not run.

Back to top

Generate logs

To generate logs for your load tests do the following:

Action How to
Enable logs
  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 Collect Vuser logs from …. For details, see Define general test settings.
Configure your script to generate logs
  1. In VuGen, select VuGen > Runtime Settings > Logs > Log Level and associated options.

    In TruClient, select > Run-time settings > Log >Log level and associated options.

  2. Set the Log level to standard.
Download the log

For details, see Run results options.

After your test run, you can download log files from either the Dashboard or Report. For details, see Download logs.

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 Splunk Cloud URL that was sent to you by Splunk when you created your Splunk instance.
    • The HTTP Event Collector port number.
    • If your account is a managed Splunk Cloud account (rather than a self-service account), select the Managed Splunk check box.
    • The HTTP Event Collector token.

  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 Define general test settings.

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.

Back to top

Configure the 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 Data streaming (Beta). Once your integration is complete, you can configure the Streaming agent.

To add a Streaming agent:

  1. In the Load Tests page, open the Streaming pane .
  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.

Back to top

Run the test

Once you configure all of the settings, you are ready to run the load test.

Before you run the test, review your settings in the Run Configuration Summary toolbar.

To run the test:

  1. Click Run Test. The Dashboard opens showing the default metrics for your test run in real time.

    During the test run, the dashboard's toolbar shows summary information such as the elapsed time, number of running Vusers, and so forth.

  2. To pause the scheduling during the test run, click the Pause scheduling button on the toolbar. To resume, click . For details, see Pause scheduling during a test run.
  3. To add Vusers during a test run, click the Change Load button . For details, see Change the Vuser load dynamically.
  4. To end a test run before its completion, click Stop Test.

Back to top

Notes and limitations

  • Before running your load test, always make sure that the monitor defined in the test is up and running and accessible so that it can monitor the test and display results in the dashboard.
  • An on-premises load generator can only be used by one running test at a time.
  • The number of Vusers defined in your test must not exceed the maximum number of Vusers defined in your Vuser license.

  • The SiteScope agent can only be used by one running test at a time.

Back to top

See also: