👋 챕터 소개

안녕하세요! 지금까지 우리는 loguru가 출력하는 멋진 로그들을 터미널 화면에서만 만나봤어요. 하지만 터미널을 끄면 로그도 함께 사라져 버리죠. 🌬️ 실제 서비스에서는 나중에라도 문제가 생겼을 때 원인을 분석하기 위해 로그를 어딘가에 차곡차곡 쌓아두어야 합니다.

이번 챕터에서는 loguru의 심장과도 같은 logger.add() 메서드를 통해, 사라지지 않는 로그, 즉 파일에 로그를 기록하는 방법을 배워보겠습니다. 로그가 흘러가는 최종 목적지를 의미하는 '싱크(Sink)'라는 새로운 개념도 함께 만나볼 거예요. 이제 여러분의 로그는 단순한 화면 출력을 넘어 영속성을 갖게 될 겁니다!

🎯 챕터 목표

이번 챕터를 마치면 여러분은 다음을 할 수 있게 될 거예요!

loguru의 모든 설정을 관장하는 핵심 함수, logger.add()의 역할을 이해합니다.
로그의 최종 목적지를 의미하는 '싱크(Sink)'의 개념을 설명할 수 있습니다.
logger.add("파일이름.log") 형식으로 로그를 파일에 저장할 수 있습니다.
logger.remove()를 사용하여 기본 콘솔 출력을 제거하고, 중복 로깅을 방지할 수 있습니다.
여러 개의 싱크를 추가하여 콘솔과 파일에 동시에, 하지만 서로 다른 레벨로 로그를 남길 수 있습니다.

💻 이번 챕터에서 사용되는 전체 코드 및 프로젝트 구조

file_logging.py 파일을 새로 추가하여 실습을 진행합니다. 코드를 실행하고 나면, 프로젝트 폴더에 my_app.log라는 로그 파일이 마법처럼 생성될 거예요!

프로젝트 구조

loguru-course/
├── venv/
├── requirements.txt
├── ... (이전 강의 파일들)
├── file_logging.py      <- 새로 추가된 파일!
└── my_app.log           <- 코드 실행 후 생성될 파일!

file_logging.py 전체 코드

# file_logging.py
import sys
from loguru import logger

# 1. 기본 핸들러(콘솔 출력)를 깔끔하게 제거합니다.
#    이렇게 해야 우리가 원하는 싱크만 제어할 수 있습니다.
logger.remove()

# 2. 파일 싱크(Sink)를 추가합니다.
#    level="INFO"로 설정하여, INFO 레벨 이상의 중요한 로그만 파일에 기록합니다.
logger.add("my_app.log", level="INFO")

# 3. 콘솔 싱크(Sink)를 다시 추가합니다.
#    level="DEBUG"로 설정하여, 개발 중에는 DEBUG 레벨까지 상세한 로그를 콘솔에서 확인합니다.
logger.add(sys.stderr, level="DEBUG")

def process_user_data(user_id, data):
    logger.debug(f"사용자 '{user_id}'의 데이터 처리 시작...")

    if len(data) < 5:
        logger.warning(f"사용자 '{user_id}'의 데이터 '{data}'가 너무 짧습니다. (길이: {len(data)})")

    logger.info(f"사용자 '{user_id}'의 데이터 처리가 완료되었습니다.")

if __name__ == "__main__":
    logger.info("--- 애플리케이션 실행 ---")
    process_user_data("user123", "test")
    process_user_data("user456", "long_enough_data")
    logger.success("--- 애플리케이션 성공적으로 종료 ---")

👋 챕터 소개

🎯 챕터 목표

💻 이번 챕터에서 사용되는 전체 코드 및 프로젝트 구조

📖 강의 내용