Spring Boot에서 로깅해보기

Spring

Spring Boot에서 로깅해보기

teo_99 2023. 5. 1. 01:28

로그, 로깅?

로그(log)란, 시스템의 작동 정보를 의미합니다.

그리고 이런 이런 로그들은 필요에 따라 기록되어야 하는데요,

시스템 실행 중에 발생하는 이벤트나 트랜잭션, 오류 등과 같은 정보는 때에 따라서는 누락되어서는 안됩니다. 이런 정보는 에러나 장애가 발생했을 때 사용될 수도 있고, 분석 데이터로도 활용될 수 있습니다.

그리고 이런 로그들을 작성하는 것을 로깅이라고 합니다.

Spring Boot에서의 로깅

Spring Boot에서는 로깅 구현체들을 위한 두 개의 인터페이스가 존재하는데요. 바로 JCL(Jakarta Commons Logging)과 SLF4J(Simple Logging Facade For Java)입니다. JCL 구현체들은 초기의 스프링에서 사용되었고 클래스로딩 타임에 구현체를 선택해야 한다는 문제로 최근에는 SLF4J 구현체들이 주로 사용됩니다.

Spring Boot는 spring-boot-starter-logging을 함께 제공하고 있는데요, spring-boot-starter-logging에서는 Logback이라는 SLF4J 로깅 구현체를 기본적으로 사용합니다. 따라서 저희가 Spring Boot 어플리케이션을 돌렸을 때 터미널에 나타나는 수많은 로그는 모두 Logback이라는 구현체에 의해 생성되는 것이라 생각해도 되겠네요.

로깅해보자!

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

@RestControllerAdvice
public class ExceptionAdvice {

    private final Logger logger = LoggerFactory.getLogger(getClass());
    
    @ExceptionHandler(Exception.class)
    public ResponseEntity<ExceptionResponse> handleException(Exception e) {
        ExceptionResponse exception = new ExceptionResponse("예상하지 못한 오류가 발생했습니다.");
        logger.error(exception.getMessage(), e);

        return ResponseEntity.internalServerError().body(exception);
    }

Logger를 사용하는 방법은 간단합니다.

구현체 선택은 LoggerFactory에게 맡기고, 저희는 getLogger 메소드만 호출해주면 됩니다.

참고로 getLogger의 인자로 getClass()를 넣어주었는데요, 이는 Logger의 이름을 클래스명으로 하겠다는 것을 의미합니다. 굳이 getClass()가 아니더라도 임의의 Logger 이름을 넣어줘도 됩니다. 하지만 터미널에서 보았을 때, 어느 Logger가 작성한 로그인지 빠르게 판단하기 위해서는 getClass()로 클래스명을 명시하는게 낫겠죠.

로깅 구현체를 이처럼 선언했다면, log.error()처럼 바로 사용하면 되는데요. 실제로 아래와 같이 로깅이 되는 것을 확인할 수 있었습니다.