docs

Creating and running a test

Test authoring
Cloud tests from the CLI
Script editor
Browser recorder
Cloud scripting extras
Troubleshooting

Analyzing Results

Overview
Performance Insights
Inspect thresholds
Inspect checks
Inspect HTTP requests
Inspect logs
Compare metrics
Compare tests
Save, share, and delete tests
Export results

Manage

Thresholds
Schedule a test
Send notifications
Environment variables
Usage Reports
Audit Trail

Integrations

Token
Cloud APM
Grafana App
Cloud to Prometheus RW

Project and Team Management

Organizations
Teams
Projects
Members
SAML SSO

Your plan

Manage subscription
Billing
Pricing questions
About data retention

Cloud reference

Test status codes
Cloud IPs
Release notes
k6.ioapp.k6.io

No results for “”

Powered byAlgolia
⚠️ This documentation is outdated. Please visit grafana.com for the latest k6 documentation.📚

Cloud environment variables

suggest edits

When you run tests in k6 Cloud, you can use three additional environment variables to find out in which load zone, server instance, and distribution label the script is currently running.

You can also set your own environment variables

To use custom Cloud environment variables, refer to Cloud environment variables.

NameValueDescription
K6_CLOUDRUN_LOAD_ZONEstringThe load zone from where the metric was collected. Values will be of the form: amazon:us :ashburn (see list above).
K6_CLOUDRUN_INSTANCE_IDnumberA sequential number representing the unique ID of a load generator server taking part in the test, starts at 0.
K6_CLOUDRUN_DISTRIBUTIONstringThe value of the "distribution label" that you used in ext.loadimpact.distribution corresponding to the load zone the script is currently executed in.

You can read the values of these variables in your k6 script as usual.

Reading injected environment variables
export const options = {
  vus: 50,
  duration: '30s',
  ext: {
    loadimpact: {
      distribution: {
        ashburnDistribution: { loadZone: 'amazon:us:ashburn', percent: 50 },
        dublinDistribution: { loadZone: 'amazon:ie:dublin', percent: 50 },
      },
    },
  },
};
export default function () {
  if (__ENV.K6_CLOUDRUN_DISTRIBUTION === 'ashburnDistribution') {
    // do something
  } else if (__ENV.K6_CLOUDRUN_DISTRIBUTION == 'dublinDistribution') {
    // do something
  }
}

The LI_ prefix is deprecated

Previously, cloud environment variables were prefixed with LI_ (for example, LI_LOAD_ZONE). These names are deprecated and may be removed in future versions of k6 Cloud.

previousCloud tags