• 로그인지금 시작하기

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

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

문제 신고

API 과부하 보호: 429 오류 처리

다른 고객이 시간이 많이 소요되는 쿼리를 실행하는 경우에도 REST API 호출에 빠르게 응답하기 위해 New Relic은 API에 과부하 보호 기능을 포함합니다.

상당한 리소스를 소비하기에 충분한 양의 데이터를 쿼리하는 경우 API의 응답 코드 및 헤더는 API 키에 사용할 수 있는 용량을 초과했음을 나타냅니다. 이것은 대부분의 고객이 결코 볼 수 없는 드문 상태입니다. API를 매우 리소스 집약적으로 사용하는 고객만 볼 수 있습니다.

고객은 분당 1000개의 API 호출로 제한됩니다.

API 응답

정상 작동 시 API는 응답에 과부하 보호 상태를 추가하지 않습니다. 조치를 취하지 않아도 됩니다.

보고 기간 동안 New Relic은 각 API 요청이 시스템에 미치는 영향을 추적합니다.

과부하 보호 또는 속도 제한을 유발할 수 있는 일반적인 경우는 다음과 같습니다.

  • 사용 중인 API 키가 분당 최대 요청 수를 초과했습니다.
  • 우리 시스템은 일반적으로 과부하 상태이며 일부 계정에서 보고를 줄여야 합니다.

속도 제한이 발생하는 경우 다음과 같은 일이 발생합니다.

  • 추가 API 호출은 HTTP 상태 코드 429(요청이 너무 많음)로 실패합니다.
  • HTTP 응답의 헤더와 본문에는 오류에 대한 추가 정보가 포함되거나 포함되지 않을 수 있습니다.
  • 보고 기간이 끝나면 API 호출이 다시 허용됩니다.

헤더

API 키의 개별 제한을 초과한 경우 API 응답에 표시될 HTTP 헤더는 다음과 같습니다.

오버로드 헤더

의미

X-RateLimit-Limit

분당 최대 요청 수입니다.

X-RateLimit-Remaining

이 기간에 남아 있는 요청 수입니다.

X-RateLimit-Reset

현재 보고 기간이 종료되는 UNIX 타임스탬프(1970년 1월 1일 이후 경과된 시간(초))입니다. 이 시간 이후에 API 요청에 응답합니다.

X-RateLimit-Docs

추가 정보를 즉시 얻을 수 있도록 이 문서에 대한 하이퍼링크.

일반적인 시스템 문제가 있는 경우 API 응답에 나타날 HTTP 헤더는 다음과 같습니다.

오버로드 헤더

의미

Retry-After

다시 시도해야 할 때까지의 시간(초)입니다.

예시

다음은 호출자가 사용 가능한 모든 리소스를 사용했으며 2016년 2월 1일 정오에 추가 API 호출이 다시 허용됨을 나타내는 API 요청의 예입니다.

curl -X GET 'https://api.newrelic.com/v2/applications.json' \
     -H 'Api-Key:$API_KEY' -i
HTTP/1.1 429 Too Many Requests
Content-Type: application/json
...
X-RateLimit-Docs: https://docs.newrelic.com/docs/apis/rest-api-v2/requirements/api-overload-protection-preventing-429-errors
X-RateLimit-Reset: 1454313600
X-RateLimit-Remaining: 0
X-RateLimit-Limit: 1000

{}

속도 제한 오류 방지

429 오류에 대한 가장 간단한 해결책은 다음 API 요청을 보내기 전에 보고 기간이 끝날 때까지 기다리는 것입니다. 그러나 쿼리를 주의 깊게 관리하면 처음부터 과부하 보호 오류를 피할 수 있습니다.

많은 리소스 집약적 쿼리를 보낼 것임을 알고 있는 경우 다음 예방 조치 중 하나를 수행할 수 있습니다.

  • 쿼리를 덜 자주 보내십시오. 특히 쿼리 빈도는 분당 한 번 미만입니다(에이전트 데이터의 새로 고침 빈도).
  • 매번 API에서 데이터를 요청하는 대신 New Relic에서 데이터를 캐시합니다.
  • 메트릭 이름과 출력 결과를 여러 페이지로 요청해야 하는 경우 커서 기반 기술을 사용합니다.
Copyright © 2022 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.