• EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

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

문제 신고

REST API(v2) 사용 방법

New Relic의 REST API를 사용하면 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

$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 유형을 비교하는 이 표를 참조하세요.

  • 인프라 경고 예시

  • 경고 예 (경고 조건 생성 및 알림 채널 구성 등).

Copyright © 2024 New Relic Inc.

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