본문으로 건너뛰기

모니터링 가이드

애플리케이션 부트스트랩 모니터링​

애플리케이션 부트스트랩 과정은 주요 진단 지점입니다. 다음 로그 패턴을 모니터링하여 애플리케이션 시작 문제를 감지할 수 있습니다:

정상 시작 로그 패턴​

Starting dta-wide-api bootstrap Creating NestJS application Getting ConfigService Setting up Google Cloud authentication Setting global prefix Setting up Swagger Setting up global pipes Getting port from config Attempting to listen on port 3000 🚀 Application is running on: http://localhost:3000/v1

오류 패턴​

Failed during bootstrap: [오류 메시지] Failed to set up Swagger: [오류 메시지] Unhandled error during bootstrap: [오류 메시지] Bootstrap timed out after 30000ms

OpenTelemetry 모니터링 (향후 활성화 시)​

애플리케이션에는 OpenTelemetry 기반 분산 추적 기능이 코드에 포함되어 있으나 현재 비활성화되어 있습니다. 활성화 시 Cloud Trace에서 다음 정보를 확인할 수 있습니다:

  1. 애플리케이션 초기화 스팬
  2. HTTP 요청 추적
  3. NestJS/Express 미들웨어 성능 지표

인프라 모니터링​

Terraform 관리 리소스 모니터링​

인프라 리소스는 코드형 인프라(IaC)를 통해 관리되며, 다음과 같은 모니터링 대상이 포함됩니다:

  1. Cloud Run 서비스

    • CPU 사용률 임계값: 80%
    • 메모리 사용률 임계값: 75%
    • 요청 지연 시간: p95 < 500ms
    • 오류율: < 1%

  2. Cloud SQL

    • 연결 수 임계값: 80% 최대 연결
    • 디스크 공간: 85% 이상 시 알림
    • 복제 지연: < 10초

  3. 인프라 변경 모니터링

    • 모든 Terraform 적용(apply) 이벤트 로깅
    • GitHub Actions 워크플로우 상태
    • 리소스 변경 이력 추적

참조 문서: TBD

문서 변경이력​

버전날짜작성자변경내용
0.1.02025-03-26bok@weltcorp.com최초 작성