“왜 노출이 안 될까?”를 한 번에 추적하는 방법
프론트엔드
“왜 노출이 안 될까?”를 한 번에 추적하는 방법
두줄요약
모듈매장 노출 이슈를 추적하기 위해 요청 흐름을 하나의 식별자로 묶는 디버깅 도구를 만들었습니다. 분산 로그를 한 화면에서 확인하고 직접 재현까지 하도록 확장해 운영 대응 속도를 높였습니다.
문제 상황
- 모듈매장과 코너 영역에서 노출 여부, 데이터 정합성 관련 운영 문의가 반복되는 상황
- 단일 API 응답만으로는 원인 파악이 어려운 전시 전처리, 후처리, 다수 서비스 호출의 결합 구조
- MSA 환경에서 분산된 로그와 수작업 추적으로 인한 대응 지연
원인 분석
- 최종 화면이 여러 전시 데이터와 내부 로직의 조합 결과인 구조
- 기존 방식이 DB 조회, 개별 서비스 로그 확인, 호출 흐름 추적을 분리된 작업으로 수행
- 로그가 서비스별로 흩어져 있어 요청 단위로 연결해 보기 어려운 점
해결 방법
- 요청 흐름을 하나의 식별자 logGroupId로 묶어 관련 로그를 연결
- Kafka Topic과 Consumer, MongoDB 적재를 통해 시간 순 로그를 한 화면에서 조회
- Swagger 연동과 화면 내 직접 API 호출 기능으로 재현과 추적을 동시에 지원
적용해볼 점
- 로그 수집 지점을 공통화해 서비스 코드 변경 범위 최소화
- 운영 도구를 단순 조회에서 실행형 디버깅 도구로 확장
- 반복 문의와 성능 비효율을 찾는 흐름 기반 관찰 도구 구축