K6
lastmod 2026-11-16created 2026-11-162 edits
k6(Grafana k6)는 Grafana Labs가 만드는 오픈 소스 부하 테스트 도구이다. 엔진은 Go로 작성되어 있고, 테스트 시나리오는 JavaScript로 쓴다. 응답 시간 같은 목표치(SLO)를 스크립트 안에 thresholds 로 적어 두면 테스트가 그 기준으로 통과·실패를 판정하므로, CI/CD 파이프라인에 성능 검사를 넣는 용도로 많이 쓰인다.
About
- 스크립트는 ES 모듈 형식.
k6/http같은 내장 모듈을 import 하고,export default function안에 가상 사용자(VU)가 반복할 동작을 적음. 실행은k6 run script.js -
options의vus·duration으로 부하를 정하거나,stages로 VU 수를 시간에 따라 늘리고 줄임. scenarios 로 open/closed 모델, 고정 RPS, 고정 반복 횟수 같은 부하 모양을 고를 수 있음 -
check()로 응답 상태·본문을 검사함. thresholds 는http_req_duration: ["p(99) < 3000"]처럼 메트릭과 백분위 기준을 짝지어 적고, 기준을 못 넘기면 테스트가 실패로 끝남 - 공식 문서의 테스트 유형 가이드: smoke, load, stress, spike, soak
- HTTP, WebSockets, gRPC 와 브라우저 테스트(k6 browser) 지원. xk6-kafka, xk6-kubernetes 같은 확장으로 프로토콜·기능 추가
- 결과는 Prometheus remote write, Datadog, New Relic 등으로 내보내 Grafana 대시보드에서 봄. 같은 스크립트를 Grafana Cloud k6 나 Kubernetes(
kubectl apply)에서도 실행 - 코드를 직접 쓰지 않고 스크립트를 만드는 데스크톱 앱 k6 Studio 가 따로 있음
- AGPL-3.0 라이선스
See also
- Load testing
- Grafana
- Locust - Python 코드로 사용자 행동을 정의하는 부하 테스트 도구
- Gatling - Scala로 작성된 부하 테스트 도구
Favorite site
- Load testing for engineering teams | Grafana k6
- Grafana k6 | Grafana k6 documentation
- Github - grafana/k6
Articles
- [K6] K6 를 시작하기 전 알아두면 좋은 점 - 로켓🐾
-
vus: 10, duration: "10s"로 실행하면 가상 사용자 10명이 10초 동안 default 함수를 계속 반복 호출함. 사용자마다 한 번씩 부르는 것이 아님 - Latency 는 요청부터 응답까지 걸린 시간, Throughput 은 단위 시간당 처리한 요청 수. 둘을 식당 주문에 빗대어 설명함
- 테스트는 자기 소유의 앱에, 운영이 아닌 Dev·Staging 환경에서 함. 클라우드에서는 테스트 중 scale up/out 이 일어나는지도 확인해야 함
- 평균은 느린 요청을 가림. 주문 500건 중 400건이 20초, 100건이 10분 넘게 걸려도 평균은 4분 정도로 나옴
- 그래서 k6 결과에 p(90)·p(95) 가 나옴. p(90) 은 요청의 90% 가 그 시간 안에 끝났다는 뜻이며, "응답의 90%는 0.5초 안에" 같은 SLO 표현과 같은 꼴임
-
이 문서를 가리키는 문서