Để chuyển các bài kiểm thử JMeter sang Apidog, hãy nhập tệp .jmx (Apidog liệt kê JMeter là một định dạng nhập được hỗ trợ, và Apidog CLI chấp nhận --format jmeter), kiểm tra lại nội dung được nhập, dựng lại luồng thành một kịch bản kiểm thử (test scenario), rồi xác nhận nó vượt qua lần chạy chức năng trước khi kiểm thử tải. Timers, script Groovy và các sampler không phải HTTP cần phải xử lý thủ công.
Nội dung dưới đây bao gồm: tệp .jmx chứa những gì, từng thành phần ánh xạ thế nào, nơi ánh xạ bị hỏng, và cách coding agent của bạn có thể thực hiện công việc này với Apidog CLI.
Bên trong tệp .jmx của JMeter có gì
Tệp .jmx là kế hoạch kiểm thử JMeter đã được lưu: một cây XML gồm các phần tử mà JMeter chạy theo thứ tự từ trên xuống dưới. Tài liệu hướng dẫn sử dụng JMeter định nghĩa các thành phần cấu thành. Mọi request đều nằm trong một thread group, và mọi phần tử khác đều thay đổi cách các request đó được gửi, kiểm tra hay định thời.
Dưới đây là những gì bạn sẽ thấy khi mở một tệp:
- Thread Group: các người dùng được mô phỏng. Nó thiết lập số lượng thread, thời gian ramp-up và số vòng lặp.
- Samplers: chính là các request. HTTP Request là loại phổ biến nhất, nhưng cũng có các sampler JDBC, FTP, LDAP và TCP.
- Logic controllers: các controller If, While, Loop, Transaction và Simple quyết định thứ tự và sự lặp lại.
- Config elements: HTTP Request Defaults, Header Manager, Cookie Manager, CSV Data Set Config và User Defined Variables.
- Pre- và post-processors: các bộ trích xuất (Regex, JSON, XPath, Boundary) và script JSR223, thường viết bằng Groovy.
- Assertions: các assertion Response, Duration, Size và JSON.
- Timers: Constant, Gaussian Random và các loại độ trễ khác giữa các sampler.
- Listeners: cây kết quả, báo cáo tổng hợp và dashboard HTML.
Nếu bạn cần ôn lại về công cụ này, hãy đọc JMeter là gì và cách hoạt động trước khi bắt tay vào phân tích kế hoạch kiểm thử.
Apidog có thể nhập tệp JMeter không?
Có. Hướng dẫn di chuyển của Apidog liệt kê JMeter dưới mục “API Clients & Data Tools” với mô tả “Nhập các tệp script Apache JMeter”. Apidog CLI cũng cung cấp cùng bộ nhập đó: apidog import --help liệt kê jmeter trong các giá trị của --format.
Điều mà tài liệu không công bố là bảng ánh xạ chi tiết từng phần tử cho việc nhập JMeter. Hướng dẫn di chuyển JMeter của Postman cung cấp báo cáo nhập với các nhóm “nhập chính xác”, “xấp xỉ” và “không hỗ trợ”; còn việc nhập thủ công trên Apidog cho bạn bản xem trước, nơi bạn chọn nội dung muốn đưa vào trước khi xác nhận. Vì vậy, hãy coi bước nhập là bản nháp đầu tiên của quá trình di chuyển, chứ không phải bộ kiểm thử hoàn chỉnh. Mở nội dung đã được nhập, so sánh với cây .jmx, và khắc phục các khoảng trống bằng tay hoặc với agent của bạn.
Một lưu ý thẳng thắn: tính năng kiểm thử hiệu năng của Apidog đang ở giai đoạn beta và chỉ hỗ trợ tối đa 100 người dùng ảo mỗi lần chạy. Nếu kế hoạch JMeter của bạn điều hành hàng nghìn thread trên một thiết lập phân tán, hãy giữ JMeter cho tải đỉnh đó và chuyển phần chức năng cùng kiểm thử hồi quy sang Apidog.
Các phần tử JMeter ánh xạ vào Apidog thế nào
Phần lớn một kế hoạch kiểm thử HTTP thông thường có chỗ tương ứng trực tiếp trong Apidog. Bảng dưới đây cho thấy mỗi phần tử nằm ở đâu sau khi di chuyển và cần kiểm tra gì sau khi nhập xong.

