GraphQL API인 New Relic NerdGraph 소개

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 문서는 다음과 같습니다.

주제	튜토리얼
계정 관리	계정 관리 사용자 그룹 및 액세스 권한 관리 API 키(데이터 수집 키 및 사용자 키) 생성 및 관리
경고	New Relic 경고의 경우: 모든 경고 관련 자습서를 참조하십시오. 응용 인텔리전스: 인시던트 상관 관계를 위한 토폴로지 구성
APM 에이전트	APM 에이전트 구성
차트 및 대시보드	NRQL(저희 쿼리 언어)을 사용하여 데이터 쿼리 대시보드 만들기 대시보드를 다른 계정으로 내보내기 대시보드를 파일로 내보내기 외부 공유 대시보드 관리
클라우드 통합(AWS, Azure, GCP)	클라우드 통합 구성
데이터 관리	이벤트 데이터를 메트릭 데이터로 변환 데이터 보존 데이터 삭제
분산 추적	분산 추적 데이터 쿼리 무한 추적 구성
엔티티	모니터링 대상에 대한 데이터 가져오기 엔터티 관계 및 종속성 이해 (서비스 맵 구축에 사용) "골든 메트릭" 쿼리 및 구성 (중요 엔터티 메트릭)
로그 관리	데이터 파티션 관리 로그 구문 분석 규칙 관리 난독화 표현 및 규칙 관리
New Relic 앱	New Relic 앱 빌드
파트너 및 리셀러	구독 관리 ( 원래 가격 책정 모델 을 사용하는 파트너만 해당)
서비스 수준	서비스 수준 구성 및 관리
합성 모니터링	모니터 관리
태그	태그 추가 및 관리
워크로드	워크로드 보기 및 구성

NerdGraph 용어

다음은 NerdGraph가 사용하는 API 형식인 GraphQL에서 유래한 용어입니다.

용어	정의
쿼리 및 돌연변이	GraphQL 작업에는 두 가지 클래스가 있습니다. 쿼리 는 데이터를 가져오는 데만 사용되는 기본 요청입니다. 이러한 쿼리는 정적이 아니므로 필요에 따라 더 많은 데이터 또는 더 적은 데이터를 요청할 수 있습니다. 각 쿼리에 대해 스키마 에서 지원하는 한 검색하려는 데이터를 정확히 지정할 수 있습니다. 변형 은 리소스 생성 또는 구성 변경과 같은 작업을 수행하는 요청입니다. 돌연변이에는 `mutation` 키워드와 돌연변이의 `name` 가 필요합니다.
유형	GraphQL의 데이터는 유형으로 구성됩니다. 유형은 스칼라 (문자열, 숫자 또는 부울과 같은) 또는 객체 유형일 수 있습니다. 개체 유형 은 필드 모음으로 구성된 사용자 정의 유형입니다. 예를 들어, `User` 이라는 객체 유형은 시스템의 사용자를 나타낼 수 있습니다.
들	필드 는 쿼리할 수 있는 개체 유형에 대한 정보를 나타냅니다. 필드는 스칼라, 목록 또는 개체일 수 있습니다. 예를 들어, `User` 객체 유형에는 `name` 이라는 문자열 필드가 있을 수 있습니다.
상호 작용	인터페이스 는 다른 객체 유형이 `implement` 할 수 있는 공통 필드 모음을 나타내는 추상 유형입니다.