NRQL 入門チュートリアル: データのロックを解除する

クエリビルダーで開始するのに最適な場所は、New Relic APM によって収集されたTransactionと呼ばれる NRDB の単一のイベントタイプを調べることです。すべての NRQL クエリにはSELECT } 句とFROM句が必要です。データをSELECTし、そのデータがFROMである場所を指定する必要があります。Transactionイベント タイプからすべてを選択する次の基本的なクエリから始めます。

SELECT *
FROM Transaction

これにより、タイムスタンプと属性のコレクションを含む多くの結果が返されます。今のところ、必要な結果は 1 つだけなので、 LIMIT 1を使用して結果を 1 つのレコードに制限できます。

SELECT *
FROM Transaction
LIMIT 1

これで、結果のボリュームを制御する方法ができました。しかし、すべての属性が必要ない場合はどうすればよいでしょうか?特定のデータ ポイントのみを表示したい場合はどうすればよいでしょうか。SQL と同様に、 *を必要な属性の名前に置き換えることで、数文字だけでこれを行うことができます。この場合、トランザクションの名前と所要時間を尋ねることができます。

SELECT name, duration
FROM Transaction

場合によっては、個々のデータ ポイントを表示するのではなく、多数のイベントにわたって要約された集計データを表示したい場合があります。これが NRDB の強みです。NRDB は、何十億ものイベントをスキャンし、データに関する質問に即座にリアルタイムで回答を提供できます。たとえば、各Transactionイベントには、呼び出しの実行にかかった秒数を表す期間属性があります。次のクエリを使用して、すべてのTransactionイベントの平均期間を調べます:

SELECT average(duration) 
FROM Transaction

NRQL には、イベント データの集計に使用できる多くの組み込み関数があります。一般的に使用される関数には、 max() 、 min() 、 average() 、 median() 、およびpercentile()が含まれます。次のクエリを使用して、過去 60 分間で最も遅いトランザクションの期間を NRDB に問い合わせることができます。これを行うには、NRDB に max(duration).

SELECT max(duration) 
FROM Transaction

これで、過去 60 分間で最も遅いカスタマー エクスペリエンスにかかった時間がわかりました。次に、逆数を見つけて、NRDB にmin(duration)を問い合わせて、最速のエクスペリエンスがどれくらいだったかを確認します。

SELECT min(duration) 
FROM Transaction

ご覧のとおり、 max()とmin()の両方が重要なデータ ポイントを返します。ただし、データに対して算術演算を実行することもできます。sum()を使用すると、数値属性で基本的な加算を行うことができます。このクエリでは、 databaseCallCountという新しい属性を使用します。この属性は、各トランザクションが行うデータベース呼び出しの数をカウントします。それらを追加することで、デフォルトの 60 分の時間枠でデータベース呼び出しの合計量を取得できます (アプリがデータベースと通信しない場合、これは 0 になります)。

SELECT sum(databaseCallCount) 
FROM Transaction

最後に、記録されたすべてのトランザクション イベントをcount(*)でカウントすることもできます。このクエリを使用すると、New Relic APM に報告するすべてのアプリケーションについて、記録されたすべてのイベントをカウントできます。

SELECT count(*) 
FROM Transaction

NRDB のすべてのデータにはtimestampがあり、すべてのクエリは時間範囲内のデータのサブセットで動作します。NRQL クエリで時間範囲を指定しない場合、前に見たようにデフォルトで過去 60 分間が返されます。しかし、異なる時間範囲のデータを表示したい場合はどうすればよいでしょうか?表示されるデータ ウィンドウをどのように制御しますか?これを行うには、 SINCEおよびUNTILキーワードを使用してクエリの時間範囲の開始と終了を指定します。

SELECT average(duration) 
FROM Transaction 
SINCE 1 day ago

day 、 week 、 hour 、 minute 、またはそれらに相当する複数形などのキーワードを使用して、クエリを作成する時間範囲を指定することもできます。SINCE今日やSINCE今週などの論理式を使用することもできます。

SELECT average(duration) 
FROM Transaction 
SINCE this week

相対時間範囲を示す別のクエリを次に示します。相対時間を指定する場合は、キーワードagoを含める必要があることに注意してください。

