NQRL の実行例

最初に、実際に NRQL を書いて、実行した際の動きを見てもらいたいと思います。以下は、直近１日の国別のページビューのタイムチャートと以下のサンプルの1つ目の直近 1時間の全アプリのスループットの2つを続けて実行しています。（NRQL で使っているキーワードはおいおい説明していきますので、ここでは気にしないでください）

どうでしょうか。昨日は説明していませんでしたが、実行すると、結果はいくつか形式で表示されている（タブが３つあります）のがわかるかと思います。上の例では、折れ線グラフ、積み重ねチャート、JSON 形式の3つの形で出力されています。2つ目は、また違った形式（タブが4つ）なのが分かるかと思います。JSON は常にあります。それ以外は出力内容によって異なります。

NQRL のサンプル（基本編）

New Relic Insights の Query 画面には、いくつか例がありますので、それを紹介していきます。Insights を使える方は、是非、一回アクセスして、試してみてください。実際に実行できるので、よりイメージがわくと思います。

直近 1時間の全アプリのスループットは？

SELECT count(*) from Transaction

結果

※ 時間を指定する必要はありません。デフォルトでは、直近1時間のデータが対象となります。

直近 1 時間の特定のアプリに属する特定のホストのスループットは？

SELECT count (*) from Transaction WHERE host='<ホスト名>' AND appName = '<アプリ名>'

結果

直近 12 時間から 1時間前までのあるアプリの全スループットは？

SELECT count(*) FROM Transaction WHERE appName = '<アプリ名>' SINCE 12 hours ago UNTIL 1 hour ago

結果

SINCE の後の hours は、他にも、days, weeks, months が使えます。
SINCE や UNTIL を使うことで、毎回 Insights を表示したときに、現在時刻をベースとした最新のデータが見えるようになります。

3 日前から現在までのあるアプリのスループットは？

SELECT count(*) FROM Transaction WHERE appName = '<アプリ名>' SINCE '2015-12-06' UNTIL '2015-12-08' TIMESERIES AUTO

結果

ここでは、日付を指定する例ですね。TIMESERIES を使うことで、時系列データ返ってきます。そして、表示もそれに沿ったグラフが表示されています。最後の AUTO は時系列データの区切り幅を指定しています。AUTO は、自動で期間にあったみやすい値が適用されるようです。ここでは、1時間区切りになっています。これは、30 minutes や 2 hours とか変えることもできます。

コントローラー名別のスループットの内訳は？

SELECT count(*) FROM Transaction FACET name

結果

NRQL では、GROUP BY の代わりに FACET というキーワードが用意されています。GROUP BY と同じ動き出そうです。逆に分かりづらい気がするんだよねこれ。

アプリの昨日と今日のスループットの比較がしたい

SELECT count(*) FROM Transaction SINCE 1 day ago TIMESERIES AUTO COMPARE WITH 1 day ago

結果

ここでは、COMPARE WITH を使って１日前と今日のデータを比較しています。これ両方とも 1 day ago って書いてあるから、アレ？ってなるんだよね。

トップ50のトランザクションの平均、最大、最小処理時間がみたい

SELECT count(*), average(duration), max(duration),  min(duration), sum(duration) FROM Transaction FACET name LIMIT 50

結果

このように表形式にした場合、SELECT の最初の function （ここでは count(*)）でソートされるそうです。

直近 1 日で受け付けたリクエストのユニークなコントローラーの数は？

SELECT uniqueCount(name) FROM Transaction WHERE appName = '<アプリ名>' SINCE 1 day ago

結果

uniqueCount は、SQL の DISTINCT と同じ動作をするようです。

直近 1 日間にリクエストを受け付けた全ホスト名前のリストは？

SELECT uniques(host) FROM Transaction SINCE 1 day ago

結果

この uniques はいろいろな場面で使えます。例えば、カスタム属性で商品名などを収取していた場合、一日で売れた商品名のリストが簡単に取り出せます。

直近 1 日間における特定のリクエストを利用した最後のホストは？

SELECT latest(host) FROM Transaction FACET name SINCE 1 day ago

結果

latest 関数は、特定の期間における属性の最新の値を返します。FACET 句と一緒に使うことで、指定した値（ここでは、name )でグループ化した結果に対して、最新の値を表示しています。

リクエストの処理の何パーセントの時間が、データベース処理以外に費やされてる？

SELECT (1-(average(duration)-average(databaseDuration))/average(duration))*100 AS '% of time in DB' FROM Transaction FACET name WHERE appName = '<アプリ名>'

結果

(1 - (平均処理時間-DB平均処理時間)/平均処理時間) * 100 = DB 以外に費やした処理の時間の割合

ここでは、数値データに対して、Math関数を利用しています。SQL と同じ感じ。NQRL では、+, -, /, * をサポートしています。
また、ラベルとして、AS も利用しています。

さいごに

どうでしたでしょうか？NRQL や　Insights のイメージが分かってきたでしょうか。ここにあるのは、あくまで例なので、ここの書いてある内容でイメージを膨らめていただいて、是非、お使いのアプリで有効に活用してください。

NQRL の詳しい文法やキーワードは、NRQL リファレンス(英語)に書いてありますので、是非活用してみてください。

ここでは、チュートリアルにある、基本のみなので、別の日に応用の方も紹介したいと思います。