Para migrar testes do JMeter para o Apidog, importe o arquivo .jmx (o Apidog lista o JMeter como um formato de importação suportado, e o Apidog CLI aceita --format jmeter), revise o que foi importado, reconstrua o fluxo como um cenário de teste e confirme que ele passa em uma execução funcional antes de fazer o teste de carga. Timers, scripts Groovy e samplers não HTTP exigem trabalho manual.
A seguir: o que um arquivo .jmx contém, como cada elemento é mapeado, onde o mapeamento falha e como seu agente de codificação pode fazer o trabalho com o Apidog CLI.
O que há dentro de um arquivo .jmx do JMeter
Um arquivo .jmx é o plano de teste do JMeter salvo: uma árvore XML de elementos que o JMeter executa de cima para baixo. O manual do usuário do JMeter define os blocos de construção. Cada requisição fica sob um grupo de threads, e todos os outros elementos alteram como essas requisições são enviadas, verificadas ou temporizadas.
Eis o que você encontrará ao abrir um:
- Thread Group: os usuários simulados. Define o número de threads, o período de ramp-up e a contagem de loops.
- Samplers: as requisições em si. O HTTP Request é o mais comum, mas também existem samplers JDBC, FTP, LDAP e TCP.
- Logic controllers: controladores If, While, Loop, Transaction e Simple que decidem a ordem e a repetição.
- Config elements: HTTP Request Defaults, Header Manager, Cookie Manager, CSV Data Set Config e User Defined Variables.
- Pré e pós-processadores: extratores (Regex, JSON, XPath, Boundary) e scripts JSR223, geralmente em Groovy.
- Assertions: asserções de Response, Duration, Size e JSON.
- Timers: Constant, Gaussian Random e outros delays entre samplers.
- Listeners: result trees, relatórios agregados e o dashboard HTML.
Se você precisar relembrar a ferramenta em si, leia o que é o JMeter e como ele funciona antes de começar a desmontar planos.
O Apidog pode importar arquivos do JMeter?
Sim. O guia de migração do Apidog lista o JMeter em "API Clients & Data Tools" com a descrição "Importar arquivos de script do Apache JMeter". O Apidog CLI expõe o mesmo importador: apidog import --help lista jmeter entre os valores de --format.
O que a documentação não publica é um mapeamento elemento por elemento para importações do JMeter. O guia de migração do JMeter do Postman gera um relatório de importação com categorias "imported exactly", "approximated" e "not supported"; a importação manual do Apidog oferece uma pré-visualização, em que você escolhe o que trazer antes de confirmar. Portanto, trate a importação como o primeiro rascunho da sua migração, não como a suíte pronta. Abra o que foi importado, compare com a árvore do .jmx e corrija as lacunas manualmente ou com seu agente.
Uma ressalva honesta: o teste de performance do Apidog está em beta e suporta até 100 usuários virtuais por execução. Se o seu plano do JMeter aciona milhares de threads em uma configuração distribuída, mantenha o JMeter para esse pico de carga e mova o lado funcional e de regressão para o Apidog.
Como os elementos do JMeter são mapeados para o Apidog
A maior parte de um plano de teste HTTP típico tem um lugar direto no Apidog. A tabela mostra onde cada elemento fica após a migração e o que verificar quando a importação terminar.

