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

New Relic NerdGraph GraphiQL explorer を使用して、 New Relic Query Language (NRQL) クエリを作成することができます。これらのクエリの作成方法やレスポンスを確認するには、 api.newrelic.com/graphiql にある NerdGraph GraphiQL エクスプローラーをご利用ください。このドキュメントでは、NRQL クエリで利用可能な関数の一部を説明しています。

NerdGraphを介して行われるNRQLクエリは、 NRQL Query Rate Limits の対象となります。

NerdGraphでの基本的なNRQLクエリ

NerdGraphを使用してNRQLクエリを作成するには、次のようにします。

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

たとえば、過去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 エクスプローラーを使って、クエリを試してみましょう。

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

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

{
   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"
            }
         }
      }
   }
}

埋め込みチャートのURLを標準的なHTTPクライアントで表示すると、送信したクエリに対するレスポンスを視覚化したイメージが返されます。これらのチャートは、他の場所で作成された埋め込みチャートと同じ 埋め込みチャートのルール に従います。データ可視化のスタイルを変更するには、 chartType 引数を embeddedChartUrl に渡します。

提案されたファセット

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

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

{
   "data": {
      "actor": {
         "account": {
            "nrql": {
               "suggestedFacets": [
                  "attributes": ["host"]
               ]
            }
         }
      }
   }
}