NerdGraph API エクスプローラーのチュートリアル

NerdGraph API エクスプローラーをセットアップする

1. one.newrelic.com > All capabilities > Apps > NerdGraph API explorer [NerdGraph API エクスプローラー]に移動します。

2. API キーのドロップダウンで、既存の API ユーザー キー を選択するか、新しい API ユーザー キーを追加します。

   

自分の名前を取得するクエリを作成する

GraphQL API であなたの名前を検索するための簡単な NerdGraph クエリから始めましょう。

以下にデフォルトのクエリが表示されない場合は、クエリ エディターですべてを消去し、クエリ エクスプローラーで次のフィールドをこの順序で選択します: actor 、 user 、 name:

{
  actor {
    user {
      name
    }
  }
}

このクエリでは、NerdGraph に、 userフィールド内にネストされているnameフィールドを取得するように依頼しています。userフィールドはユーザー キーの所有者を参照し、 userはactor (API ユーザーのアクセス レベルを範囲とするすべてのデータへの最上位エントリ) 内にネストされています。

クエリを実行する

赤い Execute query [クエリの実行] ボタンをクリックします。結果はリクエストとほぼ同じ形状になることに注意してください。クエリ ビルダーのすべてのフィールドは、利用可能なすべてのデータ型とその属性を記述する GraphQL スキーマを構成します。各フィールドの詳細を確認するには、フィールドの横にある虫眼鏡アイコンをクリックします。

クエリにフィールドを追加する

ここで、クエリにさらにフィールドを追加してみることができます。最も簡単な方法は、クエリ ビルダーでフィールドをクリックすることです。エクスプローラーは、クエリ内のどこに属性を配置するかを知っています。この例では、次のフィールドを追加します。

• アカウント id (左下隅にある自分の名前をクリックし、 API Keys [API キー]をクリックすると、この値を見つけることができます)

• email

  クエリを実行すると、データのオーバーフェッチやアンダーフェッチを行わずに、必要なデータのみが返されます。id フィールドには引数があることに注意してください。引数を渡すことは、NerdGraph クエリをカスタマイズする強力な方法です。すべてのフィールドとオブジェクトには引数を含めることができるため、複数のクエリを実行する代わりに、必要なクエリを作成するだけで済みます。

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

  コピー

突然変異を実験する

GraphQLでは、ミューテーションは、オブジェクトを作成、更新、または削除することでデータを変更できる副作用のあるクエリを実行する方法です（REST APIでは、これらは一般にCRUD操作と呼ばれます）。

最初の突然変異の準備はできていますか？

1. エディターの内容を消去します。

2. クエリビルダーを下にスクロールして、 mutationを展開します。

3. tagging まで下にスクロールし、 taggingAddTagsToEntityを選択します。

4. 次のフィールドを選択します。

   • guid!: (これを見つけるには、 All entities [すべてのエンティティ] を開き、エンティティ レコードの ... アイコンをクリックし、 See metadata & tags [メタデータとタグの表示] をクリックします。)

   • tags!:

     • key!:
     • values:

   • エラー

     • メッセージ
     • タイプ
   

   この場合、エンティティにカスタム タグを追加します。errorsを選択しない場合、エディターはエラーを表示します。ミューテーションには、バックエンドで操作がどのように実行されたかを伝える方法が必要です (リクエストが失敗すると null 応答が返されます)。

   ヒント

   RESTとは異なり、NerdGraphのようなGraphQLAPIは部分的な応答を返すことができます。たとえば、複数のエンティティにタグを追加しようとすると、一部のミューテーションが失敗し、他のミューテーションが成功する可能性があります。取得したGraphQL応答にすべてが記録されます。

ターミナルで NerdGraph クエリを試してください

満足のいくNerdGraphクエリを作成し、それを他の場所でテストしたいとします。コード対応のクエリとミューテーションをキャプチャするには：

1. [ツール]メニューを選択します。

2. クエリをcurl呼び出しまたはNewRelicCLIコマンドとしてコピーします。

   
   bash

   コピー

   $
   # 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)
   $
     }
   $
   }'