ในการย้ายเทสต์จาก 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 เหล่านั้นถูกส่ง ตรวจสอบ หรือจัดเวลา
นี่คือสิ่งที่คุณจะพบเมื่อเปิดไฟล์ดังกล่าว:
- Thread Group: ผู้ใช้จำลอง กำหนดจำนวน threads, ระยะ ramp-up และจำนวนรอบการทำงาน
- Samplers: ตัว request เอง HTTP Request เป็นตัวที่พบบ่อยที่สุด แต่ยังมี JDBC, FTP, LDAP และ TCP samplers อีกด้วย
- Logic controllers: คอนโทรลเลอร์ If, While, Loop, Transaction และ Simple ที่กำหนดลำดับและการทำซ้ำ
- Config elements: HTTP Request Defaults, Header Manager, Cookie Manager, CSV Data Set Config และ User Defined Variables
- Pre- และ post-processors: ตัวดึงข้อมูล (Regex, JSON, XPath, Boundary) และสคริปต์ JSR223 ซึ่งมักเขียนด้วย Groovy
- Assertions: Response, Duration, Size และ JSON assertions
- Timers: Constant, Gaussian Random และ delay อื่นๆ ระหว่าง samplers
- Listeners: result trees, aggregate reports และ HTML dashboard
หากคุณต้องการทบทวนตัวเครื่องมือนี้ ลองอ่าน 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 เสร็จสิ้น

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

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