NerdGraph 소개: GraphQL API | New Relic Documentation

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 명령을 만들 수 있습니다.

bash

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

주제	튜토리얼
계정 관리	계정 관리 사용자 관리 사용자 그룹 관리 API 키(데이터 인제스트 키 및 사용자 키) 생성 및 관리
알림	뉴렐릭 알림의 경우: 모든 알림 관련 튜토리얼 참조 응용 인텔리전스의 경우: 인시던트의 상호 연관을 위한 토폴로지 구성
에이전트	APM 에이전트 설정
브라우저 모니터링	브라우저 에이전트 설치 및 모니터링 구성 npm 패키지를 사용하여 여러 앱 계측
변경 추적	NerdGraph를 사용한 변경 사항 추적 CLI를 사용한 변경 사항 추적
대시보드	대시보드 생성 및 관리 대시보드: 차트 및 위젯 대시보드를 다른 계정으로 내보내기 대시보드를 파일로 내보내기 외부 공유 대시보드 관리
클라우드 통합(AWS, Azure, GCP)	클라우드 통합 설정
데이터 관리	이벤트 데이터를 메트릭 데이터로 변환 데이터 보관 스트리밍 데이터 내보내기 데이터 삭제
분산 추적	분산 추적 데이터 쿼리 Infinite Tracing 설정
엔터티	모니터링된 엔터티에 대한 데이터 가져오기 엔터티 관계 및 종속성 이해 (서비스 맵 구축에 사용) ‘골든 메트릭’ 쿼리 및 구성 (중요 엔터티 메트릭)
로그 관리	로그 데이터 파티션 관리 로그 구문 분석 규칙 관리 난독화 표현식 및 규칙 관리
모바일 모니터링	새 모바일 앱 생성 애플리케이션 토큰 검색 모바일 모니터링 구성의 예
뉴렐릭 앱	뉴렐릭 앱 구축하기
파트너 및 리셀러	서브스크립션 관리(기존 요금 모델을 사용하는 파트너만 해당)
쿼리 및 차트	데이터의 NRQL 쿼리 실행 여러 계정에서 쿼리 실행 비동기, 장기 실행 쿼리
서비스 레벨	서비스 레벨 구성 및 관리
신세틱 모니터링	모니터 관리
태그	태그 추가 및 관리
Workloads	워크로드 보기 및 구성

NerdGraph 용어

다음은 NerdGraph가 사용하는 API 포맷인 GraphQL에서 사용되는 용어입니다.

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