JMeterテストをApidogに移行する方法

JMeterのテストをApidogに移行する方法:.jmxファイルをインポートし、スレッドグループ・抽出器・アサーションをマッピングし、引き継げなかった部分を修正して、Apidog CLIでCI上で実行しましょう。

INEZA Felin-Michel

INEZA Felin-Michel

16 11月 2026

JMeterテストをApidogに移行する方法

Apidog エンタープライズ

オンプレミスデプロイ

SSO & RBAC

SOC 2 準拠

Apidog Enterpriseを見る

JMeterのテストをApidogに移行するには、.jmxファイルをインポートし(ApidogはJMeterをサポート対象のインポート形式として掲載しており、Apidog CLIは--format jmeterを受け付けます)、取り込まれた内容を確認し、フローをテストシナリオとして組み立て、負荷テストにかける前に機能テストでパスすることを確認します。タイマー、Groovyスクリプト、HTTP以外のサンプラーは手作業が必要です。

以下では、.jmxファイルの中身、各要素のマッピング方法、マッピングが破綻する箇所、そしてApidog CLIを使ってコーディングエージェントに作業させる方法を解説します。

JMeterの.jmxファイルの中身

.jmxファイルは保存されたJMeterのテストプランで、JMeterが上から下へ実行するXMLツリーになっています。構成要素はJMeterユーザーマニュアルで定義されています。すべてのリクエストはスレッドグループの下に置かれ、その他の要素はそれらのリクエストの送信方法、検証方法、タイミングを変更します。

ファイルを開くと、主に次の要素が見つかります:

ツール自体についてのおさらいが必要な場合は、テストプランを分解し始める前にJMeterとは何か、その仕組みを読んでおきましょう。

ApidogはJMeterファイルをインポートできるのか?

はい。Apidogの移行ガイドでは、JMeterが「API Clients & Data Tools」カテゴリに「Apache JMeterスクリプトファイルのインポート」という説明付きで掲載されています。Apidog CLIも同じインポーターを提供しており、apidog import --helpの--formatの値にjmeterが含まれています。

ドキュメントに公開されていないのは、JMeterインポートの要素ごとのマッピングです。PostmanのJMeter移行ガイドは「そのままインポート」「近似」「非対応」に分類されたインポートレポートを提供していますが、Apidogの手動インポートでは代わりにプレビューが表示され、確定する前に取り込む項目を選べます。したがって、インポートは移行の「初稿」として扱い、完成したスイートとは考えないでください。取り込まれた内容を開き、.jmxツリーと比較し、ギャップを手作業またはエージェントで修正しましょう。

正直な注意点として、Apidogのパフォーマンステストはベータ版で、1回の実行につき最大100仮想ユーザーまでしか対応していません。JMeterのテストプランが分散構成で数千スレッドを駆動する場合は、そのピーク負荷にはJMeterを使い続け、機能テストと回帰テストの側をApidogに移しましょう。

JMeter要素とApidogのマッピング

典型的なHTTPテストプランの大部分は、Apidogに直接対応する場所があります。次の表は、移行後に各要素がどこに配置されるか、インポート完了後に何を確認すべきかを示しています。

6つのJMeter要素とApidogでの対応物を示すダイアグラム: HTTP Requestサンプラーはリクエストステップへ、User Defined Variablesは環境変数へ、Response Assertionはアサーションへ、Thread Groupは仮想ユーザーへ、CSV Data Set Configはテストデータへ、Constant Timerは待機ステップへ
JMeter要素 Apidogでの配置先 インポート後の確認項目
HTTP Requestサンプラー エンドポイントリクエストまたはテストシナリオのステップ メソッド、パス、ボディ、ヘッダー
HTTP Request Defaults 環境のベースURL 環境ごとに1つのベースURL
Header Manager、認証 リクエストヘッダーまたは認証設定 トークンがハードコードではなく変数に移されているか
User Defined Variables ${var} 環境変数またはグローバル変数 {{var}} すべての${}参照が書き換えられているか
JSONまたはRegex抽出器 Extract Variable後処理(JSONPath、XPath) 抽出した名前が後続ステップと一致しているか
Response Assertion アサーション後処理 ステータスとボディのチェックが有効に機能しているか
Duration Assertion pm.response.responseTimeに対するpm.testスクリプト しきい値の値
CSV Data Set Config テストデータ(ランダムまたは順次マッチで実行) 列名が変数と一致しているか
Loop、If、Whileコントローラー Forループ、If、その他のフロー制御条件 ブレーク処理とエラーハンドリング
Transactionコントローラー テストシナリオ内のグループ ステップの順序
Constant Timer 待機ステップ ミリ秒単位の遅延
Thread Group パフォーマンステストの仮想ユーザー数、実行時間、ランプアップ 100仮想ユーザー未満か
リスナー アプリ内のテストレポート、またはCLIからの-r html,json,junit レポートがCIが期待する場所に生成されているか

