Apache JMeterチートシート

インストール

プラットフォーム	コマンド
Ubuntu/Debian	`sudo apt update && sudo apt install jmeter`
Ubuntu (Snap)	`sudo snap install jmeter`
macOS (Homebrew)	`brew install jmeter`
Windows (Chocolatey)	`choco install jmeter`
Binary (Linux/macOS)	`wget https://dlcdn.apache.org//jmeter/binaries/apache-jmeter-5.6.3.tgz && tar -xzf apache-jmeter-5.6.3.tgz`
Docker	`docker pull justb4/jmeter:latest`
Prerequisites	Java JDK 8+ required: `java -version`

# Add JMeter to PATH (Linux/macOS)
export JMETER_HOME=/opt/apache-jmeter-5.6.3
export PATH=$PATH:$JMETER_HOME/bin

# Verify installation
jmeter --version

# Increase heap size (add to ~/.bashrc or jmeter startup script)
export JVM_ARGS="-Xms1g -Xmx4g"

基本コマンド

コマンド	説明
`jmeter`	JMeterのGUIを起動
`jmeter -t test-plan.jmx`	GUIで特定のテストプランを開く
`jmeter -n -t test.jmx -l results.jtl`	結果を非GUIモードでテストを実行
`jmeter -n -t test.jmx -l results.jtl -e -o report/`	テストを実行してHTMLダッシュボードを生成
`jmeter --version` or `jmeter -v`	JMeterのバージョンを表示
`jmeter --help` or `jmeter -h`	ヘルプと利用可能なオプションを表示
`jmeter -?`	利用可能なプロパティをすべて一覧表示
`jmeter -n -t test.jmx -j jmeter.log`	カスタムログファイルでテストを実行
`jmeter -g results.jtl -o dashboard/`	既存の結果からHTMLレポートを生成する
`jmeter -p custom.properties`	カスタムプロパティファイルで起動
`jmeter -Xmx4g`	ヒープサイズを増やして（4GB）起動
`jmeter-server`	分散テストのためにサーバーモードでJMeterを起動する
`jmeter -n -t test.jmx -l results.csv`	テストを実行し、結果をCSVとして保存
`jmeter -n -t test.jmx -l results.xml`	テストを実行し、結果をXMLとして保存
`jmeter -Jusers=100`	ランタイムでプロパティ値を上書きする

高度な使用法

コマンド	説明
`jmeter -n -t test.jmx -r`	すべてのリモートサーバーでテストを実行
`jmeter -n -t test.jmx -R server1:1099,server2:1099`	特定のリモートサーバーでテストを実行
`jmeter -n -t test.jmx -Gusers=100 -Grampup=60`	リモートサーバーのグローバルプロパティを設定
`jmeter -n -t test.jmx -r -X`	分散テストを実行し、リモートサーバーから終了する
`jmeter -n -t test.jmx -q env.properties -q users.properties`	複数のプロパティファイルを使用する
`jmeter -H proxy.example.com -P 8080`	HTTPプロキシで実行
`jmeter -H proxy.com -P 8080 -u username -a password`	認証されたプロキシで実行
`jmeter -Lorg.apache.jmeter=DEBUG`	ログレベルをDEBUGに設定する
`jmeter -Lorg.apache.jmeter.protocol.http=DEBUG`	特定のパッケージのログレベルを設定
`jmeter-server -Djava.rmi.server.hostname=192.168.1.100`	特定のホスト名でサーバーを起動
`jmeter-server -Dserver_port=1099`	カスタムポートでサーバーを起動
`jmeter -n -t test.jmx -Jsummariser.interval=30`	サマリー間隔を30秒に設定
`jmeter -n -t test.jmx -Jjmeter.save.saveservice.output_format=xml`	XML出力形式を強制
`jmeter -n -t test.jmx -Jjmeter.save.saveservice.response_data=true`	結果にレスポンスデータを含める
`jmeter -XX:+UseG1GC -n -t test.jmx`	G1 ガベージコレクタで実行
`jmeter -Dcom.sun.management.jmxremote -n -t test.jmx`	JMX モニタリングを有効にする
`jmeter -Dhttp.keepAlive=false -n -t test.jmx`	HTTPキープアライブを無効にする
`jmeter -g results.jtl -o dashboard/ -f`	既存のダッシュボードを強制的に上書き
`jmeter -N “localhost	*.internal.com”`
`PluginsManagerCMD.sh install jpgc-casutg,jpgc-synthesis`	JMeter プラグインを CLI 経由でインストール

