• 로그인지금 시작하세요

사용자의 편의를 위해 제공되는 기계 번역입니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

Amazon API Gateway 모니터링 통합

중요

AWS CloudWatch Metric Streams 통합 을 활성화하여 사용자 지정 네임스페이스를 포함하여 AWS 서비스의 모든 CloudWatch 지표를 모니터링합니다. 개별 통합은 더 이상 권장되는 옵션이 아닙니다.

New Relic 인프라 통합 에는 Amazon API Gateway 데이터를 New Relic에 보고하기 위한 통합이 포함됩니다. 이 문서에서는 이 통합을 활성화하는 방법과 보고할 수 있는 데이터에 대해 설명합니다.

특징

Amazon의 API 게이트웨이 는 모든 규모에서 API를 생성, 게시, 유지 관리, 모니터링 및 보호할 수 있는 완전 관리형 서비스입니다. New Relic API Gateway 통합을 통해 API 계층이 이면에서 작동하는 방식에 대한 더 많은 데이터를 얻을 수 있습니다. API 호출 수, 제공된 요청 수, 오류 수, 대기 시간 수 등에 대한 메트릭 데이터를 받게 됩니다.

New Relic 에서 직접 API Gateway 데이터를 모니터링 및 경고하고 데이터를 쿼리하고 대시보드를 생성할 수 있습니다.

요구 사항

API Gateway는 자세한 CloudWatch 지표를 명시적으로 활성화하지 않는 한 "리소스별 호출 수", "리소스별 4xx 오류" 및 "리소스별 5xx 오류" 지표를 보내지 않습니다.

이러한 지표를 활성화하면 Amazon CloudWatch 계정 요금에 추가 요금이 추가될 수 있습니다.

CloudWatch 지표를 활성화하려면 다음 옵션 중 하나를 사용하십시오.

  • AWS Management 콘솔로 이동하여 CloudWatch에 대한 설정 옵션을 선택한 다음 세부 CloudWatch 지표를 활성화하는 옵션을 선택합니다.
  • Amazon API Gateway REST API의 stage:update 작업을 호출하여 metricsEnabled 속성을 true 로 업데이트합니다.

통합 활성화

이 통합을 활성화하려면 AWS 서비스를 New Relic에 연결 하기 위한 표준 절차를 따르십시오.

구성 및 폴링

구성 옵션 을 사용하여 폴링 빈도를 변경하고 데이터를 필터링할 수 있습니다.

Amazon API 게이트웨이 통합에 대한 기본 폴링 정보:

  • New Relic 폴링 간격: 5분
  • Amazon CloudWatch 데이터 간격: 1분

데이터 찾기 및 사용

인프라에서 통합 데이터를 찾으려면 one.newrelic.com > Infrastructure > AWS 로 이동하여 API Gateway 통합 링크 중 하나를 선택하십시오.

ApiGatewaySample 이벤트 유형 을 사용 하여 데이터를 쿼리하고 탐색할 수 있습니다.

데이터 사용 방법에 대한 자세한 내용은 통합 데이터 이해 및 사용 을 참조하십시오.

측정항목 데이터

이 New Relic 인프라 통합은 다음 Amazon API Gateway 데이터를 수집합니다.

미터법

설명

4XXError

캡처된 클라이언트 측 오류 수

5XXError

캡처된 서버 측 오류 수입니다.

CacheHitCount

API 캐시에서 제공된 요청 수입니다.

CacheMissCount

API 캐싱이 활성화된 경우 백엔드에서 제공된 요청 수입니다.

Count

API 메서드에 대한 호출 수입니다.

IntegrationLatency

API Gateway가 백엔드에 요청을 릴레이하는 시점과 백엔드에서 응답을 수신하는 시점 사이의 시간(밀리초)입니다.

Latency

API Gateway가 클라이언트로부터 요청을 수신한 시점과 클라이언트에 대한 응답을 반환하는 시점 사이의 시간(밀리초)입니다. 지연 시간에는 통합 지연 시간 및 기타 API Gateway 오버헤드가 포함됩니다.

인벤토리 데이터

EOL 공지

2022년 3월 이후에는 클라우드 통합을 위한 인벤토리 데이터를 비롯한 여러 기능에 대한 지원이 중단됩니다. 이 전환을 쉽게 준비하는 방법을 비롯한 자세한 내용은 Explorers Hub 게시물 을 참조하세요.

인벤토리 데이터는 서비스의 상태 및 구성에 대한 정보를 제공합니다. API Gateway 구성 옵션은 인벤토리 데이터로 보고됩니다. 인벤토리 데이터에 대한 자세한 내용은 데이터 이해 및 사용 을 참조하십시오.

물체

인벤토리 데이터

/aws/apigateway/api

apiId

apiName

awsRegion

/aws/apigateway/리소스

awsRegion

methods

resource

resourceid

/aws/apigateway/stage

apiName

awsRegion

cacheClusterEnable

cacheClusterSize

cacheClusterStatus

lastUpdatedDate

stageName

/aws/apigateway/stage/변수

value

/aws/apigateway/stage/settings

CacheDataEncrypted

CacheTtlInSeconds

CachingEnabled

DataTraceEnabled

LoginLevel

MetricsEnabled

RequireAuthorizationForCacheControl

UnauthorizedCacheControlHeaderStrategy

ThrottlingBurstLimit

ThrottlingRateLimit

/aws/apigateway/stage/resource-with-metrics

apiName

awsRegion

method

resource

stageName

치수

다음 표의 차원 을 사용하여 API Gateway 지표를 필터링할 수 있습니다.

치수

설명

ApiName

지정된 API 이름의 API에 대한 API Gateway 지표를 필터링합니다.

ApiName, Method , Resource , Stage

지정된 API, 단계, 리소스 및 메서드의 API 메서드에 대한 API Gateway 지표를 필터링합니다.

ApiName, Stage

지정된 API 및 단계의 API 단계에 대한 API Gateway 지표를 필터링합니다.

Copyright © 2022 New Relic Inc.