Cómo migrar pruebas de JMeter a Apidog

Migra tus pruebas de JMeter a Apidog: importa el archivo .jmx, mapea los grupos de hilos, los extractores y las aserciones, corrige lo que no se transfiera y ejecútalo en CI con la CLI de Apidog.

INEZA Felin-Michel

INEZA Felin-Michel

16 November 2026

Cómo migrar pruebas de JMeter a Apidog

Apidog para empresas

Despliegue local

SSO & RBAC

Conforme con SOC 2

Explorar Apidog Enterprise

Para migrar pruebas de JMeter a Apidog, importa el archivo .jmx (Apidog incluye JMeter entre sus formatos de importación compatibles, y Apidog CLI acepta --format jmeter), revisa qué se importó, reconstruye el flujo como un escenario de prueba y confirma que pasa una ejecución funcional antes de someterlo a pruebas de carga. Los temporizadores, los scripts de Groovy y los samplers que no son HTTP requieren trabajo manual.

A continuación: qué contiene un archivo .jmx, cómo se mapea cada elemento, dónde falla el mapeo y cómo tu agente de programación puede hacer el trabajo con Apidog CLI.

Qué contiene un archivo .jmx de JMeter

Un archivo .jmx es el plan de pruebas guardado de JMeter: un árbol XML de elementos que JMeter ejecuta de arriba abajo. El manual de usuario de JMeter define sus componentes básicos. Cada petición se sitúa dentro de un grupo de hilos (thread group), y todos los demás elementos cambian la forma en que esas peticiones se envían, se verifican o se temporizan.

Esto es lo que encontrarás al abrir uno:

Si necesitas repasar la herramienta en sí, lee qué es JMeter y cómo funciona antes de empezar a desmontar planes.

¿Puede Apidog importar archivos de JMeter?

Sí. La guía de migración de Apidog incluye JMeter en la categoría “API Clients & Data Tools” con la descripción “Import Apache JMeter script files”. Apidog CLI expone el mismo importador: apidog import --help muestra jmeter entre los valores posibles de --format.

Lo que la documentación no publica es un mapeo elemento por elemento para las importaciones de JMeter. La guía de migración de JMeter de Postman genera un informe de importación con las categorías “imported exactly”, “approximated” y “not supported”; la importación manual de Apidog te ofrece en cambio una vista previa, donde eliges qué traer antes de confirmar. Así que trata la importación como el primer borrador de tu migración, no como la suite terminada. Abre lo que se importó, compáralo con el árbol del .jmx y corrige las lagunas a mano o con tu agente.

Una advertencia honesta: las pruebas de rendimiento de Apidog están en beta y soportan hasta 100 usuarios virtuales por ejecución. Si tu plan de JMeter maneja miles de hilos en una configuración distribuida, conserva JMeter para esa carga máxima y traslada la parte funcional y de regresión a Apidog.

Cómo se mapean los elementos de JMeter en Apidog

La mayor parte de un plan de pruebas HTTP típico tiene un lugar directo en Apidog. La tabla muestra dónde vive cada elemento tras la migración y qué conviene comprobar una vez finalizada la importación.

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
Elemento de JMeter Dónde vive en Apidog Comprobar tras la importación
Sampler HTTP Request Petición de endpoint o paso de escenario de prueba Método, ruta, cuerpo y cabeceras
HTTP Request Defaults URL base del entorno Una URL base por entorno
Header Manager, autenticación Cabeceras de la petición o configuración de autenticación Tokens movidos a variables, no incrustados en el código
User Defined Variables ${var} Variables de entorno o globales {{var}} Todas las referencias ${} reescritas
Extractor JSON o Regex Post procesador Extract Variable (JSONPath, XPath) El nombre extraído coincide con los pasos posteriores
Response Assertion Post procesador de asertos Las comprobaciones de estado y cuerpo siguen activas
Duration Assertion Script pm.test sobre pm.response.responseTime Valor del umbral
CSV Data Set Config Datos de prueba, con coincidencia aleatoria o secuencial Los nombres de columnas coinciden con las variables
Controladores Loop, If, While Bucle for, condicional If y otras condiciones de control de flujo Manejo de break y de errores
Controlador Transaction Grupo en el escenario de prueba Orden de los pasos
Constant Timer Paso de espera Retardo en milisegundos
Thread Group Usuarios virtuales, duración y ramp-up de la prueba de rendimiento Menos de 100 usuarios virtuales
Listeners Informes de prueba en la aplicación, o -r html,json,junit desde la CLI El informe llega donde lo espera el CI