設定

JMeterプロパティファイル（`jmeter.properties`）

# Thread and ramp-up settings
jmeter.threads=100
jmeter.rampup=60

# Remote server configuration
remote_hosts=server1:1099,server2:1099,server3:1099

# Result file configuration
jmeter.save.saveservice.output_format=csv
jmeter.save.saveservice.response_data=false
jmeter.save.saveservice.samplerData=false
jmeter.save.saveservice.requestHeaders=false
jmeter.save.saveservice.url=true
jmeter.save.saveservice.responseHeaders=false

# HTTP settings
httpclient.reset_state_on_thread_group_iteration=true
http.keepAlive=true
http.connection.timeout=30000
http.socket.timeout=120000

# Summariser interval (seconds)
summariser.interval=30

# Log level
log_level.jmeter=INFO
log_level.jmeter.engine=DEBUG

ユーザープロパティファイル（`user.properties`）

# Custom variables
baseurl=https://example.com
users=100
rampup=60
duration=300

# Environment-specific settings
env=production
api_key=your_api_key_here

システムプロパティ

# Set system properties via command line
jmeter -Dhttp.proxyHost=proxy.example.com \
       -Dhttp.proxyPort=8080 \
       -Dhttps.proxyHost=proxy.example.com \
       -Dhttps.proxyPort=8080 \
       -n -t test.jmx

JVM設定（`jmeter`スクリプト）

# Edit JMETER_HOME/bin/jmeter or set environment variable
export HEAP="-Xms1g -Xmx4g -XX:MaxMetaspaceSize=256m"
export GC_ALGO="-XX:+UseG1GC -XX:MaxGCPauseMillis=100 -XX:G1ReservePercent=20"
export JVM_ARGS="$HEAP $GC_ALGO"

分散テスト設定

# In jmeter.properties on controller machine
remote_hosts=192.168.1.101:1099,192.168.1.102:1099,192.168.1.103:1099

# Server RMI configuration
server.rmi.ssl.disable=true
server.rmi.localport=4000
server_port=1099

# On remote server machines
java.rmi.server.hostname=192.168.1.101

一般的なユースケース

ユースケース1: HTMLレポート付きの基本的な負荷テスト

# Run load test with 100 users, 60s ramp-up, generate HTML report
jmeter -n -t load-test.jmx \
       -Jusers=100 \
       -Jrampup=60 \
       -Jduration=300 \
       -l results/results.jtl \
       -e -o results/dashboard/ \
       -j results/jmeter.log

# View the report
open results/dashboard/index.html  # macOS
xdg-open results/dashboard/index.html  # Linux

ユースケース2: 複数のサーバー間での分散負荷テスト

# Step 1: Start JMeter servers on remote machines
# On server1 (192.168.1.101):
jmeter-server -Djava.rmi.server.hostname=192.168.1.101

# On server2 (192.168.1.102):
jmeter-server -Djava.rmi.server.hostname=192.168.1.102

# Step 2: Run distributed test from controller
jmeter -n -t distributed-test.jmx \
       -R 192.168.1.101:1099,192.168.1.102:1099 \
       -Gusers=500 \
       -Grampup=120 \
       -l distributed-results.jtl \
       -e -o distributed-report/

# Step 3: Shutdown remote servers
jmeter -n -t distributed-test.jmx -R 192.168.1.101:1099,192.168.1.102:1099 -X

ユースケース3: 複数の環境でのAPIパフォーマンステスト

# Create environment-specific property files
# dev.properties:
echo "baseurl=https://dev-api.example.com" > dev.properties
echo "api_key=dev_key_123" >> dev.properties

# prod.properties:
echo "baseurl=https://api.example.com" > prod.properties
echo "api_key=prod_key_456" >> prod.properties

# Run test against dev environment
jmeter -n -t api-test.jmx \
       -q dev.properties \
       -Jusers=50 \
       -l dev-results.jtl \
       -e -o dev-report/

# Run test against production environment
jmeter -n -t api-test.jmx \
       -q prod.properties \
       -Jusers=200 \
       -l prod-results.jtl \
       -e -o prod-report/

