[feature] 에러/성능 모니터링 구축 #259
Open
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
🪐 작업 내용
서비스 운영 안정성 확보 및 실시간 장애 대응을 위해 에러 트래킹(Sentry) 및 성능 모니터링(Prometheus + Grafana) 환경을 구축했습니다.
🛠 모니터링 스택
✅ 관리자 설정 가이드 (Infrastructure)
1. 환경 변수 (
.env) 설정SENTRY_DSN값을.env파일에 추가해 주세요.2. 모니터링 설정 파일 생성
/home/ubuntu/app/monitoring/prometheus.ymlmonitoring/prometheus.yml파일을 해당 위치에 생성 및 복사해 주세요.3. AWS EC2 보안 그룹(SG) 포트 개방
외부에서 모니터링 대시보드에 접속할 수 있도록 인바운드 규칙 추가가 필요합니다.
📦 주요 변경 사항
application-prod.yml: Prometheus 메트릭 노출을 위한 Actuator 엔드포인트 활성화docker-compose.yml: Prometheus 및 Grafana 서비스 정의 추가 및 전용 네트워크(catchy-network) 설정monitoring/prometheus.yml: 애플리케이션 컨테이너(catchy-server) 데이터 수집을 위한 스크레이핑 규칙 정의github-actions.yml: 배포 시 전체 서비스를 갱신하도록docker-compose up -d명령 수정🔍 확인 방법
http://[EC2-IP]:3000으로 접속하여 Grafana 로그인 여부 확인http://[EC2-IP]:8081/actuator/prometheus접속 시 메트릭 텍스트가 정상 출력되는지 확인