El cambio de sintaxis de las variables es lo que más problemas causa. JMeter usa referencias como ${token}, mientras que Apidog usa {{token}}. Busca en el escenario algún ${ suelto tras la importación; cualquiera que encuentres se enviará como una cadena literal.

Qué no se traslada sin problemas

Algunas funciones de JMeter no tienen un equivalente uno a uno, y fingir lo contrario es la receta para que la migración salga mal. Ten previsto lo siguiente:

  1. Scripts de Groovy y BeanShell. Los scripts de pre y post procesador de Apidog ejecutan JavaScript con una API pm al estilo Postman. Reescribe la lógica JSR223 en JavaScript; tu agente de programación es especialmente bueno en este tipo de traducción.
  2. Samplers que no son HTTP. Los samplers de FTP, LDAP, TCP y JMS prueban protocolos fuera del alcance de un cliente de API. Mantenlos en JMeter. Las comprobaciones JDBC a menudo pueden convertirse en operaciones de base de datos de Apidog (MySQL, MongoDB, Redis y Oracle están documentadas), pero reconstrúyelas de forma deliberada.
  3. Moldeado del rendimiento (throughput shaping). Los temporizadores, los controladores de throughput y los grupos de hilos de plugins de JMeter ajustan la tasa de peticiones con precisión. La prueba de rendimiento de Apidog define usuarios virtuales, duración y ramp-up, y cada usuario recorre el escenario en bucle. Espera cifras de peticiones por segundo distintas.
  4. Escala por encima de 100 usuarios virtuales. Ese es el límite documentado para las pruebas de rendimiento de Apidog en la actualidad.
  5. Exportación de informes para ejecuciones de carga. La documentación indica que los informes de rendimiento aún no se pueden exportar; se consultan en el cliente. Las ejecuciones funcionales desde la CLI sí exportan HTML, JSON y JUnit.

Nada de esto impide una migración; decide qué pruebas se trasladan. Normalmente se mueve la suite funcional y unos pocos planes de carga máxima se quedan. El tutorial de pruebas de API con JMeter muestra el tipo de plan funcional que se traslada sin problemas.

Paso a paso: migrar un plan de pruebas de JMeter

Esta es la ruta completa, desde el .jmx hasta un job de CI en verde.

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. Registra una línea base. Ejecuta el plan una vez en modo CLI, como recomienda el manual de JMeter para cualquier prueba de carga: jmeter -n -t checkout.jmx -l baseline.jtl -e -o baseline-report/. Anota la latencia p95 y la tasa de errores.
  2. Limpia el plan. Desactiva los listeners y elimina las ramas muertas. Saca los secretos del archivo.
  3. Importa el plan. Usa el diálogo de importación de la aplicación o apidog import --project <projectId> --format jmeter --file ./checkout.jmx.
  4. Revisa qué se importó. Enumera los endpoints y los escenarios de prueba y compáralos con el árbol del .jmx usando la tabla anterior.
  5. Corrige las lagunas. Reescribe las referencias ${}, traslada los scripts a JavaScript, adjunta los datos CSV como datos de prueba y añade pasos de espera.
  6. Ejecuta las pruebas funcionalmente. Una prueba de rendimiento solo es útil una vez que cada petición pasa por sí sola, y la documentación de Apidog dice lo mismo.
  7. Somételo a pruebas de carga. En la aplicación, define usuarios virtuales, duración y ramp-up en el escenario, y compara el p95 y la tasa de errores con tu línea base de JMeter con el mismo número de usuarios.
  8. Intégralo en el CI con apidog run y un informe JUnit.

Deja que tu agente de programación haga la migración con Apidog CLI

Los pasos 3 a 6 son mecánicos, lo que los convierte en el trabajo ideal para un agente. Claude Code, Codex o Cursor pueden leer el XML del .jmx, ejecutar la importación, comparar el resultado y corregir las lagunas mientras tú supervisas.

Configura una sola vez:

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

El skill enseña a tu agente los comandos y esquemas de la CLI. Si prefieres dejar que el agente también haga la configuración, dile: “Lee https://apidog.com/apidog-cli-installation-guide.md y configura Apidog CLI.” La guía de instalación de Apidog CLI cubre los mismos pasos para humanos.

Luego dale a tu agente un único prompt desde la carpeta que contiene el 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.

El agente ejecuta comandos como estos:

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

Dos flags importan para las importaciones repetidas. --overwrite-mode define la estrategia ante conflictos (overwrite, merge, ignore o keepBoth, por defecto overwrite), y --branch te permite importar en una rama de sprint para que la migración no toque la rama principal hasta que la hayas revisado. Antes de escribir cualquier payload JSON, el agente debería ejecutar apidog cli-schema get y apidog cli-schema validate; la propia ayuda de la CLI indica que no hay que construir payloads de memoria. Para ver este flujo de trabajo en detalle, consulta Apidog CLI in Claude Code.

Ejecutar las pruebas migradas en el CI

Una vez que el escenario pasa en local, el CI es un solo comando. apidog run genera informes cli, html, json o junit, y JUnit es el formato que GitHub Actions, GitLab y Jenkins leen de forma nativa:

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

--upload-report envía el resumen de la ejecución a la nube para que tu equipo pueda abrirlo en la aplicación. Las ejecuciones basadas en datos aceptan -d con un CSV, un JSON o un ID de datos de prueba, lo que sustituye al CSV Data Set de JMeter en el pipeline. --on-error acepta ignore, continue o end. La guía del pipeline CI/CD con Apidog CLI incluye archivos de workflow completos, y la referencia del comando apidog run cubre cada flag.

Mantén JMeter funcionando en paralelo durante una o dos versiones. Cuando la suite de Apidog detecte las mismas regresiones y tus cifras de carga coincidan con el mismo número de usuarios, jubila los archivos .jmx correspondientes. Si aún estás comparando herramientas, el repaso a alternativas de JMeter compara el panorama.

FAQ

¿Apidog importa archivos .jmx directamente? Sí. JMeter aparece como formato de importación en la documentación de Apidog, y Apidog CLI acepta apidog import --format jmeter --file <path>. Revisa el resultado frente al plan original, porque la documentación no publica un mapeo por elemento.

¿Puedo exportar pruebas de Apidog de vuelta a JMeter? Sí. La documentación de Apidog indica que los escenarios de prueba pueden exportarse como archivos de datos de Apidog CLI, Postman y JMeter, de modo que puedes ejecutarlos en JMeter si algún equipo aún lo necesita.

¿Cuántos usuarios virtuales soporta Apidog en las pruebas de carga? La documentación de pruebas de rendimiento indica hasta 100 usuarios virtuales por ejecución, y la función está en beta. Conserva JMeter para pruebas distribuidas por encima de esa cifra.

¿Qué ocurre con mis scripts de Groovy? No se ejecutan en Apidog. Reescríbelos como scripts JavaScript de pre o post procesador, que usan una API pm al estilo Postman. Un agente de programación puede traducir la mayoría de los fragmentos JSR223 rápidamente; revisa el resultado.

¿Necesito cambiar la sintaxis de las variables? Sí. JMeter usa ${var} y Apidog usa {{var}}. Busca en el escenario migrado algún ${ restante antes de tu primera ejecución.

¿Es Apidog gratuito para esto? El plan gratuito de Apidog cubre hasta 4 usuarios, lo que basta para migrar la suite funcional de un equipo y ejecutarla en el CI.

Practica el diseño de API en Apidog

Descubre una forma más fácil de construir y usar APIs