JMeter

Supported OS Mac OS Windows

개요

Datadog Apache JMeter용 백엔드 리스너는 테스트 결과를 Datadog 플랫폼으로 전송하는 데 사용되는 오픈 소스 JMeter 플러그인입니다. 지연 시간, 송수신 바이트 수 등과 같은 테스트( 메트릭)에 대한 실시간 보고를 제공합니다. 또한 로그 항목으로 전체 테스트 결과를 Datadog로 보낼 수도 있습니다.

설정

설치

Datadog 백엔드 리스너 플러그인은 수동으로 설치해야 합니다. 최신 릴리스 및 자세한 설치 방법은 GitHub 리포지토리를 참조하세요.

수동 설치

릴리스 페이지에서 Datadog 플러그인 JAR 파일을 다운로드하세요.
JMeter 설치 내 lib/ext 디렉터리에 JAR을 둡니다.
JMeter를 시작합니다(또는 애플리케이션을 종료했다가 다시 실행).

JMeter 플러그인 관리자

아직 설정하지 않은 경우 JMeter 플러그인 관리자 JAR을 다운로드하세요.
다운로드가 완료되면 .jar을 JMeter 설치 내 lib/ext 디렉토리에 둡니다.
JMeter를 시작합니다(또는 애플리케이션을 종료했다가 다시 실행).
Options > Plugins Manager > Available Plugins로 이동합니다.
“Datadog 백엔드 리스너"를 검색합니다.
Datadog 백엔드 리스너 플러그인 옆의 확인란을 클릭합니다.
“변경 사항 적용 및 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	예를 들어 개별 HTTP 요청이 리디렉션을 따라야 하는 경우의 하위 결과입니다. 기본적으로 하위 결과는 무시됩니다.
excludeLogsResponseCodeRegex	false	`""`	`sendResultsAsLogs`을 설정하면 기본적으로 모든 결과가 로그로 Datadog로 전송됩니다. 이 옵션을 사용하면 응답 코드가 지정된 정규식과 일치하는 결과를 제외할 수 있습니다. 예를 들어 이 옵션을 `[123][0-5][0-9]`로 설정하여 오류만 제출할 수 있습니다.
samplersRegex	false	.*	선택적 정규식을 사용하여 샘플러를 모니터링합니다.
customTags	false	`""`	쉼표로 구분된 태그 목록을 모든 메트릭 항목에 추가합니다.

수집한 데이터

메트릭


