วิธีย้ายการทดสอบจาก JMeter มาใช้ Apidog

ย้ายเทสต์จาก JMeter มาที่ Apidog: นำเข้าไฟล์ .jmx, จับคู่ thread groups, extractors และ assertions, แก้ไขส่วนที่ย้ายมาไม่ได้ แล้วรันใน CI ด้วย Apidog CLI

INEZA Felin-Michel

INEZA Felin-Michel

16 November 2026

วิธีย้ายการทดสอบจาก JMeter มาใช้ Apidog

Apidog สำหรับองค์กร

การติดตั้งแบบ On-Premises

SSO & RBAC

รองรับมาตรฐาน SOC 2

สำรวจ Apidog Enterprise

ในการย้ายเทสต์จาก JMeter มายัง Apidog ให้ import ไฟล์ .jmx (Apidog รองรับรูปแบบ JMeter ในการ import และ Apidog CLI รองรับ --format jmeter) จากนั้นตรวจสอบสิ่งที่ถูก import เข้ามา สร้างโฟลว์ใหม่เป็น test scenario แล้วยืนยันว่าผ่านการรันแบบ functional ก่อนนำไปทดสอบโหลด Timers, Groovy scripts และ samplers ที่ไม่ใช่ HTTP จำเป็นต้องทำงานด้วยตนเอง

ด้านล่างนี้: เนื้อหาในไฟล์ .jmx มีอะไรบ้าง แต่ละองค์ประกอบจับคู่กันอย่างไร จุดใดที่การจับคู่ไม่สมบูรณ์ และ coding agent ของคุณจะทำงานนี้ด้วย Apidog CLI ได้อย่างไร

ภายในไฟล์ .jmx ของ JMeter มีอะไรบ้าง

ไฟล์ .jmx คือ test plan ของ JMeter ที่บันทึกไว้: โครงสร้าง XML ขององค์ประกอบต่างๆ ที่ JMeter รันจากบนลงล่าง คู่มือผู้ใช้ JMeter กำหนดองค์ประกอบพื้นฐานเหล่านี้ไว้ ทุก request จะอยู่ภายใต้ thread group และองค์ประกอบอื่นๆ ทั้งหมดมีหน้าที่เปลี่ยนวิธีที่ request เหล่านั้นถูกส่ง ตรวจสอบ หรือจัดเวลา

นี่คือสิ่งที่คุณจะพบเมื่อเปิดไฟล์ดังกล่าว:

หากคุณต้องการทบทวนตัวเครื่องมือนี้ ลองอ่าน JMeter คืออะไรและทำงานอย่างไร ก่อนเริ่มแกะ test plan

Apidog import ไฟล์ JMeter ได้หรือไม่?

ได้ คู่มือ migration ของ Apidog ระบุ JMeter อยู่ในหมวด "API Clients & Data Tools" พร้อมคำอธิบายว่า "Import ไฟล์สคริปต์ Apache JMeter" Apidog CLI มีตัว importer เดียวกัน: apidog import --help แสดง jmeter อยู่ในค่าที่รองรับของ --format

สิ่งที่เอกสารไม่ได้เผยแพร่คือตารางจับคู่รายองค์ประกอบสำหรับการ import JMeter คู่มือ migration ของ Postman (JMeter migration guide) มีรายงาน import ที่จัดหมวดเป็น "imported exactly", "approximated" และ "not supported" ส่วนการ import แบบ manual ของ Apidog จะให้ preview แทน ซึ่งคุณเลือกได้ว่าจะนำอะไรเข้ามาก่อนยืนยัน ดังนั้นให้ถือว่าการ import เป็นเพียงฉบับร่างแรกของ migration ไม่ใช่ชุดทดสอบสุดท้าย เปิดดูสิ่งที่ถูก import เข้ามา เปรียบเทียบกับโครงสร้าง .jmx แล้วแก้จุดที่ขาดหายด้วยตนเองหรือด้วย agent ของคุณ

ข้อควรระวังอย่างตรงไปตรงมา: การทดสอบประสิทธิภาพของ Apidog ยังอยู่ในช่วง beta และ รองรับผู้ใช้เสมือน (virtual users) สูงสุด 100 คน ต่อการรันหนึ่งครั้ง หาก test plan ของคุณใน JMeter รัน threads หลายพันตัวในรูปแบบ distributed ให้ใช้ JMeter ต่อสำหรับโหลดสูงสุดส่วนนั้น แล้วย้ายส่วน functional และ regression มายัง Apidog

องค์ประกอบ JMeter จับคู่กับ Apidog อย่างไร

Test plan แบบ HTTP ทั่วไปส่วนใหญ่มีตำแหน่งที่สอดคล้องกันโดยตรงใน Apidog ตารางนี้แสดงว่าแต่ละองค์ประกอบอยู่ที่ใดหลัง migration และควรตรวจสอบอะไรเมื่อ import เสร็จสิ้น

Diagram mapping six JMeter elements to their Apidog equivalents: HTTP Request sampler to request step, User Defined Variables to environment variables, Response Assertion to assertion, Thread Group to virtual users, CSV Data Set Config to test data, Constant Timer to wait step
องค์ประกอบ JMeter ตำแหน่งใน Apidog สิ่งที่ต้องตรวจสอบหลัง import
HTTP Request sampler Endpoint request หรือขั้นตอนใน test scenario Method, path, body และ headers
HTTP Request Defaults Base URL ของ environment มี base URL เดียวต่อหนึ่ง environment
Header Manager, auth Request headers หรือการตั้งค่า auth Token ถูกย้ายไปที่ variables ไม่ใช่ hardcode
User Defined Variables ${var} Environment หรือ global variables {{var}} การอ้างอิง ${} ทั้งหมดถูกเขียนใหม่แล้ว
JSON หรือ Regex extractor Extract Variable post processor (JSONPath, XPath) ชื่อที่ดึงออกมาตรงกับขั้นตอนถัดไป
Response Assertion Assertion post processor การตรวจสอบ status และ body ยังทำงานอยู่
Duration Assertion สคริปต์ pm.test บน pm.response.responseTime ค่า threshold
CSV Data Set Config Test data รันแบบ random หรือ sequential match ชื่อคอลัมน์ตรงกับ variables
Loop, If, While controllers เงื่อนไขควบคุมโฟลว์ เช่น For loop, If ฯลฯ การจัดการ break และ error
Transaction controller Group ใน test scenario ลำดับขั้นตอน
Constant Timer ขั้นตอน wait ค่า delay หน่วยมิลลิวินาที
Thread Group Virtual users, ระยะเวลา, ramp-up ใน performance test Virtual users ไม่เกิน 100 คน
Listeners Test reports ในแอป หรือ -r html,json,junit จาก CLI รายงานถูกส่งไปยังตำแหน่งที่ CI คาดหวัง

