Zur Migration von JMeter-Tests zu Apidog importieren Sie die .jmx-Datei (Apidog listet JMeter als unterstütztes Importformat, und die Apidog CLI akzeptiert --format jmeter), prüfen, was importiert wurde, bauen den Ablauf als Testszenario nach und stellen sicher, dass ein funktionaler Lauf erfolgreich ist, bevor Sie den Lasttest durchführen. Timer, Groovy-Skripte und Non-HTTP-Sampler erfordern manuelle Nacharbeit.
Nachfolgend: Was eine .jmx-Datei enthält, wie sich jedes Element zuordnen lässt, wo die Zuordnung scheitert und wie Ihr Coding-Agent die Arbeit mit der Apidog CLI erledigen kann.
Was steckt in einer JMeter-.jmx-Datei?
Eine .jmx-Datei ist der gespeicherte JMeter-Testplan: ein XML-Baum aus Elementen, die JMeter von oben nach unten ausführt. Das JMeter-Benutzerhandbuch definiert die Bausteine. Jeder Request liegt unter einer Thread-Gruppe, und jedes andere Element verändert, wie diese Requests gesendet, geprüft oder zeitlich gesteuert werden.
Das finden Sie, wenn Sie eine solche Datei öffnen:
- Thread Group: die simulierten Benutzer. Sie legt die Anzahl der Threads, die Ramp-up-Zeit und die Loop-Anzahl fest.
- Samplers: die Requests selbst. HTTP Request ist der häufigste, aber es gibt auch JDBC-, FTP-, LDAP- und TCP-Sampler.
- Logic Controllers: If-, While-, Loop-, Transaction- und Simple-Controller, die Reihenfolge und Wiederholung steuern.
- Config Elements: HTTP Request Defaults, Header Manager, Cookie Manager, CSV Data Set Config und User Defined Variables.
- Pre- und Post-Processors: Extraktoren (Regex, JSON, XPath, Boundary) und JSR223-Skripte, meist in Groovy.
- Assertions: Response-, Duration-, Size- und JSON-Assertions.
- Timers: Constant, Gaussian Random und andere Verzögerungen zwischen Samplern.
- Listeners: Ergebnisbäume, aggregierte Berichte und das HTML-Dashboard.
Wenn Sie eine Auffrischung zum Tool selbst brauchen, lesen Sie was JMeter ist und wie es funktioniert, bevor Sie Testpläne auseinandernehmen.
Kann Apidog JMeter-Dateien importieren?
Ja. Der Apidog-Migrationsleitfaden listet JMeter unter „API Clients & Data Tools“ mit der Beschreibung „Apache JMeter-Skriptdateien importieren“. Die Apidog CLI stellt denselben Importer bereit: apidog import --help führt jmeter unter den Werten für --format auf.
Was die Dokumentation nicht veröffentlicht, ist eine Element-für-Element-Zuordnung für JMeter-Importe. Postmans JMeter-Migrationsleitfaden liefert einen Importbericht mit den Kategorien „importiert exakt“, „angenähert“ und „nicht unterstützt“; der manuelle Import in Apidog zeigt stattdessen eine Vorschau, in der Sie auswählen, was importiert werden soll, bevor Sie bestätigen. Betrachten Sie den Import also als ersten Entwurf Ihrer Migration, nicht als fertige Testsuite. Öffnen Sie das Ergebnis, vergleichen Sie es mit dem .jmx-Baum und schließen Sie die Lücken von Hand oder mit Ihrem Agenten.
Eine ehrliche Einschränkung: Apidogs Performancetesting befindet sich in der Beta und unterstützt bis zu 100 virtuelle Benutzer pro Lauf. Wenn Ihr JMeter-Plan tausende Threads über ein verteiltes Setup steuert, behalten Sie JMeter für diese Spitzenlasten bei und migrieren Sie nur den funktionalen und Regressionsbereich zu Apidog.
Wie sich JMeter-Elemente auf Apidog abbilden lassen
Die meisten Elemente eines typischen HTTP-Testplans haben ein direktes Pendant in Apidog. Die Tabelle zeigt, wo jedes Element nach der Migration landet und was Sie nach Abschluss des Imports prüfen sollten.

