JMeter 테스트를 Apidog로 마이그레이션하려면 .jmx 파일을 가져오고(Apidog는 JMeter를 지원 가져오기 형식으로 나열하며, Apidog CLI는 --format jmeter를 허용합니다), 가져온 결과를 검토하고, 흐름을 테스트 시나리오로 재구성한 뒤, 부하 테스트를 진행하기 전에 기능 실행을 통과하는지 확인하세요. 타이머, Groovy 스크립트, 비 HTTP 샘플러는 수동 작업이 필요합니다.
아래에서는 .jmx 파일에 무엇이 담겨 있는지, 각 요소가 어떻게 매핑되는지, 매핑이 어디서 깨지는지, 그리고 코딩 에이전트가 Apidog CLI로 이 작업을 어떻게 수행할 수 있는지 다룹니다.
JMeter .jmx 파일 안에는 무엇이 있을까
.jmx 파일은 저장된 JMeter 테스트 플랜으로, JMeter가 위에서 아래로 실행하는 XML 요소 트리입니다. JMeter 사용자 매뉴얼은 이 구성 요소들을 정의합니다. 모든 요청은 스레드 그룹 아래에 위치하며, 나머지 요소들은 해당 요청들이 전송, 검증, 타이밍되는 방식을 변경합니다.
파일을 열면 다음과 같은 요소들을 볼 수 있습니다:
- Thread Group: 시뮬레이션되는 사용자입니다. 스레드 수, 램프업 기간, 반복 횟수를 설정합니다.
- Samplers: 실제 요청들입니다. HTTP Request가 가장 일반적이지만, JDBC, FTP, LDAP, TCP 샘플러도 있습니다.
- Logic controllers: 순서와 반복을 결정하는 If, While, Loop, Transaction, Simple 컨트롤러입니다.
- Config elements: HTTP Request Defaults, Header Manager, Cookie Manager, CSV Data Set Config, User Defined Variables입니다.
- Pre- and post-processors: 추출기(Regex, JSON, XPath, Boundary)와 주로 Groovy로 작성되는 JSR223 스크립트입니다.
- Assertions: Response, Duration, Size, JSON 어설션입니다.
- Timers: Constant, Gaussian Random 등 샘플러 사이의 지연을 설정합니다.
- Listeners: 결과 트리, 집계 리포트, HTML 대시보드입니다.
도구 자체에 대한 복습이 필요하다면, 플랜을 분해하기 전에 JMeter가 무엇이고 어떻게 작동하는지를 먼저 읽어보세요.
Apidog는 JMeter 파일을 가져올 수 있을까?
가능합니다. Apidog 마이그레이션 가이드는 JMeter를 "API Clients & Data Tools" 아래에 "Apache JMeter 스크립트 파일 가져오기"라는 설명과 함께 나열합니다. Apidog CLI도 동일한 가져오기를 제공합니다: apidog import --help를 실행하면 --format 값 목록에 jmeter가 표시됩니다.
문서에 공개되지 않은 것은 JMeter 가져오기에 대한 요소별 매핑입니다. Postman의 JMeter 마이그레이션 가이드는 "정확히 가져옴", "근사적으로 가져옴", "지원되지 않음" 항목으로 구성된 가져오기 리포트를 제공합니다; Apidog의 수동 가져오기는 대신 미리보기를 제공하며, 확정하기 전에 가져올 항목을 선택할 수 있습니다. 따라서 가져오기를 마이그레이션의 최종 완성본이 아닌 첫 번째 초안으로 취급하세요. 가져온 결과를 열어 .jmx 트리와 비교하고, 빠진 부분을 직접 또는 에이전트를 통해 수정하세요.
한 가지 솔직한 주의 사항: Apidog의 성능 테스트는 베타 상태이며 실행당 최대 100명의 가상 사용자까지 지원합니다. JMeter 플랜이 분산 환경에서 수천 개의 스레드를 구동한다면, 최대 부하 테스트는 JMeter를 유지하고 기능 및 회귀 테스트 쪽은 Apidog로 옮기세요.
JMeter 요소가 Apidog에 매핑되는 방식
일반적인 HTTP 테스트 플랜의 대부분은 Apidog에서 직접적인 대응 위치를 가집니다. 아래 표는 마이그레이션 후 각 요소가 어디에 속하는지, 그리고 가져오기가 끝난 후 무엇을 확인해야 하는지 보여줍니다.

