Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/gatling/gatling.io-doc/llms.txt

Use this file to discover all available pages before exploring further.

Credits are the unit of consumption in Gatling Enterprise Edition. Every test run spends credits proportional to the number of load generators deployed and the duration of the run. Understanding how credits are consumed helps you plan your testing budget, avoid surprises at billing time, and configure usage quotas to keep teams within their allotted share.

How credits are consumed

The consumption rule is straightforward:
1 credit = 1 load generator × 1 minute of runtime
This means a test that runs for 10 minutes with 3 load generators consumes 30 credits.
Credits are consumed the same way for both managed locations (hosted by Gatling) and private locations (hosted on your own infrastructure). The billing model does not differentiate between the two.

When does consumption begin?

Credit consumption begins as soon as the load generator instances or containers are provisioned and running—not when virtual users start injecting load. In particular, the simulation initialization phase (which may include long-running custom setup code) is included in the billable time.
You are charged one credit per load generator per minute even if the test fails to start due to an error on your side. Examples of chargeable failure scenarios include:
  • Your private location infrastructure is unable to spawn load generator instances
  • The simulation initialization crashes or times out due to your code

Viewing credit usage

Credit consumption details are visible in the Billing section of Organization Settings (accessible to Administrators only).

Extra credits

When you approach the credit limit of your current plan, Gatling Enterprise can be configured to allow extra credits to keep tests running. This prevents a hard block on test launches when the plan allocation runs out.
1

Approach the credit limit

As your available credits decrease, the Billing page displays a warning indicator.
2

Enable extra credits

Click Edit spending limit on the Billing page and enter the maximum number of extra credits your organization is allowed to consume above the plan allocation.
3

Run tests with extra credits

Tests that would have been blocked by insufficient credits will now proceed, consuming extra credits up to the configured limit.
Extra credits and spending limits are only available for subscriptions billed through Stripe. Organizations subscribed via the AWS Marketplace manage consumption through AWS billing controls.

Team credit quotas

Organization administrators can assign credit quotas to individual teams to prevent any single team from consuming a disproportionate share of the organization’s total allocation.
1

Open the Teams page

Navigate to OrganizationTeams in the sidebar.
2

Edit the quota

Click the edit icon (✏️) in the Quota column next to the team whose limit you want to set.
3

Enter a quota value

Enter the maximum number of credits the team can consume per billing period. Leave the field empty to allow unlimited consumption for that team.
4

Save

Click Save. Quotas are automatically carried over to the next billing period unless explicitly changed.
You must be an Organization Administrator with an annual plan to set team credit quotas. The quota applies to either an annual or monthly period depending on your plan configuration.

Plans and offers

Current plan details and available offers are visible at the bottom of the Billing page.
FieldDescription
StatusCurrent plan state: Active, Terminated, or PaymentFailure
From / ToStart and optional end date of the current plan
CreditsNumber of credits awarded per billing cycle
To upgrade, downgrade, or subscribe to a new plan:
To change your billing information or download invoices for Stripe-based subscriptions, click Customer portal in the Billing settings section. AWS Marketplace subscribers manage invoices directly in AWS.

Build docs developers (and LLMs) love