License consumption

The Tenant management License area lets admins track license consumption, allocation, and usage across projects. For details on allocating licenses, see Manage licenses.

In this topic:

License consumption overview

Licenses are consumed according to availability for a specific Vuser type. If the number of licenses configured in a test exceeds the number of available licenses for that Vuser type, the test automatically uses another existing license bundle. View your cart to see the estimated license usage before you run the test.

The following tables show several examples of how this can be applied to the Vusers (VU) license run type.

Number of licenses configured for test	Number of available licenses	Actual usage
100 Dev 50 Web 10 GUI	75 Dev 50 Web 50 GUI	75 Dev 50 Web 35 GUI
1000 Web 500 GUI	800 Web 500 GUI 500 All protocols	800 Web 500 GUI 200 All protocols

The following example shows how this is applied when the license run type is Vuser hours (VUH).

Number of licenses configured for test	Number of available licenses	Actual usage
Vusers type: 20 Web Test duration: 3 hours Cost: 60 Web VUH	50 Web VUH 50 GUI VUH	50 Web VUH 10 GUI VUH

License consumption multiplier

License consumption for both VU and VUH licenses can increase depending on the cloud load generator configuration.

To enable the cloud load generator configuration:

• The tenant administrator must submit a service request. After this capability is enabled, the tenant administrator can modify the lower limit for the number of Vusers on cloud load generators for each protocol.

• After cloud load generator configuration is enabled, an end user can reduce the maximum number of Vusers per cloud load generator on the Test settings page for a specific load test. For details on changing the default limits, see Set Vuser limits.

  Depending on the new Vuser limits configured, the system may apply a Vuser multiplier that affects VU or VUH license consumption.

  Details about Vuser multiplier ratios for license consumption are available in the service description.

License consumption examples

The following examples show VU and VUH consumption for a Web - HTTP/HTML Vuser protocol.

License Type	Configuration	License Consumption
Vuser (VU)	Tenant license: 1,000 Web VUs End-user sets the Cloud LG to run up to 1,000 VUs per LG, resulting in a ×2 multiplier.	Running a test with 400 concurrent VUs consumes 800 VUs (400 × 2) out of 1,000 licensed VUs.
Vuser Hours (VUH)	Tenant license: 100,000 Web VUHs End-user sets the Cloud LG to run up to 500 VUs per LG, resulting in a ×2 multiplier.	Running a test with 4,000 concurrent VUs for 1 hour consumes 8,000 VUHs (4,000 × 2 × 1 hour) out of 100,000 licensed VUHs.

Order of license consumption

The licenses are consumed in the following order:

1. VU licenses are consumed before VUH licenses.

2. Licenses are consumed from lowest to highest bundle cost: Dev, Web, GUI, and All protocols.

3. Licenses with the nearest expiration date are consumed first.

The following example shows the order in which the licenses with different costs and expiration dates are consumed.

Priority	Bundle	License	Expiration date
2	Dev	VU	28/10/25
1	Dev	VU	01/10/25
3	Web	VU	15/09/25
4	GUI	VU	16/08/25
6	Dev	VUH	16/08/25
5	Dev	VUH	19/03/25

For details, see Virtual user hour (VUH) licenses.

View license consumption

You can track your license consumption from within the user interface. The following table describes the viewing options.

Report name	How to access	Result
Usage Report	Click the Settings button , and select License information. Click the Usage Report tab.	Shows consumption for a specific date range for the current project. For details, see License usage report.
Consumption grid	Click the Settings button , and select Tenant management. On the Navigation menu , click License. Click the Consumption tab.	Shows the consumption per project and Vuser type. For details, see Consumption per Vuser type.
Summary report	Click the Settings button , and select Tenant management. On the Navigation menu , click License. Click the Summary tab.	Shows consumed, remaining, and allocated licenses for all projects. For details, see License allocation.
Consumption per project	Click the Settings button , and select Tenant management. On the Navigation menu , click Projects. Click the Project icon of one project (not the Project name link).	Shows license information for one project.
Allocation per project	Click the Settings button , and select Tenant management. On the Navigation menu , click Projects. Click the Project name link and open the Licenses page. Click the Allocation tab.	Shows the allocation and license information for one project. You can filter the results by Vuser type.
Usage per project	Click the Settings button , and select Tenant management On the Navigation menu , click Projects. Click the Project name link and open the Licenses page. Click the Usage tab.	Shows the current license usage for one project. You can choose a date range from the date selector.

