전공영역 공부 기록

grafana k6 웹 대시보드 활성화 하는 방법

악분 2025. 4. 14. 22:50
반응형

요약

k6 결과 데이터를 시각화 또는 결과 html파일로 생성하고 싶다면 웹 대시보드를 사용해보세요. 웹 대시보드는 디폴트로 비활성화 되어 있어, 환경변수 K6_WEB_DASHBOARD를 true로 해야 합니다.

K6_WEB_DASHBOARD=true ./k6 run script.js

 

k6 웹 대시보드란?

k6는 테스트 결과를 stdout으로 보여줍니다. 데이터를 시각화하려면 데이터 포맷을 json 등으로 변경하서 작업하거나 database와 연동해야 합니다. 데이터 시각화 설정의 단점은 시각화 할때까지의 과정이 많습니다. 즉, 준비시간이 많이 걸립니다. 준비시간이 짧을 때 또는 일회성으로 데이터를 시각화 하고 싶을 때는 웹 대시보드 기능이 좋습니다. virtual users, latency, request failed 등의 메트릭을 시각화합니다.

 

웹 대시보드 실행 방법

환경변수 K6_WEB_DASHBOARD를 true로 하면 웹 대시보드 기능이 활성화 됩니다. 디폴트는 false입니다.

K6_WEB_DASHBOARD=true ./k6 run script.js

 

주의사항

k6 웹 대시보드를 실행하면 웹 대시보드가 종료될때까지 k6 프로세스는 종료되지 않습니다. 단, k6 스크립트에서 thresholds 설정되어 있으면, thresholds가 실패하면 웹 대시보드 실행여부와 관계없이 k6 프로세스는 종료됩니다.

 

k6 웹 대시보드에서 보고서.html파일로 생성

K6_WEB_DASHBOARD_EXPORT 환경변수에 html파일 경로를 적으면, 웹 대시보드의 결과가 html파일로 생성됩니다.

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

 

html파일 생성원리는 수동으로 html파일 만드는 과정입니다. k6 웹 대시보드의 오른쪽 위에 있는 REPORT버튼을 클릭하고 save as버튼으로 html파일 저장하면, k6 웹 대시보드의 결과가 html파일로 저장됩니다.

 

참고자료

반응형