API Gateway 상세 CloudWatch 지표 설정 점검

설명

API Gateway REST API의 메서드별 상세 지표가 없으면 특정 경로와 메서드의 오류나 지연을 구분하기 어려울 수 있습니다. MetricsEnabled를 끄더라도 API·스테이지 수준의 기본 CloudWatch 지표가 모두 중단되는 것은 아닙니다.

상세 지표는 추가 비용이 발생하므로 운영에 필요한 범위를 선택하세요. 지표 수집과 로그 기록, 경보 구성은 서로 별개입니다.

잠재적 영향

일부 메서드의 오류나 지연이 집계 지표에 가려져 대응이 늦어질 수 있습니다.
필요 이상으로 상세 지표를 수집하면 모니터링 비용이 늘어날 수 있습니다.

해결 방법

메서드별 관측이 필요한 범위를 선택하고 MethodSettings의 MetricsEnabled를 true로 설정하세요. 실제 지표가 수집되는지 확인하고 오류율·지연 등 필요한 경보를 별도로 구성하세요. 지표의 분석 가치와 추가 비용을 함께 검토하세요.

예시

같은 REST API 스테이지의 설정 발췌입니다. MyRestApi와 ApiDeployment는 별도로 준비해야 합니다.

변경 전

yaml

Resources:
  ProdStage:
    Type: AWS::ApiGateway::Stage
    Properties:
      StageName: Prod
      RestApiId: !Ref MyRestApi
      DeploymentId: !Ref ApiDeployment
      MethodSettings:
        - ResourcePath: /*
          HttpMethod: "*"
          MetricsEnabled: false

이 스테이지의 모든 리소스와 메서드에 대해 상세 지표를 끕니다. 기본 API·스테이지 지표는 별도로 제공됩니다.

변경 후