Cloud options
Cloud execution has a few extra options, including to distribute load across different regions or to change projects. These cloud options are not required.
For all available options, refer to Options in the k6 OSS docs.
Example syntax
Configure cloud options in the options.ext.loadimpact
object:
export const options = {
ext: {
loadimpact: {
name: 'Hello k6 cloud!',
projectID: 123456,
staticIPs: true,
drop_metrics: ["http_req_tls_handshaking", "http_req_waiting", "http_req_connecting"],
drop_tags: {"http_req_duration": ["instance_id"]},
distribution: {
distributionLabel1: { loadZone: 'amazon:us:ashburn', percent: 50 },
distributionLabel2: { loadZone: 'amazon:ie:dublin', percent: 50 },
},
note: 'Anything that may be worth noting about your test.',
},
},
};
Options and syntax
Name | Default | Description |
---|---|---|
name (string) | The name of the main script file, so something like script.js . | The name of the test in the k6 Cloud UI. Test runs with the same name will be grouped. |
projectID (number) | Empty. | The ID of the project to which the test is assigned in the k6 Cloud UI. |
distribution (object) | The equivalent of someDefaultLabel: { loadZone: "amazon:us:ashburn", percent: 100 } . | How the traffic distributes across existing Load Zones. The keys are string labels that will be injected as environment variables. |
note (string) | Empty by default. | Notes regarding the test, changes made, or anything to note about your test. |
deleteSensitiveData (boolean) | False by default | If true , k6 deletes sensitive data as soon as the test starts running or, if still queued, when the test aborts. Sensitive data includes scripts, HAR files, archives, and APM credentials. |
drop_metrics (array) | Empty by default | Drops the metrics listed in the array during ingestion time. E.g. ["http_req_tls_handshaking"] . This helps reduce the cardinality of time series. |
drop_tags (object) | Empty by default | Drops tags for a specified metric, where the metric is the key and the tags are an array. E.g. {"http_req_duration": ["instance_id"]} . This helps reduce the cardinality of time series. |
The
deleteSensitiveData
option is unavailable in default subscriptions. If you want to activate it, contact our CS team at support@k6.io.
Options to reduce time series
The Too many time series
alert aborts a test run.
Sometimes, though, a test might trigger the alert even if the script follows all recommended practices from the performance insight.
In these cases, you can consider the drop_metrics
and drop_tags
options.
Note that if you use these options, some graphs may appear empty for the metrics deleted.
Certain important tags and metrics cannot be dropped:
- For metrics, you can’t drop
http_reqs
orhttp_req_duration
. - For tags, you can’t drop
name
andmethod
fromhttp_req_duration
.
Related resources from Grafana Labs


