How grafana/k6 works
Grafana k6 is a developer-facing, scriptable load-testing runtime. A user invokes its CLI with a JavaScript test; k6 resolves and runs the script with virtual users and protocol APIs, aggregates metrics and evaluates thresholds, then presents or exports results. The map preserves documented protocol, browser, extensibility, and Grafana Cloud capabilities, with metrics processing as an internal layer. Relationships for unsampled subsystems are documented at capability level only; source-level call paths are included only where the excerpts or SOURCE INDEX support them.
Main entry points: ramping_vus.go Load scheduling · runner.go JS runner · engine.go Metrics engine · resolution.go Module resolution
Components 26
CLI and scripting
- CLI entry
main.go - CLI commands
internal/cmd/root.go - Module resolution
js/modules/resolution.go - Extensions
ext/ext.go
Execution runtime
- JS runner
internal/js/runner.go - Load scheduling
lib/executor/ramping_vus.go
Protocol APIs
- HTTP API
js/modules/k6/http/http.go - Browser automation
internal/js/modules/k6/browser/common/frame_manager.go - Browser networking
internal/js/modules/k6/browser/common/network_manager.go - gRPC API
internal/js/modules/k6/grpc/client.go - WebSockets API
internal/js/modules/k6/websockets/websockets.go - Streams API
internal/js/modules/k6/experimental/streams/readable_stream_default_controller.go
Metrics and results
- Metric registry
metrics/registry.go - Metrics engine
internal/metrics/engine/engine.go - Output manager
output/manager.go - Test summary
internal/output/summary/summary.go - HTTP API
internal/api/server.go - Loki logging
internal/log/loki.go - Prometheus output
internal/output/prometheusrw/remote/client.go
Cloud services
- Cloud commands
internal/cmd/cloud_run.go - Cloud API client
internal/cloudapi/v6/client.go - Cloud insights
internal/cloudapi/insights/client.go - Cloud metrics output
internal/output/cloud/output.go
Other components
- Test author
- Grafana Cloud
- JavaScript test
Connections 26
- Test author → CLI entry: runs
- CLI entry → CLI commands: dispatches
main.go - CLI commands → Module resolution: loads scripts
- Module resolution → Extensions: resolves extensions
js/modules/resolution.go - Module resolution → JS runner: prepares modules
- JavaScript test → JS runner: executes as
- JS runner → Load scheduling: runs virtual users
- Load scheduling → HTTP API: generates traffic
- Load scheduling → Browser automation: runs browser workloads
- Load scheduling → gRPC API: generates traffic
- Load scheduling → WebSockets API: generates traffic
- Browser automation → Browser networking: manages requests
- JS runner → Streams API: exposes API
- JS runner → Metric registry: defines metrics
- Metric registry → Metrics engine: provides metrics
internal/metrics/engine/engine.go - Metrics engine → Output manager: aggregates samples
- Output manager → Prometheus output: dispatches samples
output/manager.go - Output manager → Cloud metrics output: dispatches samples
- Metrics engine → Test summary: supports results
- Metrics engine → HTTP API: serves test state
internal/api/server.go - Test author → Cloud commands: manages cloud tests
- Cloud commands → Cloud API client: calls lifecycle API
- Cloud metrics output → Cloud insights: sends insights
- Cloud metrics output → Grafana Cloud: uploads metrics
- Cloud API client → Grafana Cloud: manages test runs
- Loki logging → Grafana Cloud: ships logs