jmeter.active_threads.avg (gauge)	Average number of active threads during the interval. Shown as thread
jmeter.active_threads.max (gauge)	Maximum number of active threads during the interval. Shown as thread
jmeter.active_threads.min (gauge)	Minimum number of active threads during the interval. Shown as thread
jmeter.assertions.count (count)	Total number of assertion checks evaluated. Shown as assertion
jmeter.assertions.error (count)	Number of errors during assertion execution. Shown as assertion
jmeter.assertions.failed (count)	Number of failed assertion checks. Shown as assertion
jmeter.bytes_received.avg (gauge)	Average bytes received. Shown as byte
jmeter.bytes_received.count (count)	Number of samples used to compute the bytes received distribution. Shown as request
jmeter.bytes_received.max (gauge)	Maximum bytes received. Shown as byte
jmeter.bytes_received.median (gauge)	Median bytes received. Shown as byte
jmeter.bytes_received.min (gauge)	Minimum bytes received. Shown as byte
jmeter.bytes_received.p90 (gauge)	90th percentile of bytes received. Shown as byte
jmeter.bytes_received.p95 (gauge)	95th percentile of bytes received. Shown as byte
jmeter.bytes_received.p99 (gauge)	99th percentile of bytes received. Shown as byte
jmeter.bytes_received.total (count)	Total bytes received during the interval. Shown as byte
jmeter.bytes_sent.avg (gauge)	Average bytes sent. Shown as byte
jmeter.bytes_sent.count (count)	Number of samples used to compute the bytes sent distribution. Shown as request
jmeter.bytes_sent.max (gauge)	Maximum bytes sent. Shown as byte
jmeter.bytes_sent.median (gauge)	Median bytes sent. Shown as byte
jmeter.bytes_sent.min (gauge)	Minimum bytes sent. Shown as byte
jmeter.bytes_sent.p90 (gauge)	90th percentile of bytes sent. Shown as byte
jmeter.bytes_sent.p95 (gauge)	95th percentile of bytes sent. Shown as byte
jmeter.bytes_sent.p99 (gauge)	99th percentile of bytes sent. Shown as byte
jmeter.bytes_sent.total (count)	Total number of bytes sent during the interval (rate per second). Shown as byte
jmeter.cumulative.bytes_received.rate (gauge)	Bytes received per second for a label. Shown as byte
jmeter.cumulative.bytes_sent.rate (gauge)	Bytes sent per second for a label. Shown as byte
jmeter.cumulative.response_time.avg (gauge)	Average response time across all samples for a label. Shown as second
jmeter.cumulative.response_time.max (gauge)	Maximum response time across all samples for a label. Shown as second
jmeter.cumulative.response_time.median (gauge)	Median (p50) response time across all samples for a label. Shown as second
jmeter.cumulative.response_time.min (gauge)	Minimum response time across all samples for a label. Shown as second
jmeter.cumulative.response_time.p90 (gauge)	90th percentile response time across all samples for a label. Shown as second
jmeter.cumulative.response_time.p95 (gauge)	95th percentile response time across all samples for a label. Shown as second
jmeter.cumulative.response_time.p99 (gauge)	99th percentile response time across all samples for a label. Shown as second
jmeter.cumulative.responses.error_percent (gauge)	Percentage of failed samples for a label (0-100). Shown as percent
jmeter.cumulative.responses_count (gauge)	Total number of samples collected for a label. Shown as response
jmeter.cumulative.throughput.rps (gauge)	Requests per second for a label. Shown as request
jmeter.final_result.bytes_received.rate (gauge)	Bytes received per second for a label (final test result only). Shown as byte
jmeter.final_result.bytes_sent.rate (gauge)	Bytes sent per second for a label (final test result only). Shown as byte
jmeter.final_result.response_time.avg (gauge)	Average response time across all samples for a label (final test result only). Shown as second
jmeter.final_result.response_time.max (gauge)	Maximum response time across all samples for a label (final test result only). Shown as second
jmeter.final_result.response_time.median (gauge)	Median (p50) response time across all samples for a label (final test result only). Shown as second
jmeter.final_result.response_time.min (gauge)	Minimum response time across all samples for a label (final test result only). Shown as second
jmeter.final_result.response_time.p90 (gauge)	90th percentile response time across all samples for a label (final test result only). Shown as second
jmeter.final_result.response_time.p95 (gauge)	95th percentile response time across all samples for a label (final test result only). Shown as second
jmeter.final_result.response_time.p99 (gauge)	99th percentile response time across all samples for a label (final test result only). Shown as second
jmeter.final_result.responses.error_percent (gauge)	Percentage of failed samples for a label (final test result only). Shown as percent
jmeter.final_result.responses_count (gauge)	Total number of samples collected for a label (final test result only). Shown as response
jmeter.final_result.throughput.rps (gauge)	Requests per second for a label (final test result only). Shown as request
jmeter.latency.avg (gauge)	Average latency. Shown as second
jmeter.latency.count (count)	Number of samples used to compute the latency distribution. Shown as request
jmeter.latency.max (gauge)	Maximum latency. Shown as second
jmeter.latency.median (gauge)	Median latency. Shown as second
jmeter.latency.min (gauge)	Minimum 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 (count)	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.median (gauge)	Median 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.threads.finished (gauge)	Total number of threads finished. Shown as thread
jmeter.threads.started (gauge)	Total number of threads started. Shown as thread

The plugin emits three types of metrics:

Interval metrics (jmeter.*): Real-time metrics reset each reporting interval, useful for monitoring during test execution.
Cumulative metrics (jmeter.cumulative.*): Aggregate statistics over the entire test duration, similar to JMeter’s Aggregate Reports. These include a final_result tag (true at test end, false during execution).
Final result metrics (jmeter.final_result.*): Emitted only once at test completion, providing an unambiguous way to query final test results without filtering by tag.

서비스 점검

JMeter에는 서비스 점검이 포함되어 있지 않습니다.

이벤트

JMeter에는 이벤트가 포함되어 있지 않습니다.

트러블슈팅

도움이 필요하신가요? Datadog 지원 팀에 문의하세요.

참고 자료

기타 유용한 문서, 링크 및 기사:

Datadog를 사용한 JMeter 테스트 결과 모니터링