[SpringBoot] 로그(Log) @Slf4j

로그 (Log) 

로그(Log)란 시스템이 동작할 때 시스템의 상태 및 동작 정보를 시간 경과에 따라 기록하는 것

 

로그 레벨 (Log Level)

로그는 로그 레벨에 따라 출력될지 넘어갈지 결정한다. 로그 레벨에 따른 심각도 수준은 아래와 같다.

Trace > Debug > Info > Warn > Error > Fatal

로그 레벨	설명	예시
TRACE	가장 상세한 정보(메서드 호출 단위)	메서드 진입/반환 시점 등
DEBUG	디버깅용 상세 정보	변수 값, 로직 흐름 추적
INFO	일반적인 정보	서비스 시작, 요청 처리 완료
WARN	경고 상황(에러는 아니지만 주의 필요)	성능 저하, 예상치 못한 입력
ERROR	오류 발생	예외, 시스템 장애

 💡  API를 개발할 때는 로그 레벨을 DEBUG로 설정, 배포시에는 INFO나 Warn 레벨로 설정하기.

 

로그 설정 (application.yml) 예시

스프링 부트에서는 application.yml 또는 application.properties에서 로그 레벨을 제어할 수 있다.

logging:
  level:
    root: INFO
    com.example.myapp: DEBUG
  file:
    name: logs/myapp.log

 

• 기본(root) 로그 레벨은 INFO
• 특정 패키지(com.example.myapp)는 DEBUG
• 로그 파일은 logs/myapp.log에 기록됨

@Slf4j
@RestController
public class LogExampleController {

    @GetMapping("/log-test")
    public String logTest() {
        String name = "userA";

        log.trace("Trace log = {}", name);
        log.debug("Debug log = {}", name);
        log.info("Info log = {}", name);
        log.warn("Warn log = {}", name);
        log.error("Error log = {}", name);

        return "OK";
    }
}

실행결과:

INFO   c.e.demo.LogExampleController - Info log = userA
WARN   c.e.demo.LogExampleController - Warn log = userA
ERROR  c.e.demo.LogExampleController - Error log = userA

로그레벨을 INFO로 설정했기 때문에 INFO 이하만 출력한다. trace, debug는 생략됨.

로그 출력 시 문자열 연결 주의

• slf4j의 {}의 문자열 바인딩 기능을 통해 해당 위치에 파라미터를 넣어 로그를 확인한다.
• 파라미터는 한 개 혹은 두 개 만을 사용하자 (3개 이상 사용 시, Object[] 을 생성한다)

log.debug("유저 정보: {}", user.getName());

 

 

 

@Slf4j란?

@Slf4j는 Lombok의 어노테이션으로,
클래스 내부에서 log라는 이름의 로깅 객체를 자동으로 생성해 준다.

import lombok.extern.slf4j.Slf4j;

@Slf4j
public class MyService {
    public void doSomething() {
        log.info("서비스 로직이 실행되었습니다.");
        log.debug("디버그 로그입니다: {}", "디버그 정보");
        log.error("에러 발생!", new RuntimeException("예시 예외"));
    }
}

위 코드는 Lombok이 자동으로 Log객체를 만들어 준다.

아래코드를 대신하는 어노테이션👇

private static final org.slf4j.Logger log = org.slf4j.LoggerFactory.getLogger(MyService.class);

즉, log 객체를 직접 선언할 필요 없이 바로 사용할 수 있다.