NerdGraph는 뉴렐릭 데이터를 쿼리하고 일부 뉴렐릭 기능을 구성할 수 있는 GraphQL 포맷 API입니다. 무료 뉴렐릭 계정을 신청하고 모니터링 서비스를 설치한 후 NerdGraph를 시작할 수 있습니다.
NerdGraph란?
NerdGraph는 여러 뉴렐릭 API 중 하나입니다. NerdGraph는 뉴렐릭 데이터를 쿼리하고 일부 특정 구성을 수행하는 데 권장되는 API입니다. (기능에 대해 자세히 알아보십시오.) NerdGraph는 뉴렐릭의 다양한 API 및 마이크로서비스에서 데이터를 반환하기 위한 단일 API 인터페이스를 제공합니다. 시간이 지남에 따라 다른 구성 기능들이 NerdGraph에 추가될 예정입니다.
중요
NerdGraph는 데이터 인제스트에 사용되지 않습니다. 이를 위해서는 데이터 인제스트 API를 사용해야 합니다.
NerdGraph는 오버페칭이나 언더페칭 없이 필요한 데이터를 정확히 요청할 수 있는 오픈소스 API 포맷인 GraphQL을 사용하여 구축되었습니다.
NerdGraph에 대한 비디오 튜토리얼을 보길 원하시면, New Relic University의 Intro to NerdGraph로 이동하거나 뉴렐릭 API에 대한 온라인 과정을 확인하십시오.
요구 사항
시작하기 전에:
뉴렐릭 계정이 있어야
쿼리 및 변형을 포함하는 데 필요한 API에 액세스할 수 있습니다.
사용자 유형 및 할당된 역할은 NerdGraph 권한에 영향을 줄 수 있습니다. 보다 자세한 내용은 액세스에 영향을 미치는 요소를 참조하십시오.
엔드포인트
사용 가능한 API 엔드포인트는 데이터센터가 위치한 지역에 따라 다릅니다.
- 메인 엔드포인트:
https://api.newrelic.com/graphql
- EU 데이터 센터를 사용하는 계정의 엔드포인트:
https://api.eu.newrelic.com/graphql
엔드포인트에 액세스하려면 코드에서 호출하거나, NerdGraph API 탐색기를 사용하거나, 다음과 유사한 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 } }" }'
NerdGraph API 탐색기 사용
NerdGraph API를 시험 사용하는 손쉬운 방법은 NerdGraph API 탐색기를 사용하는 것입니다. 이 도구를 시작하는 데 도움이 필요하면 NerdGraph API 탐색기 튜토리얼을 참조하십시오.
NerdGraph 기능
NerdGraph 기능은 두 가지 주요 카테고리로 나눌 수 있습니다.
- 쿼리 데이터. 프로그래매틱 방식의 워크플로우에서 사용하거나 커스텀 데이터 시각화를 위해 뉴렐릭 앱을 구축하는 등 다양한 목적으로 데이터를 가져올 수 있습니다.
- 기능 구성 다양한 구성을 사용할 수 있으며, 앞으로 더 많은 구성이 추가될 예정입니다. 태그 추가, 워크로드 구성 또는 ‘골든 메트릭’ 맞춤화 등의 작업을 수행할 수 있습니다.
NerdGraph를 사용하여 광범위한 데이터를 반환하고 구성할 수 있습니다. NerdGraph가 무엇을 할 수 있는지 확인하는 한 가지 방법은 쿼리 작성을 시작하고 NerdGraph 탐색기를 사용하여 스키마를 탐색하는 것입니다.
다음은 가장 일반적으로 사용되는 NerdGraph 기능 중 일부입니다.
제공되는 모든 NerdGraph 문서는 다음과 같습니다.
주제 | 튜토리얼 |
---|---|
계정 관리 | |
알림 |
|
에이전트 | |
브라우저 모니터링 | |
변경 추적 | |
대시보드 | |
클라우드 통합(AWS, Azure, GCP) | |
데이터 관리 | |
분산 추적 | |
엔터티 |
|
로그 관리 | |
모바일 모니터링 | |
뉴렐릭 앱 | |
파트너 및 리셀러 | |
쿼리 및 차트 | |
서비스 레벨 | |
신세틱 모니터링 | |
태그 | |
Workloads |
NerdGraph 용어
다음은 NerdGraph가 사용하는 API 포맷인 GraphQL에서 사용되는 용어입니다.
용어 | 정의 |
---|---|
쿼리 및 뮤테이션 | GraphQL 연산에는 두 가지 클래스가 있습니다.
|
Type | GraphQL의 데이터는 유형별로 정리됩니다. 유형은 스칼라(문자열, 숫자 또는 부울 등) 또는 객체 유형일 수 있습니다. 객체 유형은 필드 모음으로 구성된 커스텀 유형입니다. 예를 들어, |
필드 | 필드는 쿼리할 수 있는 객체 유형에 대한 정보를 나타냅니다. 필드는 스칼라, 목록 또는 객체일 수 있습니다. 예를 들어, |
인터페이스 | 인터페이스는 다른 객체 유형이 |