| Phần tử JMeter | Nằm ở đâu trong Apidog | Cần kiểm tra sau khi nhập |
|---|---|---|
| Sampler HTTP Request | Request endpoint hoặc bước trong kịch bản kiểm thử | Method, path, body và headers |
| HTTP Request Defaults | Base URL của môi trường | Mỗi môi trường một base URL |
| Header Manager, xác thực | Request headers hoặc cài đặt xác thực | Token được chuyển sang biến, không hardcode |
User Defined Variables ${var} |
Biến môi trường hoặc toàn cục {{var}} |
Mọi tham chiếu ${} được viết lại |
| Trích xuất JSON hoặc Regex | Post processor Extract Variable (JSONPath, XPath) | Tên trích xuất khớp với các bước phía sau |
| Response Assertion | Post processor assertion | Kiểm tra status và body vẫn hoạt động |
| Duration Assertion | Script pm.test trên pm.response.responseTime |
Giá trị ngưỡng |
| CSV Data Set Config | Dữ liệu kiểm thử, chạy theo chế độ khớp ngẫu nhiên hoặc tuần tự | Tên cột khớp với biến |
| Controller Loop, If, While | Vòng lặp For, If và các điều kiện điều khiển luồng khác | Xử lý ngắt và lỗi |
| Transaction controller | Nhóm trong kịch bản kiểm thử | Thứ tự các bước |
| Constant Timer | Bước chờ | Độ trễ tính bằng mili giây |
| Thread Group | Kiểm thử hiệu năng: người dùng ảo, thời lượng, ramp-up | Dưới 100 người dùng ảo |
| Listeners | Báo cáo kiểm thử trong ứng dụng, hoặc -r html,json,junit từ CLI |
Báo cáo nằm đúng nơi CI mong đợi |
Việc thay đổi cú pháp biến khiến nhiều người lúng túng nhất. JMeter tham chiếu ${token}, còn Apidog dùng {{token}}. Sau khi nhập, hãy grep kịch bản để tìm các ký tự ${ sót lại; bất kỳ ký tự nào bạn tìm thấy sẽ được gửi đi như một chuỗi văn bản thuần.
Những gì không chuyển đổi được một cách trọn vẹn
Một số tính năng của JMeter không có tương đương một-một, và việc giả vờ ngược lại chính là cách các quá trình di chuyển thất bại. Hãy lập kế hoạch cho những điều sau:
- Script Groovy và BeanShell. Script pre và post processor của Apidog chạy JavaScript với API
pmtheo phong cách Postman. Hãy viết lại logic JSR223 bằng JavaScript; coding agent của bạn rất giỏi đúng loại dịch thuật này. - Các sampler không phải HTTP. Các sampler FTP, LDAP, TCP và JMS kiểm thử các giao thức nằm ngoài phạm vi của một API client. Hãy giữ chúng trong JMeter. Các kiểm tra JDBC thường có thể trở thành các thao tác cơ sở dữ liệu của Apidog (MySQL, MongoDB, Redis và Oracle đều được tài liệu hỗ trợ), nhưng hãy dựng lại chúng một cách chủ động.
- Định hình thông lượng. Các timer, throughput controller và plugin thread group của JMeter tinh chỉnh tốc độ request một cách chính xác. Kiểm thử hiệu năng của Apidog thiết lập người dùng ảo, thời lượng và ramp-up, và mỗi người dùng lặp qua kịch bản. Hãy chuẩn bị cho các con số request mỗi giây khác nhau.
- Quy mô vượt quá 100 người dùng ảo. Đó là giới hạn được ghi nhận cho kiểm thử hiệu năng Apidog hiện nay.
- Xuất báo cáo cho các lần chạy tải. Tài liệu cho biết báo cáo hiệu năng chưa thể xuất ra; bạn xem chúng trong client. Các lần chạy chức năng từ CLI xuất được HTML, JSON và JUnit.
Không điều nào trong số này cản trở việc di chuyển; chúng chỉ quyết định bài kiểm thử nào sẽ được chuyển. Thông thường, bộ kiểm thử chức năng được chuyển và một vài kế hoạch tải đỉnh được giữ lại. Hướng dẫn kiểm thử API với JMeter cho thấy loại kế hoạch chức năng chuyển đổi một cách trọn vẹn.
Từng bước: di chuyển một kế hoạch kiểm thử JMeter
Dưới đây là toàn bộ lộ trình, từ .jmx đến một job CI màu xanh.

- Thu thập kết quả cơ sở. Chạy kế hoạch một lần ở chế độ CLI, điều mà tài liệu JMeter khuyến nghị cho mọi kiểm thử tải:
jmeter -n -t checkout.jmx -l baseline.jtl -e -o baseline-report/. Ghi lại độ trễ p95 và tỷ lệ lỗi. - Dọn dẹp kế hoạch. Vô hiệu hóa các listeners và loại bỏ các nhánh không dùng nữa. Chuyển các thông tin nhạy cảm ra khỏi tệp.
- Nhập tệp. Dùng hộp thoại Import của ứng dụng hoặc
apidog import --project <projectId> --format jmeter --file ./checkout.jmx. - Kiểm tra nội dung được nhập. Liệt kê các endpoint và kịch bản kiểm thử, rồi so sánh với cây
.jmxbằng bảng ở trên. - Khắc phục khoảng trống. Viết lại các tham chiếu
${}, chuyển script sang JavaScript, gắn dữ liệu CSV dưới dạng dữ liệu kiểm thử, thêm các bước chờ. - Chạy chức năng. Một kiểm thử hiệu năng chỉ có ý nghĩa khi mọi request đều vượt qua độc lập, và tài liệu Apidog cũng nói như vậy.
- Kiểm thử tải. Trong ứng dụng, thiết lập người dùng ảo, thời lượng và ramp-up cho kịch bản, rồi so sánh p95 và tỷ lệ lỗi với kết quả cơ sở JMeter ở cùng số lượng người dùng.
- Tích hợp vào CI với
apidog runvà báo cáo JUnit.
Để coding agent di chuyển giúp bạn với Apidog CLI
Các bước 3 đến 6 mang tính cơ học, khiến chúng trở thành công việc lý tưởng cho agent. Claude Code, Codex hay Cursor đều có thể đọc XML của .jmx, chạy nhập, so sánh kết quả và vá các khoảng trống trong khi bạn kiểm duyệt.
Cài đặt một lần:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install
Skill này dạy agent của bạn các lệnh và schema của CLI. Nếu bạn muốn để agent tự cài đặt luôn, hãy nói với nó: “Đọc https://apidog.com/apidog-cli-installation-guide.md và cài đặt Apidog CLI.” Hướng dẫn cài đặt Apidog CLI trình bày các bước tương tự cho con người.
Sau đó, đưa cho agent của bạn một prompt duy nhất từ thư mục chứa kế hoạch kiểm thử:
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.
Agent chạy các lệnh như sau:
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
Hai cờ quan trọng cho các lần nhập lặp lại. --overwrite-mode thiết lập chiến lược xử lý xung đột (overwrite, merge, ignore hoặc keepBoth, mặc định là overwrite), và --branch cho phép bạn nhập vào một nhánh sprint để quá trình di chuyển không ảnh hưởng đến nhánh main cho đến khi bạn kiểm duyệt xong. Trước khi ghi bất kỳ payload JSON nào, agent nên chạy apidog cli-schema get và apidog cli-schema validate; chính phần trợ giúp của CLI cũng khuyên không nên dựng payload từ trí nhớ. Để tìm hiểu sâu hơn về quy trình này, xem Apidog CLI trong Claude Code.
Chạy các bài kiểm thử đã di chuyển trong CI
Khi kịch bản đã vượt qua trên máy cục bộ, việc chạy trong CI chỉ còn một lệnh. apidog run ghi ra báo cáo cli, html, json hoặc junit, và JUnit là định dạng mà GitHub Actions, GitLab và Jenkins đọc được nguyên bản:
apidog run -t <scenarioId> --project <projectId> -e <envId> \
-r cli,junit --out-dir apidog-reports --upload-report
--upload-report gửi tổng quan lần chạy lên đám mây để đội nhóm của bạn có thể mở trong ứng dụng. Các lần chạy dựa trên dữ liệu nhận -d kèm một tệp CSV, JSON hoặc ID dữ liệu kiểm thử, thay thế cho CSV Data Set của JMeter trong pipeline. --on-error chấp nhận ignore, continue hoặc end. Hướng dẫn pipeline CI/CD với Apidog CLI có đầy đủ các tệp workflow, và tài liệu tham khảo lệnh apidog run bao gồm mọi cờ.
Hãy giữ JMeter chạy song song trong một hoặc hai bản phát hành. Khi bộ kiểm thử Apidog phát hiện cùng các lỗi hồi quy và các con số tải của bạn khớp nhau ở cùng số lượng người dùng, hãy cho nghỉ hưu các tệp .jmx tương ứng. Nếu bạn vẫn đang cân nhắc các công cụ, bản tổng hợp các phương án thay thế JMeter so sánh các lựa chọn hiện có.
Câu hỏi thường gặp
Apidog có nhập trực tiếp tệp .jmx không? Có. JMeter là một định dạng nhập được liệt kê trong tài liệu Apidog, và Apidog CLI chấp nhận apidog import --format jmeter --file <path>. Hãy kiểm tra kết quả so với kế hoạch gốc, vì tài liệu không công bố bảng ánh xạ theo từng phần tử.
Tôi có thể xuất các bài kiểm thử Apidog trở lại thành JMeter không? Có. Tài liệu Apidog cho biết các kịch bản kiểm thử có thể được xuất dưới dạng tệp dữ liệu Apidog CLI, Postman và JMeter, nên bạn vẫn có thể chạy chúng trong JMeter nếu một đội nhóm vẫn cần.
Apidog hỗ trợ bao nhiêu người dùng ảo cho kiểm thử tải? Tài liệu kiểm thử hiệu năng cho biết tối đa 100 người dùng ảo mỗi lần chạy, và tính năng này đang ở giai đoạn beta. Hãy giữ JMeter cho các kiểm thử phân tán vượt quá con số đó.
Script Groovy của tôi sẽ thế nào? Chúng không chạy được trong Apidog. Hãy viết lại chúng thành các script pre hoặc post processor bằng JavaScript, vốn dùng API pm theo phong cách Postman. Một coding agent có thể dịch hầu hết các đoạn JSR223 một cách nhanh chóng; nhưng đừng quên kiểm duyệt kết quả.
Tôi có cần thay đổi cú pháp biến không? Có. JMeter dùng ${var} còn Apidog dùng {{var}}. Hãy tìm kiếm các ký tự ${ còn sót lại trong kịch bản đã di chuyển trước lần chạy đầu tiên.
Apidog có miễn phí cho việc này không? Gói Apidog Free hỗ trợ tối đa 4 người dùng, đủ để di chuyển bộ kiểm thử chức năng của một đội nhóm và chạy nó trong CI.
