DEV Community

Cover image for JMeter Testleri Apidog'a Nasıl Aktarılır?
Tobias Hoffmann
Tobias Hoffmann

Posted on Originally published at apidog.com

JMeter Testleri Apidog'a Nasıl Aktarılır?

JMeter Testlerini Apidog'a Göç Ettirme: Eşleme Haritası, Tuzaklar ve CLI ile Otomasyon

JMeter testlerini Apidog'a taşımak için .jmx dosyasını içe aktarın (Apidog, JMeter'ı desteklenen içe aktarma formatları arasında listeler ve Apidog CLI --format jmeter seçeneğini kabul eder), neyin aktarıldığını inceleyin, akışı bir test senaryosu olarak yeniden oluşturun, ardından yük testine geçmeden önce fonksiyonel bir çalıştırmadan geçtiğini doğrulayın. Zamanlayıcılar (timer), Groovy betikleri ve HTTP dışı sampler'lar elle çalışma gerektirir.

Apidog'u bugün deneyin

Aşağıda: bir .jmx dosyası ne içerir, her eleman nasıl eşlenir, eşleme nerede kopar ve kodlama ajanınız bu işi Apidog CLI ile nasıl yapabilir.

Bir JMeter .jmx dosyasının içinde ne var

Bir .jmx dosyası, kaydedilmiş JMeter test planıdır: JMeter'ın yukarıdan aşağıya çalıştırdığı, elemanlardan oluşan bir XML ağacı. JMeter kullanıcı kılavuzu bu yapı taşlarını tanımlar. Her istek bir thread group altında yer alır ve diğer tüm elemanlar bu isteklerin nasıl gönderildiğini, kontrol edildiğini veya zamanlandığını değiştirir.

Birini açtığınızda şunları bulacaksınız:

  • Thread Group: simüle edilen kullanıcılar. Thread sayısını, ramp-up süresini ve döngü sayısını belirler.
  • Sampler'lar: isteklerin kendileri. HTTP Request en yaygın olanıdır, ancak JDBC, FTP, LDAP ve TCP sampler'ları da vardır.
  • Mantık denetleyicileri (logic controller): Sırayı ve tekrarı belirleyen If, While, Loop, Transaction ve Simple controller'lar.
  • Yapılandırma elemanları: HTTP Request Defaults, Header Manager, Cookie Manager, CSV Data Set Config ve User Defined Variables.
  • Ön ve son işlemciler: çıkarıcılar (Regex, JSON, XPath, Boundary) ve genellikle Groovy ile yazılmış JSR223 betikleri.
  • Assertion'lar: Response, Duration, Size ve JSON assertion'ları.
  • Zamanlayıcılar: Constant, Gaussian Random ve sampler'lar arasındaki diğer gecikmeler.
  • Listener'lar: sonuç ağaçları, toplu raporlar ve HTML panosu.

Aracın kendisi hakkında tazelemeniz gerekiyorsa, planları sökmeye başlamadan önce JMeter'ın ne olduğunu ve nasıl çalıştığını okuyun.

Apidog JMeter dosyalarını içe aktarabilir mi?

Evet. Apidog göç rehberi, JMeter'ı "API Clients & Data Tools" altında "Import Apache JMeter script files" açıklamasıyla listeler. Apidog CLI aynı içe aktarıcıyı sunar: apidog import --help, --format için geçerli değerler arasında jmeter seçeneğini listeler.

Dokümanların yayınlamadığı şey, JMeter içe aktarımları için eleman bazında bir eşlemedir. Postman'ın JMeter göç rehberi, "birebir içe aktarıldı", "yaklaşıldı" ve "desteklenmiyor" kategorilerine ayrılmış bir içe aktarma raporu sunar; Apidog'un manuel içe aktarımı ise bunun yerine bir önizleme verir, burada onaylamadan önce neyi getireceğinizi seçersiniz. Bu yüzden içe aktarımı göçünüzün ilk taslağı olarak görün, bitmiş test paketi olarak değil. Aktarılanları açın, .jmx ağacıyla karşılaştırın ve eksikleri elle veya ajanınızla giderin.

Dürüst bir uyarı: Apidog'un performans testi beta aşamasındadır ve çalıştırma başına 100 sanal kullanıcıya kadar destekler. JMeter planınız dağıtık bir kurulumda binlerce thread çalıştırıyorsa, bu zirve yük için JMeter'ı tutun ve fonksiyonel ve regresyon tarafını Apidog'a taşıyın.

JMeter elemanları Apidog'a nasıl eşlenir

