Pour migrer vos tests JMeter vers Apidog, importez le fichier .jmx (Apidog liste JMeter parmi les formats d'import pris en charge, et Apidog CLI accepte --format jmeter), vérifiez le résultat, reconstruisez le flux sous forme de scénario de test, puis confirmez qu'il passe une exécution fonctionnelle avant de le tester en charge. Les timers, les scripts Groovy et les samplers non HTTP nécessitent un travail manuel.
Vous trouverez ci-dessous : ce que contient un fichier .jmx, la correspondance de chaque élément, les limites de cette correspondance, et comment votre agent de codage peut effectuer le travail avec Apidog CLI.
Que contient un fichier .jmx JMeter
Un fichier .jmx est le plan de test JMeter enregistré : un arbre XML d'éléments que JMeter exécute de haut en bas. Le manuel utilisateur de JMeter définit les composants de base. Chaque requête se trouve sous un groupe de threads, et tout autre élément modifie la façon dont ces requêtes sont envoyées, vérifiées ou temporisées.
Voici ce que vous trouverez en ouvrant un tel fichier :
- Groupe de threads : les utilisateurs simulés. Il définit le nombre de threads, la période de montée en charge (ramp-up) et le nombre de boucles.
- Samplers : les requêtes elles-mêmes. HTTP Request est le plus courant, mais il existe aussi des samplers JDBC, FTP, LDAP et TCP.
- Contrôleurs logiques : les contrôleurs If, While, Loop, Transaction et Simple qui déterminent l'ordre et la répétition.
- Éléments de configuration : HTTP Request Defaults, Header Manager, Cookie Manager, CSV Data Set Config et User Defined Variables.
- Pré- et post-processeurs : extracteurs (Regex, JSON, XPath, Boundary) et scripts JSR223, généralement en Groovy.
- Assertions : assertions Response, Duration, Size et JSON.
- Timers : Constant, Gaussian Random et autres délais entre les samplers.
- Listeners : arbres de résultats, rapports agrégés et tableau de bord HTML.
Si vous avez besoin d'un rappel sur l'outil lui-même, lisez ce qu'est JMeter et comment il fonctionne avant de commencer à démonter vos plans de test.
Apidog peut-il importer des fichiers JMeter ?
Oui. Le guide de migration d'Apidog liste JMeter sous « API Clients & Data Tools » avec la description « Import Apache JMeter script files ». Apidog CLI expose le même importateur : apidog import --help liste jmeter parmi les valeurs de --format.
Ce que la documentation ne publie pas, c'est une correspondance élément par élément pour les imports JMeter. Le guide de migration JMeter de Postman fournit un rapport d'import avec les catégories « importé exactement », « approximé » et « non pris en charge » ; l'import manuel d'Apidog vous propose plutôt un aperçu, dans lequel vous choisissez ce que vous souhaitez importer avant de confirmer. Considérez donc l'import comme la première ébauche de votre migration, et non comme la suite définitive. Ouvrez ce qui a été importé, comparez-le à l'arbre .jmx, puis comblez les lacunes à la main ou avec votre agent.
Une mise en garde honnête : les tests de performance d'Apidog sont en version bêta et prennent en charge jusqu'à 100 utilisateurs virtuels par exécution. Si votre plan JMeter pilote des milliers de threads dans une configuration distribuée, conservez JMeter pour cette charge de pointe et migrez les aspects fonctionnels et de régression vers Apidog.
Correspondance entre les éléments JMeter et Apidog
La plupart d'un plan de test HTTP typique trouve une place directe dans Apidog. Le tableau montre où vit chaque élément après la migration et ce qu'il faut vérifier une fois l'import terminé.

| Élément JMeter | Emplacement dans Apidog | Vérification après import |
|---|---|---|
| Sampler HTTP Request | Requête d'endpoint ou étape de scénario de test | Méthode, chemin, corps et en-têtes |
| HTTP Request Defaults | URL de base de l'environnement | Une URL de base par environnement |
| Header Manager, authentification | En-têtes de requête ou paramètres d'authentification | Jetons déplacés vers des variables, non codés en dur |
User Defined Variables ${var} |
Variables d'environnement ou globales {{var}} |
Toutes les références ${} réécrites |
| Extracteur JSON ou Regex | Post-processeur Extract Variable (JSONPath, XPath) | Le nom extrait correspond aux étapes suivantes |
| Response Assertion | Post-processeur d'assertion | Les vérifications de statut et de corps se déclenchent toujours |
| Duration Assertion | Script pm.test sur pm.response.responseTime |
Valeur du seuil |
| CSV Data Set Config | Données de test, exécutées en correspondance aléatoire ou séquentielle | Les noms de colonnes correspondent aux variables |
| Contrôleurs Loop, If, While | Boucle For, If et autres conditions de contrôle de flux | Gestion des ruptures et des erreurs |
| Contrôleur Transaction | Groupe dans le scénario de test | Ordre des étapes |
| Timer Constant | Étape d'attente | Délai en millisecondes |
| Groupe de threads | Utilisateurs virtuels, durée, ramp-up du test de performance | Moins de 100 utilisateurs virtuels |
| Listeners | Rapports de test dans l'application, ou -r html,json,junit depuis le CLI |
Le rapport arrive là où le CI l'attend |
Le changement de syntaxe des variables surprend le plus grand nombre. JMeter référence ${token}, tandis qu'Apidog utilise {{token}}. Cherchez dans le scénario un ${ résiduel après l'import ; tous ceux que vous trouverez seront envoyés comme chaîne littérale.
Ce qui ne se transfère pas correctement
Certaines fonctionnalités de JMeter n'ont pas d'équivalent un à un, et prétendre le contraire est la meilleure façon de rater une migration. Prévoyez ces cas :
- Scripts Groovy et BeanShell. Les scripts de pré- et post-processeurs d'Apidog s'exécutent en JavaScript avec une API
pmde style Postman. Réécrivez la logique JSR223 en JavaScript ; votre agent de codage excelle précisément dans ce type de traduction. - Samplers non HTTP. Les samplers FTP, LDAP, TCP et JMS testent des protocoles hors du périmètre d'un client API. Gardez-les dans JMeter. Les vérifications JDBC peuvent souvent devenir des opérations de base de données Apidog (MySQL, MongoDB, Redis et Oracle sont documentés), mais reconstruisez-les délibérément.
- Modelage du débit. Les timers, contrôleurs de débit et groupes de threads avec plugins de JMeter ajustent finement le taux de requêtes. Le test de performance d'Apidog définit les utilisateurs virtuels, la durée et le ramp-up, et chaque utilisateur boucle sur le scénario. Attendez-vous à des nombres de requêtes par seconde différents.
- Échelle au-delà de 100 utilisateurs virtuels. C'est le plafond documenté pour les tests de performance Apidog actuellement.
- Exports de rapports pour les exécutions de charge. La documentation indique que les rapports de performance ne peuvent pas encore être exportés ; vous les consultez dans le client. Les exécutions fonctionnelles depuis le CLI exportent en HTML, JSON et JUnit.
Rien de tout cela ne bloque une migration ; cela détermine simplement quels tests migrent. En général, la suite fonctionnelle migre et quelques plans de charge de pointe restent. Le tutoriel de test d'API avec JMeter montre le type de plan fonctionnel qui migre sans problème.
Étape par étape : migrer un plan de test JMeter
Voici le parcours complet, du .jmx à un job CI au vert.

- Enregistrez une référence. Exécutez le plan une fois en mode CLI, ce que le manuel JMeter recommande pour tout test de charge :
jmeter -n -t checkout.jmx -l baseline.jtl -e -o baseline-report/. Notez la latence p95 et le taux d'erreur. - Nettoyez le plan. Désactivez les listeners et supprimez les branches mortes. Déplacez les secrets hors du fichier.
- Importez-le. Utilisez la boîte de dialogue Importer de l'application ou
apidog import --project <projectId> --format jmeter --file ./checkout.jmx. - Vérifiez le résultat. Listez les endpoints et scénarios de test, puis comparez-les à l'arbre
.jmxà l'aide du tableau ci-dessus. - Comblez les lacunes. Réécrivez les références
${}, portez les scripts en JavaScript, rattachez les données CSV en tant que données de test, ajoutez des étapes d'attente. - Exécutez-le fonctionnellement. Un test de performance n'est utile que lorsque chaque requête passe individuellement, et la documentation d'Apidog dit la même chose.
- Testez en charge. Dans l'application, définissez les utilisateurs virtuels, la durée et le ramp-up sur le scénario, puis comparez le p95 et le taux d'erreur à votre référence JMeter avec le même nombre d'utilisateurs.
- Intégrez-le au CI avec
apidog runet un rapport JUnit.
Laissez votre agent de codage effectuer la migration avec Apidog CLI
Les étapes 3 à 6 sont mécaniques, ce qui en fait un travail idéal pour un agent. Claude Code, Codex ou Cursor peuvent lire le XML .jmx, lancer l'import, comparer le résultat et corriger les lacunes pendant que vous révisez.
Configurez une seule fois :
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install
La skill enseigne à votre agent les commandes et schémas du CLI. Si vous préférez laisser l'agent faire aussi la configuration, dites-lui : « Lis https://apidog.com/apidog-cli-installation-guide.md et configure Apidog CLI. » Le guide d'installation d'Apidog CLI couvre les mêmes étapes pour les humains.
Donnez ensuite à votre agent une seule invite depuis le dossier contenant le 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.
L'agent exécute des commandes comme celles-ci :
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
Deux options comptent pour les imports répétés. --overwrite-mode définit la stratégie de conflit (overwrite, merge, ignore ou keepBoth, par défaut overwrite), et --branch permet d'importer dans une branche de sprint afin que la migration ne touche pas la branche principale tant que vous n'avez pas tout révisé. Avant d'écrire une charge utile JSON, l'agent doit exécuter apidog cli-schema get et apidog cli-schema validate ; l'aide du CLI indique elle-même de ne pas construire les charges utiles de mémoire. Pour un aperçu plus approfondi de ce flux de travail, consultez Apidog CLI dans Claude Code.
Exécuter les tests migrés dans le CI
Une fois que le scénario passe en local, le CI ne tient qu'à une commande. apidog run écrit des rapports cli, html, json ou junit, et JUnit est le format que GitHub Actions, GitLab et Jenkins lisent nativement :
apidog run -t <scenarioId> --project <projectId> -e <envId> \
-r cli,junit --out-dir apidog-reports --upload-report
--upload-report envoie l'aperçu de l'exécution vers le cloud afin que votre équipe puisse l'ouvrir dans l'application. Les exécutions pilotées par les données acceptent -d avec un ID de CSV, JSON ou de données de test, ce qui remplace le CSV Data Set de JMeter dans le pipeline. --on-error accepte ignore, continue ou end. Le guide du pipeline CI/CD d'Apidog CLI contient des fichiers de workflow complets, et la référence de la commande apidog run détaille chaque option.
Laissez JMeter tourner en parallèle pendant une ou deux versions. Lorsque la suite Apidog détecte les mêmes régressions et que vos chiffres de charge concordent avec le même nombre d'utilisateurs, mettez à la retraite les fichiers .jmx correspondants. Si vous hésitez encore entre les outils, la sélection d'alternatives à JMeter compare le marché.
FAQ
Apidog importe-t-il directement les fichiers .jmx ? Oui. JMeter est un format d'import listé dans la documentation d'Apidog, et Apidog CLI accepte apidog import --format jmeter --file <path>. Vérifiez le résultat par rapport au plan d'origine, car la documentation ne publie pas de correspondance élément par élément.
Puis-je exporter les tests Apidog vers JMeter ? Oui. La documentation d'Apidog indique que les scénarios de test peuvent être exportés comme fichiers de données Apidog CLI, Postman et JMeter, ce qui permet de les exécuter dans JMeter si une équipe en a encore besoin.
Combien d'utilisateurs virtuels Apidog prend-il en charge pour les tests de charge ? La documentation des tests de performance indique jusqu'à 100 utilisateurs virtuels par exécution, et la fonctionnalité est en version bêta. Conservez JMeter pour les tests distribués au-delà de ce seuil.
Que deviennent mes scripts Groovy ? Ils ne s'exécutent pas dans Apidog. Réécrivez-les en scripts JavaScript de pré- ou post-processeur, qui utilisent une API pm de style Postman. Un agent de codage peut traduire rapidement la plupart des extraits JSR223 ; révisez le résultat.
Dois-je changer la syntaxe des variables ? Oui. JMeter utilise ${var} et Apidog utilise {{var}}. Recherchez les ${ résiduels dans le scénario migré avant votre première exécution.
Apidog est-il gratuit pour cet usage ? Le plan gratuit d'Apidog couvre jusqu'à 4 utilisateurs, ce qui suffit pour migrer la suite fonctionnelle d'une équipe et l'exécuter dans le CI.
