에러 트래킹 환경 구축

개요

"문제 있다고 해서 봤는데, 내 컴퓨터에서는 잘 되는데요…"사용자로부터 버튼이 안 된다는 제보가 들어왔는데, 내가 확인할 땐 아무 문제가 없다. 에러 메시지도 없고 어떤 상황에서 그랬는지도 알 수 없어서 디버깅에만 며칠을 썼다.그 사용자가 무슨 오류를 겪었던 건지, 어떻게 확인할 수 있을까?무슨 오류인지 알아야 고칠 텐데, 확인할 방법이 없다.

완료 조건

• 배포한 서비스에서 에러가 발생했을 때 실시간으로 수집하고 확인할 수 있는 환경을 구축한다.
• 팀원이 에러 발생 여부와 위치를 확인하고, 재현 가능한 힌트를 얻을 수 있어야 한다.

기술 역량 목표

• Sentry 등 에러 트래킹 도구를 자율적으로 선택하고, 프로젝트에 연동해 적용할 수 있다.
• 수집할 에러의 종류를 정의하고, 심각도에 따라 분류해 대응 우선순위를 판단할 수 있다.
• 수집된 에러 로그를 바탕으로 문제를 재현하고 디버깅하는 흐름을 경험한다.

---

기술 선택

후보 1, 2,3 설명

센트리 , 엠플리튜드 , 포스트호그 , GA, 클레어리티

사용자 세션과 에러트래킹을 한 곳에서 볼 수 있는 포스트 호그 설정

에러 발생 여부 확인

1. 소스맵

소스맵을 통해 어떤환경과 어느 부분에서 나왔는지

2. 알림

PostHog에 디스코드의 웹 훅을 연결해 프로덕션의 에러 알림을 받을 수 있도록 했습니다.

소스맵을 연결해 어느 위치에서 에러가 발생했는지 확인하여 1차로 문제 진단을 가능하게 했고

사용자가 어느 환경에서 에러가 나왔는지 상세히 볼 수 있도록 했습니다.

에러 심각도

등급	기준	예시	대응
P0	서비스 사용 불가	앱 전체 흰 화면, 인증 전체 실패, 치명적 런타임 오류	즉시 확인
P1	핵심 기능 사용 불가	로그인 실패, 매물 등록 실패, 지도 선택 실패	우선 수정
P2	일부 기능 오류	PDF 생성 실패, 주변 시설 조회 실패	다음 작업에서 수정
P3	사용자 영향이 낮음	일시적 네트워크 오류, 취소 가능한 요청 실패	추이만 모니터링

플로우

PostHog Error Tracking에서 이슈 확인
environment, app_version, platform 확인
소스맵으로 원본 파일과 라인 확인
에러가 발생한 세션 리플레이 확인
같은 사용자의 직전 이벤트 확인
네트워크 요청과 에러 메시지 확인
dev에서 동일한 조건으로 재현
수정 후 새 버전 배포
같은 이슈가 재발하지 않는지 확인