웹앱 서버 로깅 개선기

문제 상황

• Streaming SSR 기반 웹앱에서 서버 로깅이 많아지며 디버깅과 모니터링 효율 저하
• 로그 형식이 제각각이라 유저 흐름, 요청 흐름, 오류 발생 위치를 빠르게 추적하기 어려움
• 잘못된 로그의 발생 지점을 찾기 위해 소거법과 수작업 확인에 많은 시간이 소요

원인 분석

• 엔지니어별 자유로운 로거 사용으로 인한 비일관적 로깅 정책
• 메타데이터와 호출 위치 정보 부족으로 로그 간 연결성 저하
• 로그 집계·모니터링 도구와의 연계가 약해 전체 흐름 파악이 어려움

해결 방법

• level, 메시지, 트레이스, 메타데이터로 로그 포맷 통일
• Error stack trace 기반으로 로그 호출 위치를 함께 출력
• 요청 식별자·사용자 식별자 등 공통 메타데이터를 JSON으로 주입
• 미들웨어에서 logger context를 생성해 공통 메타데이터가 자동 삽입되도록 구성

성능/운영 포인트

• 사용자 식별자, 요청 식별자 기준으로 로그 검색 및 그룹화 가능
• 모니터링 툴과 연동해 클라이언트 에러부터 서버 로그까지 한 흐름으로 추적 가능
• 반복 오류의 원인 파악 속도와 운영 가시성 향상