Comment migrer vos tests JMeter vers Apidog

Migrez vos tests JMeter vers Apidog : importez le fichier .jmx, mappez les groupes d'utilisateurs, les extracteurs et les assertions, corrigez ce qui n'est pas repris automatiquement, puis exécutez le tout en CI avec Apidog CLI.

INEZA Felin-Michel

INEZA Felin-Michel

16 November 2026

Comment migrer vos tests JMeter vers Apidog

Apidog pour les entreprises

Déploiement sur site

SSO & RBAC

Conforme SOC 2

Découvrir Apidog Enterprise

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 :

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é.

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
É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 :

  1. Scripts Groovy et BeanShell. Les scripts de pré- et post-processeurs d'Apidog s'exécutent en JavaScript avec une API pm de style Postman. Réécrivez la logique JSR223 en JavaScript ; votre agent de codage excelle précisément dans ce type de traduction.
  2. 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.
  3. 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.
  4. Échelle au-delà de 100 utilisateurs virtuels. C'est le plafond documenté pour les tests de performance Apidog actuellement.
  5. 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.

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. 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.
  2. Nettoyez le plan. Désactivez les listeners et supprimez les branches mortes. Déplacez les secrets hors du fichier.
  3. Importez-le. Utilisez la boîte de dialogue Importer de l'application ou apidog import --project <projectId> --format jmeter --file ./checkout.jmx.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
  8. Intégrez-le au CI avec apidog run et 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.

Pratiquez le Design-first d'API dans Apidog

Découvrez une manière plus simple de créer et utiliser des API