Apache JMeterは、HTTPなどのリクエストを多数のスレッドから送り、応答時間と処理量を測るJava製のオープンソースツールです。この記事では最新の安定版5.6.3を使い、インストール、テスト計画の作成、コマンドラインでの実行、HTMLレポートの読み方までを順に説明します。
実測値は、主に手元のNode.jsサーバーとJMeter 5.6.3・Java 21で測定しました(2026年11月)。Javaの比較には25・26、本体のHTTP/2比較には6.0.0-SNAPSHOTも使っています。負荷をかける側とサーバーを同じ端末で動かしているため、絶対値ではなく条件ごとの差を見てください。
まとめ:JMeterで負荷テストを行うときの要点
- 最新の安定版は5.6.3(2024年1月公開)。Java 21で動かす。Java 25と26ではGroovyスクリプトが実行時に失敗した
- GUIはテスト計画の作成とデバッグに使い、負荷をかける本番は
jmeter -nのCLIで実行する - 到達できる処理量はスレッド数と応答時間で決まる。10スレッドの実測で、応答100msなら約91件/秒、500msなら約20件/秒だった
- ログイン後の画面を試すならCookie Managerと値の受け渡し(相関)が要る。無いと後続の要求が401になる
- HTTP 200で返る業務エラーはアサーションが無いと成功に数えられる。全件失敗でも
jmeterの終了コードは0なので、CIではstatistics.jsonで判定する - HTTP/2は5.6.3の標準サンプラーでは使えない。今使うならBlazeMeter HTTPプラグイン3.2で、本体対応は未リリースの6.0に入っている
JMeterの役割とブラウザとの違い
JMeterはプロトコルのレベルで要求を送るツールです。公式サイトは「JMeter is not a browser」と明記しており、HTML内のJavaScriptは実行せず、ページの描画もしません。測れるのはサーバーが応答を返すまでの時間で、画面が表示されるまでの体感時間ではありません。
対象はHTTP・HTTPSのほか、JDBC、LDAP、JMS、FTP、TCPなどです。ライセンスはApache License 2.0で、無料で使えます。負荷試験そのものの設計(目的、合否指標、環境の揃え方)は「負荷試験とは?シナリオ設計と合否指標、本番相当環境の揃え方をk6の実例で解説」で扱っているので、ここからはJMeterの操作に絞ります。
JMeterのインストールと起動:Javaの選び方から日本語表示まで
JMeter 5.6.3で選ぶJavaはJava 21
公式の手順には「Java 8 or higher」、リリースノートにはJava 17以降を推奨するとありますが、新しければよいわけではありません。Javaの版を変えて、HTTP要求200件と、JSR223サンプラーのGroovyスクリプトを実行しました。
| Java | HTTP要求200件 | Groovy(JSR223) |
|---|---|---|
| 21.0.13 | 200件成功 | 成功 |
| 25.0.5 | 200件成功 | 失敗(class file major version 69) |
| 26.0.2.1 | 200件成功 | 失敗(class file major version 70) |
失敗の原因は、5.6.3に同梱のGroovy 3.0.20が新しいJavaのクラスファイルを読めないことです。HTTPだけの計画は動くので、JSR223を使い始めた時点で初めて気づくことになります。厄介なのは、スレッドが例外で落ちて結果が0件になっても、jmeter コマンドの終了コードが0のままな点です。結果の件数を見ない運用では、試験が走らなかったことに気づけません。
JMeterのダウンロードと展開
公式のダウンロードページからBinariesのtgzかzipを取得し、任意の場所に展開します。インストーラーはありません。macOS・Linuxなら次の手順です。
curl -O https://downloads.apache.org/jmeter/binaries/apache-jmeter-5.6.3.tgz
curl -O https://downloads.apache.org/jmeter/binaries/apache-jmeter-5.6.3.tgz.sha512
shasum -a 512 -c apache-jmeter-5.6.3.tgz.sha512
tar xzf apache-jmeter-5.6.3.tgz
export JAVA_HOME=/path/to/jdk-21
export PATH="$PWD/apache-jmeter-5.6.3/bin:$PATH"
jmeter --version
Windowsではzipを展開し、bin\jmeter.bat を実行します。
GUIの起動と日本語表示の設定
bin/jmeter を引数なしで実行するとGUIが開きます。メニューの Options → Choose Language → Japanese で表示が日本語になりますが、再起動すると戻ります。常に日本語にするには bin/user.properties に language=ja を書きます。この記事のメニュー名は、ネット上の情報と照合しやすい英語表記で書いています。
テスト計画の作り方:スレッドグループとHTTPリクエストの最小構成
JMeterの試験手順は「テスト計画」(.jmxファイル)に保存します。最小の構成は次の4手順です。
- 左のTest Planを右クリックし、Add → Threads (Users) → Thread Group を追加する
- Thread Groupを右クリックし、Add → Sampler → HTTP Request を追加する。Server Name、Port、Path、Methodを入れる
- Thread Groupを右クリックし、Add → Listener → View Results Tree を追加する
- File → Save で.jmxを保存し、上部の緑の再生ボタンを押して、要求が通るかを少ないスレッド数で確かめる
View Results Treeはデバッグ専用です。公式のBest Practicesも、負荷試験中はこのリスナーを使わず、スクリプト作成の段階だけにするよう書いています。
スレッド数・Ramp-Up・ループ回数の設定
Thread Groupで決めるのは3つです。スレッド数は同時に動く仮想ユーザーの数、Ramp-Up期間は全スレッドを起動し終えるまでの秒数、ループ回数は各スレッドが手順を繰り返す回数です。10スレッド・Ramp-Up 10秒で測ると要求の開始は約1秒間隔に並び(817〜1,148ms)、Ramp-Up 0秒では10件が同じミリ秒に発射されました。
値はテスト計画に直書きせず、関数 ${__P(threads,10)} のように書いておくと、実行時に -Jthreads=50 で変えられます。第2引数は省略時の既定値です。
スレッド数と到達スループットの関係
JMeterの通常のスレッドは、応答を受け取ってから次の要求を送ります。そのため、サーバーが遅くなるとかかる負荷も下がります。タイマーなしの2条件は10スレッド×20回、1秒のタイマーありは10スレッド×10回で測った結果です(各条件3回の中央値)。
| 条件 | 応答時間の中央値 | スループット |
|---|---|---|
| 10スレッド・応答100ms | 103ms | 91.0件/秒 |
| 10スレッド・応答500ms | 503ms | 19.6件/秒 |
| 10スレッド・応答100ms+1秒のタイマー | 104ms | 9.05件/秒 |
スループットは「スレッド数 ÷(応答時間+待ち時間)」でほぼ説明できます。「毎秒100件を流す」試験のつもりで10スレッドにしても、応答が500msに落ちれば約20件/秒しか流れません。必要なスレッド数は、目標の件数に想定の応答時間と待ち時間を掛けて見積もります。
実際の操作に近づける設定:Cookie・CSV・相関・アサーション
最小構成は同じURLを叩くだけなので、ログインを含む業務シナリオでは次の4要素を足します。優先順はCookie、相関、アサーション、CSVです。
HTTP Cookie Managerでセッションを維持する
HTTP Requestだけの構成では、応答のCookieは次の要求に送られません。ログイン後にCookieを確認するページを試すと、Cookie Managerが無い場合は要求20件のうち10件(ログイン後の画面すべて)が401になり、Thread Groupに HTTP Cookie Manager を1つ加えると20件すべて成功しました。Cookieはスレッドごとに別々に保持されます。
CSV Data Set Configでユーザーを変える
全スレッドが同じアカウントで動くと、キャッシュやロックの効き方が本番と変わります。CSV Data Set Config にファイル名と変数名(例:user,password)を指定すると、要求の中で ${user} と書けます。
既定の「Recycle on EOF」はTrueで、行が尽きると先頭に戻ります。アカウントを使い回せない試験では、RecycleをFalse、Stop thread on EOFをTrueにします。3行のCSVを5スレッド×4回で流すと、CSVの3行分だけ手順が実行され、残りのスレッドは止まりました(要求6件)。行数の不足はエラーにならないので、結果の件数で確かめてください。
JSON Extractorで動的な値を受け渡す(相関)
トークンのように応答ごとに変わる値は、前の応答から取り出して次の要求に渡します。これを相関と呼びます。ログイン要求の子に JSON Extractor を置き、変数名 token、JSONパス $.token を指定して、次の要求のHTTP Header Managerに Authorization: Bearer ${token} と書きます。
抽出の設定が無いと変数は置換されず、${token} という文字列がそのまま送られます。5スレッド×4回では、40件中20件(ログイン後のAPIすべて)が401でした。HTMLならRegular Expression ExtractorかCSS Selector Extractorを使います。
Response Assertionで業務エラーを失敗に数える
JMeterは既定でHTTPステータスを見て成否を決めます。本文が {"status":"error"} でもステータスが200なら成功です。実測ではアサーションが無いとエラー率0%、応答本文に "status":"ok" を含むことを Response Assertion で確かめるとエラー率100%になりました。負荷が高いときにだけエラーを200で返すアプリケーションでは、これを置かないと結果を読み違えます。
HTTP(S) Test Script Recorderでブラウザ操作を記録する
手順が多い画面は、Test PlanにAdd → Non-Test Elements → HTTP(S) Test Script Recorderを追加し、RecorderのStartボタンでプロキシを起動し、ブラウザのプロキシをJMeterのホストとポート(既定は8888)へ向けて操作すると記録できます。HTTPSを記録するには、bin に生成されるルート証明書をブラウザへ登録します。記録された値をそのまま再利用できない場合は相関を設定し、ユーザーや入力データを切り替える場合はCSVを使います。
Think Timeとスループット目標の入れ方:タイマーの使い分け
実際の利用者は操作の合間に間を空けます。この待ち時間(Think Time)をタイマーで入れます。タイマーは、置かれたスコープ内の各サンプラーの実行前に処理され、同じスコープに複数置くと待ち時間が足し合わされます。
| タイマー | 待ち時間 | 向く用途 |
|---|---|---|
| Constant Timer | 毎回同じミリ秒 | 動作確認 |
| Uniform Random Timer | 固定値+0〜最大値の乱数 | 一般的なThink Time |
| Gaussian Random Timer | 固定値+正規乱数×偏差の絶対値(整数化) | 待ち時間にばらつきを設定 |
| Constant Throughput Timer | 目標に合わせて自動調整 | 毎分の到達量を決める |
Constant Throughput Timerの目標の単位は1分あたりのサンプル数で、毎秒ではありません。「Calculate Throughput based on」を「all active threads in current thread group (shared)」にし、目標600(毎秒10件)を20スレッドで流すと、結果は10.15件/秒でした(3回の中央値)。スレッド数が足りないか応答が遅ければ、目標には届きません。到達量を決める試験ほど、結果のスループットが目標を下回っていないかを最初に確認します。
コマンドラインでの実行とHTMLレポートの読み方
公式の手順は、負荷試験ではGUIを使わないCLIモードで実行するよう指示しています。次のコマンドで試験からHTMLレポートの生成までを行います。
jmeter -n -t load.jmx -Jthreads=50 -Jrampup=60 -l result.jtl -e -o report/
# メモリは環境変数で変える(既定は -Xms1g -Xmx1g)
HEAP="-Xms4g -Xmx4g -XX:MaxMetaspaceSize=256m" jmeter -n -t load.jmx -l result.jtl -e -o report/
# 前回の結果とレポートを消してから実行する
jmeter -n -f -t load.jmx -l result.jtl -e -o report/
-e -o は2回目の実行で失敗します。出力先に中身があると「folder is not empty」で、結果ファイルが残っていると「Results file:… is not empty」で、いずれも終了コード1です。繰り返すなら -f を付けるか、実行ごとに出力先を変えます。
HTMLレポートで見る4つの数値
report/index.html のStatistics表で見る順番は、エラー率、スループット、95パーセンタイル、平均です。
- エラー率:0でなければ、応答時間を読む前に失敗の種類(Errors表)を見る
- スループット:要求数を、最初の開始から最後の終了までの時間で割った値。待ち時間も分母に入るので、Think Timeを入れると下がるのが正常
- 95パーセンタイル:要求の95%がこの時間以内に返った値。遅い利用者の体感に近い
- 平均:外れ値に引っ張られるので、合否の基準にしない
要求数が少ない試験のp95は、接続確立の時間に左右されます。HTTPSで10スレッド×20回の測定では、中央値が4msなのに95パーセンタイルが1,056msでした。200件のうち10件(5%)が、各スレッド最初のTLSハンドシェイクを含む要求だからです。この値を「サーバーが遅い」と読む前に、試験時間を延ばすか、結果ファイルのConnect列を確認してください。
CIでの失敗検知:全件失敗でも終了コードは0
コマンドの成否だけを見るCIは、JMeterでは使えません。全要求が500で失敗した試験でも、jmeter の終了コードは0でした。次の例はPOSIXシェルとjqが必要です。レポートの statistics.json からエラー率を取り出し、サンプル数が1件以上かつエラー率が1%未満なら合格とします。閾値は試験の合否基準に合わせて変更します。
jmeter -n -f -t load.jmx -l result.jtl -e -o report/
err=$(jq '.Total.errorPct' report/statistics.json)
count=$(jq '.Total.sampleCount' report/statistics.json)
awk -v e="$err" -v n="$count" 'BEGIN { exit !(n > 0 && e < 1.0) }' \
|| { echo "NG: error=${err}% samples=${count}"; exit 1; }
エラー率に加えて件数も見ているのは、前述のJavaの不整合のように、1件も実行されない失敗を拾うためです。閾値の判定をツール側に任せたい場合は、閾値を破ると0以外で終了する k6 のほうが向いています。
1台で負荷が足りないときの分散実行
1台の負荷生成機でCPUやネットワークが頭打ちになると、測っているのはサーバーではなくJMeter側の限界になります。その場合は複数台で実行します。各サーバーで bin/jmeter-server を起動し、コントローラーから jmeter -n -t load.jmx -R host1,host2 -l result.jtl で実行します。
公式の手順で先に確かめる条件は3点です。全台のJMeterとJavaの版を揃えること、RMIのSSL鍵を作るか server.rmi.ssl.disable=true で無効にすること、そしてCSVなどのデータファイルは送られないので各サーバーに置くことです。スレッド数は台数倍になります。Thread Groupの100スレッドを2台で動かすと200スレッドです。
JMeterでHTTP/2を試験する方法:本体6.0とBlazeMeter HTTPプラグイン
5.6.3の標準HTTP Requestが使うHttpClient4とJavaの実装は、どちらもHTTP/2を話しません。2016年起票の要望 #4023 は、2026年10月29日に PR #6742 がマージされて完了扱いになりましたが、これは次期6.0向けの変更で、配布版にはまだ入っていません(2026年11月9日時点で、マイルストーン6.0.0の期日は12月1日、未完了の項目が13件)。mainをビルドした6.0.0-SNAPSHOTも含めて、サーバー側でプロトコルを記録しながら10スレッド×20回を流しました。
| 構成 | 送信先 | 成功 | プロトコル | TLS接続数 |
|---|---|---|---|---|
| 5.6.3 標準HTTP Request | HTTP/1.1も可 | 200/200 | HTTP/1.1 | 10 |
| 5.6.3 標準HTTP Request | HTTP/2のみ | 0/200 | (403で失敗) | 200 |
| 5.6.3 +プラグイン3.2.0 | HTTP/1.1も可 | 200/200 | HTTP/2 | 10 |
| 5.6.3 +プラグイン3.2.0 | HTTP/2のみ | 200/200 | HTTP/2 | 10 |
| 6.0開発版 HttpClient5・HTTP/2 | HTTP/1.1も可 | 200/200 | HTTP/2 | 10〜11 |
| 6.0開発版 HttpClient5・HTTP/2 | HTTP/2のみ | 200/200 | HTTP/2 | 10 |
| 6.0開発版 HttpClient5・HTTP/2 | HTTP/1.1のみ | 200/200 | HTTP/1.1 | 11 |
| 6.0開発版 HttpClient5・HTTP/2 Strict | HTTP/1.1のみ | 0/200 | (接続エラー) | ― |
| 6.0開発版 HttpClient5・HTTP Version空欄 | HTTP/1.1も可 | 200/200 | HTTP/1.1 | 10 |
注意すべきは1行目です。HTTP/2対応のサーバーへ標準サンプラーを当てても、エラーは出ず、すべてHTTP/1.1で成功します。接続数はHTTP/2でもスレッド数とほぼ同じで、スレッド間で1本の接続を共有する動きにはなりません(6.0の文書にも、接続はスレッド間で共有されないとあります)。
今HTTP/2を試すならBlazeMeter HTTPプラグイン3.2
プラグインは、Plugins Managerの「BlazeMeter – HTTP Plugin」(ID:bzm-http2)か、GitHubのReleasesの jmeter-bzm-http2-3.2.0.jar(約27.6MB・依存込みの1本)を lib/ext に置いて導入します。3.0でBlazeMeter HTTPに改称し、Java 17以上が必須になりました。サンプラー名は「bzm – HTTP Sampler」です。古い解説の「bzm – HTTP2 Sampler」は2.0系の名称です。
既定のプロファイルはHTTP/2が使えないとHTTP/1.1へ自動で切り替えるため、HTTP/2だけを測るなら user.properties で固定します。既存の.jmxはTools → BlazeMeter HTTPから一括で移行できます。
blazemeter.http.enableHttp1=false
blazemeter.http.enableHttp3=false
blazemeter.http.enableHttp2=true
blazemeter.http.alpnEnabled=true
1スレッド内で複数の要求を同時に送る動きは、Async Controllerで再現します。300ms応答の要求6本は、Thread Group直下で約1,870ms、bzm – HTTP Async Controllerの中で約340msでした(接続確立を含まない2回目以降の反復の中央値)。Async Controllerの直下にタイマーを置くと各要求の前に待ちが入って効果が消えるので、Flow Control Actionの子にします。
6.0で変わるHTTP RequestのHTTP/2設定
6.0では、標準のHTTP Requestで Implementation を HttpClient5 にし、新設の HTTP Version で HTTP/2 Negotiate か HTTP/2 Strict を選びます。Negotiateはサーバーが対応していなければHTTP/1.1へ戻り、Strictはその場合に要求を失敗させます。既定の実装はHttpClient4のままなので、既存の.jmxは設定を変えない限りHTTP/1.1で動きます。ImplementationがJavaのときはHTTP/2を指定してもHTTP/1.1で通信しました。6.0はJava 17以上が必須(推奨はJava 21)です。
HTTP/2にして負荷の性質が変わるのは、接続とヘッダー処理の層です。プラグインや6.0開発版が必要なのは、HTTP/2で通信する条件を試験する場合です。埋め込みリソースの並列取得自体は、5.6.3の標準HTTP Requestでも設定できます。ロードバランサーでHTTP/2を終端し、背後のアプリケーションへHTTP/1.1で中継する構成で業務処理の性能を見るなら、標準のHTTP Requestのままで構いません。HTTP/3を試す場合のUDP経路の確認は、「QUIC(通信プロトコル)とは?HTTP/3を支える仕組みとTCPとの違いを実装視点で解説」を参考にしてください。
JMeterを選ばないほうがいい負荷試験の条件
JMeterの強みは、GUIで組めることと、対応プロトコルの幅です。JDBCやJMSまで1つの道具で測るなら第一候補になります。逆に次の条件では、ほかのツールを選びます。
- シナリオをコードとしてレビューしたい:.jmxはXMLで差分レビューに向かない。JavaScriptのk6、PythonのLocust、ScalaなどのGatlingを使う
- 画面が表示されるまでの時間を測りたい:JavaScriptを実行しないJMeterでは測れない。ブラウザを動かす計測ツールを使う
- 数万規模の同時接続を1台で作りたい:通常のスレッドグループは仮想ユーザーごとにJavaスレッドを使い、メモリやOSのスレッド数上限が制約になり得る。分散かイベント駆動型のツールを検討する
用途別の比較は「負荷テストツール比較|Web・CPU・ネットワーク別の無料ツールとWindowsでの実行手順」に、結果から必要台数を見積もる手順は「キャパシティプランニングとは?ピーク負荷から必要台数と余裕率を見積もる手順」にまとめています。性能試験の設計から本番の運用改善までを外部に任せたい場合は、保守運用・内製化支援で相談を受けています。
よくある質問
JMeterのスレッド数はどう決めますか?
目標の毎秒件数に、1回あたりの応答時間と待ち時間の合計(秒)を掛けます。毎秒100件、応答0.2秒、待ち0.8秒なら100スレッドが目安です。負荷をかける端末のCPUとメモリが余っているかも同時に確認し、頭打ちなら分散実行に切り替えます。応答が遅くなると処理量も下がるので、実測のスループットが目標に届いているかを必ず確かめます。
JMeterのThink Timeはどこで設定しますか?
Constant TimerやUniform Random Timerなどのタイマー要素を、待ち時間を入れたいサンプラーと同じスコープに追加します。タイマーはスコープ内の各サンプラーの実行前に毎回処理され、複数置くと合計されます。特定の1要求の前だけ待たせたいときは、そのサンプラーの子としてタイマーを置きます。
JMeterのスループットとは何ですか?
要求数を、最初のサンプルの開始から最後のサンプルの終了までの時間で割った値です。待ち時間も分母に含まれるので、Think Timeを入れるとサーバーの能力より低い値になります。実測では10スレッド・応答100msで、タイマー無しの91.0件/秒が、1秒のタイマーで約9件/秒になりました。
JMeterは無料で使えますか?
Apache License 2.0のオープンソースで、商用の試験にも無料で使えます。費用がかかるのは、負荷をかけるサーバーと、BlazeMeterなどのクラウド実行サービスを使う場合です。Plugins Managerから入れるプラグインは個別にライセンスが異なるので、配布元で確認してください。
JMeterはHTTP/2に対応していますか?
最新の安定版5.6.3は標準では対応していません。HTTP/2で試験するにはBlazeMeter HTTPプラグイン(bzm – HTTP Sampler)を追加します。本体の対応は2026年10月にmainへマージされ、次期6.0の標準HTTP Requestで、ImplementationをHttpClient5にして使えるようになる予定です。