👋 챕터 소개

안녕하세요! 이제 우리는 로그를 파일에 안정적으로 저장할 수 있게 되었습니다. 하지만 이대로 계속 둔다면 어떻게 될까요? 시간이 흐르면서 로그 파일은 점점 커져서, 나중에는 디스크 공간을 모두 차지해버리는 '공룡 파일'이 될 수도 있어요! 🦖

이번 챕터에서는 이렇게 로그 파일이 무한정 커지는 것을 방지해주는 loguru의 아주 똑똑한 기능, **'회전(Rotation)'**에 대해 배워봅니다. logger.add()에 단 하나의 파라미터만 추가해서, 파일 크기나 시간에 따라 loguru가 스스로 로그 파일을 분리하고 관리하게 만드는 마법을 경험해 보세요!

🎯 챕터 목표

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

로그 파일을 주기적으로 분리해야 하는 '회전(Rotation)'의 필요성을 이해합니다.
logger.add()의 rotation 파라미터를 사용하여 자동 회전 기능을 설정할 수 있습니다.
파일 크기를 기준으로 (rotation="10 MB") 로그 파일을 회전시킬 수 있습니다.
시간을 기준으로 (rotation="00:00", rotation="1 week") 로그 파일을 회전시킬 수 있습니다.

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

log_rotation.py 파일을 새로 추가하여 실습합니다. 이 코드를 실행하면, 크기 기반 회전을 테스트하면서 여러 개의 로그 파일(size_log.log, size_log.log.1 등)이 자동으로 생성되는 것을 볼 수 있습니다.

프로젝트 구조

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

log_rotation.py 전체 코드

# log_rotation.py
import time
from loguru import logger

# --- Part 1: 크기 기반 회전 (Size-based Rotation) ---
# 로그 파일이 500 바이트(B)를 초과하면, 기존 파일을 .1, .2, ... 로 백업하고 새 파일을 생성합니다.
# 실습을 위해 매우 작은 용량으로 설정했습니다.
logger.add("size_log.log", rotation="500 B")

print("--- 크기 기반 회전 테스트 시작 ---")
print("100개의 로그를 빠르게 기록하여 파일이 분리되는 것을 확인합니다.")
for i in range(100):
    logger.info(f"이것은 {i+1}번째 로그 메시지입니다. 이 메시지는 충분히 깁니다.")
    time.sleep(0.01) # 너무 빠른 실행을 방지하기 위한 약간의 딜레이
print("--- 크기 기반 회전 테스트 종료 ---")
print("프로젝트 폴더에서 'size_log.log'로 시작하는 파일들을 확인해보세요!")

# --- Part 2: 시간 기반 회전 (Time-based Rotation) ---
# 아래 설정들은 지금 당장 파일이 회전되지는 않지만,
# 특정 시간이 되면 loguru가 자동으로 파일을 분리해준다는 것을 보여줍니다.

# 매일 자정("00:00")에 로그 파일을 회전시킵니다.
# 회전된 파일 이름에는 날짜가 포함됩니다. (e.g., time_log.2025-09-02.log)
logger.add("time_log.log", rotation="00:00")

# 매주 월요일에 로그 파일을 회전시킵니다. (월요일 실행시)
logger.add("weekly_log.log", rotation="1 week")

# 3일마다 로그 파일을 회전시킵니다.
logger.add("interval_log.log", rotation="3 days")

logger.info("시간 기반 로테이션 설정이 완료되었습니다.")
print("\\n'time_log.log', 'weekly_log.log' 등의 파일이 생성되었습니다.")
print("이 파일들은 설정된 시간이 되면 자동으로 새로운 파일로 분리(회전)됩니다.")

📖 강의 내용

😥 문제 인식: 로그 파일이 뚱뚱해진다면?

하나의 로그 파일에 모든 기록을 계속 쌓는 것은 여러 문제를 일으켜요.