서비스 이벤트 모니터링

서비스 이벤트는 CloudWatch Application Signals로 모니터링되는 서비스에 대한 자동화된 심층 관찰성을 제공합니다. 추가 코드 변경 없이 오류 지표, 함수 수준 성능 데이터, 인시던트 스냅샷(요청이 지연 시간 임곗값을 초과하거나 예외가 발생하는 경우) 및 배포 이벤트를 캡처합니다.

서비스 이벤트 작동 방식

서비스 이벤트는 계측된 서비스에서 다음과 같은 유형의 신호를 수집합니다.

서비스에 대해 CloudWatch Application Signals를 활성화하면 서비스 이벤트가 자동으로 활성화됩니다. 오류 지표 및 예외 추적은 즉시 활성화됩니다. 함수 직접 호출 지표에는 추가 구성이 필요합니다. 함수 직접 호출 데이터가 수집되기 전에 계측할 패키지를 구성해야 합니다(함수 계측 활성화 참조). OTEL_AWS_SERVICE_EVENTS_ENABLED=false를 설정하여 서비스 이벤트를 비활성화할 수 있습니다. 데이터는 ADOT SDK에서 CloudWatch 에이전트로 전달됩니다. 에이전트는 CloudWatch Logs(/aws/service-events/service-name 로그 그룹)와 CloudWatch Metrics에 이벤트를 게시합니다.

지원되는 언어: Java, Python 및 Node.js

데이터 스토리지

서비스 이벤트는 CloudWatch Logs에 데이터를 저장합니다. CloudWatch는 /aws/application-signals/service-name 접두사가 붙은 로그 그룹에 서비스 이벤트 데이터를 게시합니다. 여기서 service-name은 OTEL_SERVICE_NAME 환경 변수의 값입니다. 서비스별로 하나의 로그 그룹이 생성됩니다.

로그 수집 및 스토리지 요금은 표준 CloudWatch Logs 요율에 따라 청구됩니다.

콘솔에서 오류 보기

CloudWatch 콘솔에서 Application Signals로 이동하여 서비스를 선택한 다음 오류 탭을 선택합니다. 이 탭에는 서비스의 예외 지표가 표시됩니다.

탭에 다음 내용이 표시됩니다.

스택 트레이스, 예외 메시지 및 연결된 트레이스에 대한 링크를 포함한 세부 정보를 드릴다운하려면 예외를 선택합니다.

오류는 작업, 예외 유형 및 최상위 스택 프레임별로 그룹화됩니다. 각 그룹의 최신 대표만 표시됩니다.

로그에서 서비스 이벤트 보기

서비스 이벤트 데이터는 CloudWatch Logs의 /aws/service-events/service-name 접두사가 붙은 로그 그룹에 저장됩니다. CloudWatch Logs Insights를 사용하여 이 데이터를 직접 쿼리하여 사용자 지정 보기를 구축하거나, 대시보드를 생성하거나, 특정 인시던트를 조사할 수 있습니다.

서비스 이벤트를 쿼리하려면 다음을 수행하세요.

CloudWatch Application Signals MCP(Model Context Protocol) 서버의 서비스 이벤트

서비스 이벤트 데이터는 CloudWatch Application Signals MCP(Model Context Protocol) 서버를 통해 액세스할 수 있으며, 이를 통해 AI 코딩 어시스턴트 및 에이전트가 서비스의 런타임 동작을 직접 쿼리할 수 있습니다.

문제 해결

성능 개선

설정 및 사용 지침은 GitHub 웹 사이트의 Application Signals MCP server를 참조하세요.

서비스 이벤트 구성

사전 조건

서비스 이벤트를 사용하려면 다음 구성 요소의 최소 필수 버전이 있어야 합니다.

Amazon EKS를 사용하는 경우 추가 기능 설정 지침은 Amazon EKS 클러스터에서 애플리케이션 활성화 섹션을 참조하세요.

기본적으로 활성화된 기능

CloudWatch Application Signals를 사용하는 경우 다음 서비스 이벤트 신호는 별도의 구성 없이 기본적으로 활성화됩니다.

다음 기능은 옵트인이며 데이터를 생성하려면 환경 변수를 설정해야 합니다.

일반 설정

함수 계측 활성화

함수 계측은 기본적으로 활성화되지만 계측할 패키지를 구성할 때까지 지표를 생성하지 않습니다. 함수별 원격 분석 수집을 시작하려면 패키지 허용 목록을 제공합니다.

엔드포인트 필터링

엔드포인트 필터링은 엔드포인트 오류 지표와 인시던트 스냅샷을 생성하는 엔드포인트를 제어합니다. 이러한 설정은 함수 계측에 영향을 주지 않습니다.

지연 시간 임곗값

다음 환경 변수를 사용하여 인시던트 스냅샷 트리거의 지연 시간 임곗값을 구성합니다.

속도 제한

다음 환경 변수를 사용하여 서비스 이벤트 데이터가 수집되고 보고되는 속도를 제어합니다.

배포 이벤트 구성

배포 이벤트는 항상 애플리케이션 시작 시와 24시간마다 내보내집니다. 배포 메타데이터를 제공하면 이러한 이벤트가 보강되므로 인시던트 및 성능 변경 사항과 특정 코드 배포의 상관관계를 파악할 수 있습니다.

애플리케이션 컨테이너 또는 프로세스에서 다음 환경 변수를 설정하여 배포 메타데이터를 제공합니다.

GitHub Actions를 사용하여 배포 이벤트 구성

GitHub Actions 워크플로에서 기본 제공 환경 변수를 사용하여 배포 메타데이터를 채웁니다. 배포 단계 또는 컨테이너 환경에 다음을 추가합니다.

env:
  OTEL_AWS_SERVICE_EVENTS_GIT_COMMIT_SHA: ${{ github.sha }}
  OTEL_AWS_SERVICE_EVENTS_GIT_REPO_URL: ${{ github.server_url }}/${{ github.repository }}
  OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_ID: ${{ github.run_id }}
  OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_TIMESTAMP: $(date -u +%Y-%m-%dT%H:%M:%SZ)
  OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}

컨테이너 이미지를 배포하는 경우 이러한 값을 태스크 정의 또는 포드 사양에 환경 변수로 전달합니다. 빌드 시 값을 이미지에 베이크하거나 배포 구성을 통해 배포 시 값을 주입할 수 있습니다.

GitLab CI/CD를 사용하여 배포 이벤트 구성

GitLab CI/CD 파이프라인에서 사전 정의된 CI/CD 변수를 사용하여 배포 메타데이터를 채웁니다. 배포 작업에 다음을 추가합니다.

deploy:
  variables:
    OTEL_AWS_SERVICE_EVENTS_GIT_COMMIT_SHA: $CI_COMMIT_SHA
    OTEL_AWS_SERVICE_EVENTS_GIT_REPO_URL: $CI_PROJECT_URL
    OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_ID: $CI_PIPELINE_ID
    OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_TIMESTAMP: $(date -u +%Y-%m-%dT%H:%M:%SZ)
    OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_URL: $CI_PIPELINE_URL

컨테이너 오케스트레이션 플랫폼을 통해 배포 시 이러한 변수를 애플리케이션 컨테이너에 전달합니다(예: Amazon ECS 태스크 정의 또는 Kubernetes 배포 매니페스트의 환경 변수로).