Dropwizard 메트릭
필수 의존성: io.ktor:ktor-server-metrics
코드 예제: dropwizard-metrics
Native 서버Ktor는 Kotlin/Native를 지원하므로 추가 런타임이나 가상 머신 없이도 서버를 실행할 수 있습니다. 지원: ✖️
DropwizardMetrics 플러그인을 사용하면 Metrics 라이브러리를 구성하여 서버 및 수신 요청에 대한 유용한 정보를 얻을 수 있습니다.
의존성 추가
DropwizardMetrics을(를) 활성화하려면 빌드 스크립트에 다음 아티팩트를 포함해야 합니다:
ktor-server-metrics의존성 추가:kotlinimplementation(ktorLibs.server.metrics)위 코드 스니펫은 Ktor 버전 카탈로그를 사용하여 Ktor 의존성을 지정합니다.groovyimplementation ktorLibs.server.metrics위 코드 스니펫은 Ktor 버전 카탈로그를 사용하여 Ktor 의존성을 지정합니다.xml<dependency> <groupId>io.ktor</groupId> <artifactId>ktor-server-metrics-jvm</artifactId> <version>${ktor_version}</version> </dependency>선택 사항으로, 특정 리포터(reporter)에 필요한 의존성을 추가합니다. 아래 예제는 JMX를 통해 메트릭을 보고하는 데 필요한 아티팩트를 추가하는 방법을 보여줍니다:
kotlinimplementation("io.dropwizard.metrics:metrics-jmx:$dropwizard_version")groovyimplementation "io.dropwizard.metrics:metrics-jmx:$dropwizard_version"xml<dependency> <groupId>io.dropwizard.metrics</groupId> <artifactId>metrics-jmx</artifactId> <version>${dropwizard_version}</version> </dependency>$dropwizard_version을metrics-jmx아티팩트의 필요한 버전(예:4.2.40)으로 바꿀 수 있습니다.
DropwizardMetrics 설치
애플리케이션에 DropwizardMetrics 플러그인을 설치하려면, 지정된 모듈모듈을 사용하면 라우트를 그룹화하여 애플리케이션의 구조를 설계할 수 있습니다.의 install 함수에 전달하세요. 다음 예제는 DropwizardMetrics을(를) 설치하는 방법을 보여줍니다:
embeddedServer()함수 호출 내부.Application클래스에 명시적으로 정의된module()확장 함수 내부.
import io.ktor.server.engine.*
import io.ktor.server.netty.*
import io.ktor.server.application.*
import io.ktor.server.metrics.dropwizard.*
fun main() {
embeddedServer(Netty, port = 8080) {
install(DropwizardMetrics)
// ...
}.start(wait = true)
}import io.ktor.server.application.*
import io.ktor.server.metrics.dropwizard.*
// ...
fun Application.module() {
install(DropwizardMetrics)
// ...
}DropwizardMetrics 구성
DropwizardMetrics에서는 registry 프로퍼티를 사용하여 지원되는 모든 Metric 리포터를 사용할 수 있습니다. SLF4J 및 JMX 리포터를 구성하는 방법을 살펴보겠습니다.
SLF4J 리포터
SLF4J 리포터를 사용하면 SLF4J가 지원하는 모든 출력으로 주기적인 보고서를 내보낼 수 있습니다. 예를 들어 10초마다 메트릭을 출력하려면 다음과 같이 작성합니다:
install(DropwizardMetrics) {
Slf4jReporter.forRegistry(registry)
.outputTo(this@module.log)
.convertRatesTo(TimeUnit.SECONDS)
.convertDurationsTo(TimeUnit.MILLISECONDS)
.build()
.start(10, TimeUnit.SECONDS)
}전체 예제는 여기에서 확인할 수 있습니다: dropwizard-metrics.
애플리케이션을 실행하고 http://0.0.0.0:8080을 열면 다음과 같은 출력이 표시됩니다:
[DefaultDispatcher-worker-1] INFO Application - Responding at http://0.0.0.0:8080
... type=COUNTER, name=ktor.calls.active, count=0
... type=METER, name=ktor.calls./(method:GET).200, count=6, m1_rate=1.2, m5_rate=1.2, m15_rate=1.2, mean_rate=0.98655785084844, rate_unit=events/second
... type=METER, name=ktor.calls./(method:GET).meter, count=6, m1_rate=1.2, m5_rate=1.2, m15_rate=1.2, mean_rate=0.9841134429134598, rate_unit=events/second
... type=METER, name=ktor.calls.exceptions, count=0, m1_rate=0.0, m5_rate=0.0, m15_rate=0.0, mean_rate=0.0, rate_unit=events/second
... type=METER, name=ktor.calls.status.200, count=6, m1_rate=1.2, m5_rate=1.2, m15_rate=1.2, mean_rate=0.9866015088545449, rate_unit=events/second
... type=TIMER, name=ktor.calls./(method:GET).timer, count=6, min=0.359683, max=14.213046, mean=2.691307542732234, stddev=5.099546889849414, p50=0.400967, p75=0.618972, p95=14.213046, p98=14.213046, p99=14.213046, p999=14.213046, m1_rate=1.2, m5_rate=1.2, m15_rate=1.2, mean_rate=0.9830677128229028, rate_unit=events/second, duration_unit=milliseconds
... type=TIMER, name=ktor.calls.duration, count=6, min=0.732149, max=33.735719, mean=6.238046092985701, stddev=12.169258340009847, p50=0.778864, p75=1.050454, p95=33.735719, p98=33.735719, p99=33.735719, p999=33.735719, m1_rate=0.2, m5_rate=0.2, m15_rate=0.2, mean_rate=0.6040311229887146, rate_unit=events/second, duration_unit=millisecondsJMX 리포터
JMX 리포터를 사용하면 모든 메트릭을 JMX에 노출하여 jconsole을 사용해 해당 메트릭을 확인할 수 있습니다.
install(DropwizardMetrics) {
JmxReporter.forRegistry(registry)
.convertRatesTo(TimeUnit.SECONDS)
.convertDurationsTo(TimeUnit.MILLISECONDS)
.build()
.start()
}전체 예제는 여기에서 확인할 수 있습니다: dropwizard-metrics.
애플리케이션을 실행하고 JConsole을 사용하여 해당 프로세스에 연결하면 메트릭이 다음과 같이 표시됩니다:

