• /
  • ログイン

New RelicのGraphQL APIであるNerdGraphの概要

NerdGraphは、New Relicデータにクエリを実行して、いくつかのNew Relic機能を設定できる当社のGraphQL形式のAPIです。

ヒント

API、および当社のその他のオブザーバビリティプラットフォームを使用するには、New Relicファミリーに参加してください。サインアップして、わずか数秒で無料アカウントを作成できます。次に、毎月最大100GBのデータを無料で取り込みます。期間無制限です。

NerdGraphとは

New Relicには、いくつかのAPIがあります。NerdGraphは、New Relicデータにクエリを実行して、特定の設定を実行するための推奨APIです(機能の詳細を確認する)。NerdGraphには、New RelicのさまざまなAPIおよびマイクロサービスからデータを返すための単一のAPIインタフェースがあります。NerdGraphには、時間経過とともに他の設定機能が追加される予定です。

重要

NerdGraphは、データ取り込みには使用しません。そのため、当社のデータ取り込みAPIを使用します。

NerdGraphは、フェッチするデータの過不足なしに必要なデータを正確に要求できるオープンソースAPI形式であるGraphQLを使用して構築されています。

NerdGraphの使い方については、この7分間のビデオをご覧ください。

さらにビデオチュートリアルをご覧になりたい方は、New Relic UniversityのNerdGraphの紹介にアクセスしてください。またはNew Relic APIのオンラインコースをご覧ください。

GraphiQLエクスプローラーを使用する

GraphQLの使用を開始するには、GraphQLを使用するためのオープンソースグラフィカルインタフェースであるGraphiQLエクスプローラーを使用することをお勧めします。これを使用すると、データスキーマを検索し、組み込みのオブジェクト定義を読み込み、クエリを構築して実行できます。

GraphQLを使用するには、ユーザーキーと呼ばれるユーザー固有のNew Relic APIキーが必要です。APIキーは、GraphiQLエクスプローラーで生成でき、APIキードロップダウンを使用して既存のキーを探すこともできます。

GraphiQLエクスプローラーの場所:

クエリを構築する方法のヒントについては、クエリの構築をご覧ください。

要件とエンドポイント

NerdGraphを使用するには、GraphiQLエクスプローラーで生成してアクセスできるNew Relicのユーザーキーが必要です。

エンドポイント:

  • メインエンドポイント: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 } }" } '

NerdGraphでできること:

NerdGraph機能は、主に以下の2つのカテゴリに分類できます。

  • New Relicデータにクエリを実行する。データは、プログラム的なワークフローで使用する、カスタマイズされたデータ可視化のためのNew Relic Oneアプリを構築するなどのさまざまな目的のためにフェッチできます。
  • New Relicの機能を設定する。現在、さまざまな設定を利用できますが、時間経過とともにさらに機能が追加されます。タグの追加、ワークロードの設定、「ゴールデンメトリクス」のカスタマイズなどを実行できます。

NerdGraphを使用すると、さまざまなNew Relicデータを返すことができますが、一般的な使用例に関するチュートリアルを作成しました。

トピック

チュートリアル

監視対象エンティティ

データにクエリを実行する

NRQLを使用するクエリ(NRQL:当社のクエリ言語)

タグ

タグを追加および管理する

ダッシュボード

アラート

アラートに関連するすべてのチュートリアルを表示する

応用インテリジェンス

トポロジを表示して設定する

ワークロード

ワークロードを表示して設定する

キーを管理する

キーを作成して管理する(データ取り込みに使用するライセンスキー、およびユーザーキー)

データを管理

ディストリビューティッド(分散)トレーシング

New Relic Oneアプリ

New Relic Oneアプリを構築する

クラウドインテグレーション(AWS、Azure、GCP)

クラウドインテグレーションを設定する

パートナーとリセラー

サブスクリプションを管理する元の価格設定プランを使用しているパートナーのみ)

データパーティション

データパーティションの管理

NerdGraphの用語

以下にGraphQLから派生する用語を示します(API形式NerdGraphが使用する用語)。

用語

定義

クエリとミューテーション

GraphQLの操作には、以下の2つのクラスがあります。

  • クエリは、データのフェッチにのみ使用する基本的な要求です。クエリは静的ではなく、必要に応じて要求するデータ量を加減できます。各クエリについて、スキーマでサポートされている限り、どのデータを取得するかを厳密に指定できます。
  • ミューテーションは、リソースの作成や設定の変更などのアクションを実行するための要求です。ミューテーションでは、キーワードmutationと、ミューテーションのnameが必要です。

タイプ

Data in GraphQLはタイプにまとめられます。タイプは、スカラー(文字列や数字、booleanなど)またはオブジェクトタイプとなります。

オブジェクトタイプは、一連のフィールドで構成されるカスタムタイプです。たとえば、Userと呼ばれるオブジェクトタイプは、システムのユーザーを表します。

フィールド

フィールドは、クエリを実行できるオブジェクトタイプの情報の断片を表します。フィールドは、スカラー、リスト、またはオブジェクトです。たとえば、Userオブジェクトタイプには、nameという文字列フィールドを指定できます。

インタフェース

インタフェースは、他のオブジェクトタイプが実装できる一連の一般的なフィールドを表す抽象型です。

GraphiQLエクスプローラーを使用する際のヒント

クエリは、NerdGraph GraphiQLエクスプローラーを使用して実行できます。エクスプローラーには、オートコンプリート、クエリ検証などのスキーマ定義や機能が組み込まれています。

その他のヘルプ

さらに支援が必要な場合は、これらのサポートと学習リソースを確認してください:

問題を作成するこのページを編集する
Copyright © 2020 New Relic Inc.