grafana k6 데이터를 influxDb v2에 저장하는 방법

이 글은 k6 데이터를 influxDB v2에 저장하는 방법을 설명합니다.

 

요약

2025.4월 기준 k6의 데이털는 influxdb v2를 저장하지 못합니다. 만약 저장해야 한다면 xk6-output-influxdb플러그인을 사용해야 합니다.

• 플러그인 링크: https://github.com/grafana/xk6-output-influxdb

 

k6 데이터를 데이터베이스에 저장해야하는 이유

k6 데이터는 부하 테스트 결과입니다. 해당 데이터는 k6를 실행할때만 임시적으로 저장하는 휘발성데이터입니다. 따라서 부하 테스트를 분석하고 여러 사람과 같이 공유하려면 데이터베이스에 저장해야 합니다.

 

k6에서 지원하는 데이터베이스를 real time이라고 부릅니다. 현재 지원하는 real time은 시계열 DB입니다. influxDB가 오픈소스여서 많이 사용하는 편이고 최근 실험모드로 prometheus를 지원하고 있습니다.

 

influxDB의 버전

influxDB의 v1은 아직 deprecated가 되지는 않았지만 신규기능 개발이 중단되었습니다. 아쉬운 인증/인가 기능, 성능개선, 웹UI 미지원 등이 있어 influxDB에서는 v2사용을 권장하고 있습니다.

 

k6에서는 influxDB v2를 지원하지 않는다.

하지만 influxDB v2에서는 core API가 변했기 때문에, k6에서 안타깝게 지원하지 않습니다. 다행히도 k6 플러그인을 사용하면 influxDB v2도 사용할 수 있습니다.

• github 링크: https://github.com/grafana/xk6-output-influxdb

 

influxDB v2플러그인 설치 방법

플러그인은 내 PC에서 빌드를 해야 합니다. 빌드를 위해 go언어가 설치되어야 합니다. 아래 명령어를 순서대로 실행하면 k6 실행파일이 생성됩니다.

  

    
    
    
    
  
go install go.k6.io/xk6/cmd/xk6@latest
xk6 build --with github.com/grafana/xk6-output-influxdb@latest

 

생성된 k6를 사용하여 k6스크립트를 실행합니다. k6 실행인자에 –out xk6-influxdb을 지정하여 데이터를 influxDB v2에 저장합니다.

  

    
    
    
    
  
./k6 run --out xk6-influxdb=http://localhost:8086 {k6 스크립트 경로}

 

참고자료

• https://github.com/grafana/xk6-output-influxdb