| JMeter 요소 | Apidog에서의 위치 | 가져오기 후 확인 사항 |
|---|---|---|
| HTTP Request 샘플러 | 엔드포인트 요청 또는 테스트 시나리오 스텝 | 메서드, 경로, 바디, 헤더 |
| HTTP Request Defaults | 환경 베이스 URL | 환경당 하나의 베이스 URL |
| Header Manager, 인증 | 요청 헤더 또는 인증 설정 | 토큰이 하드코딩되지 않고 변수로 이동했는지 |
User Defined Variables ${var} |
환경 또는 전역 변수 {{var}} |
모든 ${} 참조가 재작성되었는지 |
| JSON 또는 Regex 추출기 | Extract Variable 후처리기 (JSONPath, XPath) | 추출된 이름이 이후 스텝과 일치하는지 |
| Response Assertion | Assertion 후처리기 | 상태 및 바디 검사가 여전히 작동하는지 |
| Duration Assertion | pm.response.responseTime에 대한 pm.test 스크립트 |
임계값 |
| CSV Data Set Config | 테스트 데이터, 랜덤 또는 순차 매칭으로 실행 | 컬럼 이름이 변수와 일치하는지 |
| Loop, If, While 컨트롤러 | For 루프, If 및 기타 흐름 제어 조건 | 중단(break) 및 오류 처리 |
| Transaction 컨트롤러 | 테스트 시나리오의 그룹 | 스텝 순서 |
| Constant Timer | Wait 스텝 | 밀리초 단위 지연 |
| Thread Group | 성능 테스트의 가상 사용자, 지속 시간, 램프업 | 가상 사용자 100명 미만 |
| Listeners | 앱 내 테스트 리포트, 또는 CLI에서 -r html,json,junit |
리포트가 CI가 기대하는 위치에 생성되는지 |
변수 문법 변경이 가장 많은 사람을 걸리게 합니다. JMeter는 ${token}을 사용하고, Apidog는 {{token}}을 사용합니다. 가져오기 후 시나리오에서 남아 있는 ${를 검색하세요. 발견되는 것들은 모두 리터럴 문자열로 전송됩니다.
깔끔하게 옮겨지지 않는 것들
일부 JMeter 기능은 일대일 대응이 없으며, 그렇지 않다고 가정하는 것이 마이그레이션이 실패하는 원인입니다. 다음 사항을 계획에 포함하세요:
- Groovy 및 BeanShell 스크립트. Apidog의 전/후처리기 스크립트는 Postman 스타일의
pmAPI를 사용하는 JavaScript로 실행됩니다. JSR223 로직을 JavaScript로 재작성하세요. 코딩 에이전트는 바로 이런 종류의 변환에 능숙합니다. - 비 HTTP 샘플러. FTP, LDAP, TCP, JMS 샘플러는 API 클라이언트의 범위를 벗어나는 프로토콜을 테스트합니다. 이런 것들은 JMeter에 유지하세요. JDBC 검사는 종종 Apidog 데이터베이스 작업(MySQL, MongoDB, Redis, Oracle이 문서화되어 있음)으로 전환할 수 있지만, 신중하게 재구성해야 합니다.
- 처리량 조정. JMeter의 타이머, 처리량 컨트롤러, 플러그인 스레드 그룹은 요청 비율을 정밀하게 조정합니다. Apidog의 성능 테스트는 가상 사용자, 지속 시간, 램프업을 설정하며 각 사용자가 시나리오를 반복 실행합니다. 초당 요청 수는 다르게 나올 것으로 예상하세요.
- 100명 이상의 가상 사용자 규모. 현재 Apidog 성능 테스트의 문서화된 상한입니다.
- 부하 실행 리포트 내보내기. 문서에 따르면 성능 리포트는 아직 내보낼 수 없으며, 클라이언트에서만 볼 수 있습니다. CLI의 기능 실행은 HTML, JSON, JUnit을 내보낼 수 있습니다.
이 중 어떤 것도 마이그레이션을 막지는 않습니다. 대신 어떤 테스트를 옮길지 결정합니다. 일반적으로 기능 스위트가 옮겨지고 몇 개의 최대 부하 플랜은 남습니다. JMeter API 테스팅 튜토리얼은 깔끔하게 옮겨지는 기능 플랜의 예를 보여줍니다.
단계별 가이드: JMeter 테스트 플랜 마이그레이션
다음은 .jmx에서 시작해 CI 잡이 초록불이 켜질 때까지의 전체 과정입니다.

- 기준선을 기록합니다. JMeter 매뉴얼이 모든 부하 테스트에 권장하는 CLI 모드로 플랜을 한 번 실행합니다:
jmeter -n -t checkout.jmx -l baseline.jtl -e -o baseline-report/. p95 지연 시간과 오류율을 기록해 두세요. - 플랜을 정리합니다. 리스너를 비활성화하고 죽은 분기를 제거합니다. 시크릿은 파일 밖으로 옮깁니다.
- 가져옵니다. 앱의 Import 대화상자 또는
apidog import --project <projectId> --format jmeter --file ./checkout.jmx를 사용합니다. - 가져온 결과를 검토합니다. 엔드포인트와 테스트 시나리오를 나열한 뒤, 위의 표를 참고해
.jmx트리와 비교합니다. - 빈 곳을 채웁니다.
${}참조를 재작성하고, 스크립트를 JavaScript로 이식하고, CSV 데이터를 테스트 데이터로 연결하고, wait 스텝을 추가합니다. - 기능적으로 실행합니다. 모든 요청이 개별적으로 통과해야 성능 테스트가 의미가 있으며, Apidog 문서도 같은 내용을 말합니다.
- 부하 테스트를 진행합니다. 앱에서 시나리오에 가상 사용자, 지속 시간, 램프업을 설정하고, 동일한 사용자 수 기준으로 p95와 오류율을 JMeter 기준선과 비교합니다.
- CI에 연결합니다.
apidog run과 JUnit 리포트로 연결합니다.
코딩 에이전트가 Apidog CLI로 마이그레이션하게 하기
3~6단계는 기계적인 작업이므로 에이전트에게 이상적인 일입니다. Claude Code, Codex 또는 Cursor는 .jmx XML을 읽고, 가져오기를 실행하고, 결과를 비교하고, 빈 곳을 패치할 수 있으며, 사용자는 검토만 하면 됩니다.
한 번만 설정하세요:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install
이 스킬은 에이전트에게 CLI의 명령과 스키마를 가르쳐 줍니다. 설정까지 에이전트에게 맡기고 싶다면 이렇게 지시하세요: “https://apidog.com/apidog-cli-installation-guide.md를 읽고 Apidog CLI를 설정해 줘.” Apidog CLI 설치 가이드는 사람을 위한 동일한 단계를 다룹니다.
그런 다음 플랜이 있는 폴더에서 에이전트에게 프롬프트 하나를 주세요:
Import ./checkout.jmx into Apidog project <projectId> with the jmeter format.
Then list what was created and compare it with the .jmx: every HTTP sampler,
extractor, assertion, CSV data set and controller. Fix variable syntax,
rewrite any Groovy JSR223 scripts as JavaScript, and give me a table of
anything that did not carry over. Finally run the checkout scenario against
the staging environment and summarize failures.
에이전트는 다음과 같은 명령을 실행합니다:
apidog import --project <projectId> --format jmeter --file ./checkout.jmx
apidog endpoint list --project <projectId>
apidog test-scenario list --project <projectId>
apidog environment list --project <projectId>
apidog cli-schema get test-scenario-create
apidog run -t <scenarioId> --project <projectId> -e <envId> -r cli,json
반복 가져오기에서 중요한 두 가지 플래그가 있습니다. --overwrite-mode는 충돌 전략을 설정하고(overwrite, merge, ignore, keepBoth, 기본값 overwrite), --branch는 스프린트 브랜치로 가져올 수 있게 해 주어 검토 전까지 main에 영향을 주지 않습니다. JSON 페이로드를 작성하기 전에 에이전트는 apidog cli-schema get과 apidog cli-schema validate를 실행해야 합니다; CLI 자체 도움말도 페이로드를 기억으로 만들지 말라고 합니다. 이 워크플로우에 대해 더 자세히 알아보려면 Apidog CLI in Claude Code를 참고하세요.
마이그레이션된 테스트를 CI에서 실행하기
시나리오가 로컬에서 통과하면 CI는 명령 한 줄입니다. apidog run은 cli, html, json, junit 리포트를 작성하며, GitHub Actions, GitLab, Jenkins가 기본적으로 읽는 형식은 JUnit입니다:
apidog run -t <scenarioId> --project <projectId> -e <envId> \
-r cli,junit --out-dir apidog-reports --upload-report
--upload-report는 실행 개요를 클라우드로 전송해 팀이 앱에서 열어볼 수 있게 합니다. 데이터 기반 실행은 -d와 함께 CSV, JSON 또는 테스트 데이터 ID를 받으며, 이는 파이프라인에서 JMeter의 CSV Data Set을 대체합니다. --on-error는 ignore, continue, end를 받습니다. Apidog CLI CI/CD 파이프라인 가이드에는 전체 워크플로우 파일이 있으며, apidog run 명령 참조는 모든 플래그를 다룹니다.
한두 릴리스 동안은 JMeter를 병행해서 실행하세요. Apidog 스위트가 동일한 회귀를 잡아내고 동일한 사용자 수에서 부하 수치가 일치하면, 해당하는 .jmx 파일을 폐기하세요. 아직 도구를 저울질 중이라면 JMeter 대안 총정리가 여러 선택지를 비교해 줍니다.
FAQ
Apidog는 .jmx 파일을 직접 가져올 수 있나요? 네. JMeter는 Apidog 문서에 나열된 가져오기 형식이며, Apidog CLI는 apidog import --format jmeter --file <path>를 허용합니다. 문서에 요소별 매핑이 공개되어 있지 않으므로, 결과를 원본 플랜과 비교해 검토하세요.
Apidog 테스트를 다시 JMeter로 내보낼 수 있나요? 네. Apidog 문서에 따르면 테스트 시나리오를 Apidog CLI, Postman, JMeter 데이터 파일로 내보낼 수 있으므로, 팀이 여전히 필요로 한다면 JMeter에서 실행할 수 있습니다.
Apidog는 부하 테스트에서 몇 명의 가상 사용자를 지원하나요? 성능 테스트 문서에 따르면 실행당 최대 100명의 가상 사용자까지 지원하며, 이 기능은 베타 상태입니다. 그 이상의 분산 테스트는 JMeter를 유지하세요.
Groovy 스크립트는 어떻게 되나요? Apidog에서 실행되지 않습니다. Postman 스타일의 pm API를 사용하는 JavaScript 전/후처리기 스크립트로 재작성해야 합니다. 코딩 에이전트가 대부분의 JSR223 코드를 빠르게 변환할 수 있지만, 결과물은 꼭 검토하세요.
변수 문법을 바꿔야 하나요? 네. JMeter는 ${var}을 사용하고 Apidog는 {{var}}를 사용합니다. 첫 실행 전에 마이그레이션된 시나리오에서 남아 있는 ${를 검색하세요.
Apidog는 이 용도로 무료인가요? Apidog Free 플랜은 최대 4명의 사용자를 지원하며, 팀의 기능 스위트를 마이그레이션하고 CI에서 실행하기에 충분합니다.
