DocumentationGrafana k6Set upSet up distributed k6UsageUse the k6 Operator with Grafana Cloud k6

Use the k6 Operator with Grafana Cloud k6

Grafana Cloud k6 is the Grafana Cloud offering of k6, which gives you access to all of k6 capabilities, while Grafana handles the infrastructure, storage, and metrics aggregation and insights from your tests.

When using the k6 Operator, you can still leverage Grafana Cloud k6 to get access to the metric storage and analysis that the platform offers.

There are two ways to use the k6 Operator with Grafana Cloud k6: Private Load Zones and Cloud output.

Before you begin

To use the k6 Operator with Grafana Cloud k6, you’ll need:

• A Grafana Cloud account.

Private Load Zones

Private Load Zones (PLZ) are load zones that you can host inside your network by using the k6 Operator. You can start a cloud test in a PLZ by referencing it by name from your script, and the test will run in the nodes of your Kubernetes cluster.

Refer to Set up private load zones for more details.

Cloud output

With k6, you can send the output from a test run to Grafana Cloud k6 with the k6 run --out cloud script.js command. This feature is also available in the k6 Operator if you have a Grafana Cloud account.

To use this option in k6 Operator, set the argument in YAML:

yaml Copy

# ...
script:
  configMap:
    name: '<configmap>'
arguments: --out cloud
# ...

Then, if you installed operator with bundle or Helm, create a secret with the following command:

bash Copy

kubectl -n k6-operator-system create secret generic my-cloud-token \
    --from-literal=token=<COPY YOUR TOKEN HERE> && kubectl -n k6-operator-system label secret my-cloud-token "k6cloud=token"

Alternatively, if you installed operator with a Makefile, you can uncomment the cloud output section in config/default/kustomization.yaml and copy your token from Grafana Cloud k6 there:

yaml Copy

# Uncomment this section if you need cloud output and copy-paste your token
secretGenerator:
  - name: cloud-token
    literals:
      - token=<copy-paste-token-string-here>
    options:
      annotations:
        kubernetes.io/service-account.name: k6-operator-controller
      labels:
        k6cloud: token

After updating the file, run make deploy.

After these steps, you can run k6 with the cloud output and default values of projectID and name.

Refer to Cloud options for details on how to change the projectID and name options.