HikariCP
HikariCP 관련 메트릭 수집
설정¶
DataKit 수집기를 통한 수집¶
statsd수집기 활성화
DataKit 설치 디렉터리의 conf.d/samples로 이동하여 statsd.conf.sample을 statsd.conf로 복사합니다.
statsd.conf에 protocol = "udp"와 service_address = ":8125"가 설정되어 있는지 확인하고, parse_data_dog_tags = true를 활성화하여 커넥션 풀의 pool 태그를 유지합니다.
- 애플리케이션 트레이스도 수집하려면
ddtrace수집기 활성화
DataKit 설치 디렉터리의 conf.d/ddtrace로 이동하여 ddtrace.conf.sample을 ddtrace.conf로 복사합니다.
cp ddtrace.conf.sample ddtrace.conf
- 수집기 설정을 변경한 후 다음 명령을 실행하여 DataKit 다시 시작
클라이언트 설정¶
데이터 소스 유형에 따라 MBean을 활성화한 다음 JMXFetch와 시작 매개변수를 설정합니다.
Spring Boot 단일 데이터 소스¶
Spring Boot 단일 데이터 소스에는 register-mbeans=true를 사용합니다.
spring.datasource.url=jdbc:mysql://xx.xxx.xx.xxx:3306/test?useSSL=false&useLegacyDatetimeCode=false&allowPublicKeyRetrieval=true
spring.datasource.username=***
spring.datasource.password=*****
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.type=com.zaxxer.hikari.HikariDataSource
spring.datasource.hikari.maximum-pool-size=10
spring.datasource.hikari.minimum-idle=5
spring.datasource.hikari.idle-timeout=300000
spring.datasource.hikari.max-lifetime=1800000
spring.datasource.hikari.connection-timeout=30000
spring.datasource.hikari.pool-name=HikariCP
spring.datasource.hikari.register-mbeans=true
dynamic-datasource 다중 데이터 소스¶
dynamic-datasource를 사용하는 경우(이 예제에서는 4.3.1), 다음 필드를 기존 설정에 병합하고 데이터 소스 이름을 실제 설정에 맞게 바꿉니다.
spring:
datasource:
dynamic:
datasource:
master:
hikari:
is-register-mbeans: true
slave:
hikari:
is-register-mbeans: true
spring.datasource.dynamic.hikari.is-register-mbeans=true를 전역으로 설정할 수도 있습니다. 각 데이터 소스의 개별 설정이 우선 적용됩니다.
매개변수 이름은 is-register-mbeans입니다. 변경 후 애플리케이션을 다시 시작하세요. 사용자 지정 pool-name은 데이터 소스의 url과 같은 계층에 있어야 하며, 각 풀 이름은 고유해야 합니다.
JMXFetch 설정¶
dd-java-agent다운로드
- 다음 내용으로
hikaricp.yaml파일 생성
init_config:
instances:
- jvm_direct: true
name: hikari-slick-monitoring
collect_default_jvm_metrics: false
collect_default_metrics: false
refresh_beans: 60
conf:
- include:
bean_regex: "com.zaxxer.hikari:type=Pool \\((.*)\\)"
tags:
pool: $1
attribute:
ActiveConnections:
metric_type: gauge
alias: hikaricp.connections.active
IdleConnections:
metric_type: gauge
alias: hikaricp.connections.idle
TotalConnections:
metric_type: gauge
alias: hikaricp.connections.total
ThreadsAwaitingConnection:
metric_type: gauge
alias: hikaricp.connections.pending
- include:
bean_regex: "com.zaxxer.hikari:type=PoolConfig \\((.*)\\)"
tags:
pool: $1
attribute:
MaximumPoolSize:
metric_type: gauge
alias: hikaricp.pool.size.max
IdleTimeout:
metric_type: gauge
alias: hikaricp.idle.timeout
MaxLifetime:
metric_type: gauge
alias: hikaricp.max.lifetime
MinimumIdle:
metric_type: gauge
alias: hikaricp.min.idle
ConnectionTimeout:
metric_type: gauge
alias: hikaricp.connections.timeout
ValidationTimeout:
metric_type: gauge
alias: hikaricp.validation.timeout
LeakDetectionThreshold:
metric_type: gauge
alias: hikaricp.leak.detection.threshold
시작 매개변수 설정¶
다음 명령은 애플리케이션과 DataKit이 같은 호스트에서 실행되는 경우의 예입니다.
java \
-javaagent:/xxx/dd-java-agent.jar \
-Ddd.agent.port=9529 \
-Ddd.service=demo \
-Ddd.jmxfetch.check-period=1000 \
-Ddd.jmxfetch.enabled=true \
-Ddd.jmxfetch.config.dir=/xxx/ \
-Ddd.jmxfetch.config=hikaricp.yaml \
-Ddd.jmxfetch.statsd.host=127.0.0.1 \
-Ddd.jmxfetch.statsd.port=8125 \
-jar xxxx.jar
config.dir은 애플리케이션 프로세스가 읽을 수 있는 JMX 설정 디렉터리입니다. 파일 이름은 config 매개변수와 일치해야 합니다. 모든 -D 매개변수는 -jar 앞에 배치합니다.
애플리케이션과 DataKit이 서로 다른 Pod에서 실행되는 경우, statsd.host를 datakit-service.datakit.svc.cluster.local과 같은 실제 Service 주소로 변경하고 UDP 포트 8125에 접근할 수 있는지 확인합니다.
수집 결과 확인¶
시작 후 각 풀의 Hikari MBean이 등록되어 있고 DataKit StatsD 수신 건수가 계속 증가하는지 확인합니다. 그런 다음 Guance의 hikaricp 측정 집합에서 데이터를 조회하고 pool 태그로 커넥션 풀을 구분합니다.
메트릭¶
hikaricp 측정 집합¶
HikariCP 메트릭은 hikaricp 측정 집합에 저장됩니다. 다음 표에서 관련 메트릭을 설명합니다.
| Metrics | 설명 | 용도 | 단위 |
|---|---|---|---|
connections_active |
현재 활성 데이터베이스 연결 수 |
애플리케이션에서 현재 사용 중인 연결 수를 나타냅니다 | count |
connections_idle |
현재 유휴 데이터베이스 연결 수 |
사용되지 않고 유휴 상태인 연결 수를 나타냅니다 | count |
connections_pending |
현재 연결을 기다리는 요청 수 |
값이 높으면 현재 동시 처리 요구를 충족하기에 커넥션 풀 크기가 부족할 수 있습니다 | count |
connections_total |
현재 커넥션 풀의 전체 데이터베이스 연결 수 |
활성 연결과 유휴 연결을 모두 포함합니다 | count |
idle_timeout |
연결의 최대 유휴 시간 |
설정 항목. 연결의 유휴 시간이 이 값을 초과하면 풀에서 해당 연결을 닫습니다 | ms |
leak_detection_threshold |
연결 누수 감지 임계값 |
설정 항목. 연결 점유 시간이 이 임계값을 초과하면 풀에서 연결 누수 가능성이 있다고 판단하고 경고를 표시합니다 | ms |
max_lifetime |
연결의 최대 수명 |
설정 항목. 연결 생성부터 종료까지의 전체 수명은 이 값을 초과할 수 없습니다 | ms |
min_idle |
풀의 최소 유휴 연결 수 |
설정 항목. 새 요청에 빠르게 응답할 수 있도록 풀에서 최소한 이 수만큼의 유휴 연결을 유지합니다 | count |
pool_size_max |
풀에서 허용되는 최대 연결 수 |
설정 항목. 풀 크기를 제한하여 과도한 연결로 인한 리소스 과소비를 방지합니다 | count |
validation_timeout |
연결 유효성 검사 제한 시간 |
설정 항목. 풀에서 연결을 가져올 때 연결 유효성을 검사하며, 검사 시간이 이 값을 초과하면 실패로 판단합니다 | ms |
connections_timeout |
연결 제한 시간 |
설정 항목. 연결을 설정하기 위한 최대 대기 시간입니다 | ms |