SELECT average(duration) 
FROM Transaction 
SINCE 1 week ago 
UNTIL 2 days ago

一般的な NRQL の使用例は、値が時間の経過とともにどのように変化するかを照会することです。このタイプのクエリは、折れ線グラフ、面グラフ、およびその他の視覚化用のデータを提供します。いくつかのクエリを実行して、集計関数average() 、 max() 、 min() 、 sum() 、およびcount()を調査しました。ここで、この例を使用して、集計関数で作成された任意のクエリを取得し、 TIMESERIESキーワードを追加して時間の経過に伴う値をプロットする方法を確認します。

SELECT average(duration) 
FROM Transaction 
SINCE 1 day ago 
TIMESERIES

時系列クエリは、指定された期間にわたってデータをバケットと呼ばれるいくつかの領域に分割します。NRDB にそのバケットの幅の値を選択させるか、独自の値を選択させることができます。このクエリを使用して、NRDB にアプリケーション トランザクションの平均期間を表示し、返されたデータを 1 時間のバケットにまとめて表示します。

SELECT average(duration) 
FROM Transaction 
SINCE 1 day ago 
TIMESERIES 1 hour

プロットされている 1 日の期間全体で 24 のデータ ポイントしかないため、これはより平坦なグラフを返す可能性があることに注意してください。しかし、可能な限り最大の粒度を確認したい場合はどうすればよいでしょうか?時系列クエリは最大 366 個のデータ バケットを持つことができます。つまり、24 時間で可能な最大粒度は、データを 4 分のウィンドウにバケット化することです。TIMESERIES 4 minutesまたはTIMESERIES MAXを使用してこれをクエリします。

SELECT average(duration) 
FROM Transaction 
SINCE 1 day ago 
TIMESERIES MAX

場合によっては、NRDB データの特定のサブセットに対してクエリを実行したい場合があります。たとえば、アプリケーションの平均応答時間を照会する場合、 transactionTypeという属性を使用できます。これは、トランザクションがWebまたはNon-Web (cron ジョブまたはキュー タスクなど) トランザクションであったかどうかを指定します。この例を使用して、 Webトランザクション タイプのデータのみを返すクエリを作成します。

SELECT average(duration) 
FROM Transaction 
WHERE transactionType='Web' 
TIMESERIES

また、 ANDとORを組み合わせてより複雑なクエリを作成し、括弧(と)を使用してこれらの連携方法を制御することもできます。このクエリは、100 ミリ秒よりも高速で、応答コードが 200 または 302 の「Web」トランザクションの平均応答時間を示します。ORを制御するために括弧を使用していることに注意してください。

SELECT average(duration) 
FROM Transaction 
WHERE transactionType='Web' 
AND duration < 0.1 
AND (httpResponseCode=200 
OR httpResponseCode=302) 
TIMESERIES

多くの場合、特定の属性でグループ化された "上位 N" の値を特定したいことがあります。NRQL では、 FACETを使用してこれを行います。たとえば、平均して観測された最も遅いTransaction呼び出しを、名前別にグループ化してクエリできます。これを「名前によるファセット」と考えてください。

SELECT average(duration) 
FROM Transaction 
FACET name 
SINCE 1 day ago

デフォルトでは、ファセット クエリは上位 10 件の結果を返しますが、 LIMITを配置することで返される結果の数をカスタマイズできます。この例では、 TIMESERIESを使用して、折れ線グラフに表示される上位 5 つの結果を取得します。

SELECT average(duration) 
FROM Transaction 
FACET name 
SINCE 3 hours ago 
LIMIT 5 
TIMESERIES

しかし、折れ線グラフが必要ない場合や、トランザクションのより大きなリストが必要な場合があります。TIMESERIESを削除すると、棒グラフまたは円グラフを表示でき、 LIMITを増やすことでリストの範囲を広げることができます。

SELECT average(duration) 
FROM Transaction 
FACET name 
SINCE 3 hours ago 
LIMIT 20

最後に、Web トランザクションの量を比較するもう少し複雑なクエリを次に示します。これは、New Relic に報告する個々のアプリケーションごとに分類されています。

SELECT count(*) 
FROM Transaction 
WHERE transactionType='Web' 
FACET appName 
LIMIT 5 
SINCE 6 hours ago 
TIMESERIES