<aside>

</aside>

👋 챕터 소개

안녕하세요, 코드 탐정 여러분! 🕵️ 지난번 @logger.catch를 통해 loguru가 얼마나 상세한 예외 보고서를 만들어주는지 경험했죠? 이번 챕터에서는 거기서 한 걸음 더 나아가, 예외가 발생한 순간의 모든 것을 속속들이 파헤치는 두 가지 강력한 디버깅 도구, backtrace와 diagnose 옵션을 배워보겠습니다.

이 옵션들은 logger.add()로 싱크를 설정할 때 추가하는 것으로, 마치 비행기 블랙박스처럼 오류가 발생하기까지의 모든 경로와 그 순간의 데이터를 기록해 줍니다. 하지만 강력한 힘에는 큰 책임이 따르는 법! 특히 diagnose 옵션의 엄청난 능력과 그에 따른 중요한 보안 경고에 대해 집중적으로 다뤄보겠습니다.

🎯 챕터 목표

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

• backtrace=True 옵션을 사용하여 전체 호출 스택(Full Stack Trace)을 추적하고 에러의 근본 원인을 파악할 수 있습니다.
• diagnose=True 옵션을 사용하여 예외 발생 시점의 변수 값들까지 확인하는 궁극의 디버깅을 할 수 있습니다.
• diagnose=True 옵션이 프로덕션 환경에서 왜 절대 사용되면 안 되는지, 그 심각한 보안 위험을 명확히 이해하고 설명할 수 있습니다.

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

deep_dive_debugging.py 파일을 새로 추가하여 실습합니다. 이 코드는 (1)기본, (2)backtrace, (3)diagnose 세 가지 옵션으로 각각 다른 로그 파일을 생성하여, 각 옵션이 예외 로그를 어떻게 변화시키는지 명확하게 비교합니다.

• 프로젝트 구조

  loguru-course/
  ├── venv/
  ├── ... (이전 강의 파일들)
  ├── deep_dive_debugging.py   <- 새로 추가된 파일!
  ├── debug_default.log        <- 실행 후 생성될 파일 1
  ├── debug_backtrace.log      <- 실행 후 생성될 파일 2
  └── debug_diagnose.log       <- 실행 후 생성될 파일 3
  
  

• deep_dive_debugging.py 전체 코드

  # deep_dive_debugging.py
  import sys
  from loguru import logger
  
  # 설정 전 기존 핸들러 모두 제거
  logger.remove()
  
  # --- 설정 1: 기본 예외 로깅 (짧은 트레이스, 변수값 표시 안 함) ---
  logger.add("debug_default.log", level="ERROR", backtrace=False, diagnose=False)
  
  # --- 설정 2: backtrace=True ---
  # 예외가 잡힌 지점을 넘어 전체 호출 경로를 보여줍니다.
  logger.add("debug_backtrace.log", level="ERROR", backtrace=True, diagnose=False)
  
  # --- 설정 3: diagnose=True ---
  # 스택 각 프레임의 변수 값까지 보여줍니다. (🚨보안 주의🚨)
  # ※ diagnose는 backtrace와 독립 옵션이므로, 함께 True로 두어 비교를 명확히 합니다.
  logger.add("debug_diagnose.log", level="ERROR", backtrace=True, diagnose=True)
  
  def calculate_inverse(value, secret_key):
      # 이 함수 내부에서 'ZeroDivisionError' 예외가 발생합니다.
      logger.info(f"'{value}'의 역수를 계산합니다. KEY: {secret_key}")
      return 1 / value
  
  def process_data(data, key):
      # 중간 단계의 함수. 여기서 예외를 잡아서 로깅합니다.
      try:
          result = calculate_inverse(data, key)
          print(f"계산 결과: {result}")
      except ZeroDivisionError:
          # logger.exception()은 예외 정보를 자동으로 로그에 포함시켜줍니다.
          logger.exception("데이터 처리 중 예상치 못한 오류가 발생했습니다.")
  
  def main():
      api_key = "super-secret-api-key-12345"
      process_data(10, api_key)
      process_data(0, api_key) # 이 호출에서 예외가 발생합니다.
  
  if __name__ == "__main__":
      main()
      print("\\n실습 완료! 프로젝트 폴더에 생성된 3개의 로그 파일을 열어 비교해보세요.")
  
  

📖 강의 내용

🛤️ backtrace=True: 전체 호출 경로 추적하기

(이번 실습의 기본 설정인 backtrace=False, diagnose=False에서는) 예외가 except 블록에서 잡힌 부분 중심의 비교적 짧은 트레이스가 출력됩니다. 반면 backtrace=True를 켜면, 예외가 발생한 지점에서부터 프로그램이 시작된 지점까지의 전체 함수 호출 경로를 역추적하여 보여줍니다.