Documentation Grafana Cloud Testing and synthetics Performance testing Author and run tests Cloud scripting extras Cloud tags

Cloud tags

When a test runs in k6 Cloud, k6 adds two tags to all metrics. As with all tags in k6, you can use cloud tags to filter results.

By default, k6 only preserves instance_id in the following metrics: iterations, load_generator_cpu_percent, load_generator_file_handles, load_generator_memory_percent, vus and vus_max. You can use the keep_tags configuration option to retain it on other metrics.

The cloud tags are automatically added when collecting test metrics. They work as regular tags do. For example, you can filter the results for a particular load zone, or define a Threshold based on the results of a load zone.

JavaScript Copy

import http from 'k6/http';

export const options = {
  vus: 50,
  duration: '30s',
  thresholds: {
    'http_req_duration{load_zone:amazon:us:ashburn}': ['p(95)<500'],
    'http_req_duration{load_zone:amazon:ie:dublin}': ['p(95)<800'],
  },
  cloud: {
    distribution: {
      ashburnDistribution: { loadZone: 'amazon:us:ashburn', percent: 50 },
      dublinDistribution: { loadZone: 'amazon:ie:dublin', percent: 50 },
    },
  },
};
export default function () {
  http.get('https://quickpizza.grafana.com');
}