운영 환경에서 도움이 되는 로그는 따로 있다

운영 로그는 개발 중 출력하던 콘솔 메시지와 목적이 다릅니다. 나중에 원인을 좁혀야 하는 사람을 위한 정보여야 하고, 하나의 요청 흐름을 따라갈 수 있어야 합니다.

남기면 좋은 정보

• 요청을 구분할 수 있는 ID
• 사용자 행동이나 리소스 식별자
• 실패 원인과 상태 코드

피하고 싶은 로그

설명 없는 성공 메시지, 너무 긴 객체 전체 출력, 문맥 없이 반복되는 에러는 오히려 읽는 속도를 늦춥니다. 로그는 기록이 아니라 검색 가능한 단서에 가까워야 합니다.

작은 기준

문제가 생겼을 때 “이 로그 한 줄로 다음 추적 지점을 알 수 있는가”를 기준으로 보면 대부분의 로그 품질이 빠르게 좋아집니다.