• /
  • ログイン
  • 無料アカウント

New Relic NerdGraphの概要

NerdGraphは、New RelicのGraphQLフォーマットAPIです。NerdGraphは、効率的で柔軟なクエリ言語で、フェッチの過不足なしに、必要なデータのみをリクエストできます。一般的なREST APIであれば複数のURLからロードする必要があるものの、NerdGraphコールは単一のリクエストですべてのデータを取得できます。また、NerdGraphは、APIを経時的に進化させて、強力な開発者ツールとなります。

ヒント

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

NerdGraph GraphiQLエクスプローラーを使用

スキーマを調査し、定義を見つけ、呼び出しを形成できるGraphiQLエクスプローラーがあります。エクスプローラーを使用するには:

  1. New Relicユーザーキーが必要です。
  2. api.newrelic.com/graphiql にアクセスします(EUにNew Relicデータがある場合は、api.eu.newrelic.com/graphiqlを使用してください)

要件とエンドポイント

NerdGraphを使用するには、New Relicユーザーキーが必要です。

NerdGraphエンドポイント:

  • 主要なエンドポイント:https://api.newrelic.com/graphql
  • EUエンドポイント: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を使用して、次のことを行えます:

機能性

チュートリアル

アカウントに関連するすべてのエンティティをクエリする。

エンティティチュートリアルを参照してください。

御社のアカウントに関連するワークロードのクエリ、作成、および更新を行います。

ワークロードのチュートリアルをご覧ください。

タグを作成、管理し、エンティティに追加する。

詳細と例についてはタグ作成チュートリアルを参照してください。

ディストリビューティッド(分散)トレーシングデータのクエリを行う。

トレースデータのチュートリアルを参照してください。

New Relic Oneアプリを構築する際にデータをフェッチする。

New Relic Oneアプリのデータクエリおよびミューテーションを参照してください。

サービスとのアップストリームとダウンストリームの関係を理解する。

関係チュートリアルを参照してください。

New Relicクラウドインテグレーションを設定します。

クラウドインテグレーションの例を参照してください。

NRQLを使用してイベントデータをクエリします。

NRQLチュートリアルを参照してください。

NerdGraphについてのビデオチュートリアルを見る。

New Relic University チュートリアル New Relic NerdGraphの説明にアクセスします。または、完全なオンラインコースのNew Relic APIにアクセスしてください。

NerdGraphテクノロジー

New Relic GraphQLサーバーは、NerdGraphのグラフ構造を明示的に定義します。次のキーワードは、すべてのGraphQLサーバーに共通しています。このキーワードを使用して、独自のクエリを構築し理解に役立ててください。さらに、以下の手順に従います。

用語

定義

クエリ

クエリとは、追加のアクションなしにデータのみをフェッチするための、基本的なリクエストです。NerdGraph GraphiQLエクスプローラーでのクエリは静的ではありません。つまり、ニーズに応じて、求めるデータの量を加減することができます。各クエリについて、スキーマでサポートされている限り、どのデータを取得するかを厳密に指定できます。

ミューテーション

ミューテーションとは、データの作成やサーバーでのデータ更新など、アクションを追加するためのリクエストです。ミューテーションでは、キーワードmutationと、ミューテーションのnameが必要です。

種類

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

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

フィールド

フィールドは、クエリを行えるオブジェクトタイプについての一片の情報を表します。フィールドとしては、スカラーやリスト、オブジェクトがあります。たとえば、Userオブジェクトは、nameと呼ばれる文字列フィールドを有することができます。

インタフェース

インタフェースとは、その他のオブジェクトタイプがimplement可能な一連の一般的なフィールドを表す抽象型です。

エクスプローラーを使用してクエリを行う

NerdGraph GraphiQL エクスプローラーを使用して、クエリを行うことができます。エクスプローラーは、自動完了およびクエリ検証を含む、組み込み型のスキーマ定義と機能を備えています。

GraphQLで、New Relicのデータのグラフ構成で特定の情報を尋ねます。グラフのノードに従い、希望するデータそのもののクエリを行えます。

新規フィールドがシームレスに追加され、古いフィールドには非推奨として印が付けられ、ドキュメントから削除され、最終的にはそのフィールドを円満にシャットダウンできます。

その他のヘルプ

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

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