• ログイン今すぐ開始

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

NerdGraphチュートリアル。NRQLを使ってデータを照会する

NerdGraph APIを使用して、 NRQLクエリを作成できます。

NerdGraphを使用して行われたNRQLクエリには、 NRQLクエリの制限が適用されます。

NerdGraphでの基本的なNRQLクエリ

NerdGraphを使用して基本的なNRQLクエリを作成するには:

  1. api.newrelic.com/graphiqlでNerdGraphエクスプローラーにアクセスします。
  2. NRQLクエリを文字列引数としてNRQLオブジェクトに渡し、NerdGraphクエリにresultsフィールドを含めます。

たとえば、過去1時間のすべての トランザクションイベント のカウントを取得するには、次のクエリを使用します。

{
   actor {
      account(id: YOUR_ACCOUNT_ID) {
         nrql(query: "SELECT count(*) FROM Transaction SINCE 1 HOUR AGO") {
            results
         }
      }
   }
}

このNerdGraphのクエリの例では、次のような結果が得られます。

{
   "data": {
      "actor": {
         "account": {
            "nrql": {
               "results": [
                 {
                  "count": 1000
                 }
                ]
            }
         }
      }
   }
}

カウントの実際の値は、お使いのトランザクションデータによって異なります。NerdGraph GraphiQL エクスプローラーを使って、クエリを試してみましょう。

埋め込み可能なチャートの作成

生データを返すことに加えて、アプリケーションで使用するデータの埋め込み可能なグラフリンクをフェッチできます。たとえば、 トランザクションの単一のカウントの代わりに、時間の経過に伴うバケット化されたカウントの時系列を示すグラフを作成できます。embeddedChartUrlを使用してクエリにTIMESERIESを追加します:

{
   actor {
      account(id: YOUR_ACCOUNT_ID) {
         nrql(query: "SELECT count(*) from Transaction TIMESERIES") {
            embeddedChartUrl
         }
      }
   }
}

このNerdGraphのクエリ例では、チャートのURLを次のようなレスポンスで返しています。

{
   "data": {
      "actor": {
         "account": {
            "nrql": {
               "embeddedChartUrl": "https://chart-embed.service.newrelic.com/charts/EMBEDDABLE-CHART-ID"
            }
         }
      }
   }
}

標準のHTTPクライアントを使用して埋め込みグラフのURLを表示すると、送信したクエリへの応答を視覚化した画像が返されます。これらのグラフは、他の場所で作成された埋め込みグラフと同じ埋め込みグラフのルールに従います。データ視覚化のスタイルを変更するには、 chartType引数をembeddedChartUrlに渡します。

提案されたファセット

NerdGraphを使用してデータを探索する場合、 suggestedFacetsフィールドを使用して、 ファセットNRQLクエリで使用するための推奨属性を返すことができます。

実行時間の長いクエリ

実行時間の長いNRQLクエリを実行する必要がある場合は、非同期クエリを参照してください。

Copyright © 2022 New Relic株式会社。

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