중요
AWS CloudWatch Metric Streams 통합 을 활성화하여 사용자 지정 네임스페이스를 포함하여 AWS 서비스의 모든 CloudWatch 지표를 모니터링합니다. 개별 통합은 더 이상 권장되는 옵션이 아닙니다.
New Relic 인프라 통합 에는 Amazon API Gateway 데이터를 New Relic에 보고하기 위한 통합이 포함됩니다. 이 문서에서는 이 통합을 활성화하는 방법과 보고할 수 있는 데이터에 대해 설명합니다.
팁
API Gateway v1 지표는 Amazon API Gateway에 대한 API 폴링 통합을 통해서만 사용할 수 있습니다. API Gateway v2 지표는 CloudWatch Metric Streams 통해 스트리밍됩니다.
특징
Amazon의 API 게이트웨이 는 모든 규모에서 API를 생성, 게시, 유지 관리, 모니터링 및 보호할 수 있는 완전 관리형 서비스입니다. New Relic API Gateway 통합을 통해 API 계층이 이면에서 작동하는 방식에 대한 더 많은 데이터를 얻을 수 있습니다. API 호출 수, 제공된 요청 수, 오류 수, 대기 시간 수 등에 대한 메트릭 데이터를 받게 됩니다.
New Relic 에서 직접 API Gateway 데이터를 모니터링 및 경고하고 데이터를 쿼리하고 대시보드를 생성할 수 있습니다.
요구 사항
API Gateway는 자세한 CloudWatch 지표를 명시적으로 활성화하지 않는 한 "리소스별 호출 수", "리소스별 4xx 오류" 및 "리소스별 5xx 오류" 지표를 보내지 않습니다.
팁
이러한 지표를 활성화하면 Amazon CloudWatch 계정 요금에 추가 요금이 추가될 수 있습니다.
CloudWatch 지표를 활성화하려면 다음 옵션 중 하나를 사용하십시오.
AWS Management Console로 이동하여 CloudWatch에 대한
Settings
옵션을 선택한 다음 자세한 CloudWatch 지표를 활성화하는 옵션을 선택합니다.
Amazon API Gateway REST API의
stage:update
작업을 호출하여metricsEnabled
속성을true
로 업데이트합니다.
통합 활성화
이 통합을 활성화하려면 AWS 서비스를 New Relic에 연결 하기 위한 표준 절차를 따르십시오.
구성 및 폴링
구성 옵션 을 사용하여 폴링 빈도를 변경하고 데이터를 필터링할 수 있습니다.
Amazon API 게이트웨이 통합에 대한 기본 폴링 정보:
- New Relic 폴링 간격: 5분
- Amazon CloudWatch 데이터 간격: 1분
데이터 찾기 및 사용
인프라 UI에서 통합 데이터를 찾으려면 one.newrelic.com > All capabilities > Infrastructure > AWS 으로 이동하여 API 게이트웨이 통합 링크 중 하나를 선택하세요.
ApiGatewaySample
이벤트 유형 을 사용 하여 데이터를 쿼리하고 탐색할 수 있습니다.
데이터 사용 방법에 대한 자세한 내용은 통합 데이터 이해 및 사용 을 참조하십시오.
측정항목 데이터
이 New Relic 인프라 통합은 다음 Amazon API Gateway 데이터를 수집합니다.
미터법 | 설명 |
---|---|
| 캡처된 클라이언트 측 오류 수 |
| 캡처된 서버 측 오류 수입니다. |
| API 캐시에서 제공된 요청 수입니다. |
| API 캐싱이 활성화된 경우 백엔드에서 제공되는 요청 수입니다. |
| API 메서드에 대한 호출 수입니다. |
| API Gateway가 백엔드로 요청을 릴레이하는 시점과 백엔드로부터 응답을 수신하는 시점 사이의 시간(밀리초)입니다. |
| API Gateway가 클라이언트로부터 요청을 수신한 시점과 클라이언트에 대한 응답을 반환하는 시점 사이의 시간(밀리초)입니다. 지연 시간에는 통합 지연 시간 및 기타 API Gateway 오버헤드가 포함됩니다. |
치수
다음 표의 차원 을 사용하여 API Gateway 지표를 필터링할 수 있습니다.
치수 | 설명 |
---|---|
| 지정된 API 이름의 API에 대한 API Gateway 지표를 필터링합니다. |
| 지정된 API, 단계, 리소스 및 메서드의 API 메서드에 대한 API Gateway 지표를 필터링합니다. |
| 지정된 API 및 단계의 API 단계에 대한 API Gateway 지표를 필터링합니다. |