<aside>

</aside>

👋 챕터 소개

안녕하세요! 우리는 지난 시간 loguru를 사용해 로그를 파일에 성공적으로 저장했습니다. loguru가 기본적으로 제공하는 로그 형식도 훌륭하지만, 프로젝트의 특성이나 팀의 규칙에 따라 로그 형식을 바꾸고 싶을 때가 분명히 있을 거예요. 🖌️

이번 챕터에서는 logger.add() 함수의 format 파라미터를 사용해 로그 메시지를 우리만의 스타일로 '디자인'하는 방법을 배워봅니다. 마치 레고 블록을 조립하듯, loguru가 제공하는 다양한 변수들을 조합하여 가독성 높고 유용한 우리만의 로그 포맷을 만들어 볼 거예요!

🎯 챕터 목표

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

• logger.add()의 format 파라미터를 사용하여 로그 출력 형식을 변경할 수 있습니다.
• {time}, {level}, {message} 등 자주 사용되는 포맷 변수들을 이해하고 활용할 수 있습니다.
• 날짜/시간 형식을 지정하고, 정렬 옵션(: <8)을 사용하여 로그의 가독성을 높일 수 있습니다.
• 터미널에 출력할 때는 **색상을 입히는 방법(colorize=True)**을 알게 됩니다.

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

custom_format.py 파일을 새로 추가하여 실습을 진행합니다. 코드를 실행하면, 우리가 디자인한 멋진 포맷으로 로그가 기록된 custom_format.log 파일이 생성됩니다.

• 프로젝트 구조

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

• custom_format.py 전체 코드

  # custom_format.py
  import sys
  from loguru import logger
  
  # 1. 기본 핸들러 제거
  logger.remove()
  
  # 2. 우리만의 커스텀 포맷을 문자열로 정의합니다.
  #    로그 레벨을 8자리로 만들고 왼쪽 정렬(<)하여 가독성을 높입니다.
  #    <green>, <level> 같은 태그는 colorize=True 옵션과 함께 사용될 때 색상을 입혀줍니다.
  log_format = (
      "<green>{time:YYYY-MM-DD HH:mm:ss}</green> | "
      "<level>{level: <8}</level> | "
      "<cyan>{name}</cyan>:<cyan>{function}</cyan>:<cyan>{line}</cyan> - <level>{message}</level>"
  )
  
  # 3. 파일 싱크: 커스텀 포맷을 적용하되, 색상은 제외됩니다.
  logger.add(
      "custom_format.log",
      format=log_format,
      level="INFO"
  )
  
  # 4. 콘솔 싱크: 커스텀 포맷과 함께 colorize=True로 색상을 활성화합니다.
  logger.add(
      sys.stderr,
      format=log_format,
      level="DEBUG",
      colorize=True
  )
  
  def data_processing(item_id):
      logger.debug(f"'{item_id}' 처리 시작...")
      # ... 복잡한 데이터 처리 로직 ...
      logger.info(f"'{item_id}' 처리 완료.")
  
  if __name__ == "__main__":
      logger.info("--- 데이터 처리 배치 작업 시작 ---")
      data_processing("item-001")
      data_processing("item-002")
      logger.success("--- 모든 배치 작업 성공 ---")
  
  

📖 강의 내용

🏗️ format 파라미터: 로그의 청사진 그리기

loguru의 logger.add() 함수에 format이라는 파라미터를 추가하면, 로그가 어떤 모양으로 출력될지 직접 디자인할 수 있습니다. 이 format 파라미터에 우리가 원하는 '청사진(템플릿 문자열)'을 전달하기만 하면 돼요.