Cara Migrasi Pengujian JMeter ke Apidog

Migrasikan pengujian JMeter ke Apidog: impor file .jmx, petakan thread group, extractor, dan assertion, perbaiki bagian yang tidak bisa langsung dipindahkan, lalu jalankan di CI dengan Apidog CLI.

INEZA Felin-Michel

INEZA Felin-Michel

16 November 2026

Cara Migrasi Pengujian JMeter ke Apidog

Apidog untuk Perusahaan

Penerapan On-Premises

SSO & RBAC

Sesuai SOC 2

Jelajahi Apidog Enterprise

Untuk memigrasikan tes JMeter ke Apidog, impor file .jmx (Apidog mencantumkan JMeter sebagai format impor yang didukung, dan Apidog CLI menerima --format jmeter), tinjau apa yang berhasil diimpor, bangun ulang alurnya sebagai skenario tes, lalu pastikan lulus uji fungsional sebelum melakukan load test. Timer, skrip Groovy, dan sampler non-HTTP memerlukan pengerjaan manual.

Di bawah ini: apa saja isi file .jmx, cara memetakan setiap elemen, di mana pemetaan tersebut tidak berjalan mulus, dan bagaimana coding agent Anda bisa mengerjakannya dengan Apidog CLI.

Apa saja isi file .jmx JMeter

File .jmx adalah test plan JMeter yang tersimpan: sebuah pohon XML berisi elemen-elemen yang dijalankan JMeter dari atas ke bawah. Manual pengguna JMeter mendefinisikan elemen-elemen penyusunnya. Setiap request berada di bawah thread group, dan setiap elemen lain mengubah cara request tersebut dikirim, diperiksa, atau diatur waktunya.

Berikut yang akan Anda temukan saat membukanya:

Jika Anda perlu mengingat kembali tentang tool ini, baca apa itu JMeter dan cara kerjanya sebelum mulai membongkar test plan.

Apakah Apidog bisa mengimpor file JMeter?

Bisa. Panduan migrasi Apidog mencantumkan JMeter di bagian "API Clients & Data Tools" dengan deskripsi "Import Apache JMeter script files." Apidog CLI menyediakan importer yang sama: apidog import --help menampilkan jmeter di antara nilai untuk --format.

Yang tidak dipublikasikan dalam dokumentasi adalah pemetaan elemen per elemen untuk impor JMeter. Panduan migrasi JMeter milik Postman menyertakan laporan impor dengan kategori "imported exactly", "approximated", dan "not supported"; impor manual di Apidog justru memberi Anda pratinjau, di mana Anda memilih apa yang ingin dibawa sebelum mengonfirmasi. Jadi anggap impor ini sebagai draf awal migrasi Anda, bukan suite yang sudah jadi. Buka hasil impor, bandingkan dengan pohon .jmx, lalu perbaiki celahnya secara manual atau dengan agent Anda.

Satu catatan jujur: pengujian performa Apidog masih dalam tahap beta dan mendukung hingga 100 virtual user per eksekusi. Jika test plan JMeter Anda menjalankan ribuan thread dalam setup terdistribusi, pertahankan JMeter untuk beban puncak tersebut dan pindahkan sisi fungsional serta regresi ke Apidog.

Cara elemen JMeter dipetakan ke Apidog

Sebagian besar test plan HTTP umum punya tempat langsung di Apidog. Tabel berikut menunjukkan lokasi setiap elemen setelah migrasi dan apa yang perlu diperiksa setelah impor selesai.

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
Elemen JMeter Lokasinya di Apidog Periksa setelah impor
HTTP Request sampler Request endpoint atau langkah skenario tes Method, path, body, dan header
HTTP Request Defaults Base URL environment Satu base URL per environment
Header Manager, auth Header request atau pengaturan auth Token dipindahkan ke variabel, bukan di-hardcode
User Defined Variables ${var} Variabel environment atau global {{var}} Semua referensi ${} sudah ditulis ulang
Extractor JSON atau Regex Post processor Extract Variable (JSONPath, XPath) Nama yang diekstrak cocok dengan langkah selanjutnya
Response Assertion Post processor assertion Pemeriksaan status dan body tetap berjalan
Duration Assertion Skrip pm.test pada pm.response.responseTime Nilai threshold
CSV Data Set Config Test data, dijalankan dengan pencocokan acak atau berurutan Nama kolom cocok dengan variabel
Controller Loop, If, While For loop, If, dan kondisi kontrol alur lainnya Penanganan break dan error
Transaction controller Group dalam skenario tes Urutan langkah
Constant Timer Langkah wait Delay dalam milidetik
Thread Group Virtual user, durasi, ramp-up pada pengujian performa Di bawah 100 virtual user
Listener Laporan tes di aplikasi, atau -r html,json,junit dari CLI Laporan tersimpan di tempat yang diharapkan CI