ユースケース4: CI/CD統合（Jenkins/GitLab）

#!/bin/bash
# performance-test.sh - CI/CD pipeline script

# Set variables
TEST_PLAN="test-plans/load-test.jmx"
RESULTS_DIR="results/$(date +%Y%m%d_%H%M%S)"
USERS=${USERS:-100}
DURATION=${DURATION:-300}

# Create results directory
mkdir -p $RESULTS_DIR

# Run JMeter test
jmeter -n -t $TEST_PLAN \
       -Jusers=$USERS \
       -Jduration=$DURATION \
       -l $RESULTS_DIR/results.jtl \
       -e -o $RESULTS_DIR/dashboard/ \
       -j $RESULTS_DIR/jmeter.log

# Check for errors (exit code)
if [ $? -eq 0 ]; then
    echo "Test completed successfully"
    
    # Archive results
    tar -czf $RESULTS_DIR.tar.gz $RESULTS_DIR
    
    # Optional: Upload to artifact storage
    # aws s3 cp $RESULTS_DIR.tar.gz s3://bucket/results/
else
    echo "Test failed with errors"
    exit 1
fi

ユースケース5: データベースパフォーマンステスト

# Test database performance with parameterized queries
jmeter -n -t database-test.jmx \
       -Jdb.host=db.example.com \
       -Jdb.port=5432 \
       -Jdb.name=testdb \
       -Jdb.user=testuser \
       -Jdb.password=testpass \
       -Jthreads=50 \
       -Jrampup=30 \
       -l db-results.jtl \
       -e -o db-report/

# Generate report from existing results
jmeter -g db-results.jtl -o db-report-regenerated/

ベストプラクティス

実際のテストではGUIモードを使用しない: GUIモードは大量のリソースを消費し、テストの精度に影響を与えます。すべてのパフォーマンステストでjmeter -nを使用してください。
十分なヒープメモリを割り当てる: JVMヒープサイズを利用可能なRAMの少なくとも25%に設定します。大規模なテストの場合：export JVM_ARGS="-Xms2g -Xmx4g -XX:+UseG1GC"
結果ファイルにCSV形式を使用: CSVフォーマットはXMLよりも効率的です。不要なデータ収集を無効にしてオーバーヘッドを削減します： jmeter.save.saveservice.response_data=false
適切なランプアップ期間を実装: すべてのスレッドを同時に開始しないでください。現実的な負荷パターンをシミュレートするために、段階的なランプアップ（通常テスト時間の10-20%）を使用します。
高負荷のために分散テストを活用: 単一マシンの制限により結果が歪む可能性があります。500-1000スレッドを超えるテストには複数のJMeterサーバーを使用します。
テストデータをパラメータ化: ハードコードされた値の代わりに、CSV Data Set ConfigまたはVariablesを使用します。これにより、テスト設定と環境の切り替えが容易になります。
テスト中にシステムリソースを監視: JMeterマシンとターゲットシステムの両方で、CPU、メモリ、ネットワーク、ディスクI/Oを追跡します。JMeterでのリソース使用率が高い場合、テスト実行のボトルネックを示しています。
テストプランをバージョン管理: .jmxファイルとプロパティファイルをGitに保存します。意味のあるコミットメッセージを使用し、再現性のためにリリースにタグ付けします。
適切な相関とアサーションを実装: 動的な値（トークン、セッションID）を抽出し、レスポンスを検証します。速度だけを測定するのではなく、正確性を確認します。
テスト実行間のクリーンアップ: 結果ディレクトリとログをクリアします。必要に応じてアプリケーションの状態をリセットし、一貫したテスト条件を確保します。

トラブルシューティング

