Node 서비스 성능·부하 테스트 적용 방법

개요

성능 테스트와 부하테스트는 서비스 안정성을 확보하는 핵심 활동이다. 특히 Node 기반 API는 단일 스레드 모델 특성 때문에 동시성 처리와 I/O 패턴에 따라 성능 병목이 달라진다. 이 글에서는 Apache JMeter와 k6를 사용한 실무 적용 방법을 알기 쉽게 설명한다. 초보자도 따라 할 수 있도록 준비부터 스크립트 작성, 실행, 결과 해석까지 단계별로 정리한다.

기본 개념 정리

성능 테스트 vs 부하테스트

성능 테스트는 응답 시간, 처리량, 리소스 사용률 같은 지표를 측정해 기준을 검증하는 활동이다. 부하테스트는 시스템에 일정량 이상의 트래픽을 주어 시스템이 어떻게 동작하는지 확인하는 테스트다. 둘은 목적과 설계 관점에서 차이가 있으나 도구와 시나리오 설계 원칙은 유사하다.

테스트 전 준비 사항

• 테스트 목표 정의 (응답 시간 SLA, 동시 사용자 수, 목표 처리량)
• 성능 지표 선정 (p95, p99 응답 시간, 에러율, CPU/메모리)
• 테스트 환경 구성 (스테이징 환경 추천, 실제 서비스와 유사한 데이터)
• 모니터링 준비 (애플리케이션, 인프라 메트릭 수집 도구 연동)

JMeter를 이용한 API 부하테스트 (JMeter API 부하테스트 Node)

왜 JMeter를 선택하는가

JMeter는 GUI 기반 설계가 가능하며 복잡한 시나리오와 다양한 프로토콜을 지원한다. 기존에 익숙한 팀이거나 복합적인 요청 흐름을 재현해야 할 때 유리하다.

간단한 테스트 플랜 예시

다음은 CLI로 JMeter를 실행하는 기본 명령 예시다.

jmeter -n -t test_plan.jmx -l results.jtl -Jusers=100 -Jrampup=30

test_plan.jmx는 HTTP 요청, 스레드 그룹, 리스너를 포함한다. Node API를 대상으로 할 때는 인증 토큰과 헤더를 변수로 관리하면 재현성이 좋아진다.

실무 팁

• 스레드 그룹을 통해 동시 사용자 수와 램프업을 조절한다.
• 정적 파일 요청은 제외하고 API 중심으로 측정한다.
• 결과 jtl 파일은 Grafana/Loki와 연동하거나 JMeter 플러그인으로 시각화한다.

k6를 이용한 Node 부하테스트 (Node 부하테스트 k6 사용법)

k6의 장점

k6는 스크립트 기반이며 코드형 테스트를 선호하는 팀에 적합하다. CI 파이프라인과 연계가 쉽고 메모리 효율이 좋다. JavaScript로 시나리오를 정의하므로 개발자가 빠르게 익힐 수 있다.

기본 k6 스크립트 예시

import http from 'k6/http';
import { check, sleep } from 'k6';

export let options = {
  vus: 50,
  duration: '1m',
};

export default function () {
  const res = http.get('https://api.example.com/users');
  check(res, { 'status 200': (r) => r.status === 200 });
  sleep(1);
}

위 스크립트는 50명의 가상 사용자가 1분 동안 GET 요청을 반복해 API 응답을 검증한다. 복잡한 시나리오 생성, 페이로드 POST, 인증 핸들링도 JavaScript로 구현 가능하다.

실행과 결과 해석

• 로컬 실행: k6 run script.js
• 결과는 평균 응답시간, 에러율, 처리량(RPS) 중심으로 해석
• 지표가 SLA를 벗어나면 프로파일링(콜 스택, 이벤트 루프 지연)과 인프라 리소스를 확인

성능 테스트 시나리오 설계 (성능 테스트 시나리오 Node)

시나리오 설계는 현실적 트래픽 패턴을 재현하는 것이 목표다. 다음 절차를 따른다.

• 사용자 행동 흐름 도출 (인증 → 목록 조회 → 상세 조회 → 변경)
• 각 흐름에 대한 가중치 설정 (예: 조회 70%, 생성 20%, 삭제 10%)
• 데이터 세트 분리로 캐시 효과 최소화
• 점진적 부하 증가(스모크 → 스트레스 → 러닝)로 병목 재현

결과 분석과 대응

결과 해석 시 우선 에러 로그와 응답 시간 분포(p95, p99)를 확인한다. CPU, 메모리, 이벤트 루프 지연, DB 연결 수를 함께 분석하면 병목 원인을 좁힐 수 있다. 예를 들어 이벤트 루프 지연이 크면 비동기 I/O 로직을 점검하고, DB 대기 시간이 길면 쿼리 최적화나 커넥션 풀 조정을 고려한다.

마무리 체크리스트

• 테스트 목표와 성공 기준 문서화
• 현실적 시나리오 반영 및 데이터 준비
• 모니터링 연동으로 인프라 지표 동시 수집
• 반복 실행을 통한 회귀 확인

JMeter와 k6는 목적과 환경에 따라 선택할 수 있는 강력한 도구다. 본문에서 제시한 절차와 예시를 바탕으로 자신의 Node 서비스 특성에 맞게 시나리오를 구성하면 실무에서 유의미한 성능 개선을 도출할 수 있다.