<aside>

</aside>

👋 챕터 소개

안녕하세요! 지난 시간에는 FastAPI에 loguru를 성공적으로 연동했죠. 하지만 자세히 보면, 모든 엔드포인트 함수(read_root, read_item) 안에 우리가 직접 logger.info() 코드를 작성해야 했습니다. 엔드포인트가 수백 개라면 어떨까요? 모든 곳에 로깅 코드를 복사-붙여넣기 하는 것은 비효율적이고 실수를 유발하기 쉽습니다. 😫

이번 챕터에서는 FastAPI의 강력한 기능인 **'미들웨어(Middleware)'**를 사용하여 이 문제를 아주 우아하게 해결해 보겠습니다. 미들웨어는 모든 요청이 우리의 API에 도달하기 전, 그리고 응답이 클라이언트에게 돌아가기 직전에 거치는 '중앙 관문'과 같아요. 이 관문에 로그 기록 장치를 설치하여 모든 요청과 응답을 자동으로 기록하고, 추적을 위한 **'요청 ID(Request ID)'**까지 부여해 보겠습니다!

🎯 챕터 목표

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

• 모든 HTTP 요청/응답을 가로채는 FastAPI 미들웨어의 개념을 이해하고 작성할 수 있습니다.
• 들어오는 모든 요청에 대해 HTTP 메서드, URL 등의 정보를 자동으로 로깅할 수 있습니다.
• 각 요청마다 고유한 요청 ID를 생성하고, logger.contextualize()를 통해 관련된 모든 로그에 이 ID를 전파할 수 있습니다.
• 요청 처리 시간을 계산하여 응답 로그에 포함시킴으로써, API의 성능을 파악할 수 있습니다.

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

지난 시간의 main.py 파일을 수정하여 미들웨어 로직을 추가하고, 엔드포인트에 있던 수동 로깅 코드를 제거하여 코드를 더욱 깔끔하게 만듭니다.

• 프로젝트 구조 (변경 없음)

  fastapi-loguru-project/
  ├── venv/
  ├── requirements.txt
  └── main.py               <- 이 파일을 수정합니다!
  └── server.log
  
  

• main.py 전체 코드 (수정 후)

📖 강의 내용

🚪 FastAPI 미들웨어란?

미들웨어는 애플리케이션의 '중앙 현관'과 같아요. 모든 손님(HTTP Request)은 이 현관을 통해 들어오고, 현관을 통해 나갑니다(HTTP Response).