License usage report

The Usage Report tab shows license usage per test run.

To track usage for the current project, in the banner go to Settings > License information and then select Usage Report. To export the usage report, click Export to CSV in the table header.

The following table lists the primary details that are displayed in the usage report in the user interface and the CSV file:

UI table column name	CSV file column name	Description
Run Id	run_id	The run id of the test.
Test name	test_name	The name of the test.
Vusers	vusers_num	The total number of Vusers used during the test.
Delayed start duration	delayed_start_duration	The duration of the delayed start.
Duration	duration	The duration of the test run, including the time the test was paused.
Type	run_mode	The type of license used to run the test, VU or VUH. For details, see Virtual user hour (VUH) licenses.
<Vuser type>	<Vuser type>_cost	The total number of <Vuser type> Vusers used during the test. For example, the total number of GUI Vusers used during the test. For details on the different Vuser types, see Protocol bundles.
Run time	start_time	The date and time of the test run.
State	state	The state of the test run, either Active or Deleted.
User	test_run_user	The name of the user who ran the test.

The UI usage report also lets you see the number of Vusers per bundle, and the protocol types that participated in the test run.

• To view the bundles, expand Bundles in the table header.

• To view the protocols, expand Protocols in the table header.

The following table lists additional details that are displayed in the CSV usage report, but not in the user interface window:

Column name	Description
is_test_run_deleted	Indicates whether test run was delayed: True or False.
project_name	The name of the project.
all_protocols_cost	The total license consumption for all Vuser types.
ui_status	Test run status: Passed, Failed, Stopped.
<Protocol type>_multiplier	The Vuser type multiplier.
<Protocol type>_total	Total license consumption per protocol type.

Consumption per Vuser type

The License page's Consumption tab lets you view consumption per project and per Vuser type.

You can perform the following actions.

Action	Task
Show active licenses only	Select Show active only above the project list to display only the licenses that are currently active.
Save license data to a CSV file	Click Export to CSV to save the license consumption data to a CSV file.
Show all test runs	Click Show All in the banner to display all test runs for the selected projects.
Display test runs for a selected date range	Use the date picker to specify a date range. The grid displays the test runs during that period.

License allocation

The License page's Summary tab lets you view allocation and entitlement information per license. The grid is split into two sections that you can expand and collapse:

• The Available section includes licenses that have not yet expired or have not been fully consumed.

• The Inactive section includes expired or fully utilized licenses.

The license summary grid shows the following information.

UI Elements	Value
Start date	The beginning date of the license.
Expiration date	The license's expiration date.
Type	The bundle type, such as Web VU or GUI VU. For details, see Protocol bundles. This column also indicates Dedicated IPs if they are enabled for your tenant.
Subscription	The type of subscription. For protocol bundles, typical values are Trial and Paid. For Dedicated IP addresses, the subscription types are Freemium (those provided for free with your tenant) and Paid.
Total entitled capacity	For protocol bundles, this column shows the total number of Vusers and VUH entitled by the license. For dedicated IPs, this column shows the number of entitled IPs.
Total VUH consumed	The total number of VUH licenses currently consumed. For details, see Virtual user hour (VUH) licenses.
Total VUH remaining	The total number of VUH licenses available for consumption and not currently being consumed by any project.
Total allocated to projects	The total number of licenses allocated to projects. Click the View license allocation by project button to open the Allocation summary dialog box and see a breakdown of licenses, including expired licenses, allocated to each project. The Allocation summary dialog box displays a per-project breakdown of the license ID and type (VU or VUH), project ID and name, and the allocated quantity. This provides a snapshot of how the license was recently allocated to projects, not allocation history, making it easier to reassign allocations after adding a new or renewed license. Click Export to CSV to download the allocation details for both active and inactive licenses. Note: The system does not link new licenses to prior licenses, so snapshots are not carried over between licenses. Use the allocation details to manually reassign licenses where required.
Total assigned for running tests	The total number of Vusers assigned to running tests.

Non-English usage data

If your usage data contains test names with non-English characters, you must configure your application to use UTF-8 to display the report results correctly.

For example, in Excel, use the following steps to correctly format the data to view non-English characters:

1. Import the data using Data > From Text.

2. In the Text Import Wizard select the following.

   Setting	Options
   Original data type	Delimited
   File origin	65001: Unicode (UTF-8)
   Delimiters	Comma

See also

• Tenant management
• Manage licenses
• Projects