• 로그인

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

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

문제 신고

New Relic REST API 소개(v2)

New Relic의 REST API 를 사용하면 New Relic 도구에서 데이터를 검색하고 데이터를 New Relic 도구로 푸시하고 구성 및 삭제 기능을 포함할 수 있습니다. API 탐색기 를 사용하여 REST API를 통해 사용할 수 있는 데이터를 이해하고, curl 명령을 얻고, JSON 응답을 볼 수도 있습니다.

설정

REST API 명령 구조는 다음 템플릿을 따릅니다.

curl  -X GET <URL> -H "Api-Key:$API_KEY" -d '<PAYLOAD>'

GET 명령은 쿼리 의도에 따라 POST 또는 DELETE 일 수도 있습니다.

자리 표시자를 이해하려면 계속 읽으십시오.

예제에서는 REST API에서 메트릭 타임슬라이스 데이터를 가져오기 위한 공통 명령줄 도구로 curl을 사용합니다. 그러나 모든 방법을 사용하여 REST 요청을 만들 수 있습니다. curl 명령에는 모든 요청 메커니즘과 관련된 대상 URL, 헤더 정보 및 데이터가 포함됩니다.

URL

API 호출에는 데이터에 액세스할 위치를 지정하는 URL이 필요합니다. 요청하는 데이터 유형에 따라 변경될 적절한 URL로 자리 표시자 <URL> 를 교체해야 합니다. 일반적으로 URL은 다음 템플릿을 따릅니다.

https://api.newrelic.com/v2/applications/$APP_ID/metrics/data.json

$APPID 는 데이터가 요청되는 정확한 애플리케이션 또는 제품을 지정합니다. 이 매개변수 뒤에 오는 정보는 데이터 요청에 따라 달라집니다.

EU 지역 계정 이 있는 경우 URL은 다음과 같습니다.

api.eu.newrelic.com/v2/applications/$APP_ID/metrics/data.json

.json.xml 로 바꾸면 JSON 대신 XML 데이터를 검색할 수 있습니다.

API 키 $API_KEY

새로운 Relic API 호출에는 API 키가 필요합니다. 이것은 여러 API 키 중 하나일 수 있습니다.

  • 사용자 키 : 권장합니다. 최신 키 구현이며 REST API 키보다 제한 사항이 적습니다. 사용자 키는 NerdGraph API 에도 사용됩니다.
  • REST API 키 : 이것은 우리의 이전 키 구현입니다. 이에 대한 자세한 내용은 REST API 키 를 참조하십시오. 이 키를 사용하는 경우 필수 헤더는 { Api-Key 이 아니라 X-Api-Key }입니다.
  • New Relic 파트너쉽 계정이 있는 경우 다른 키를 사용하게 됩니다. 파트너쉽 인증 을 참조하십시오.

REST API 예제에서는 Unix 셸 프로그래밍에서 API 키 자리 표시자 $API_KEY 를 차용합니다. 호출을 형성할 때 해당 변수와 기타 사용자별 변수를 교체해야 합니다.

쿼리 세부정보(PAYLOAD)

<PAYLOAD> 에는 다음을 정의하는 쿼리 세부 정보가 포함됩니다.

  • 쿼리하려는 메트릭 이름 및 검색하려는 값
  • 측정항목 검색을 위해 정의된 시간 범위
  • (선택사항): 요약 을 사용한 메트릭 타임슬라이스 데이터의 평균

REST API 사용 사례의 예는 다음 문서를 참조하세요.

Copyright © 2022 New Relic Inc.

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