콘텐츠로 이동

HikariCP

HikariCP 관련 메트릭 수집

설정

DataKit 수집기를 통한 수집

  • statsd 수집기 활성화

DataKit 설치 디렉터리의 conf.d/samples로 이동하여 statsd.conf.sample을 statsd.conf로 복사합니다.

mkdir -p ../statsd
cp statsd.conf.sample ../statsd/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 다시 시작
datakit service -R

클라이언트 설정

데이터 소스 유형에 따라 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 다운로드

SDK

  • 다음 내용으로 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

문서 평가

이 페이지가 도움이 되었나요?