<aside>

</aside>

👋 챕터 소개

안녕하세요! loguru 완전 정복의 여정이 계속됩니다. 우리는 level 파라미터를 사용해 특정 심각도 이상의 로그만 기록하는, 기본적인 필터링을 이미 사용해왔습니다. 하지만 실무에서는 훨씬 더 복잡한 요구사항이 생기죠. "결제 모듈에서 발생한 로그만 따로 모아보고 싶어!", "비밀번호가 포함된 로그는 절대 파일에 남기면 안 돼!" 와 같이 말이에요. 🎛️

이번 챕터에서는 logger.add() 함수의 filter 파라미터를 사용하여, 단순한 레벨 필터링을 넘어 우리만의 커스텀 규칙으로 로그의 흐름을 제어하는 '동적 필터링' 기법을 배워봅니다. loguru의 똑똑한 교통 관제사를 고용하여, 원하는 로그만 정확한 목적지로 안내하는 방법을 마스터해 보세요!

🎯 챕터 목표

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

• logger.add()의 filter 파라미터를 사용하여 고급 필터링 규칙을 적용할 수 있습니다.
• 람다(lambda) 함수를 사용하여 로그 레코드의 내용을 기반으로 동적인 필터링 로직을 구현할 수 있습니다.
• 로그 메시지에 민감한 정보(예: "password")가 포함된 경우, 해당 로그를 특정 파일에서 제외할 수 있습니다.
• bind()로 추가된 컨텍스트 정보를 기반으로, 특정 사용자(예: 관리자)의 활동 로그만 별도의 파일에 기록할 수 있습니다.

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

loguru-mastery 폴더에 dynamic_filtering.py 파일을 새로 추가하여 실습합니다. 이 코드는 여러 개의 싱크에 각기 다른 필터를 적용하여, 로그가 어떻게 선택적으로 각기 다른 파일에 저장되는지를 보여줍니다.

• 프로젝트 구조

  loguru-mastery/
  ├── venv/
  ├── requirements.txt
  ├── custom_levels.py
  └── dynamic_filtering.py      <- 새로 추가된 파일!
  └── admin_actions.log         <- 실행 후 생성될 파일 1
  └── secure_general.log        <- 실행 후 생성될 파일 2
  
  

• dynamic_filtering.py 전체 코드

  # dynamic_filtering.py
  import sys
  from loguru import logger
  
  logger.remove()
  
  # --- 싱크 1: 관리자(admin-007)의 로그만 admin_actions.log 파일에 기록 ---
  # filter는 문자열/함수/딕셔너리를 인자로 받아야 합니다.
  # record["extra"]에 user_id가 있고, 그 값이 'admin-007'일 때만 True를 반환합니다.
  logger.add(
      "admin_actions.log",
      level="INFO",
      filter=lambda record: record["extra"].get("user_id") == "admin-007"
  )
  
  # --- 싱크 2: 'password'가 포함된 민감한 로그는 제외하고 secure_general.log 파일에 기록 ---
  logger.add(
      "secure_general.log",
      level="INFO",
      filter=lambda record: "password" not in record["message"].lower()
  )
  
  # --- 싱크 3: 콘솔에는 INFO 이상의 모든 로그를 출력하여 필터링 동작을 비교 ---
  logger.add(sys.stderr, level="INFO")
  
  def user_task(user_id, task_description):
      # “contextualize()를 사용하여 모든 로그에 user_id 컨텍스트를 추가합니다.
      with logger.contextualize(user_id=user_id):
          logger.info(task_description)
  
  if __name__ == "__main__":
      print("--- 동적 필터링 테스트 시작 ---")
      user_task("user-123", "게시글을 작성했습니다.")
      user_task("admin-007", "시스템 설정을 변경했습니다.")
      user_task("user-456", "비밀번호를 변경했습니다. new_password=...hidden...")
      user_task("admin-007", "새로운 사용자를 초대했습니다.")
      print("\\\\n--- 테스트 종료 ---")
      print("콘솔 출력과 'admin_actions.log', 'secure_general.log' 파일의 내용을 비교해보세요.")
  
  

📖 강의 내용

🎛️ filter 파라미터 심화 학습

logger.add()의 filter 파라미터는 level보다 훨씬 더 정교한 '문지기' 역할을 합니다. 이 문지기에게 우리는 통과시킬 로그에 대한 '특별 규칙'을 알려줄 수 있죠.