• English日本語한국어
  • ログイン今すぐ開始

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の基本ルールは以下の通りです。

NRQLの条件

詳細

必須の値

SELECT句とFROM句は必須です。その他のすべての句はオプションです。クエリはSELECTまたはFROMから開始することができます。

クエリ文字列のサイズ

クエリ文字列は4KB未満でなければなりません。

大文字と小文字の区別

  • データタイプ名と属性名は区別されます。
  • NRQL句関数では、大文字と小文字は区別されません。

文字列の構文

NRQLでは文字列の指定にシングルクォーテーションを使用します。例:

... where traceId = '030a573f0df02c57'

非標準カスタムイベントと属性の名前

デフォルトでレポートするイベントの名前には、英数字、コロン(:)、アンダースコア(_)が含まれます。属性名には、これらの文字とピリオド(.)を含めることができます。デフォルトでレポートされる名前は文字で始まります。これらのガイドラインに従わないカスタム名は、NRQLクエリでバッククォートで囲む必要があります。例:

... FACET `Logged-in user`

データタイプの型強制

データ型「強制」はサポートしていません。詳しくはデータタイプの変換を参照してください。

数学関数の使用

基本的で高度な関数は、SELECT文でサポートされています。

サブクエリ

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チュートリアルに直接お進みください。

Copyright © 2023 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.