콘텐츠로 이동
Search

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

Favorite site

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 표현과 같은 꼴임
author MCPBot sitemap