| Elemento do JMeter | Onde fica no Apidog | Verificar após a importação |
|---|---|---|
| Sampler HTTP Request | Requisição de endpoint ou etapa do cenário de teste | Método, caminho, corpo e headers |
| HTTP Request Defaults | URL base do ambiente | Uma URL base por ambiente |
| Header Manager, autenticação | Headers da requisição ou configurações de autenticação | Tokens movidos para variáveis, não hardcoded |
User Defined Variables ${var} |
Variáveis de ambiente ou globais {{var}} |
Todas as referências ${} reescritas |
| Extrator JSON ou Regex | Pós-processador Extract Variable (JSONPath, XPath) | O nome extraído corresponde às etapas seguintes |
| Response Assertion | Pós-processador de asserção | Verificações de status e corpo ainda funcionam |
| Duration Assertion | Script pm.test em pm.response.responseTime |
Valor do limite |
| CSV Data Set Config | Dados de teste, executados em correspondência aleatória ou sequencial | Nomes das colunas correspondem às variáveis |
| Controladores Loop, If, While | For loop, If e outras condições de controle de fluxo | Tratamento de break e erros |
| Controlador Transaction | Grupo no cenário de teste | Ordem das etapas |
| Constant Timer | Etapa de espera | Delay em milissegundos |
| Thread Group | Teste de performance: usuários virtuais, duração, ramp-up | Menos de 100 usuários virtuais |
| Listeners | Relatórios de teste no app, ou -r html,json,junit do CLI |
O relatório chega onde o CI espera |
A mudança de sintaxe de variáveis pega a maioria das pessoas. O JMeter usa ${token}, enquanto o Apidog usa {{token}}. Procure na cena um ${ perdido após a importação; qualquer um que encontrar será enviado como string literal.
O que não é migrado de forma limpa
Alguns recursos do JMeter não têm equivalente um a um, e fingir o contrário é como as migrações dão errado. Planeje-se para estes casos:
- Scripts Groovy e BeanShell. Os scripts de pré e pós-processador do Apidog executam JavaScript com uma API
pmno estilo Postman. Reescreva a lógica JSR223 em JavaScript; seu agente de codificação é ótimo exatamente nesse tipo de tradução. - Samplers não HTTP. Os samplers FTP, LDAP, TCP e JMS testam protocolos fora do escopo de um cliente de API. Mantenha-os no JMeter. Verificações JDBC geralmente podem se tornar operações de banco de dados do Apidog (MySQL, MongoDB, Redis e Oracle são documentados), mas reconstrua-as deliberadamente.
- Moldagem de throughput. Os timers do JMeter, os controladores de throughput e os grupos de threads de plugins ajustam a taxa de requisições com precisão. O teste de performance do Apidog define usuários virtuais, duração e ramp-up, e cada usuário percorre o cenário em loop. Espere números diferentes de requisições por segundo.
- Escala acima de 100 usuários virtuais. Esse é o teto documentado para os testes de performance do Apidog atualmente.
- Exportação de relatórios para execuções de carga. A documentação diz que os relatórios de performance ainda não podem ser exportados; você os visualiza no cliente. Execuções funcionais do CLI exportam HTML, JSON e JUnit.
Nada disso impede uma migração; isso decide quais testes se movem. Normalmente a suíte funcional se move e alguns planos de pico de carga permanecem. O tutorial de teste de API com JMeter mostra o tipo de plano funcional que migra de forma limpa.
Passo a passo: migrar um plano de teste do JMeter
Este é o caminho completo, do .jmx a um job de CI verde.

- Registre uma linha de base. Execute o plano uma vez em modo CLI, que o manual do JMeter recomenda para qualquer teste de carga:
jmeter -n -t checkout.jmx -l baseline.jtl -e -o baseline-report/. Anote a latência p95 e a taxa de erros. - Limpe o plano. Desative listeners e remova ramificações mortas. Mova segredos para fora do arquivo.
- Importe-o. Use o diálogo de Importação do app ou
apidog import --project <projectId> --format jmeter --file ./checkout.jmx. - Revise o que foi importado. Liste endpoints e cenários de teste e compare-os com a árvore do
.jmxusando a tabela acima. - Corrija as lacunas. Reescreva referências
${}, porte scripts para JavaScript, anexe dados CSV como dados de teste, adicione etapas de espera. - Execute-o funcionalmente. Um teste de performance só é útil quando cada requisição passa por conta própria, e a documentação do Apidog diz o mesmo.
- Faça o teste de carga. No app, defina usuários virtuais, duração e ramp-up no cenário e compare p95 e taxa de erros com sua linha de base do JMeter na mesma contagem de usuários.
- Integre-o ao CI com
apidog rune um relatório JUnit.
Deixe seu agente de codificação migrar com o Apidog CLI
Os passos 3 a 6 são mecânicos, o que os torna trabalho ideal para um agente. Claude Code, Codex ou Cursor podem ler o XML do .jmx, executar a importação, comparar o resultado e corrigir as lacunas enquanto você revisa.
Configure uma vez:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install
A skill ensina ao seu agente os comandos e schemas do CLI. Se preferir deixar o agente fazer a configuração também, diga a ele: "Leia https://apidog.com/apidog-cli-installation-guide.md e configure o Apidog CLI." O guia de instalação do Apidog CLI cobre os mesmos passos para humanos.
Em seguida, dê ao seu agente um prompt a partir da pasta que contém o plano:
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.
O agente executa comandos como estes:
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
Duas flags importam para importações repetidas. --overwrite-mode define a estratégia de conflito (overwrite, merge, ignore ou keepBoth, padrão overwrite), e --branch permite importar para uma branch de sprint para que a migração não toque na main até você revisá-la. Antes de escrever qualquer payload JSON, o agente deve executar apidog cli-schema get e apidog cli-schema validate; o próprio help do CLI diz para não construir payloads de memória. Para uma análise mais profunda deste fluxo de trabalho, veja Apidog CLI in Claude Code.
Executar os testes migrados no CI
Depois que o cenário passa localmente, o CI é um único comando. O apidog run gera relatórios cli, html, json ou junit, e o JUnit é o que GitHub Actions, GitLab e Jenkins leem nativamente:
apidog run -t <scenarioId> --project <projectId> -e <envId> \
-r cli,junit --out-dir apidog-reports --upload-report
A flag --upload-report envia a visão geral da execução para a nuvem para que sua equipe possa abri-la no app. Execuções orientadas a dados aceitam -d com um CSV, JSON ou ID de dados de teste, o que substitui o CSV Data Set do JMeter no pipeline. --on-error aceita ignore, continue ou end. O guia de pipeline CI/CD do Apidog CLI tem arquivos de workflow completos, e a referência do comando apidog run cobre todas as flags.
Mantenha o JMeter rodando em paralelo por um ou dois releases. Quando a suíte do Apidog capturar as mesmas regressões e seus números de carga se alinharem na mesma contagem de usuários, aposente os arquivos .jmx correspondentes. Se você ainda está avaliando ferramentas, o levantamento de alternativas ao JMeter compara as opções.
FAQ
O Apidog importa arquivos .jmx diretamente? Sim. O JMeter é um formato de importação listado na documentação do Apidog, e o Apidog CLI aceita apidog import --format jmeter --file <path>. Revise o resultado em comparação com o plano original, pois a documentação não publica um mapeamento por elemento.
Posso exportar testes do Apidog de volta para o JMeter? Sim. A documentação do Apidog diz que cenários de teste podem ser exportados como arquivos de dados Apidog CLI, Postman e JMeter, então você pode executá-los no JMeter se alguma equipe ainda precisar.
Quantos usuários virtuais o Apidog suporta para testes de carga? A documentação de teste de performance diz até 100 usuários virtuais por execução, e o recurso está em beta. Mantenha o JMeter para testes distribuídos acima disso.
O que acontece com meus scripts Groovy? Eles não rodam no Apidog. Reescreva-os como scripts JavaScript de pré ou pós-processador, que usam uma API pm no estilo Postman. Um agente de codificação pode traduzir a maioria dos snippets JSR223 rapidamente; revise o resultado.
Preciso mudar a sintaxe das variáveis? Sim. O JMeter usa ${var} e o Apidog usa {{var}}. Pesquise no cenário migrado por ${ remanescentes antes da primeira execução.
O Apidog é gratuito para isso? O plano Apidog Free cobre até 4 usuários, o que é suficiente para migrar a suíte funcional de uma equipe e executá-la no CI.