Perubahan sintaks variabel paling sering membuat orang keliru. JMeter menggunakan referensi ${token}, sedangkan Apidog menggunakan {{token}}. Cari sisa ${ yang tertinggal di skenario setelah impor; yang masih ada akan dikirim sebagai string literal.

Apa yang tidak terbawa dengan mulus

Beberapa fitur JMeter tidak punya padanan satu-satu, dan berpura-pura sebaliknya adalah cara migrasi gagal. Rencanakan untuk hal-hal berikut:

  1. Skrip Groovy dan BeanShell. Skrip pre dan post processor Apidog menjalankan JavaScript dengan API pm bergaya Postman. Tulis ulang logika JSR223 dalam JavaScript; coding agent Anda sangat mahir dalam jenis penerjemahan ini.
  2. Sampler non-HTTP. Sampler FTP, LDAP, TCP, dan JMS menguji protokol di luar cakupan API client. Pertahankan yang itu di JMeter. Pemeriksaan JDBC sering kali bisa menjadi operasi database Apidog (MySQL, MongoDB, Redis, dan Oracle terdokumentasi), tetapi bangun ulang dengan sengaja.
  3. Penyetelan throughput. Timer, throughput controller, dan plugin thread group milik JMeter menyetel laju request secara presisi. Pengujian performa Apidog mengatur virtual user, durasi, dan ramp-up, lalu setiap user melakukan loop melalui skenario. Bersiap melihat angka request per detik yang berbeda.
  4. Skala di atas 100 virtual user. Itu adalah batas maksimum yang terdokumentasi untuk pengujian performa Apidog saat ini.
  5. Ekspor laporan untuk eksekusi beban. Dokumentasi menyatakan laporan performa belum bisa diekspor; Anda melihatnya di client. Eksekusi fungsional dari CLI bisa mengekspor HTML, JSON, dan JUnit.

Tidak ada dari semua ini yang menghalangi migrasi; semuanya menentukan tes mana yang dipindahkan. Biasanya suite fungsional yang dipindahkan dan beberapa test plan beban puncak tetap tinggal. Tutorial pengujian API JMeter menunjukkan jenis test plan fungsional yang bisa dipindahkan dengan mulus.

Langkah demi langkah: memigrasikan test plan JMeter

Berikut rute lengkapnya, dari .jmx hingga job CI yang hijau.

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. Rekam baseline. Jalankan plan sekali dalam mode CLI, yang direkomendasikan oleh manual JMeter untuk semua load test: jmeter -n -t checkout.jmx -l baseline.jtl -e -o baseline-report/. Catat latensi p95 dan tingkat error.
  2. Bersihkan plan. Nonaktifkan listener dan hapus cabang yang tidak terpakai. Pindahkan rahasia (secrets) keluar dari file.
  3. Impor. Gunakan dialog Import di aplikasi atau apidog import --project <projectId> --format jmeter --file ./checkout.jmx.
  4. Tinjau hasil impor. Daftarkan endpoint dan skenario tes, lalu bandingkan dengan pohon .jmx menggunakan tabel di atas.
  5. Perbaiki celahnya. Tulis ulang referensi ${}, porting skrip ke JavaScript, lampirkan data CSV sebagai test data, tambahkan langkah wait.
  6. Jalankan secara fungsional. Pengujian performa hanya berguna setelah setiap request lulus secara mandiri, dan dokumentasi Apidog menyatakan hal yang sama.
  7. Lakukan load test. Di aplikasi, atur virtual user, durasi, dan ramp-up pada skenario, lalu bandingkan p95 dan tingkat error dengan baseline JMeter Anda pada jumlah user yang sama.
  8. Integrasikan ke CI dengan apidog run dan laporan JUnit.

Biarkan coding agent Anda memigrasikannya dengan Apidog CLI

Langkah 3 hingga 6 bersifat mekanis, sehingga ideal untuk dikerjakan agent. Claude Code, Codex, atau Cursor bisa membaca XML .jmx, menjalankan impor, membandingkan hasilnya, dan memperbaiki celahnya sementara Anda melakukan review.

Lakukan setup sekali:

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

Skill ini mengajarkan command dan schema CLI kepada agent Anda. Jika Anda lebih suka membiarkan agent melakukan setup juga, beri tahu dia: “Baca https://apidog.com/apidog-cli-installation-guide.md dan lakukan setup Apidog CLI.” Panduan instalasi Apidog CLI mencakup langkah yang sama untuk manusia.

Lalu berikan satu prompt ke agent Anda dari folder yang menyimpan 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 akan menjalankan command seperti ini:

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

Dua flag penting untuk impor berulang. --overwrite-mode mengatur strategi konflik (overwrite, merge, ignore, atau keepBoth, default overwrite), dan --branch memungkinkan Anda mengimpor ke branch sprint sehingga migrasi tidak menyentuh main sebelum Anda mereviewnya. Sebelum menulis payload JSON apa pun, agent harus menjalankan apidog cli-schema get dan apidog cli-schema validate; bantuan CLI sendiri mengatakan untuk tidak membangun payload dari ingatan. Untuk melihat lebih dalam alur kerja ini, lihat Apidog CLI in Claude Code.

Jalankan tes hasil migrasi di CI

Setelah skenario lulus secara lokal, CI hanya butuh satu command. apidog run menulis laporan cli, html, json, atau junit, dan JUnit adalah format yang dibaca secara native oleh GitHub Actions, GitLab, dan Jenkins:

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

--upload-report mengirimkan ringkasan eksekusi ke cloud agar tim Anda bisa membukanya di aplikasi. Eksekusi berbasis data menerima -d dengan ID CSV, JSON, atau test data, yang menggantikan CSV Data Set milik JMeter dalam pipeline. --on-error menerima ignore, continue, atau end. Panduan pipeline CI/CD Apidog CLI berisi file workflow lengkap, dan referensi command apidog run mencakup setiap flag.

Pertahankan JMeter berjalan paralel selama satu atau dua rilis. Ketika suite Apidog menangkap regresi yang sama dan angka beban Anda sejalan pada jumlah user yang sama, pensiunkan file .jmx yang sesuai. Jika Anda masih mempertimbangkan tool, rangkuman alternatif JMeter membandingkan pilihan yang tersedia.

FAQ

Apakah Apidog mengimpor file .jmx secara langsung? Ya. JMeter adalah format impor yang tercantum di dokumentasi Apidog, dan Apidog CLI menerima apidog import --format jmeter --file <path>. Tinjau hasilnya dibandingkan dengan plan asli, karena dokumentasi tidak mempublikasikan pemetaan per elemen.

Bisakah saya mengekspor tes Apidog kembali ke JMeter? Ya. Dokumentasi Apidog menyatakan skenario tes dapat diekspor sebagai file data Apidog CLI, Postman, dan JMeter, jadi Anda bisa menjalankannya di JMeter jika sebuah tim masih membutuhkannya.

Berapa banyak virtual user yang didukung Apidog untuk load test? Dokumentasi pengujian performa menyatakan hingga 100 virtual user per eksekusi, dan fitur ini masih dalam beta. Pertahankan JMeter untuk tes terdistribusi di atas batas itu.

Apa yang terjadi pada skrip Groovy saya? Skrip itu tidak bisa berjalan di Apidog. Tulis ulang sebagai skrip pre atau post processor JavaScript, yang menggunakan API pm bergaya Postman. Coding agent bisa menerjemahkan sebagian besar cuplikan JSR223 dengan cepat; lakukan review pada hasilnya.

Apakah saya perlu mengubah sintaks variabel? Ya. JMeter menggunakan ${var} dan Apidog menggunakan {{var}}. Cari sisa ${ yang tertinggal di skenario hasil migrasi sebelum eksekusi pertama Anda.

Apakah Apidog gratis untuk ini? Paket Apidog Free mencakup hingga 4 pengguna, cukup untuk memigrasikan suite fungsional tim dan menjalankannya di CI.

Mengembangkan API dengan Apidog

Apidog adalah alat pengembangan API yang membantu Anda mengembangkan API dengan lebih mudah dan efisien.