Tipik bir HTTP test planının çoğu, Apidog'da doğrudan bir karşılık bulur. Tablo, göçten sonra her elemanın nerede yaşadığını ve içe aktarma bittiğinde neyi kontrol etmeniz gerektiğini gösterir.

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 elemanı Apidog'daki yeri İçe aktarmadan sonra kontrol edin
HTTP Request sampler Endpoint isteği veya test senaryosu adımı Metot, yol, gövde ve header'lar
HTTP Request Defaults Ortamın temel URL'si Ortam başına bir temel URL
Header Manager, kimlik doğrulama İstek header'ları veya kimlik doğrulama ayarları Token'lar değişkenlere taşınmış, gömülü değil
User Defined Variables ${var} Ortam veya global değişkenler {{var}} Her ${} referansı yeniden yazılmış
JSON veya Regex extractor Extract Variable son işlemcisi (JSONPath, XPath) Çıkarılan isim sonraki adımlarla eşleşiyor
Response Assertion Assertion son işlemcisi Durum ve gövde kontrolleri hâlâ tetikleniyor
Duration Assertion pm.response.responseTime üzerinde pm.test betiği Eşik değeri
CSV Data Set Config Test verisi, rastgele veya sıralı eşleştirmeyle çalıştırılır Sütun adları değişkenlerle eşleşiyor
Loop, If, While controller'ları For döngüsü, If ve diğer akış kontrol koşulları Break ve hata yönetimi
Transaction controller Test senaryosundaki grup Adım sırası
Constant Timer Bekleme adımı Milisaniye cinsinden gecikme
Thread Group Performans testinde sanal kullanıcılar, süre, ramp-up 100 sanal kullanıcının altında
Listener'lar Uygulama içindeki test raporları veya CLI'dan -r html,json,junit Rapor, CI'ın beklediği yere düşüyor

