NerdGraph 탐색기 사용

NerdGraph는 데이터를 쿼리하고 New Relic 기능을 구성하기 위한 주요 API입니다.NerdGraph를 사용하고 API를 요청하는 인기 있는 방법 중 하나는 NerdGraph 탐색기를 사용하는 것입니다.

탐험가 찾기

NerdGraph 탐색기를 찾으려면:

• EU: New Relic 계정이 EU 데이터 센터 를 사용하는 경우 api.eu.newrelic.com/graphiql 로 이동합니다.
• EU 외부: 계정이 EU 외부인 경우 api.newrelic.com/graphiql 을 사용하십시오.

NerdGraph 탐색기란 무엇입니까?

NerdGraph API는 타사 쿼리 언어인 GraphQL을 사용하여 구축되었습니다.NerdGraph 탐색기는 GraphQL 요청을 형성하고 생성하기 위한 오픈 소스 그래픽 인터페이스인 GraphiQL을 사용하여 구축되었습니다.

NerdGraph 탐색기를 사용하여 데이터 스키마를 탐색하고 기본 제공 개체 정의를 읽고 쿼리를 작성 및 실행할 수 있습니다.

탐색기 사용 방법을 보여주는 짧은 비디오를 보려면 NerdGraph 소개를 참조하십시오.

시작하기 전에

여기에서 수업을 하기 전에 NerdGraph 소개를 검토했는지 확인하세요.

탐색기 로 이동하여 New Relic 사용자 ID와 암호를 사용하여 로그인합니다.

유효한 New Relic 사용자 키 가 있는지 확인하십시오.NerdGraph 탐색기에서 생성하거나 API 키 UI 에서 보고 생성할 수 있습니다.

다음으로 Explorer 사용 방법을 배우는 데 도움이 되는 몇 가지 단계를 안내해 드리겠습니다.

1단계. 이름을 검색하는 쿼리 작성

간단한 NerdGraph 쿼리부터 시작하겠습니다.New Relic 데이터베이스에서 귀하의 이름을 검색하십시오:

1. 쿼리 편집기에서 모든 항목을 지웁니다.
2. 쿼리 탐색기에서 actor , user , name 순서로 필드를 선택합니다.

이 GraphQL 스니펫은 편집기에 나타납니다.

{
  actor {
    user {
      name
    }
  }
}

2단계. 결과를 보려면 재생 버튼을 클릭하세요.

이 쿼리를 사용하면 NerdGraph에 이름을 검색하도록 지시합니다.user 필드 내에 중첩된 name 필드를 요청하고 있습니다.이는 API 키 를 소유한 사용자를 나타내며, 이는 차례로 actor 내에 중첩됩니다.

결과를 보려면 재생 버튼을 클릭하십시오. 요청과 거의 같은 모양입니다.쿼리 빌더의 모든 필드는 사용 가능한 모든 데이터 유형과 해당 속성을 설명하는 GraphQL 스키마를 구성합니다.각 필드에 대해 자세히 알아보려면 문서 버튼을 클릭하거나 편집기에서 필드 위로 마우스를 가져갑니다.

3단계. 쿼리에 필드 추가

이제 쿼리에 더 많은 필드를 추가할 수 있습니다.가장 간단한 방법은 쿼리 빌더에서 필드를 클릭하는 것입니다. 탐색기는 속성이 쿼리에서 어디로 가야 하는지 알고 있습니다.이 예에서는 계정 id 및 email 필드를 추가합니다.

쿼리를 실행하면 데이터를 과도하게 가져오거나 부족하게 하지 않고 필요한 데이터만 반환합니다.id 필드에는 인수가 있습니다. 인수 전달은 NerdGraph 쿼리를 사용자 정의하는 강력한 방법입니다.모든 필드와 개체에는 인수가 포함될 수 있으므로 여러 쿼리를 실행하는 대신 필요한 쿼리만 작성하면 됩니다.

{
  actor {
    user {
      name
      email
    }
    account(id: 12345678)
  }
}

4단계. 돌연변이 실험

GraphQL에서 돌연변이 는 객체를 생성, 업데이트 또는 삭제하여 데이터를 변경할 수 있는 부작용이 있는 쿼리를 실행하는 방법입니다(REST API에서는 일반적으로 CRUD 작업이라고 함).

첫 번째 돌연변이에 대한 준비가 되셨습니까?

1. 편집기에 있는 내용을 지웁니다.
2. 쿼리 빌더를 아래로 스크롤하여 mutation 을 확장합니다.
3. 다음 스크린샷에서 필드를 선택합니다.

이 경우 엔터티에 사용자 지정 태그를 추가하려고 합니다.편집자는 errors 을 선택하지 않으면 불평합니다. 변형에는 백엔드에서 작업이 수행된 방식을 알려주는 방법이 있어야 합니다(요청이 실패하면 null 응답이 발생함).

5단계. 터미널에서 NerdGraph 쿼리 시도

만족하는 NerdGraph 쿼리를 구축했으며 다른 곳에서 테스트하려고 한다고 가정해 보겠습니다.코드 준비 쿼리 및 변형을 캡처하려면:

1. 도구 메뉴를 선택합니다.
2. 쿼리를 curl 호출 또는 New Relic CLI 명령으로 복사합니다.

$
# curl version
$
curl https://api.newrelic.com/graphql \
>
  -H 'Content-Type: application/json' \
>
  -H 'API-Key: API_KEY_REDACTED' \
>
  --data-binary '{"query":"{\n  actor {\n    user {\n      name\n      email\n    }\n    account(id: 12345678)\n  }\n}\n", "variables":""}'
$

$
# New Relic CLI version
$
newrelic nerdgraph query '{
$
  actor {
$
    user {
$
      name
$
      email
$
    }
$
    account(id: 12345678)
$
  }
$
}
$
'

다음 단계

이제 NerdGraph 쿼리를 작성하고 테스트하는 기본 사항을 알았습니다. 하지만 이를 클라이언트 또는 서버 코드로 변환하는 방법은 무엇입니까?GraphQL 코드 생성기 와 같은 솔루션은 NerdGraph 쿼리를 구현을 위한 코드로 변환하는 데 도움이 될 수 있습니다.

쿼리 작성기에서 필드를 클릭하고 개체를 확장하여 더 복잡한 쿼리를 만들어 보십시오(변이는 계정에 변경 사항을 초래할 수 있으므로 주의).아래 섹션에서 몇 가지 예시 요청을 확인하세요.

NerdGraph에 대한 자세한 내용과 개발자 커뮤니티의 다른 프로젝트를 탐색하려면 Explorer의 Hub 게시물 을 확인하세요.

기타 예시 요청

다음은 도움이 될 수 있는 NerdGraph 요청의 몇 가지 다른 예입니다.

query {
   actor {
      account(id: YOUR_ACCOUNT_ID) {
         name
      }
   }
}

{
  "data": {
      "actor": {
         "account": {
            "name": "Data Nerd"
         }
      }
   }
}

query {
   actor {
      account(id: YOUR_ACCOUNT_ID) {
         name
         nrql(query: "SELECT * FROM Transaction") {
            results
         }
      }
      user {
         name
         id
      }
   }
}