การเปลี่ยนรูปแบบ syntax ของตัวแปรเป็นจุดที่ทำให้คนพลาดมากที่สุด JMeter อ้างอิงด้วย ${token} ขณะที่ Apidog ใช้ {{token}} ให้ค้นหา ${ ที่ตกค้างใน scenario หลัง import ทุกตัวที่พบจะถูกส่งออกไปเป็นข้อความล้วน

สิ่งที่ย้ายมาไม่ได้อย่างราบรื่น

ฟีเจอร์บางอย่างของ JMeter ไม่มีสิ่งที่เทียบเท่าแบบหนึ่งต่อหนึ่ง และการปั้นน้ำเป็นน้ำมันคือสาเหตุที่ทำให้ migration ล้มเหลว เตรียมรับมือกับสิ่งเหล่านี้:

  1. สคริปต์ Groovy และ BeanShell. สคริปต์ pre และ post processor ของ Apidog รัน JavaScript ด้วย API สไตล์ Postman คือ pm ให้เขียน logic จาก JSR223 ใหม่เป็น JavaScript ซึ่ง coding agent ของคุณถนัดงานแปลโค้ดประเภทนี้มาก
  2. Samplers ที่ไม่ใช่ HTTP. FTP, LDAP, TCP และ JMS samplers ทดสอบโปรโตคอลที่อยู่นอกขอบเขตของ API client ให้เก็บส่วนนี้ไว้ใน JMeter ส่วนการตรวจสอบ JDBC มักแปลงเป็น database operations ของ Apidog ได้ (รองรับ MySQL, MongoDB, Redis และ Oracle ตามเอกสาร) แต่ควรสร้างใหม่อย่างรอบคอบ
  3. การควบคุม throughput. Timers, throughput controllers และ plugin thread groups ของ JMeter ปรับอัตรา request ได้อย่างละเอียด ส่วน performance test ของ Apidog กำหนด virtual users, ระยะเวลา และ ramp-up โดยผู้ใช้แต่ละคนจะวนลูปผ่าน scenario คาดว่าตัวเลข requests-per-second จะไม่เท่ากัน
  4. ขนาดที่เกิน 100 virtual users. นี่คือเพดานที่เอกสารระบุไว้สำหรับ performance test ของ Apidog ในปัจจุบัน
  5. การ export รายงานสำหรับการรันโหลด. เอกสารระบุว่ารายงาน performance ยัง export ไม่ได้ คุณต้องดูใน client ส่วนการรันแบบ functional จาก CLI export ได้ทั้ง HTML, JSON และ JUnit

ข้อจำกัดเหล่านี้ไม่ได้ขวาง migration แต่ช่วยตัดสินว่าเทสต์ไหนควรย้าย โดยทั่วไปชุด functional จะย้ายมา และ test plan โหลดสูงสุดบางตัวยังอยู่ที่เดิม บทเรียนการทดสอบ API ด้วย JMeter แสดงตัวอย่าง test plan แบบ functional ที่ย้ายมาได้อย่างราบรื่น

ทีละขั้นตอน: ย้าย test plan จาก JMeter

นี่คือเส้นทางทั้งหมด จากไฟล์ .jmx สู่ CI job สีเขียว

Flow diagram of the migration: checkout.jmx, then apidog import with the jmeter format, then a test scenario, then a functional run with apidog run, then a performance test and CI
  1. บันทึกค่า baseline. รัน plan หนึ่งครั้งในโหมด CLI ซึ่ง คู่มือ JMeter แนะนำสำหรับการทดสอบโหลด: jmeter -n -t checkout.jmx -l baseline.jtl -e -o baseline-report/ จดค่า p95 latency และอัตรา error ไว้
  2. ทำความสะอาด plan. ปิด listeners และลบสายงานที่ไม่ใช้แล้ว ย้าย secrets ออกจากไฟล์
  3. Import ไฟล์. ใช้หน้าต่าง Import ของแอป หรือ apidog import --project <projectId> --format jmeter --file ./checkout.jmx
  4. ตรวจสอบสิ่งที่ถูก import. ดูรายการ endpoints และ test scenarios แล้วเปรียบเทียบกับโครงสร้าง .jmx โดยใช้ตารางด้านบน
  5. แก้จุดที่ขาดหาย. เขียนการอ้างอิง ${} ใหม่ พอร์ตสคริปต์เป็น JavaScript แนบข้อมูล CSV เป็น test data และเพิ่มขั้นตอน wait
  6. รันแบบ functional. Performance test จะมีประโยชน์ก็ต่อเมื่อทุก request ผ่านด้วยตัวเองก่อน และเอกสารของ Apidog ก็ระบุเช่นเดียวกัน
  7. ทดสอบโหลด. ในแอป กำหนด virtual users, ระยะเวลา และ ramp-up บน scenario แล้วเทียบ p95 และอัตรา error กับ baseline ของ JMeter ที่จำนวนผู้ใช้เท่ากัน
  8. เชื่อมต่อเข้ากับ CI ด้วย apidog run และรายงาน JUnit

ให้ coding agent ของคุณย้ายงานด้วย Apidog CLI

ขั้นตอนที่ 3 ถึง 6 เป็นงานเชิงกลไก จึงเหมาะกับงานของ agent Claude Code, Codex หรือ Cursor สามารถอ่าน XML ของ .jmx, รัน import, เปรียบเทียบผลลัพธ์ และแก้จุดที่ขาดหายได้ ขณะที่คุณทำหน้าที่ตรวจสอบ

ตั้งค่าครั้งเดียว:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install

skill นี้สอน agent ของคุณเกี่ยวกับคำสั่งและ schemas ของ CLI หากคุณต้องการให้ agent ตั้งค่าเองด้วย ให้บอกมันว่า: "อ่าน https://apidog.com/apidog-cli-installation-guide.md แล้วตั้งค่า Apidog CLI" ส่วน คู่มือติดตั้ง Apidog CLI อธิบายขั้นตอนเดียวกันสำหรับมนุษย์

จากนั้นให้ agent ของคุณ prompt เดียวจากโฟลเดอร์ที่เก็บ test plan:

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 จะรันคำสั่งลักษณะนี้:

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

มีสอง flag ที่สำคัญสำหรับการ import ซ้ำ --overwrite-mode กำหนดกลยุทธ์จัดการความขัดแย้ง (overwrite, merge, ignore หรือ keepBoth, ค่าเริ่มต้นคือ overwrite) และ --branch ให้คุณ import เข้า branch ของ sprint เพื่อให้ migration ไม่กระทบ main จนกว่าคุณจะตรวจสอบแล้ว ก่อนที่ agent จะเขียน JSON payload ใดๆ ควรรัน apidog cli-schema get และ apidog cli-schema validate ก่อน help ของ CLI เองระบุว่าไม่ควรสร้าง payload จากความจำ สำหรับรายละเอียดเพิ่มเติมของ workflow นี้ ดูได้ที่ Apidog CLI in Claude Code

รันเทสต์ที่ย้ายมาแล้วใน CI

เมื่อ scenario ผ่านในเครื่องแล้ว CI เหลือเพียงคำสั่งเดียว apidog run สร้างรายงานแบบ cli, html, json หรือ junit โดย JUnit เป็นรูปแบบที่ GitHub Actions, GitLab และ Jenkins อ่านได้โดยตรง:

apidog run -t <scenarioId> --project <projectId> -e <envId> \
  -r cli,junit --out-dir apidog-reports --upload-report

--upload-report ส่งภาพรวมการรันไปยังคลาวด์ เพื่อให้ทีมของคุณเปิดดูได้ในแอป การรันแบบ data-driven รับ -d พร้อม CSV, JSON หรือ test data ID ซึ่งทดแทน CSV Data Set ของ JMeter ใน pipeline --on-error รับค่า ignore, continue หรือ end คู่มือ Apidog CLI CI/CD pipeline มีไฟล์ workflow ครบถ้วน และ คู่มือคำสั่ง apidog run อธิบายทุก flag

ให้ JMeter รันคู่ขนานไปอีกหนึ่งถึงสอง release เมื่อชุดเทสต์ของ Apidog จับ regression ชุดเดียวกันได้ และตัวเลขโหลดของคุณสอดคล้องกันที่จำนวนผู้ใช้เท่ากัน ก็ถึงเวลาเกษียณไฟล์ .jmx ที่ทำหน้าที่ตรงกัน หากคุณยังเปรียบเทียบเครื่องมืออยู่ บทสรุปทางเลือกแทน JMeter เปรียบเทียบตัวเลือกต่างๆ ในตลาดให้แล้ว

คำถามที่พบบ่อย

Apidog import ไฟล์ .jmx ได้โดยตรงหรือไม่? ได้ JMeter เป็นรูปแบบ import ที่ระบุไว้ในเอกสารของ Apidog และ Apidog CLI รองรับ apidog import --format jmeter --file <path> ให้ตรวจสอบผลลัพธ์เทียบกับ plan ต้นฉบับ เพราะเอกสารไม่ได้เผยแพร่ตารางจับคู่รายองค์ประกอบ

สามารถ export เทสต์จาก Apidog กลับไปเป็น JMeter ได้หรือไม่? ได้ เอกสารของ Apidog ระบุว่า test scenarios สามารถ export เป็นไฟล์ข้อมูล Apidog CLI, Postman และ JMeter ได้ คุณจึงรันใน JMeter ต่อได้หากทีมใดยังต้องใช้

Apidog รองรับ virtual users กี่คนสำหรับ load test? เอกสาร performance testing ระบุว่าสูงสุด 100 virtual users ต่อการรันหนึ่งครั้ง และฟีเจอร์นี้ยังอยู่ในช่วง beta ให้ใช้ JMeter สำหรับการทดสอบแบบ distributed ที่เกินระดับนี้

สคริปต์ Groovy ของฉันจะเป็นอย่างไร? สคริปต์เหล่านั้นไม่ทำงานใน Apidog ต้องเขียนใหม่เป็นสคริปต์ JavaScript แบบ pre หรือ post processor ซึ่งใช้ API สไตล์ Postman คือ pm coding agent สามารถแปลโค้ด JSR223 ส่วนใหญ่ได้อย่างรวดเร็ว แต่ควรตรวจสอบผลลัพธ์

ฉันจำเป็นต้องเปลี่ยนรูปแบบ syntax ของตัวแปรหรือไม่? จำเป็น JMeter ใช้ ${var} ขณะที่ Apidog ใช้ {{var}} ให้ค้นหา ${ ที่ตกค้างใน scenario ที่ย้ายมาแล้วก่อนการรันครั้งแรก

Apidog ใช้ฟรีสำหรับงานนี้ได้หรือไม่? แผน Apidog Free รองรับผู้ใช้สูงสุด 4 คน ซึ่งเพียงพอสำหรับการย้ายชุดเทสต์ functional ของทีมและรันใน CI

ฝึกการออกแบบ API แบบ Design-first ใน Apidog

ค้นพบวิธีที่ง่ายขึ้นในการสร้างและใช้ API