Değişken sözdizimi değişikliği en çok insanı yakalar. JMeter ${token} kullanırken, Apidog {{token}} kullanır. İçe aktarmadan sonra senaryoda fazladan bir ${ arayın; bulduklarınız düz metin (literal) olarak gönderilir.

Neler sorunsuz taşınmıyor

Bazı JMeter özelliklerinin birebir karşılığı yoktur ve aksini iddia etmek göçlerin başarısız olmasının sebebidir. Bunları planlayın:

  1. Groovy ve BeanShell betikleri. Apidog'un ön ve son işlemci betikleri, Postman tarzı bir pm API'siyle JavaScript çalıştırır. JSR223 mantığını JavaScript'e yeniden yazın; kodlama ajanınız tam da bu tür çevirilerde iyidir.
  2. HTTP dışı sampler'lar. FTP, LDAP, TCP ve JMS sampler'ları, bir API istemcisinin kapsamı dışındaki protokolleri test eder. Bunları JMeter'da tutun. JDBC kontrolleri genellikle Apidog veritabanı işlemlerine dönüştürülebilir (MySQL, MongoDB, Redis ve Oracle dokümante edilmiştir), ancak bunları bilinçli olarak yeniden oluşturun.
  3. Verim (throughput) şekillendirme. JMeter'ın zamanlayıcıları, throughput controller'ları ve eklenti thread group'ları istek oranını hassas biçimde ayarlar. Apidog'un performans testi sanal kullanıcıları, süreyi ve ramp-up'ı ayarlar ve her kullanıcı senaryodan döngüyle geçer. Farklı saniye-başına-istek sayılarına hazır olun.
  4. 100 sanal kullanıcının ötesindeki ölçek. Bu, bugün Apidog performans testleri için dokümante edilmiş üst sınırdır.
  5. Yük çalıştırmaları için rapor dışa aktarma. Dokümanlar, performans raporlarının henüz dışa aktarılamadığını, istemcide görüntülendiklerini söylüyor. CLI'dan fonksiyonel çalıştırmalar HTML, JSON ve JUnit dışa aktarır.

Bunların hiçbiri göçi engellemez; hangi testlerin taşınacağına karar verir. Genellikle fonksiyonel paket taşınır ve birkaç zirve yük planı kalır. JMeter API testi eğitimi, sorunsuz taşınan fonksiyonel plan türünü gösterir.

Adım adım: bir JMeter test planını göç ettirme

İşte .jmx'ten yeşil bir CI işine kadar olan yolun tamamı.

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. Bir referans ölçün (baseline). Planı bir kez CLI modunda çalıştırın; JMeter kılavuzu bunu her yük testi için önerir: jmeter -n -t checkout.jmx -l baseline.jtl -e -o baseline-report/. p95 gecikmesini ve hata oranını not edin.
  2. Planı temizleyin. Listener'ları devre dışı bırakın ve ölü dalları kaldırın. Sırları dosyadan çıkarın.
  3. İçe aktarın. Uygulamanın Import iletişim kutusunu veya apidog import --project <projectId> --format jmeter --file ./checkout.jmx komutunu kullanın.
  4. Aktarılanları inceleyin. Endpoint'leri ve test senaryolarını listeleyin, ardından yukarıdaki tabloyu kullanarak .jmx ağacıyla karşılaştırın.
  5. Eksikleri giderin. ${} referanslarını yeniden yazın, betikleri JavaScript'e taşıyın, CSV verisini test verisi olarak ekleyin, bekleme adımları ekleyin.
  6. Fonksiyonel olarak çalıştırın. Bir performans testi, ancak her istek kendi başına geçtiğinde anlamlıdır ve Apidog'un dokümanları da aynısını söylüyor.
  7. Yük testi yapın. Uygulamada senaryo üzerinde sanal kullanıcıları, süreyi ve ramp-up'ı ayarlayın ve aynı kullanıcı sayısında p95'i ve hata oranını JMeter referansınızla karşılaştırın.
  8. CI'a bağlayın — apidog run ve bir JUnit raporuyla.

Kodlama ajanınızın Apidog CLI ile göç etmesini sağlayın

3 ile 6 arasındaki adımlar mekaniktir; bu da onları ideal ajan işi yapar. Claude Code, Codex veya Cursor, .jmx XML'ini okuyabilir, içe aktarmayı çalıştırabilir, sonucu karşılaştırabilir ve siz incelerken eksikleri yamalayabilir.

Bir kez kurulum yapın:

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

Skill, ajanınıza CLI'nın komutlarını ve şemalarını öğretir. Kurulumu da ajana yaptırmak isterseniz, ona şunu söyleyin: "Read https://apidog.com/apidog-cli-installation-guide.md and set up Apidog CLI." Apidog CLI kurulum rehberi aynı adımları insanlar için kapsar.

Ardından ajanınıza, planın bulunduğu klasörden tek bir istem (prompt) verin:

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.
Enter fullscreen mode Exit fullscreen mode

Ajan şu komutları çalıştırır:

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
Enter fullscreen mode Exit fullscreen mode

Tekrarlanan içe aktarımlar için iki bayrak önemlidir. --overwrite-mode çakışma stratejisini ayarlar (overwrite, merge, ignore veya keepBoth, varsayılan overwrite) ve --branch, göçün siz inceleyene kadar main'e dokunmaması için bir sprint dalına içe aktarma yapmanızı sağlar. Herhangi bir JSON gövdesi yazmadan önce, ajan apidog cli-schema get ve apidog cli-schema validate komutlarını çalıştırmalıdır; CLI'nın kendi yardımı, gövdeleri ezberden oluşturmamayı söyler. Bu iş akışına daha derin bir bakış için Apidog CLI in Claude Code yazısına bakın.

Göç ettirilen testleri CI'da çalıştırma

Senaryo yerel olarak geçtiğinde, CI tek komuttur. apidog run cli, html, json veya junit raporları yazar ve GitHub Actions, GitLab ve Jenkins'in yerleşik olarak okuduğu format JUnit'tir:

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

--upload-report, çalıştırma özetini buluta gönderir, böylece ekibiniz uygulama içinde açabilir. Veri odaklı çalıştırmalar, CSV, JSON veya test verisi kimliğiyle -d bayrağını alır; bu, hattaki (pipeline) JMeter'ın CSV Data Set'inin yerini alır. --on-error ignore, continue veya end değerlerini kabul eder. Apidog CLI CI/CD pipeline rehberi tam iş akışı dosyalarına sahiptir ve apidog run komut referansı her bayrağı kapsar.

JMeter'ı bir veya iki sürüm daha paralel çalışır durumda tutun. Apidog paketi aynı regresyonları yakaladığında ve yük sayılarınız aynı kullanıcı sayısında örtüştüğünde, karşılık gelen .jmx dosyalarını emekliye ayırın. Hâlâ araçları tartıyorsanız, JMeter alternatifleri derlemesi sahayı karşılaştırır.

SSS

Apidog .jmx dosyalarını doğrudan içe aktarıyor mu? Evet. JMeter, Apidog dokümanlarında listelenmiş bir içe aktarma formatıdır ve Apidog CLI apidog import --format jmeter --file <path> komutunu kabul eder. Dokümanlar eleman bazında bir eşleme yayınlamadığı için, sonucu orijinal planla karşılaştırarak inceleyin.

Apidog testlerini JMeter'a geri aktarabilir miyim? Evet. Apidog'un dokümanları, test senaryolarının Apidog CLI, Postman ve JMeter veri dosyaları olarak dışa aktarılabileceğini söylüyor; böylece hâlâ ihtiyaç duyan bir ekip için JMeter'da çalıştırabilirsiniz.

Apidog yük testleri için kaç sanal kullanıcı destekliyor? Performans testi dokümanları, çalıştırma başına 100 sanal kullanıcıya kadar olduğunu ve özelliğin beta aşamasında olduğunu söylüyor. Bunun üzerindeki dağıtık testler için JMeter'ı tutun.

Groovy betiklerime ne olur? Apidog'da çalışmazlar. Postman tarzı bir pm API'si kullanan JavaScript ön veya son işlemci betikleri olarak yeniden yazın. Bir kodlama ajanı, JSR223 parçalarının çoğunu hızlıca çevirebilir; çıktıyı inceleyin.

Değişken sözdizimini değiştirmem gerekiyor mu? Evet. JMeter ${var}, Apidog ise {{var}} kullanır. İlk çalıştırmanızdan önce, göç ettirilen senaryoda kalmış ${ arayın.

Apidog bu için ücretsiz mi? Apidog Free planı 4 kullanıcıya kadarını kapsar; bu, bir ekibin fonksiyonel paketini göç ettirmek ve CI'da çalıştırmak için yeterlidir.

Top comments (0)