問題	ソリューション
OutOfMemoryError during test	Increase heap size: `export JVM_ARGS="-Xms2g -Xmx4g"` or reduce threads/disable response data saving
Connection refused on remote servers	Check firewall rules for ports 1099 and 4000. Verify `java.rmi.server.hostname` is set correctly on server
Test results show 100% errors	Verify target URL is accessible, check proxy settings, review `jmeter.log` for detailed error messages
GUI freezes during large tests	Never run large tests in GUI mode. Use non-GUI: `jmeter -n -t test.jmx -l results.jtl`
Inconsistent results between runs	適切なランプアップを確保し、実行間でキャッシュ/クッキーをクリアし、ネットワークの安定性を確認し、ターゲットシステムの負荷を確認する
Cannot generate HTML report	Verify results file format is compatible (CSV/JTL), ensure output directory is empty or use `-f` flag to force overwrite
Remote servers not starting	Check Java version compatibility (JDK 8+), verify RMI registry port is available, review `jmeter-server.log`
SSL/TLS certificate errors	Add certificate to Java keystore or disable validation: `jmeter -Jhttps.default.protocol=TLSv1.2`
Slow test execution	非GUI モードでリスナーを無効化し、アサーションの複雑さを軽減し、正規表現を最適化し、効率的なエクストラクターを使用する
”Non HTTP response code: java.net.SocketException”	タイムアウト値を増やし、接続プールの設定を確認し、ターゲットシステムの容量を検証し、スレッド数を削減する
Distributed test results incomplete	すべてのサーバーで同じテスト計画バージョンを確認し、ネットワーク接続を確認し、サーバー間のクロック同期を検証する
High CPU on JMeter machine	スレッド数を削減し、不要なプロセッサ/リスナーを無効にし、シンプルなサンプラーを使用し、分散テストを検討する
Cannot install plugins	Download Plugins Manager JAR manually to `lib/ext/`, ensure internet connectivity, check proxy settings
Results file corrupted or empty	十分なディスク容量を確保し、ファイルのアクセス権を確認し、JMeterプロセスが正常に完了したことを検証する
”Address already in use” error	Change server port: `jmeter-server -Dserver_port=1100`, kill existing JMeter processes, wait for port release

クイックリファレンス：コマンドラインオプション

オプション	説明	例
`-n`	非GUIモード	`jmeter -n -t test.jmx`
`-t`	テストプランファイル	`jmeter -t mytest.jmx`
`-l`	結果ログファイル	`jmeter -n -t test.jmx -l results.jtl`
`-j`	JMeterログファイル	`jmeter -n -t test.jmx -j jmeter.log`
`-r`	すべてのリモートサーバーで実行	`jmeter -n -t test.jmx -r`
`-R`	特定のサーバーで実行	`jmeter -n -t test.jmx -R server1,server2`
`-g`	ファイルからレポートを生成	`jmeter -g results.jtl -o report/`
`-e`	テストの後にレポートを生成	`jmeter -n -t test.jmx -l results.jtl -e -o report/`
`-o`	レポートの出力フォルダ	`jmeter -g results.jtl -o dashboard/`
`-H`	プロキシホスト	`jmeter -H proxy.com -P 8080`
`-P`	プロキシポート	`jmeter -H proxy.com -P 8080`
`-u`	プロキシユーザー名	`jmeter -H proxy.com -P 8080 -u user`
`-a`	プロキシパスワード	`jmeter -H proxy.com -P 8080 -a pass`
`-J`	JMeterプロパティを定義する	`jmeter -Jusers=100 -Jrampup=60`
`-G`	グローバルプロパティを定義する	`jmeter -Gusers=100` (for remote servers)
`-D`	システムプロパティを定義する	`jmeter -Dhttp.proxyHost=proxy.com`
`-L`	ログレベルを設定	`jmeter -Lorg.apache.jmeter=DEBUG`
`-p`	プロパティファイル	`jmeter -p custom.properties`
`-q`	追加のプロパティファイル	`jmeter -q env.properties`
`-X`	リモートサーバーから退出	`jmeter -n -t test.jmx -r -X`

Apache JMeterチートシート

Apache JMeterチートシート

インストール

基本コマンド

高度な使用法

設定

JMeterプロパティファイル（jmeter.properties）

ユーザープロパティファイル（user.properties）

システムプロパティ

JVM設定（jmeterスクリプト）

分散テスト設定

一般的なユースケース

ユースケース1: HTMLレポート付きの基本的な負荷テスト

ユースケース2: 複数のサーバー間での分散負荷テスト

ユースケース3: 複数の環境でのAPIパフォーマンステスト

ユースケース4: CI/CD統合（Jenkins/GitLab）

ユースケース5: データベースパフォーマンステスト

ベストプラクティス

トラブルシューティング

クイックリファレンス：コマンドラインオプション

JMeterプロパティファイル（`jmeter.properties`）

ユーザープロパティファイル（`user.properties`）

JVM設定（`jmeter`スクリプト）