노출되는 메트릭
DropwizardMetrics은(는) 다음 메트릭을 노출합니다:
- Ktor 전용 메트릭 및 JVM 메트릭을 포함하는 전역 메트릭.
- 엔드포인트별 메트릭.
전역 메트릭
전역 메트릭에는 다음 Ktor 전용 메트릭이 포함됩니다:
ktor.calls.active:Count- 아직 완료되지 않은 활성 요청 수.ktor.calls.duration- 호출 소요 시간에 대한 정보.ktor.calls.exceptions- 예외 발생 횟수에 대한 정보.ktor.calls.status.NNN- 특정 HTTP 상태 코드NNN이 발생한 횟수에 대한 정보.
메트릭 이름은 ktor.calls 접두사로 시작합니다. baseName 프로퍼티를 사용하여 이 접두사를 커스터마이즈할 수 있습니다:
install(DropwizardMetrics) {
baseName = "my.prefix"
}엔드포인트별 메트릭
"/uri(method:VERB).NNN"- 해당 경로 및 HTTP 메서드(verb)에서 특정 HTTP 상태 코드NNN이 발생한 횟수에 대한 정보."/uri(method:VERB).meter"- 해당 경로 및 HTTP 메서드에 대한 호출 횟수 정보."/uri(method:VERB).timer"- 해당 엔드포인트의 소요 시간에 대한 정보.
JVM 메트릭
HTTP 메트릭 외에도 Ktor는 JVM 모니터링을 위한 일련의 메트릭을 노출합니다. registerJvmMetricSets 프로퍼티를 사용하여 이러한 메트릭을 비활성화할 수 있습니다:
install(DropwizardMetrics) {
registerJvmMetricSets = false
}전체 예제는 여기에서 확인할 수 있습니다: dropwizard-metrics.
