NerdGraph는 뉴렐릭 데이터를 쿼리하고 일부 뉴렐릭 기능을 구성할 수 있는 GraphQL 포맷 API입니다. 무료 뉴렐릭 계정을 신청하고 모니터링 서비스를 설치한 후 NerdGraph를 시작할 수 있습니다.
너드그래프란?
NerdGraph는 여러 뉴렐릭 API 중 하나입니다. NerdGraph는 뉴렐릭 데이터를 쿼리하고 일부 특정 구성을 수행하는 데 권장되는 API입니다. (기능에 대해 자세히 알아보십시오.) NerdGraph는 뉴렐릭의 다양한 API 및 마이크로서비스에서 데이터를 반환하기 위한 단일 API 인터페이스를 제공합니다. 시간이 지남에 따라 다른 구성 기능들이 NerdGraph에 추가될 예정입니다.
중요
NerdGraph는 데이터 수집에 사용되지 않습니다. 이를 위해 데이터 수집 API 를 사용합니다.
NerdGraph는 오버페칭이나 언더페칭 없이 필요한 데이터를 정확히 요청할 수 있는 오픈 소스 API 형식인 GraphQL 을 사용하여 구축되었습니다.
요구 사항
시작하기 전에:
- 뉴렐릭 계정이 필요하며 해당 계정을 사용하면 쿼리 및 변형에 포함해야 하는 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 기능은 두 가지 주요 범주로 나눌 수 있습니다.
- Querying data. 프로그래밍 방식의 워크플로우에서 사용하거나 사용자 지정 데이터 시각화를 위한 뉴렐릭 앱을 구축하는 등 다양한 목적으로 데이터를 가져올 수 있습니다.
- Configuring features. 다양한 설정을 사용할 수 있으며 시간이 지남에 따라 더 많은 설정이 추가될 예정입니다. 태그 추가, 워크로드 구성, "골든 메트릭" 사용자 지정 등의 작업을 수행할 수 있습니다.
NerdGraph를 사용하여 광범위한 데이터를 반환하고 구성할 수 있습니다. NerdGraph가 무엇을 할 수 있는지 확인하는 한 가지 방법은 쿼리 작성을 시작하고 NerdGraph 탐색기를 사용하여 스키마를 탐색하는 것입니다.
다음은 가장 일반적으로 사용되는 NerdGraph 기능 중 일부입니다.
사용 가능한 모든 NerdGraph 문서는 다음과 같습니다.
주제 | 튜토리얼 |
|---|---|
계정 관리 | |
경고 |
|
에이전트 | |
변경 추적 | |
대시보드 | |
클라우드 통합(AWS, Azure, GCP) | |
데이터 관리 | |
분산 추적 | |
엔티티 |
|
로그 관리 | |
모바일 모니터링 | |
New Relic 앱 | |
쿼리 및 차트 | |
서비스 수준 | |
합성 모니터링 | |
태그 | |
워크로드 |
NerdGraph 용어
다음은 NerdGraph가 사용하는 API 형식인 GraphQL에서 유래한 용어입니다.
용어 | 정의 |
|---|---|
쿼리 및 돌연변이 | GraphQL 작업에는 두 가지 클래스가 있습니다. |
유형 | GraphQL의 데이터는 유형으로 구성됩니다. 유형은 스칼라 (문자열, 숫자 또는 부울과 같은) 또는 객체 유형일 수 있습니다. 개체 유형 은 필드 모음으로 구성된 사용자 정의 유형입니다. 예를 들어, |
들 | 필드 는 쿼리할 수 있는 개체 유형에 대한 정보를 나타냅니다. 필드는 스칼라, 목록 또는 개체일 수 있습니다. 예를 들어, |
상호 작용 | 인터페이스 는 다른 객체 유형이 |