Skip to content

Conversation

@krsy0411
Copy link
Collaborator

개요

이 PR은 기존에 사용하던 Azure Application Insights 기반 모니터링을 제거하고,
Sentry + Umami 조합으로 마이그레이션하는 작업을 포함합니다.

  • Sentry: 프론트엔드 에러 추적 및 디버깅 목적
  • Umami: 경량 웹 트래픽 분석 (페이지 뷰, 방문자 통계)
  • 클라이언트 측 Azure Application Insights 설정 제거

변경 배경

현재 애플리케이션은 GitHub Pages에 배포되는 정적 웹 사이트로,
백엔드 서버나 Azure 런타임 환경이 존재하지 않습니다.

이러한 구조에서 Azure Application Insights는:

  • 기능 범위가 현재 요구사항 대비 과도하고
  • 프론트엔드 에러 추적과 트래픽 분석이 하나의 도구에 혼합되어 있어
    관리 및 목적이 다소 불명확한 상태였습니다.

이에 따라 모니터링 역할을 분리하여:

  • 에러 모니터링 → Sentry
  • 사용자 트래픽 분석 → Umami

로 명확히 구분하고, 정적 사이트 환경에 더 적합한 구성으로 변경했습니다.

변경 사항

  • Azure Application Insights SDK 및 관련 설정 제거
  • Sentry Browser SDK 추가 (프론트엔드 에러 모니터링)
  • Umami 트래킹 스크립트 추가 (페이지 뷰 분석)
  • 빌드 및 환경 변수 설정 업데이트

krsy0411 and others added 7 commits January 28, 2026 15:16
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- Sentry Browser SDK 및 Vite 플러그인 추가
- Web Vitals 수집 및 전송 구현
- Session Replay 기능 활성화 (개인정보 보호 모드)
- 개발 환경 전용 Sentry 테스트 함수 추가
- Application Insights 코드 및 의존성 완전 제거
- Sourcemap 생성 활성화 (에러 디버깅 지원)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- VITE_APPINSIGHTS_CONNECTION_STRING 제거
- VITE_SENTRY_DSN 및 SENTRY_AUTH_TOKEN 추가

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- Docker Compose: named volume에서 anonymous volume으로 변경
- node_modules 자동 정리 및 패키지 변경 시 자동 반영 지원
- version 필드 제거 (deprecated 경고 해결)
- VITE_SENTRY_DSN 환경 변수 추가
- gitignore: .env.sentry-build-plugin 제외 추가

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@krsy0411 krsy0411 merged commit b039936 into docker-ko:main Jan 28, 2026
1 check passed
@krsy0411 krsy0411 deleted the krsy0411-feat/observability/sentry branch January 28, 2026 07:10
@krsy0411 krsy0411 self-assigned this Jan 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[운영] Sentry 및 Umami 도입으로 Observability 마이그레이션

1 participant