Menu
Open source RSS

Web dashboard

k6 provides a built-in web dashboard that you can enable to visualize and monitor your tests results in real-time.

Web dashboard screenshot

The dashboard provides a real-time overview of the performance observed by k6 while a test is running, and can help you identify potential reliability issues as they occur.

How to use

The web dashboard is a built-in feature of k6. You can enable it by setting the K6_WEB_DASHBOARD environment variable to true when running your test script, for example:

shell
K6_WEB_DASHBOARD=true k6 run script.js
shell
K6_WEB_DASHBOARD=true ./k6 run script.js

          /\      |‾‾| /‾‾/   /‾‾/
     /\  /  \     |  |/  /   /  /
    /  \/    \    |     (   /   ‾‾\
   /          \   |  |\  \ |  (‾)  |
  / __________ \  |__| \__\ \_____/ .io

     execution: local
        script: ../extensions/xk6-dashboard/script.js
 web dashboard: http://127.0.0.1:5665
        output: -

By default, the web dashboard is available on localhost port 5665. You can change the host and port by using the dashboard options.

Note

The k6 process waits to exit as long as there’s at least one open browser window for the dashboard extension.

In certain environments, such as a CI/CD pipeline, the k6 process has to exit after the test run completes. In that case, it’s advisable to disable the HTTP port by setting it to -1.

Generate HTML test reports

You can generate detailed, downloadable HTML reports directly from the web dashboard or the command line. These reports are self-contained, making them ideal for sharing with your team.

HTML test report screenshot

Generate report from web dashboard

To generate a report from the web dashboard, click Report on the dashboard’s menu.

HTML test report generation button

Generate report from the command line

To automatically generate a report from the command line once the test finishes running, use the K6_WEB_DASHBOARD_EXPORT option. For example:

shell
K6_WEB_DASHBOARD=true K6_WEB_DASHBOARD_EXPORT=html-report.html k6 run script.js

Note

The report only includes graphs if the test duration is greater than three times the aggregation period value, set by the K6_WEB_DASHBOARD_PERIOD variable.

Dashboard options

The web dashboard can be configured using environment variables:

Environment variableDescriptionDefault value
K6_WEB_DASHBOARDEnable the web dashboardfalse
K6_WEB_DASHBOARD_HOSTHost to bind the web dashboard tolocalhost
K6_WEB_DASHBOARD_PORTPort to bind the web dashboard to5665
K6_WEB_DASHBOARD_PERIODPeriod in seconds to update the web dashboard10s
K6_WEB_DASHBOARD_OPENOpen the web dashboard in the default browserfalse
K6_WEB_DASHBOARD_EXPORTFilename to automatically export the HTML test report to at the end of the test run. By default, the value is empty and the report isn’t exported.``