Supported OS
Datadog Backend Listener for Apache JMeter is an open source JMeter plugin used to send test results to the Datadog platform. It provides real-time reporting of test metrics like latency, the number of bytes sent and received, and more. You can also send to Datadog complete test results as log entries.
The Datadog Backend Listener plugin needs to be installed manually. See the latest release and more detailed installation instructions on the repo release page.
The plugin has the following configuration options:
| Name | Required | Default value | description |
|---|---|---|---|
| apiKey | true | NA | Your Datadog API key. |
| datadogUrl | false | https://api.datadoghq.com/api/ | You can configure a different endpoint, for instance https://api.datadoghq.eu/api/ if your datadog instance is in the EU |
| logIntakeUrl | false | https://http-intake.logs.datadoghq.com/v1/input/ | You can configure a different endpoint, for instance https://http-intake.logs.datadoghq.eu/v1/input/ if your datadog instance is in the EU. |
| metricsMaxBatchSize | false | 200 | Metrics are submitted every 10 seconds in batches of size metricsMaxBatchSize. |
| logsBatchSize | false | 500 | Logs are submitted in batches of size logsBatchSize as soon as this size is reached. |
| sendResultsAsLogs | false | false | By default only metrics are reported to Datadog. To report individual test results as log events, set this field to true. |
| includeSubresults | false | false | A subresult is for instance when an individual HTTP request has to follow redirects. By default subresults are ignored. |
| samplersRegex | false | .* | An optional regex to filter the samplers to monitor. |
| jmeter.responses_count (count) | Count of the number of responses received by sampler and by status. Shown as response |
| 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.p99 (gauge) | P99 value of the latency. Shown as second |
| jmeter.latency.p95 (gauge) | P95 value of the latency. Shown as second |
| jmeter.latency.p90 (gauge) | P90 value of the latency. Shown as second |
| 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.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.p99 (gauge) | P99 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.p90 (gauge) | P90 value of the response time. 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.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.p99 (gauge) | P99 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.p90 (gauge) | P90 value of the number of bytes received. Shown as byte |
| 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_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.p99 (gauge) | P99 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.p90 (gauge) | P90 value of the number of bytes sent. 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 does not include any service checks.
JMeter does not include any events.
Need help? Contact Datadog support.
Additional helpful documentation, links, and articles:
