Spring Boot, HikariCP, 로그 레벨 조정으로 이슈 원인 식별하기

개요

• HikariCP는 현재 Spring Boot에서 기본으로 채택하고 있는 경량이자 고성능의 JDBC 커넥션 풀 라이브러리이다. 물리 데이터베이스 노드와 연계되다보니 운영 환경에서 다양한 이슈가 발생하게 되는데 정확한 원인 식별과 문제 해결을 위해 HikariCP의 로그 레벨을 설정하는 방법을 설명하고자 한다.

로그 레벨 조정

• 운영체제 환경 변수로 전달할 경우 아래와 같이 설정하면 된다.

LOGGING_LEVEL_COM_ZAXXER_HIKARI_HIKARI_CONFIG=DEBUG
LOGGING_LEVEL_COM_ZAXXER_HIKARI=TRACE

• 프로젝트 내의 application.yml 파일로 설정할 경우 아래와 같이 설정하면 된다.

logging.level.com.zaxxer.hikari.HikariConfig: DEBUG 
logging.level.com.zaxxer.hikari: TRACE

로그 확인

• 앞서 HikariCP의 로그 레벨을 DEBUG로 조정했기 때문에 아래와 같이 상세한 로그 확인이 가능하다.

2021-12-13 14:41:47.405 DEBUG 1 --- [ari housekeeper] com.zaxxer.hikari.pool.HikariPool        : Hikari - Pool stats (total=10, active=7, idle=3, waiting=0)
2021-12-13 14:42:17.411 DEBUG 1 --- [ari housekeeper] com.zaxxer.hikari.pool.HikariPool        : Hikari - Pool stats (total=10, active=10, idle=0, waiting=11)

참고 글

• HikariCP
• Logging HikariCP Spring boot