| JMeter-Element | Wo es in Apidog liegt | Nach dem Import prüfen |
|---|---|---|
| HTTP-Request-Sampler | Endpoint-Request oder Schritt im Testszenario | Methode, Pfad, Body und Header |
| HTTP Request Defaults | Basis-URL der Umgebung | Eine Basis-URL pro Umgebung |
| Header Manager, Authentifizierung | Request-Header oder Auth-Einstellungen | Tokens in Variablen verschoben, nicht hartkodiert |
User Defined Variables ${var} |
Umgebungs- oder globale Variablen {{var}} |
Jede ${}-Referenz umgeschrieben |
| JSON- oder Regex-Extraktor | Post-Processor „Extract Variable“ (JSONPath, XPath) | Der extrahierte Name stimmt mit späteren Schritten überein |
| Response Assertion | Post-Processor „Assertion“ | Status- und Body-Prüfungen greifen weiterhin |
| Duration Assertion | pm.test-Skript auf pm.response.responseTime |
Schwellenwert |
| CSV Data Set Config | Testdaten, Lauf mit zufälliger oder sequenzieller Zuordnung | Spaltennamen stimmen mit Variablen überein |
| Loop-, If-, While-Controller | For-Schleife, If und andere Flusssteuerungen | Abbruch- und Fehlerbehandlung |
| Transaction Controller | Gruppe im Testszenario | Schritt-Reihenfolge |
| Constant Timer | Wait-Schritt | Verzögerung in Millisekunden |
| Thread Group | Virtuelle Benutzer, Dauer, Ramp-up im Performancetest | Unter 100 virtuellen Benutzern |
| Listeners | Testberichte in der App, oder -r html,json,junit über die CLI |
Bericht landet dort, wo die CI ihn erwartet |
Die Änderung der Variablensyntax erwischt die meisten Leute. JMeter referenziert ${token}, während Apidog {{token}} verwendet. Durchsuchen Sie das Szenario nach dem Import mit grep nach verbliebenen ${; alles, was Sie finden, wird als literale Zeichenkette gesendet.
Was sich nicht sauber übernehmen lässt
Einige JMeter-Features haben kein Eins-zu-Eins-Äquivalent, und wer das leugnet, gerät bei der Migration in Schwierigkeiten. Planen Sie Folgendes ein:
- Groovy- und BeanShell-Skripte. Apidogs Pre- und Post-Processor-Skripte laufen in JavaScript mit einer Postman-ähnlichen
pm-API. Schreiben Sie die JSR223-Logik in JavaScript um; genau diese Art von Übersetzung beherrscht Ihr Coding-Agent gut. - Non-HTTP-Sampler. FTP-, LDAP-, TCP- und JMS-Sampler testen Protokolle außerhalb des Anwendungsbereichs eines API-Clients. Behalten Sie diese in JMeter. JDBC-Prüfungen lassen sich oft in Apidog-Datenbankoperationen umwandeln (MySQL, MongoDB, Redis und Oracle sind dokumentiert), aber bauen Sie sie bewusst neu auf.
- Durchsatzsteuerung. JMeter-Timer, Throughput-Controller und Plugin-Thread-Gruppen steuern die Request-Rate präzise. Apidogs Performancetest legt virtuelle Benutzer, Dauer und Ramp-up fest, und jeder Benutzer durchläuft das Szenario in einer Schleife. Rechnen Sie mit anderen Requests-per-Sekunde-Werten.
- Skalierung über 100 virtuelle Benutzer hinaus. Das ist die dokumentierte Obergrenze für Apidog-Performancetests derzeit.
- Berichtsexporte für Lastläufe. Laut Dokumentation können Performanceberichte noch nicht exportiert werden; Sie betrachten sie im Client. Funktionale Läufe über die CLI exportieren HTML, JSON und JUnit.
Keines davon blockiert eine Migration; es entscheidet nur, welche Tests umziehen. Meist zieht die funktionale Suite um, und einige Spitzenlast-Pläne bleiben. Das JMeter-API-Testing-Tutorial zeigt, welche Art von funktionalem Plan sich sauber migrieren lässt.
Schritt für Schritt: Einen JMeter-Testplan migrieren
Hier ist der komplette Weg von der .jmx-Datei bis zu einem grünen CI-Job.

- Baseline aufnehmen. Führen Sie den Plan einmal im CLI-Modus aus, was das JMeter-Handbuch für jeden Lasttest empfiehlt:
jmeter -n -t checkout.jmx -l baseline.jtl -e -o baseline-report/. Notieren Sie sich p95-Latenz und Fehlerrate. - Plan bereinigen. Deaktivieren Sie Listener und entfernen Sie tote Zweige. Lagern Sie Geheimnisse aus der Datei aus.
- Importieren. Verwenden Sie den Import-Dialog der App oder
apidog import --project <projectId> --format jmeter --file ./checkout.jmx. - Ergebnis prüfen. Listen Sie Endpoints und Testszenarien auf und vergleichen Sie sie mit dem
.jmx-Baum anhand der obigen Tabelle. - Lücken schließen.
${}-Referenzen umschreiben, Skripte nach JavaScript portieren, CSV-Daten als Testdaten anbinden, Wait-Schritte hinzufügen. - Funktional ausführen. Ein Performancetest ist erst sinnvoll, wenn jeder Request für sich besteht – die Apidog-Dokumentation sagt dasselbe.
- Lasttest durchführen. Legen Sie in der App virtuelle Benutzer, Dauer und Ramp-up für das Szenario fest und vergleichen Sie p95 und Fehlerrate mit Ihrer JMeter-Baseline bei gleicher Benutzerzahl.
- In CI einbinden mit
apidog runund einem JUnit-Bericht.
Den Coding-Agenten mit der Apidog CLI migrieren lassen
Die Schritte 3 bis 6 sind mechanisch – ideale Arbeit für einen Agenten. Claude Code, Codex oder Cursor können die .jmx-XML lesen, den Import ausführen, das Ergebnis abgleichen und die Lücken patchen, während Sie prüfen.
Richten Sie einmalig ein:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install
Das Skill bringt Ihrem Agenten die Befehle und Schemata der CLI bei. Wenn der Agent auch das Setup übernehmen soll, sagen Sie ihm: „Read https://apidog.com/apidog-cli-installation-guide.md and set up Apidog CLI.“ Der Apidog-CLI-Installationsleitfaden deckt dieselben Schritte für Menschen ab.
Geben Sie Ihrem Agenten dann aus dem Ordner mit dem Testplan diesen Prompt:
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.
Der Agent führt Befehle wie diese aus:
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
Zwei Flags sind bei wiederholten Imports wichtig. --overwrite-mode legt die Konfliktstrategie fest (overwrite, merge, ignore oder keepBoth, Standard overwrite), und mit --branch importieren Sie in einen Sprint-Branch, sodass die Migration main nicht anfasst, bis Sie sie geprüft haben. Bevor der Agent ein JSON-Payload schreibt, sollte er apidog cli-schema get und apidog cli-schema validate ausführen; die Hilfe der CLI rät ausdrücklich davon ab, Payloads aus dem Gedächtnis zu bauen. Einen tieferen Einblick in diesen Workflow gibt Apidog CLI in Claude Code.
Die migrierten Tests in CI ausführen
Sobald das Szenario lokal erfolgreich ist, ist CI nur noch ein Befehl. apidog run schreibt Berichte im Format cli, html, json oder junit, und JUnit lesen GitHub Actions, GitLab und Jenkins nativ:
apidog run -t <scenarioId> --project <projectId> -e <envId> \
-r cli,junit --out-dir apidog-reports --upload-report
--upload-report sendet die Laufübersicht in die Cloud, damit Ihr Team sie in der App öffnen kann. Datengetriebene Läufe akzeptieren -d mit einer CSV, JSON oder einer Testdaten-ID, was JMeter’s CSV Data Set in der Pipeline ersetzt. --on-error akzeptiert ignore, continue oder end. Der Apidog-CLI-CI/CD-Pipeline-Leitfaden enthält vollständige Workflow-Dateien, und die apidog-run-Befehlsreferenz deckt jedes Flag ab.
Lassen Sie JMeter noch ein bis zwei Releases parallel laufen. Wenn die Apidog-Suite dieselben Regressionen aufdeckt und Ihre Lastwerte bei gleicher Benutzerzahl übereinstimmen, können Sie die entsprechenden .jmx-Dateien einstellen. Wenn Sie noch Tools abwägen, vergleicht das JMeter-Alternativen-Roundup den Markt.
FAQ
Importiert Apidog .jmx-Dateien direkt? Ja. JMeter ist in der Apidog-Dokumentation als Importformat gelistet, und die Apidog CLI akzeptiert apidog import --format jmeter --file <path>. Prüfen Sie das Ergebnis gegen den ursprünglichen Plan, da die Dokumentation keine Zuordnung pro Element veröffentlicht.
Kann ich Apidog-Tests zurück nach JMeter exportieren? Ja. Laut Apidog-Dokumentation lassen sich Testszenarien als Apidog-CLI-, Postman- und JMeter-Datendateien exportieren, sodass Sie sie in JMeter ausführen können, falls ein Team das noch benötigt.
Wie viele virtuelle Benutzer unterstützt Apidog für Lasttests? Die Performancetesting-Dokumentation nennt bis zu 100 virtuelle Benutzer pro Lauf, und das Feature befindet sich in der Beta. Behalten Sie JMeter für verteilte Tests darüber hinaus bei.
Was passiert mit meinen Groovy-Skripten? Sie laufen nicht in Apidog. Schreiben Sie sie als JavaScript-Pre- oder Post-Processor-Skripte um, die eine Postman-ähnliche pm-API nutzen. Ein Coding-Agent übersetzt die meisten JSR223-Snippets schnell; prüfen Sie das Ergebnis.
Muss ich die Variablensyntax ändern? Ja. JMeter verwendet ${var}, Apidog verwendet {{var}}. Durchsuchen Sie das migrierte Szenario vor dem ersten Lauf nach verbliebenen ${.
Ist Apidog dafür kostenlos? Der Apidog-Free-Plan umfasst bis zu 4 Benutzer – genug, um die funktionale Suite eines Teams zu migrieren und in CI auszuführen.
