JMeter

Supported OS Linux Mac OS Windows

概要

Datadog Backend Listener for Apache JMeter は、テスト結果を Datadog プラットフォームに送信するために使用される、オープンソースの JMeter プラグインです。これにより、レイテンシー、送受信されるバイト数などのテストメトリクスをリアルタイムで報告できます。また、完全なテスト結果をログエントリとして Datadog へ送信することも可能です。

セットアップ

インストール

Datadog Backend Listener プラグインは手動でインストールする必要があります。GitHub リポジトリの最新リリースと最新のインストール手順を参照してください。

手動インストール

リリースページから Datadog プラグイン JAR ファイルをダウンロードします。
JMeter インストール内の lib/ext ディレクトリに JAR を配置します。
JMeter を起動します (またはアプリケーションを終了し、再度開きます)。

JMeter Plugins Manager

まだ構成されていない場合は、JMeter Plugins Manager JAR をダウンロードします。
ダウンロードが完了したら、JMeter インストール内の lib/ext ディレクトリに .jar を配置します。
JMeter を起動します (またはアプリケーションを終了し、再度開きます)。
Options > Plugins Manager > Available Plugins に移動します。
“Datadog Backend Listener” を検索します。
Datadog Backend Listener プラグインの横のチェックボックスをクリックします。
“Apply Changes and Restart JMeter” をクリックします。

構成

Datadog にメトリクスの報告を開始するには

Datadog にメトリクスを送信したいスレッドグループまたはテストプランを右クリックします。
Add > Listener > Backend Listener に移動します。
Backend Listener Implementation を修正し、ドロップダウンから org.datadog.jmeter.plugins.DatadogBackendClient を選択します。
変数 apiKey に Datadog API キーを設定します。
テストを実行し、メトリクスが Datadog に表示されたことを確認します。

プラグインには以下のコンフィギュレーションオプションがあります。

名前	必須	デフォルト値	説明
apiKey	true	NA	Datadog API キー。
datadogUrl	false	https://api.datadoghq.com/api/	Datadog インスタンスが EU にある場合は、異なるエンドポイントを構成する（例: https://api.datadoghq.eu/api/）ことができます
logIntakeUrl	false	https://http-intake.logs.datadoghq.com/v1/input/	Datadog インスタンスが EU にある場合は、異なるエンドポイントを構成する（例: https://http-intake.logs.datadoghq.eu/v1/input/）ことができます。
metricsMaxBatchSize	false	200	メトリクスは、`metricsMaxBatchSize` サイズのバッチ内で 10 秒ごとに送信されます。
logsBatchSize	false	500	ログは、`logsBatchSize` のサイズに到達するとすぐにバッチ内で送信されます。
sendResultsAsLogs	false	false	デフォルトでは、メトリクスのみが Datadog に報告されます。個別のテスト結果をログイベントとして報告するには、このフィールドを `true` に設定します。
includeSubresults	false	false	Subresult は、たとえば個別の HTTP リクエストがリダイレクトに従わなければならない時に使用されます。デフォルトで、subresult は無視されます。
excludeLogsResponseCodeRegex	false	`""`	`sendResultsAsLogs` を設定すると、デフォルトですべての結果をログとして Datadog に送信します。このオプションを使用すると、レスポンスコードが指定した正規表現に一致する結果を除外することができます。例えば、`[123][0-5][0-9]` と設定すると、エラーだけを送信することができます。
samplersRegex	false	.*	監視するサンプラーをフィルターするための任意の正規表現。
customTags	false	`""`	すべてのメトリクスに追加するタグのカンマ区切りリスト

収集データ

メトリクス

jmeter.byte_received.avg (gauge)	Average value of the number of bytes received. Shown as byte
jmeter.byte_received.count (gauge)	Number of samples used to compute the bytes received distribution. Shown as request
jmeter.byte_received.max (gauge)	Maximum value of the number of bytes received. Shown as byte
jmeter.byte_received.min (gauge)	Minimum value of the number of bytes received. Shown as byte
jmeter.byte_received.p90 (gauge)	P90 value of the number of bytes received. Shown as byte
jmeter.byte_received.p95 (gauge)	P95 value of the number of bytes received. Shown as byte
jmeter.byte_received.p99 (gauge)	P99 value of the number of bytes received. Shown as byte
jmeter.byte_sent.avg (gauge)	Average value of the number of bytes sent. Shown as byte
jmeter.byte_sent.count (gauge)	Number of samples used to compute the bytes sent distribution. Shown as request
jmeter.byte_sent.max (gauge)	Maximum value of the number of bytes sent. Shown as byte
jmeter.byte_sent.min (gauge)	Minimum value of the number of bytes sent. Shown as byte
jmeter.byte_sent.p90 (gauge)	P90 value of the number of bytes sent. Shown as byte
jmeter.byte_sent.p95 (gauge)	P95 value of the number of bytes sent. Shown as byte
jmeter.byte_sent.p99 (gauge)	P99 value of the number of bytes sent. Shown as byte
jmeter.latency.avg (gauge)	Average value of the latency. Shown as second
jmeter.latency.count (gauge)	Number of samples used to compute the latency distribution. Shown as request
jmeter.latency.max (gauge)	Maximum value of the latency. Shown as second
jmeter.latency.min (gauge)	Mininimum value of the latency. Shown as second
jmeter.latency.p90 (gauge)	P90 value of the latency. Shown as second
jmeter.latency.p95 (gauge)	P95 value of the latency. Shown as second
jmeter.latency.p99 (gauge)	P99 value of the latency. Shown as second
jmeter.response_time.avg (gauge)	Average value of the response time. Shown as second
jmeter.response_time.count (gauge)	Number of samples used to compute the response time distribution. Shown as request
jmeter.response_time.max (gauge)	Maximum value of the response time. Shown as second
jmeter.response_time.min (gauge)	Minimum value of the response time. Shown as second
jmeter.response_time.p90 (gauge)	P90 value of the response time. Shown as second
jmeter.response_time.p95 (gauge)	P95 value of the response time. Shown as second
jmeter.response_time.p99 (gauge)	P99 value of the response time. Shown as second
jmeter.responses_count (count)	Count of the number of responses received by sampler and by status. Shown as response

サービスチェック

JMeter には、サービスのチェック機能は含まれません。

イベント

JMeter には、イベントは含まれません。

トラブルシューティング

ご不明な点は、Datadog のサポートチームまでお問合せください。

その他の参考資料

お役に立つドキュメント、リンクや記事:

Datadog で JMeter テスト結果を監視する