Skip to main content

Integrations

k6 integrates with a wide ecosystem of tools for monitoring, visualization, CI/CD, and more.

Observability and monitoring

Grafana

Visualize k6 metrics in Grafana dashboards with InfluxDB, Prometheus, or k6 Cloud.

Prometheus

Export k6 metrics to Prometheus for long-term storage and alerting.
k6 run --out experimental-prometheus-rw script.js

InfluxDB

Stream real-time metrics to InfluxDB for analysis and visualization.
k6 run --out influxdb=http://localhost:8086 script.js

Datadog

Send k6 metrics to Datadog for unified observability.
k6 run --out datadog script.js

CI/CD platforms

GitHub Actions

Use the official k6 action:
name: Load Test
on: [push]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: grafana/[email protected]
        with:
          filename: test.js
          flags: --vus 50 --duration 10s

GitLab CI

load_test:
  image: grafana/k6:latest
  script:
    - k6 run test.js
  artifacts:
    reports:
      junit: summary.xml

Jenkins

pipeline {
  agent any
  stages {
    stage('Load Test') {
      steps {
        sh 'k6 run --out json=results.json test.js'
      }
    }
  }
}

CircleCI

version: 2.1
jobs:
  load-test:
    docker:
      - image: grafana/k6:latest
    steps:
      - checkout
      - run: k6 run test.js

Test generation

k6 Studio

Desktop app for recording and generating k6 scripts from browser interactions.

Postman

Convert Postman collections to k6 scripts:
postman-to-k6 collection.json -o script.js

HAR files

Generate tests from HAR (HTTP Archive) files:
har-to-k6 archive.har -o script.js

OpenAPI

Generate tests from OpenAPI specifications:
openapi-generator generate -g k6 -i api.yaml

Cloud platforms

Grafana Cloud k6

Run tests in the cloud with built-in dashboards and insights:
k6 cloud script.js
Learn more about Grafana Cloud k6

AWS

  • Run k6 on EC2 instances for distributed testing
  • Use AWS Lambda with k6 for serverless testing
  • Store results in CloudWatch or S3

Azure

  • Deploy k6 using Azure Container Instances
  • Use Azure Load Testing (powered by k6)
  • Stream metrics to Azure Monitor

Google Cloud

  • Run k6 on GKE (Google Kubernetes Engine)
  • Use Cloud Run for serverless k6 tests
  • Export metrics to Cloud Monitoring

Kubernetes

k6-operator

Run distributed k6 tests on Kubernetes clusters.
apiVersion: k6.io/v1alpha1
kind: K6
metadata:
  name: k6-sample
spec:
  parallelism: 4
  script:
    configMap:
      name: test-script
Learn more about distributed testing

Test data and mocking

Generate realistic test data:
import { Faker } from 'https://esm.sh/@faker-js/faker';

const faker = new Faker();

export default function () {
  const user = {
    name: faker.person.fullName(),
    email: faker.internet.email(),
  };
}
Mock REST APIs for testing:
# Start mock server
json-server --watch db.json

# Test against it
k6 run test.js
Stub HTTP services:
import http from 'k6/http';

export default function () {
  http.get('http://localhost:8080/api/users');
}

Reporting

HTML reports

Generate HTML reports from k6 results:
k6 run --out json=results.json script.js
k6-reporter results.json

JUnit reports

For CI/CD integration:
import { jUnit, textSummary } from 'https://jslib.k6.io/k6-summary/0.0.1/index.js';

export function handleSummary(data) {
  return {
    'stdout': textSummary(data, { indent: ' ', enableColors: true }),
    'summary.xml': jUnit(data),
  };
}

CSV/JSON export

Export metrics to files:
k6 run --out csv=results.csv script.js
k6 run --out json=results.json script.js

Notification and alerting

Slack

Send test results to Slack channels.

PagerDuty

Trigger incidents on test failures.

Email

Email test summaries and alerts.

Webhooks

POST results to custom endpoints.

Extensions ecosystem

k6 has a rich extension ecosystem for specialized testing needs.
Explore k6 extensions

Community tools

  • k6-jslib-utils - Utility functions for k6 scripts
  • k6-jslib-aws - AWS SDK for k6
  • k6-jslib-httpx - Enhanced HTTP client
  • k6-chaijs - Chai assertions for k6

Automated testing

CI/CD integration guide

Results output

Exporting and visualizing results

Extensions

Extending k6 functionality

Grafana Cloud k6

Cloud-based test execution

Build docs developers (and LLMs) love