NerdGraph 는 New Relic 데이터를 쿼리하고 일부 New Relic 기능을 구성할 수 있는 GraphQL 형식 API입니다. 무료 New Relic 계정에 가입 하고 모니터링 서비스를 설치 한 후 NerdGraph를 시작할 수 있습니다.
너드그래프란?
New Relic에는 여러 API 가 있습니다. NerdGraph는 New Relic 데이터를 쿼리하고 일부 특정 구성을 수행하는 데 권장하는 API입니다( 기능에 대해 자세히 알아보기 ). NerdGraph는 New Relic의 다양한 API 및 마이크로서비스에서 데이터를 반환하기 위한 단일 API 인터페이스를 제공합니다. 시간이 지나면서 다른 구성 기능이 NerdGraph에 추가될 것입니다.
중요
NerdGraph는 데이터 수집에 사용되지 않습니다. 이를 위해 데이터 수집 API 를 사용합니다.
NerdGraph는 오버페칭이나 언더페칭 없이 필요한 데이터를 정확히 요청할 수 있는 오픈 소스 API 형식인 GraphQL 을 사용하여 구축되었습니다.
다음은 NerdGraph 탐색기 에서 NerdGraph를 사용하는 방법을 소개하는 짧은 비디오입니다.
더 많은 비디오 자습서를 보고 싶으십니까? New Relic University의 NerdGraph 소개로 이동 합니다. 또는 New Relic APIs에 대한 온라인 과정을 참조하십시오.
요구 사항 및 끝점
NerdGraph 요구 사항에 대한 참고 사항:
- NerdGraph에는 New Relic 사용자 키 가 필요합니다. 이것은 GraphiQL 탐색기 에서 생성하고 액세스할 수 있습니다.
- 사용자 유형 및 할당된 역할은 NerdGraph 권한에 영향을 줄 수 있습니다. 자세한 내용은 액세스에 영향을 미치는 요소 를 참조하십시오.
NerdGraph 엔드포인트는 다음과 같습니다.
- 메인 엔드포인트:
https://api.newrelic.com/graphql
- EU 데이터 센터를 사용하는 계정의 엔드포인트:
https://api.eu.newrelic.com/graphql
엔드포인트에 액세스하려면 다음 cURL 명령을 사용합니다.
curl -X POST https://api.newrelic.com/graphql \
-H 'Content-Type: application/json' \
-H 'API-Key: YOUR_NEW_RELIC_USER_KEY' \
-d '{ "query": "{ requestContext { userId apiKey } }" } '
GraphiQL 탐색기 사용
GraphQL 사용을 시작하려면 NerdGraph 탐색기를 사용하는 것이 좋습니다.탐색기를 찾고 사용하는 방법은 NerdGraph 탐색기 자습서 를 참조하십시오.
NerdGraph 기능
NerdGraph 기능은 두 가지 주요 범주로 나눌 수 있습니다.
- 데이터 쿼리. 프로그래밍 방식의 워크플로에서 데이터를 사용하거나 맞춤형 데이터 시각화를 위한 New Relic 앱 을 구축하는 등 다양한 목적으로 데이터를 가져올 수 있습니다.
- 기능 구성. 다양한 구성을 사용할 수 있으며 시간이 지나면 더 많이 추가될 것입니다. 태그 추가, 워크로드 구성 또는 "골든 메트릭" 사용자 지정과 같은 작업을 수행할 수 있습니다.
NerdGraph를 사용하여 광범위한 데이터를 반환하고 구성할 수 있습니다. NerdGraph가 무엇을 할 수 있는지 확인하는 한 가지 방법은 쿼리 작성을 시작하고 NerdGraph 탐색기 를 사용하여 스키마를 탐색하는 것입니다.
다음은 가장 일반적으로 사용되는 NerdGraph 기능 중 일부입니다.
사용 가능한 모든 NerdGraph 문서는 다음과 같습니다.
주제 | 튜토리얼 |
---|---|
계정 관리 | |
경고 |
|
APM 에이전트 | |
차트 및 대시보드 | |
클라우드 통합(AWS, Azure, GCP) | |
데이터 관리 | |
분산 추적 | |
엔티티 |
|
로그 관리 | |
New Relic 앱 | |
파트너 및 리셀러 | 구독 관리 ( 원래 가격 책정 모델 을 사용하는 파트너만 해당) |
서비스 수준 | |
합성 모니터링 | |
태그 | |
워크로드 |
NerdGraph 용어
다음은 NerdGraph가 사용하는 API 형식인 GraphQL에서 유래한 용어입니다.
용어 | 정의 |
---|---|
쿼리 및 돌연변이 | GraphQL 작업에는 두 가지 클래스가 있습니다. |
유형 | GraphQL의 데이터는 유형으로 구성됩니다. 유형은 스칼라 (문자열, 숫자 또는 부울과 같은) 또는 객체 유형일 수 있습니다. 개체 유형 은 필드 모음으로 구성된 사용자 정의 유형입니다. 예를 들어, |
들 | 필드 는 쿼리할 수 있는 개체 유형에 대한 정보를 나타냅니다. 필드는 스칼라, 목록 또는 개체일 수 있습니다. 예를 들어, |
상호 작용 | 인터페이스 는 다른 객체 유형이 |