Menu
Open source

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 is at least one open browser window for the dashboard extension. In this way, the report can be downloaded, for example, even after the test has been completed.

In certain environments, it is not allowed that the k6 process does not exit after the test run (e.g CI/CD pipeline). In this case, it is advisable to disable the HTTP port (with the -1 value of port parameter).

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

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.``