ツールを使用する前に、その使い方を知っておくとよいでしょう。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の基本ルールは以下の通りです。
NRQLの条件 | 詳細 |
---|---|
必須の値 |
|
クエリ文字列のサイズ | クエリ文字列は4KB未満でなければなりません。 |
大文字と小文字の区別 | |
文字列の構文 | NRQLでは文字列の指定にシングルクォーテーションを使用します。例:
|
非標準カスタムイベントと属性の名前 | デフォルトでレポートするイベントの名前には、英数字、コロン(
|
データタイプの型強制 | データ型「強制」はサポートしていません。詳しくはデータタイプの変換を参照してください。 |
数学関数の使用 | |
サブクエリ | NRQLはサブクエリをサポートします。 |
コメント | NRQLクエリにコメントを追加できます。コメントの詳細をご覧ください。 |
これらはNRQLの基本ルールであり、クエリの作成に役立つNRQLリファレンスに詳細情報が記載されています。
データの探索
NRQLの使用方法を学ぶ最善の方法は、New Relicクエリツールにアクセスし、それを使用してデータを探索してみることです。次にクエリビルダーとインターフェースからの推奨エントリを使用して、データを探索する例をご紹介します。
ヒント
データを使用して実際に試してみてください!当社のクエリインターフェースを使用しても何も壊れませんので、お早めに、頻繁にお使いください。
FROM
でクエリを開始し、<space>を押します。インターフェースは使用可能なタイプのデータを推奨し、そのリストからTransaction
を選択します。
次に、SELECT
を使用して属性を選択すると、クエリは次のようになります。
FROM Transaction SELECT
<space>をもう一度押すと、インターフェースによって使用可能な属性が推奨されます。以下の例では、appId
が選択されています。
その結果、必要な句とステートメント(FROM
およびSELECT
)を使用した非常に基本的なNRQLクエリとなり、以下に示すように、トランザクションとそれぞれに関連付けられたappId
のリストが表示されます。
データを探索するもう1つの優れた方法として、既存のダッシュボードに移動し、View queryをクリックして、クエリビルダーでのチャートの実行があります。
NRQLで作成したチャートには、オプションとしてクエリを表示があります。ここからクエリを編集・カスタマイズして、変更内容が視覚的な結果にどのような影響を及ぼすのか確認できます。
NRQL クエリの例
以下は、APMが報告する、Transaction
データのもう少し詳細なNRQLクエリ例になります。このクエリの場合:
Transaction
は選択したデータタイプですSelect
は平均期間の決定に使用します。- 結果はappNameを使用してグループ化されます
Facet
Timeseries
は、自動時間枠でのデータ表示に使用します。
FROM Transaction SELECT average(duration) FACET appName TIMESERIES auto
これによって、次のようなチャートが作成されます:
以下は、クエリの例です:
重要
NRQLを使用することなくデータを探索するには、メトリクスとイベント データエクスプローラーを使用します。New Relicでのデータのクエリの詳細をご覧ください。
さらに学ぶ準備は整っていますか? NRQLの概要をまだ確認していない場合は必ず確認するか、NRQLでチャートやダッシュボードを使用する方法を学習してください。NRQLの使用を直ちに開始されたい場合は、ガイド付きNRQLチュートリアルに直接お進みください。