NRQLの使用方法：クエリの仕組み

ツールを使用する前に、その使い方を知っておくとよいでしょう。NRQLを使用したクエリの作成、構造化、および記述を行うプロセスがあります。NRQLを使用したクエリのルールを理解すると、データを最大限に活用できます。これまでにクエリを実行したことがない場合でも、基本的なルールを理解するだけで、必要な（ほぼ）すべてのデータにアクセスして、チャートやダッシュボードで視覚化できます。

NRQL の構文

すでにSQLクエリに精通しているなら、NRQLには多くの類似点があることがお分かりになるでしょう。NRQLクエリの構造の簡単な内訳は次のとおりです。

SELECT function(attribute) [AS 'label'][, ...] 
  FROM data type
  [WHERE attribute [comparison] [AND|OR ...]][AS 'label'][, ...]
  [FACET attribute | function(attribute)]
  [LIMIT number]
  [SINCE time]
  [UNTIL time]
  [WITH TIMEZONE timezone]
  [COMPARE WITH time]
  [TIMESERIES time]

NRQLの基本ルールは以下の通りです。

... where traceId = '030a573f0df02c57'

... FACET `Logged-in user`

これらはNRQLの基本ルールであり、クエリの作成に役立つNRQL構文と機能に関する詳細情報もあります。

データの探索

NRQLの使用方法を学ぶ最善の方法は、New Relicクエリツールにアクセスし、それを使用してデータを探索してみることです。次にクエリビルダーとインターフェースからの推奨エントリを使用して、データを探索する例をご紹介します。

FROMでクエリを開始し、<space>を押します。インターフェースは使用可能なタイプのデータを推奨し、そのリストからTransactionを選択します。

次に、SELECTを使用して属性を選択すると、クエリは次のようになります。

FROM Transaction SELECT

<space>をもう一度押すと、インターフェースによって使用可能な属性が推奨されます。以下の例では、appIdが選択されています。

その結果、必要な句とステートメント（FROMおよびSELECT）を使用した非常に基本的なNRQLクエリとなり、以下に示すように、APMトランザクションとそれぞれに関連付けられたappIdのリストが表示されます。

データを探索するもう1つの優れた方法として、既存のダッシュボードに移動し、View queryをクリックして、クエリビルダーでのチャートの実行があります。

NRQL クエリの例

以下は、APMが報告する、Transactionデータのもう少し詳細なNRQLクエリ例になります。このクエリの場合：

• Transaction は選択したデータタイプです
• Select は平均期間の決定に使用します。
• 結果はappNameを使用してグループ化されます Facet
• Timeseries は、自動時間枠でのデータ表示に使用します。

FROM Transaction 
SELECT average(duration) 
  FACET appName 
  TIMESERIES auto

これによって、次のようなチャートが作成されます：

以下は、クエリの例です：

SELECT uniqueCount(user) FROM PageView 
  WHERE userAgentOS = 'Mac' 
  FACET countryCode
  SINCE 1 day ago 
  LIMIT 20

SELECT count(*)
 FROM Transaction
 FACET `Logged-in user`

SELECT count(*) FROM Transaction, PageView SINCE 3 days ago

SELECT function(attribute), function(attribute) ...
  FROM ...

SELECT min(duration), max(duration), average(duration)
  FROM PageView SINCE 1 week ago

さらに学ぶ準備は整っていますか？ NRQLの概要をまだ確認していない場合は必ず確認するか、NRQLでチャートやダッシュボードを使用する方法を学習してください。NRQLの使用を直ちに開始されたい場合は、ガイド付きNRQLチュートリアルに直接お進みください。