• 로그인지금 시작하세요

뉴렐릭의 GraphQL API인 뉴렐릭 NerdGraph 정보

NerdGraph는 뉴렐릭 데이터를 쿼리하고 일부 뉴렐릭 기능을 구성할 수 있도록 해주는 GraphQL 포맷 API입니다. 무료 뉴렐릭 계정을 신청하고 모니터링 서비스를 설치한 후 NerdGraph를 시작할 수 있습니다.

NerdGraph란?

뉴렐릭에는 여러 API가 있습니다. NerdGraph는 뉴렐릭 데이터를 쿼리하고 일부 특정 구성을 수행하는 데 권장되는 API입니다. (기능에 대해 자세히 알아보십시오.) NerdGraph는 뉴렐릭의 다양한 API와 마이크로서비스에서 데이터를 반환하기 위한 단일 API 인터페이스를 제공합니다. 향후 여러 다른 구성 기능이 NerdGraph에 추가될 예정입니다.

중요

NerdGraph는 데이터 인제스트에 사용되지 않습니다. 이를 위해서는 데이터 인제스트 API를 사용해야 합니다.

NerdGraph는 오버페칭이나 언더페칭 없이 필요한 데이터를 정확히 요청할 수 있는 오픈소스 API 포맷인 GraphQL을 사용하여 구축되었습니다.

다음은 NerdGraph 탐색기와 함께 NerdGraph를 사용하는 방법을 소개하는 짧은 비디오입니다.

더 많은 비디오 튜토리얼을 보길 원하시면 New Relic University의 NerdGraph 소개를 확인하시거나 뉴렐릭 API에 대한 온라인 과정을 참조하십시오.

요구 사항 및 엔드포인트

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 기능은 두 가지 주요 카테고리로 나눌 수 있습니다.

  • 쿼리 데이터. 프로그래매틱 방식의 워크플로우에서 사용하거나 커스텀 데이터 시각화를 위해 뉴렐릭 앱을 구축하는 등 다양한 목적으로 데이터를 가져올 수 있습니다.
  • 기능 구성 다양한 구성을 사용할 수 있으며, 앞으로 더 많은 구성이 추가될 예정입니다. 태그 추가, 워크로드 구성 또는 ‘골든 메트릭’ 맞춤화 등의 작업을 수행할 수 있습니다.

NerdGraph를 사용하여 광범위한 데이터를 반환하고 구성할 수 있습니다. NerdGraph가 무엇을 할 수 있는지 확인하는 한 가지 방법은 쿼리 작성을 시작하고 NerdGraph 탐색기를 사용하여 스키마를 탐색하는 것입니다.

다음은 가장 일반적으로 사용되는 NerdGraph 기능 중 일부입니다.

제공되는 모든 NerdGraph 문서는 다음과 같습니다.

주제

튜토리얼

계정 관리

알림

APM 에이전트

APM 에이전트 설정

차트 및 대시보드

클라우드 통합(AWS, Azure, GCP)

클라우드 통합 설정

데이터 관리

분산 추적

엔터티

로그 관리

뉴렐릭 앱

뉴렐릭 앱 구축하기

파트너 및 리셀러

서브스크립션 관리(기존 요금 모델을 사용하는 파트너만 해당)

서비스 레벨

서비스 레벨 구성 및 관리

신세틱 모니터링

모니터 관리

태그

태그 추가 및 관리

Workloads

워크로드 보기 및 구성

NerdGraph 용어

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

용어

정의

쿼리 및 뮤테이션

GraphQL 연산에는 두 가지 클래스가 있습니다.

  • 쿼리는 데이터를 가져오는 데만 사용되는 기본 요청입니다. 이러한 쿼리는 고정된 것이 아닙니다. 즉, 필요에 따라 더 많은 데이터 또는 더 적은 데이터를 요청할 수 있습니다. 스키마에서 지원만 된다면, 각 쿼리에 대해 검색하려는 데이터를 정확히 지정할 수 있습니다.
  • 뮤테이션(Mutations)은 리소스 생성 또는 구성 변경 같은 작업을 수행하는 요청입니다. 뮤테이션은 mutation 키워드와 뮤테이션의 name이 필요합니다.

Type

GraphQL의 데이터는 유형별로 정리됩니다. 유형은 스칼라(문자열, 숫자 또는 부울 등) 또는 객체 유형일 수 있습니다.

객체 유형은 필드 모음으로 구성된 커스텀 유형입니다. 예를 들어, User라는 객체 유형은 시스템의 사용자를 나타낼 수 있습니다.

필드

필드는 쿼리할 수 있는 객체 유형에 대한 정보를 나타냅니다. 필드는 스칼라, 목록 또는 객체일 수 있습니다. 예를 들어, User 객체 유형에는 name이라는 문자열 필드가 있을 수 있습니다.

인터페이스

인터페이스는 다른 객체 유형이 implement 할 수 있는 공통 필드 모음을 나타내는 추상 유형입니다.

Copyright © 2022 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.