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 유형을 비교한 이 표를 참조하세요.
- 인프라 경고 예시
- 경고 예 (경고 조건 생성 및 알림 채널 구성 등).