変数構文の変更につまずく人が最も多いです。JMeterは${token}を参照するのに対し、Apidogは{{token}}を使います。インポート後にシナリオ内を${で検索しましょう。見つかったものはリテラル文字列として送信されてしまいます。

そのまま移行できないもの

JMeterの一部の機能には一対一の対応物がなく、そうではないかのように振る舞うと移行が失敗します。以下を想定して計画しましょう:

  1. GroovyスクリプトとBeanShellスクリプト。 Apidogの前処理・後処理スクリプトは、Postman風のpm APIを使うJavaScriptで実行されます。JSR223のロジックはJavaScriptに書き直しましょう。この種の変換はまさにコーディングエージェントの得意分野です。
  2. HTTP以外のサンプラー。 FTP、LDAP、TCP、JMSのサンプラーは、APIクライアントの範囲外のプロトコルをテストします。これらはJMeterに残しましょう。JDBCチェックは多くの場合、Apidogのデータベース操作(MySQL、MongoDB、Redis、Oracleがドキュメント化されています)に置き換えられますが、意図的に再構築してください。
  3. スループットの制御。 JMeterのタイマー、スループットコントローラー、プラグインのスレッドグループは、リクエストレートを精密に調整します。Apidogのパフォーマンステストは仮想ユーザー数、実行時間、ランプアップを設定し、各ユーザーがシナリオをループします。秒間リクエスト数の値は異なるものになると想定してください。
  4. 100仮想ユーザーを超えるスケール。 これが現在のApidogパフォーマンステストでドキュメント化されている上限です。
  5. 負荷実行のレポートエクスポート。 ドキュメントによると、パフォーマンスレポートはまだエクスポートできず、クライアント内で閲覧する形になります。CLIからの機能テストの実行はHTML、JSON、JUnitをエクスポートできます。

これらは移行を妨げるものではありません。どのテストを移すかを決める要素です。通常は機能テストスイートを移し、ピーク負荷用のプランをいくつか残します。JMeter APIテストチュートリアルは、スムーズに移行できる機能テストプランの例を示しています。

手順:JMeterテストプランを移行する

.jmxからCIのグリーンジョブまでの全工程は以下の通りです。

移行のフローダイアグラム: checkout.jmx、jmeter形式でのapidog import、テストシナリオ、apidog runによる機能テスト実行、パフォーマンステストとCI
  1. ベースラインを記録する。 JMeterマニュアルが負荷テストで推奨しているCLIモードでプランを1回実行します:jmeter -n -t checkout.jmx -l baseline.jtl -e -o baseline-report/。p95レイテンシとエラー率を記録しておきましょう。
  2. プランをクリーンアップする。 リスナーを無効化し、不要なブランチを削除します。シークレットはファイルの外に移します。
  3. インポートする。 アプリのインポートダイアログ、またはapidog import --project <projectId> --format jmeter --file ./checkout.jmxを使います。
  4. 取り込まれた内容を確認する。 エンドポイントとテストシナリオを一覧表示し、上の表を参照しながら.jmxツリーと比較します。
  5. ギャップを修正する。 ${}参照の書き換え、スクリプトのJavaScriptへの移植、CSVデータのテストデータとしての登録、待機ステップの追加を行います。
  6. 機能テストとして実行する。 すべてのリクエストが単体でパスして初めて、パフォーマンステストは意味を持ちます。Apidogのドキュメントも同じことを述べています。
  7. 負荷テストを行う。 アプリでシナリオに仮想ユーザー数、実行時間、ランプアップを設定し、同じユーザー数でのp95とエラー率をJMeterのベースラインと比較します。
  8. CIに組み込む。 apidog runとJUnitレポートで構成します。

Apidog CLIでコーディングエージェントに移行させる

ステップ3〜6は機械的な作業なので、エージェントに最適です。Claude Code、Codex、Cursorは.jmxのXMLを読み、インポートを実行し、結果を差分確認し、ギャップを修正しながら、あなたはレビューに専念できます。

一度だけセットアップします:

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

スキルはCLIのコマンドとスキーマをエージェントに教えます。セットアップ自体もエージェントに任せたい場合は、「https://apidog.com/apidog-cli-installation-guide.mdを読んでApidog CLIをセットアップして」と伝えればOKです。Apidog CLIインストールガイドは人間向けに同じ手順を解説しています。

その後、テストプランのあるフォルダでエージェントに次のプロンプトを1つ渡します:

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.

エージェントは次のようなコマンドを実行します:

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

繰り返しインポートする際に重要なフラグが2つあります。--overwrite-modeは競合戦略(overwrite、merge、ignore、keepBoth、デフォルトはoverwrite)を指定し、--branchを使うとスプリントブランチにインポートできるため、レビューが済むまでmainに影響を与えません。JSONペイロードを書き込む前に、エージェントには必ずapidog cli-schema getとapidog cli-schema validateを実行させてください。CLIのヘルプ自体、ペイロードを記憶から組み立てるなと指示しています。このワークフローの詳細については、Apidog CLI in Claude Codeを参照してください。

移行したテストをCIで実行する

シナリオがローカルでパスしたら、CIはコマンド1つです。apidog runはcli、html、json、junitレポートを出力でき、GitHub Actions、GitLab、Jenkinsがネイティブに読めるのはJUnitです:

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

--upload-reportを付けると実行概要がクラウドに送信され、チームがアプリ内で開けます。データ駆動の実行はCSV、JSON、テストデータIDを-dで渡せます。これがパイプライン内でJMeterのCSV Data Setの役割を果たします。--on-errorはignore、continue、endを受け付けます。Apidog CLI CI/CDパイプラインガイドには完全なワークフローファイルがあり、apidog runコマンドリファレンスはすべてのフラグを解説しています。

1〜2リリースはJMeterを並行して動かしましょう。Apidogのスイートが同じリグレッションを検出し、同じユーザー数で負荷数値が一致するようになったら、対応する.jmxファイルを廃止します。ツールの選定をまだ検討中であれば、JMeter代替ツールまとめが各ツールを比較しています。

FAQ

Apidogは.jmxファイルを直接インポートできますか? はい。JMeterはApidogドキュメントに記載のインポート形式で、Apidog CLIはapidog import --format jmeter --file <path>を受け付けます。ただし、要素ごとのマッピングはドキュメントに公開されていないため、元のテストプランと照合して結果を確認してください。

ApidogのテストをJMeterにエクスポートし直せますか? はい。Apidogのドキュメントによると、テストシナリオはApidog CLI、Postman、JMeterのデータファイルとしてエクスポートできるため、チームがまだ必要としている場合はJMeterで実行できます。

Apidogの負荷テストは何仮想ユーザーまで対応していますか? パフォーマンステストのドキュメントによると、1回の実行につき最大100仮想ユーザーで、機能はベータ版です。それ以上の分散テストにはJMeterを使い続けてください。

Groovyスクリプトはどうなりますか? Apidogでは実行できません。Postman風のpm APIを使うJavaScriptの前処理・後処理スクリプトとして書き直してください。コーディングエージェントなら、ほとんどのJSR223スニペットを素早く変換できます。出力は必ずレビューしましょう。

変数構文を変更する必要はありますか? はい。JMeterは${var}、Apidogは{{var}}を使います。最初の実行の前に、移行したシナリオに残った${を検索してください。

この用途でApidogは無料で使えますか? ApidogのFreeプランは最大4ユーザーまで対応しており、チームの機能テストスイートを移行してCIで実行するには十分です。

ApidogでAPIデザイン中心のアプローチを取る

APIの開発と利用をよりシンプルなことにする方法を発見できる