👋 챕터 소개

안녕하세요! 지금까지 우리는 정해진 문자열을 로그로 남겨왔습니다. 하지만 실제 프로그램에서는 '어떤 사용자'가 '몇 시에' '무엇을' 했는지와 같이, 계속해서 변하는 동적인 데이터를 로그에 담아야 할 때가 훨씬 많아요. 🕵️

이번 챕터에서는 로그 메시지에 변수를 손쉽게 포함시키는 방법을 배우고, 한 단계 더 나아가 여러 로그를 하나의 '이야기'로 묶어주는 강력한 기능인 컨텍스트(Context) 추가에 대해 알아봅니다. logger.bind()를 사용해 각기 흩어진 로그에 '요청 ID'와 같은 고유한 꼬리표를 붙여, 복잡한 작업의 흐름도 한눈에 추적할 수 있게 만들어 봅시다!

🎯 챕터 목표

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

logger.info("User {} logged in", user_id)처럼 로그 메시지에 변수를 간단하게 포함시킬 수 있습니다.
여러 로그에 걸쳐 동일한 정보를 일관되게 추가해야 하는 컨텍스트 로깅의 필요성을 이해합니다.
logger.bind() 메서드를 사용하여 특정 컨텍스트 정보(예: request_id)를 가진 새로운 로거를 생성할 수 있습니다.
{extra} 딕셔너리를 사용하여 bind()로 추가된 정보를 로그 포맷에 표시할 수 있습니다.

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

contextual_logging.py 파일을 새로 추가하여, 간단한 메시지 포매팅과 bind()를 사용한 컨텍스트 로깅을 비교하며 실습합니다.

프로젝트 구조

loguru-course/
├── venv/
├── ... (이전 강의 파일들)
└── contextual_logging.py      <- 새로 추가된 파일!

contextual_logging.py 전체 코드

# contextual_logging.py
import sys
import uuid
from loguru import logger

# 1. 기본 핸들러 제거 및 커스텀 포맷 설정
#    {extra} 딕셔너리를 사용하여 bind()로 추가된 데이터를 출력할 자리를 마련합니다.
logger.remove()
log_format = (
    "{time:HH:mm:ss} | {level: <8} | "
    "{extra[request_id]} | " # bind()로 추가될 request_id를 표시할 부분
    "{name}:{function}:{line} - {message}"
)
# 기본 바인딩이 없다면 keyError가 발생할 수 있어요!
logger = logger.bind(request_id="-")

logger.add(sys.stderr, format=log_format)

# --- 방법 1: 간단한 메시지 포매팅 ---
def simple_log_event(user, action):
    # logger.info()에 메시지 템플릿과 변수를 차례로 전달합니다.
    logger.info("사용자 '{}'가 '{}' 액션을 수행했습니다.", user, action)

# --- 방법 2: bind()를 사용한 컨텍스트 추가 ---
def process_request(request_data):
    # 각 요청마다 고유한 ID를 생성하여, 어떤 로그가 어떤 요청에 속하는지 추적합니다.
    request_id = str(uuid.uuid4())[:8]

    # bind()를 사용하여 request_id를 컨텍스트에 '바인딩'한 새로운 로거를 생성합니다.
    context_logger = logger.bind(request_id=request_id)

    context_logger.info("요청 처리 시작: {}", request_data)
    context_logger.debug("데이터베이스에서 사용자 정보를 조회합니다...")

    if "error" in request_data:
        context_logger.error("요청 데이터에 오류가 포함되어 있습니다.")
    else:
        context_logger.success("요청 처리를 성공적으로 완료했습니다.")

if __name__ == "__main__":
    print("--- 1. 간단한 메시지 포매팅 테스트 (컨텍스트 ID 없음) ---")
    # extra에 request_id가 없으므로 해당 필드는 비어있게 됩니다.
    simple_log_event("alice", "로그인")

    print("\\n" + "="*50 + "\\n")

    print("--- 2. bind()를 사용한 컨텍스트 로깅 테스트 ---")
    process_request({"user": "bob", "data": "some_payload"})
    print("-" * 20)
    process_request({"user": "charlie", "data": "another_payload", "error": True})

📖 강의 내용

💬 방법 1: 간단한 메시지 포매팅

로그 메시지에 변수를 포함시키는 가장 간단한 방법은 logger의 로깅 메서드(info, debug 등)가 파이썬의 str.format() 메서드처럼 동작한다는 점을 이용하는 것입니다.