New Relic의 REST API를 사용하면 New Relic 도구에서 데이터를 검색 및 푸시할 수 있을 뿐만 아니라 기능을 구성하고 삭제 작업을 수행할 수 있습니다. API 탐색기 를 사용하여 REST API를 통해 사용할 수 있는 데이터를 이해하고 curl 명령을 얻고 JSON 응답을 볼 수도 있습니다.
설정
REST API 명령 구조는 다음 템플릿을 따릅니다.
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$APP_ID 는 데이터가 요청되는 정확한 애플리케이션 또는 제품을 지정합니다. 이 매개변수 다음의 정보는 데이터 요청에 따라 달라집니다.
EU 지역 계정 이 있는 경우 URL은 다음과 같습니다.
api.eu.newrelic.com/v2/applications/$APP_ID/metrics/data.json팁
.json 을 .xml 로 바꾸면 JSON 대신 XML 데이터를 검색할 수 있습니다.
API 키 $API_KEY
New 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 사용 사례의 예는 다음 문서를 참조하세요.
APM 예제 (메트릭 타임슬라이스 데이터를 검색하는 방법)
).
브라우저 예제 (메트릭 타임슬라이스 데이터를 검색하는 방법)
). REST API는 Lite 브라우저 에이전트 스크립트만 반환합니다. 자세한 내용은 Lite, Pro 및 Pro+SPA 유형을 비교하는 이 표를 참조하세요.
경고 예 (경고 조건 생성 및 알림 채널 구성 등).