🌿 중급 백엔드
API 로깅은 왜 중요한가요?
쉽게 이해하기
가게에서 매출 장부를 쓰듯이, API도 '누가, 언제, 무엇을 요청했는지' 기록해둬요. 나중에 문제가 생기면 장부를 보고 '아, 이 시간에 이 손님이 이걸 샀구나'하고 원인을 찾을 수 있어요.
핵심 정리
API 요청과 응답을 기록해서 문제를 추적하고 분석하는 거예요.
자세히 알아보기
API는 하루에 수천, 수만 번 호출돼요. 대부분은 정상적으로 작동하지만, 가끔 에러가 발생하거나 이상한 동작을 할 때가 있어요. 이때 로그가 없으면 '뭔가 잘못됐는데 이유를 모르겠다'는 상황이 돼요. 로그는 API의 블랙박스 같은 거예요.
API 로그에는 보통 요청 시간, 엔드포인트, HTTP 메서드, 요청자 IP, 응답 시간, 상태 코드 등을 기록해요. 예를 들어 '2026-02-06 14:23:15 | POST /api/orders | 192.168.1.5 | 201 | 125ms' 같은 식이죠. 이 정보로 '14시 23분에 주문 API가 호출됐고, 정상 처리됐으며 125밀리초 걸렸다'는 걸 알 수 있어요.
로그는 단순히 디버깅용이 아니라 분석용으로도 중요해요. 어떤 API가 가장 많이 호출되는지, 평균 응답 시간이 얼마인지, 에러율이 얼마인지 파악해서 최적화할 부분을 찾을 수 있어요. 또 보안 측면에서도 중요한데, 비정상적으로 많은 요청이나 불법적인 접근 시도를 로그로 감지할 수 있어요.
실무에서는 로그를 파일로 저장하거나 ELK(Elasticsearch, Logstash, Kibana) 같은 전문 로그 시스템에 보내요. 로그가 쌓이면 검색하고 시각화해서 대시보드를 만들 수 있어요. 다만 민감한 정보(비밀번호, 토큰 등)는 로그에 남기면 안 되니 주의해야 해요. 로그는 API 운영의 눈과 귀 같은 존재예요.