[java] Hibernate에서 로깅(logging) 설정하는 방법은?

20 Nov 2023

java

Hibernate은 강력한 ORM(Object-Relational Mapping) 프레임워크로 잘 알려져 있습니다. 로깅(logging)은 개발자가 애플리케이션의 동작을 추적하고 디버깅하는 데 도움을 주는 중요한 요소입니다. Hibernate에서는 다양한 로깅 옵션을 제공하여 개발자가 로그 메시지를 커스터마이징하고 필요한 정보를 얻을 수 있습니다.

Hibernate에서 로깅을 설정하는 방법은 다음과 같습니다:

의존성 추가: 로깅을 사용하기 위해 먼저 log4j, slf4j 또는 logback 등의 로깅 프레임워크에 대한 의존성을 프로젝트에 추가해야 합니다. Maven을 사용한다면, pom.xml 파일에 다음과 같이 의존성을 추가할 수 있습니다:

<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-core</artifactId>
    <version>버전</version>
</dependency>

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-api</artifactId>
    <version>버전</version>
</dependency>
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-log4j12</artifactId>
    <version>버전</version>
</dependency>

로그 설정 파일 작성: Hibernate의 로깅 설정은 log4j.properties, log4j.xml, logback.xml 등의 로깅 프레임워크에서 지원하는 설정 파일을 사용하여 수행됩니다. 이 파일은 로그 레벨, 로그 출력 포맷, 로그 파일 위치 등을 정의합니다. 예를 들어, log4j.properties 파일을 사용하여 Hibernate의 로깅을 구성하려면 다음과 같이 설정 파일을 작성합니다:

# 로그 레벨 설정
log4j.rootLogger=DEBUG, FILE

# 파일로 로그 기록
log4j.appender.FILE=org.apache.log4j.FileAppender
log4j.appender.FILE.File=/path/to/hibernate.log
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n

Hibernate 설정에 로깅 설정 추가: Hibernate의 hibernate.cfg.xml 파일 또는 Spring과 같은 프레임워크에서 사용하는 설정 파일에서 로깅 설정을 추가해야 합니다. 설정 파일에 로깅 프레임워크와 로그 설정 파일을 지정해야 합니다. 예를 들어, hibernate.cfg.xml 파일에 다음과 같이 설정할 수 있습니다:

<property name="hibernate.show_sql">true</property>
<property name="hibernate.format_sql">true</property>
<property name="hibernate.use_sql_comments">true</property>
<property name="hibernate.generate_statistics">true</property>
<property name="hibernate.ejb.interceptor">com.example.MyInterceptor</property>
<property name="hibernate.connection.provider_class">org.hibernate.connection.DriverManagerConnectionProvider</property>
<property name="hibernate.connection.url">jdbc:h2:mem:mydb</property>
<property name="hibernate.connection.driver_class">org.h2.Driver</property>
<property name="hibernate.connection.username">sa</property>
<property name="hibernate.connection.password"></property>
<property name="hibernate.dialect">org.hibernate.dialect.H2Dialect</property>

<property name="hibernate.connection.pool_size">1</property>
<property name="hibernate.hbm2ddl.auto">create-drop</property>

<!-- 로깅 프레임워크와 로그 설정 파일 지정 -->
<property name="hibernate.jdbc.use_streams_for_binary">false</property>
<property name="hibernate.jdbc.batch_size">30</property>
<property name="hibernate.transaction.manager_lookup_class">org.hibernate.transaction.JBossTransactionManagerLookup</property>

<property name="hibernate.transaction.auto_close_session">true</property>
<!-- Logging 설정-->
<property name="hibernate.transaction.factory_class">org.hibernate.transaction.JDBCTransactionFactory</property>
<property name="hibernate.cache.provider_class">org.hibernate.cache.NoCacheProvider</property>
<property name="hibernate.cache.use_query_cache">false</property>
<property name="hibernate.cache.use_minimal_puts">true</property>

<property name="hibernate.query.substitutions">true 1, false 0, yes 'Y', no 'N'</property>
<property name="hibernate.connection.release_mode">after_transaction</property>

로깅 레벨 및 기타 로깅 설정을 변경하려면 설정 파일에 있는 로깅 관련 속성 값을 수정하면 됩니다. 이렇게 설정된 로그는 설정 파일에서 지정한 위치에 저장되며, 필요한 경우 애플리케이션의 로그를 확인하기 위해 해당 파일을 확인할 수 있습니다.

참고 문헌:

Hibernate Documentation: Logging
Hibernate Reference Documentation: Logging