NRQLの構文、句、関数

SELECT attribute ...

SELECT function(attribute) ...

SELECTは、属性または関数を指定することによって、データ型のどの部分をクエリするかを指定します。その後、カンマ区切りの1つ以上の引数が続きます。各引数では、以下を実行できます。

• ワイルドカードとして*を使用することで、利用可能なすべての属性値を取得。例：SELECT * from Transaction。
• 指定した属性、または カンマ区切りのリストで指定した複数の属性に関連する値を取得。
• 集計関数を選択することで、指定した属性から集計値を取得。
• AS句で、各引数で返された結果にラベル付け。

基本的な数学関数とともにSELECTを使用することもできます。

SELECT average(duration) FROM PageView SINCE 1 week ago

SELECT ...
  FROM data type
  ...

FROM句を使用して、クエリするデータ型を指定します。クエリはFROMまたはSELECTで開始できます。カンマ区切りのリストの複数のデータタイプにまたがる同じ属性の値をマージできます。

SELECT count(*) FROM Transaction SINCE 7 days ago

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

SELECT ...
  AS 'label'
  ...

AS句を使用して、シングルクォート区切りの文字列で属性、集計、ファネル内のステップ、または数学関数の結果にラベルを付けます。このラベルは結果のチャートで使用されます。

SELECT count(*)/uniqueCount(session) AS 'Pageviews per Session'
  FROM PageView

SELECT funnel(SESSION,
    WHERE name='Controller/about/main' AS 'Step 1',
    WHERE name = 'Controller/about/careers' AS 'Step 2')
    FROM PageView SINCE 1 week ago

SELECT ... (SINCE or UNTIL) (integer units) AGO
  COMPARE WITH (integer units) AGO
  ...

COMPARE WITH句を使用すると、2つの異なる時間範囲の値を比較できます。

COMPARE WITH にはSINCEまたはUNTIL文が必要です。COMPARE WITHで指定された時間は、SINCEまたはUNTILで指定した時間に相対します。たとえば、SINCE 1 day ago COMPARE WITH 1 day ago昨日を一昨日と比較します。

COMPARE WITH値の時間範囲は、常にSINCEまたはUNTILで指定されたものと同じになります。たとえば、SINCE 2 hours ago COMPARE WITH 4 hours agoは午後3時〜5時までと午前11時〜午後1時までを比較できます。

COMPARE WITH 結果は、折れ線グラフまたはビルボードで表示できます。

• TIMESERIESを使用すると、COMPARE WITHは比較内容を経時的にマッピングした折れ線グラフを作成します。
• TIMESERIESがない場合、COMPARE WITHは現在値とCOMPARE WITH値からの増減率でビルボードを生成します。

例：このクエリは、データを過去1時間の95パーセンタイルと1週間前の同じ範囲を表示する折れ線グラフで返します。最初は単一値、次は折れ線グラフです。

SELECT percentile(duration) FROM PageView
  SINCE 1 week ago COMPARE WITH 1 week AGO

SELECT percentile(duration) FROM PageView
  SINCE 1 week ago COMPARE WITH 1 week AGO TIMESERIES AUTO

この句は以下のデータ型で使用できます。

• Transaction

• TransactionError

• APMエージェントAPIで報告されたカスタムイベント

  EXTRAPOLATEの目的は、クエリ結果がシステム内のアクティビティ全体をより厳密に表現できるよう、イベントデータのAPMエージェントサンプリングの影響を数学的に補うことです。

  この句は、APMエージェントが収集サイクルの報告限度をしばしば超過する多くのイベントを報告する際に便利です。その場合、エージェントはイベントのサンプリングを開始します。

  EXTRAPOLATEに対応したNRQLクエリでこれを使用する場合、報告されたイベントと合計イベントの比率で、合計未サンプルデータの近似を推定します。この句に未対応であるか、サンプルデータを使用していないNRQLでこれを使用する場合、結果に影響を与えません。

  重要

  EXTRAPOLATEは、（スループットまたはエラー率など）同種データに対して最も有用である点に注意してください。（uniqueCount()またはuniques()など）特徴的なものの数を外挿する際には有効ではありません。

  この句は、以下のいずれかの集計関数を使用するNRQLクエリでのみ機能します。

• apdex

• average

• count

• ヒストグラム

• sum

• percentage（引数として取る関数がEXTRAPOLATEに対応している場合）

• rate（引数として取る関数がEXTRAPOLATEに対応している場合）

• stddev

  スループットの推定の例

  interestingApplicationという名前のサービスの推定スループットを示すクエリ。

  SELECT count(*) FROM Transaction WHERE appName='interestingApplication' SINCE 60 minutes ago EXTRAPOLATE

  コピー

  時系列としてのスループットの推定の例

  トランザクション名ごとに、時系列として表示するinterestingApplicationという名前のサービスの推定スループットを示すクエリ。

  SELECT count(*) FROM Transaction WHERE appName='interestingApplication'
  SINCE 60 minutes ago FACET name TIMESERIES 1 minute EXTRAPOLATE

  コピー

SELECT ...
  FACET attribute
  ...

FACETを使用すると、結果を属性値で分割してグループ化できます。たとえば、PageViewデータでdeviceType別にFACETを行い、トラフィックの何割が携帯電話、タブレット、およびデスクトップデバイスから発生しているかを把握することができます。

LIMIT句を使用して、表示するファセットの数を指定します（デフォルトは10）。より複雑なグループ化に関しては、FACET CASESを使用します。FACET句は、カンマで区切られた最大5つの属性をサポートします。

ファセットは、SELECT句で指定した最初のフィールドによって降順でソートされます。2,000件以上のユニーク値を持つ属性をファセットに指定した場合、ファセット値のサブセットを選択し、それらをクエリタイプに従って並べ替えます。

min()、max()、percentile()、average()、またはcount()を選択すると、FACETはこれらの関数を使用してファセットの選択方法とソート方法を決定します。その他の関数を選択すると、FACETはファセット対象の属性の発生頻度に基づいて、ファセットの選択方法とソート方法を決定します。

SELECT count(*) FROM PageView FACET city

SELECT uniqueCount(pageUrl) FROM PageView FACET city

FACET ... AS句では、クエリでASキーワードを使用してファセットに名前を付けます。この句は、結果のファセットに明確な名前または簡略化された名前を追加するのに役立ちます。ネスト構造の集計クエリで、ファセットの名前を変更するためにも使用できます。

FACET ... AS クエリでは、結果のファセット名が変更されますが（たとえば、テーブルのヘッダーとして表示される場合）、実際のファセット名自体は変更されません。

FROM Transaction SELECT count(*) FACET response.headers.contentType AS 'content type'

SELECT ...
  FACET CASES (
    WHERE attribute operator value, WHERE attribute operator value, ...
    )
  ...

FACET CASESを使用して、FACETで可能な範囲を超えた複雑な条件別にデータを取り出します。複数の条件はカンマ,で区切ります。たとえば、PageViewデータをクエリして、1秒未満、1秒から10秒、10秒を上回るといったカテゴリにFACET CASESを行うことができます。ケース内の複数の属性を組み合わせ、ASセレクタでケースにラベルを付けることができます。データ点は、最大で1つのファセットケースに追加されます。つまり、一致する最初のファセットになります。

また、属性とともに時間関数を使用することもできます。また、OR演算子を使用して、指定したどのケースにも一致しないファセット結果を表示することもできます。

SELECT count(*) FROM PageView FACET CASES (WHERE duration < 1, WHERE duration > 1 and duration < 10, WHERE duration > 10)

SELECT count(*) FROM Transaction FACET CASES (WHERE name LIKE '%login%', WHERE name LIKE '%feature%' AND customer_type='Paid')

SELECT count(*) FROM Transaction FACET CASES (WHERE name LIKE '%login%' AS 'Total Logins', WHERE name LIKE '%feature%' AND customer_type='Paid' AS 'Feature Visits from Paid Users')

SELECT count(*) FROM Transaction FACET CASES (WHERE name LIKE '%login%', WHERE name LIKE '%feature%' AND customer_type='Paid') OR name

NRQLでは、デフォルトはSELECT句の最初の集計で、クエリ内のファセットの選択をガイドします。FACET ... ORDER BYでは、ORDER BY修飾子で集計関数を追加し、ファセットの選択方法を指定することで、このデフォルト動作をオーバーライドできます。具体的には、LIMIT句によって制限される前に、最終結果に含めるファセットの優先度をオーバーライドします。この句はクエリで使用できますが、アラートやストリーミングには使用できません。

この例では、FACET ... ORDER BYを使用してアプリトランザクションの平均期間を見つける方法を示し、応答サイズが最大のアプリによる上位10（デフォルトの制限）の最大期間を示しています。この場合、FACET ... ORDER BYが使用されていない場合、クエリ結果には、アプリの選択とは関係のない応答サイズで、期間が最も長い上位10件が代わりに表示されます。

FROM Transaction SELECT average(duration) TIMESERIES FACET appName ORDER BY max(responseSize)

SELECT ...
  LIMIT count
  ...

LIMIT句を使用して、FACETクエリで返されるファセット値の最大数、またはSELECT *クエリで返される項目の最大数を制御します。この句は、単一の整数値を引数に取ります。LIMIT句が指定されない、または値が提供されない場合、リミットのデフォルト設定は、FACETクエリの場合は10、SELECT *クエリの場合は100となります。

LIMIT句で許容される最大値は2,000です。

SELECT uniqueCount(session), percentile(duration, 95)
  FROM PageView WHERE userAgentOS = 'Windows'
  FACET countryCode LIMIT 20 SINCE YESTERDAY

SELECT ...
  LIMIT count OFFSET count
  ...

OFFSET句とLIMIT句を使用して、SELECT *またはSELECT columnクエリによって返される行の一部を制御します。LIMIT句と同様に、OFFSETは引数として単一の整数値を取ります。OFFSETは、クエリで選択された行が返される前に、スキップされる行数を設定します。これはLIMITによって制約されます。

OFFSET 行はスキップされ、直近のレコードから開始されます。

たとえば、クエリSELECT interestingValue FROM Minute_Report LIMIT 5 OFFSET 1は、最新の値を除き、Minute_Reportから最後の5つの値を返します。

ORDER BY句を使用すると、行でイベント属性を選択するクエリで結果を並べ替える方法を指定できます。

このクエリは、期間順にトランザクションを並べ替えます。

FROM Transaction SELECT appName, duration ORDER BY duration

デフォルトの並べ替え順序は昇順ですが、ASCまたはDESCの修飾子を追加することで変更できます。

SHOW EVENT TYPES...

SHOW EVENT TYPES は、特定の時間範囲内にアカウントに存在するすべてのデータ型のリストを返します。これは、SELECTの代わりにクエリの最初の句として使用されます。

SHOW EVENT TYPES SINCE 1 day ago

SELECT ...
  SINCE [numerical units AGO | phrase]
  ...

デフォルト値は 1 時間前です。

SINCE句を使用して、返されたデータに対する時間範囲の開始を定義します。タイムゾーンは結果ではなく、クエリに対して指定できます。NRQLの結果はシステム時間に基づきます。

NRQLを使用する場合、UTCタイムスタンプまたは相対時間範囲を設定できます。

• タイムスタンプはYYYY-MM-DD HH:MM:SS ZZZZの形式を使用します。たとえば、FROM Transaction SELECT count(*) SINCE '2021-12-25 00:00:00 +0000' UNTIL '2021-12-25 23:59:59 +0000'。
• 当社は、以下の相対時間範囲をサポートしています：YESTERDAY、TODAY、SUNDAY、MONDAY、TUESDAY、WEDNESDAY、THURSDAY、FRIDAY、SATURDAY。例、SINCE YESTERDAY UNTIL NOW。
• また、YEAR、QUARTER、MONTH、WEEK、DAY、HOUR、MINUTE、SECONDもサポートしています。この場合、SINCEをTHISまたはLASTと組み合わせることができます。たとえば、SINCE LAST MONTH UNTIL THIS WEEK。SINCE 3 WEEKS AGO UNTIL 10 MINUTES AGOのように、AGOを含めることもできます。

SLIDE BY句は、スライディングウィンドウと呼ばれる機能をサポートしています。スライディングウィンドウを使用すると、SLIDE BYデータは、互いに重複する時間の「ウィンドウ」に収集されます。これらのウィンドウは、移動集計（移動平均など）が狭い時間枠からの集計よりも重要である場合に、変動の多い折れ線グラフを滑らかにするのに役立ちます。

SLIDE BYを使用するには、TIMESERIES句の後のクエリにこの句を配置します。たとえば、このクエリは1分のSLIDE BY間隔で5分間のウィンドウにデータをプルします。つまり、各ウィンドウは5分間続きますが、ウィンドウ1は0分後に開始し、ウィンドウ2は1分後に開始し、ウィンドウ3は2分後に開始します。

SELECT average(duration) FROM Transaction TIMESERIES 5 minutes SLIDE BY 1 minute

SLIDE BYをいつ、どのように使用できるかについての詳細は、スライディングウィンドウを使用してよりスムーズなグラフを作成するを参照してください。または、この短いビデオをご覧ください（約3分20秒）。

SELECT average(duration) FROM Transaction TIMESERIES 5 minutes SLIDE BY AUTO

SELECT average(duration) FROM Transaction TIMESERIES 5 minutes SLIDE BY MAX

SELECT ...
  TIMESERIES integer units
  ...

TIMESERIES句を使用して、指定期間単位の時系列としてデータを返します。TIMESERIESは特定のチャートを表示するために使用されるため、デフォルト値はありません。

時間範囲を指定するには、integer unitsを使用します。例：

• TIMESERIES 1 minute
• TIMESERIES 30 minutes
• TIMESERIES 1 hour
• TIMESERIES 30 seconds

TIMESERIES 以下の例に示すように、MAX、AUTO、SLIDE BYなどの引数と組み合わせると、クエリ結果をさらに調整できます。

SELECT ... SINCE 1 day AGO TIMESERIES 30 minutes

SELECT average(duration), percentile(duration, 50, 90)
  FROM PageView SINCE 1 week AGO TIMESERIES AUTO

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

SELECT ...
  UNTIL integer units AGO
  ...

デフォルト値はNOWです。UNTILは、デフォルト以外の終了点を指定するためのみに使用してください。

UNTIL句を使用して、データを返す時間範囲の終了時点を定義します。時間範囲を指定するとデータが保存されるようになり、時間範囲が終了した後に確認することができます。

詳細情報と例については、タイムピッカーを使用して時間設定を調整するを参照してください。

WHERE句を使用して、結果をフィルタリングします。NRQLは、句で指定する条件を満たす結果を返します。

SELECT function(attribute) ...
  WHERE attribute [operator 'value' | IN ('value' [, 'value]) | IS [NOT] NULL ]
  [AND|OR ...]
  ...

• 複数の条件を指定する場合は、条件を演算子ANDまたはORで区切ります。
• SQLのjoinをシミュレートする場合は、WHEREまたはFACET句でカスタムアトリビュートを使用します。

SELECT * FROM PageView WHERE countryCode NOT IN ('CA', 'WA')

SELECT histogram(duration, 50, 20) FROM PageView
WHERE countryCode IN ('CA', 'US') AND userAgentName='Safari' AND pageUrl LIKE '%checkout%'
SINCE 1 day ago

メトリックデータのクエリに関する情報については、メトリクスのクエリを行うを参照してください。

SELECT ... WITH TIMEZONE (selected zone)
  ...

デフォルトで、クエリ結果は、現在使用しているブラウザのタイムゾーンで表示されます。

WITH TIMEZONE句を使用すると、タイムゾーンが未指定のクエリ内で日付や時刻のタイムゾーンを選択できます。

たとえば、SINCE Monday UNTIL Tuesday WITH TIMEZONE 'America/New_York'というクエリ句は、東部標準時の月曜日午前0時から東部標準時の火曜日午前0時までに記録されたデータを返します。

詳細な情報と例については、ダッシュボードとチャートで時間範囲を設定するを参照してください。

aggregationendtime()関数を使用して、関連集計の時刻を返します。より具体的には、aggregationendtime()関数は、指定した集計の、集計期間終了のタイムスタンプを提供します。たとえば、時系列クエリでは、1時間分のデータを含むデータポイントの場合、関数はその時間の終わりのタイムスタンプを返します。

apdex関数を使用して、単一のトランザクションまたはすべてのトランザクションのApdexスコアを返します。属性には、durationまたはbackendDurationなどのレスポンスタイムに基づく、任意の属性を指定できます。t:引数は、選択した属性と同じ時間単位でApdex T閾値を定義します。たとえば、属性が秒単位で測定される場合、tは秒単位の閾値になります。

apdex()関数が返すApdexスコアは、実行時間のみに基づくものです。APMエラーは考慮していません。エラーが含まれているにもかかわらず、トランザクションがApdex T以下で完了する場合、そのトランザクションはapdex ()関数によって満足と評価されます。

特定の顧客の Apdexを取得する

定義済みカスタム属性がある場合は、それらの属性に基づいて絞り込むことができます。たとえば、特に重要な顧客のApdexを監視することができます。

SELECT apdex(duration, t: 0.4) FROM Transaction
  WHERE customerName='ReallyImportantCustomer' SINCE 1 day ago

コピー

特定のトランザクションのApdexを取得する

name属性を使用して特定のトランザクションのスコア、またはnameを省略して総合的なApdexを返します。このクエリは、直近1時間のController/notes/indexトランザクションのApdexスコアを返します。

SELECT apdex(duration, t: 0.5) from Transaction
WHERE name='Controller/notes/index' SINCE 1 hour ago

コピー

アプリ全体のApdexを取得する

このクエリの例では、直近3週間のアプリケーション全体のApdexを返します。

SELECT apdex(duration, t: 0.08) FROM Transaction SINCE 3 week ago

コピー

average()関数を使用して、属性の平均値を返します。引数として単一の属性名を取得します。属性の値が数字でない場合、集計の際に無視されます。クエリの条件に合うデータが見つからない場合、またはクエリにより数値が返されない場合は、null値を返します。

buckets()関数を使用して、FACET句ごとに分割されたデータを、範囲に基づきバケットに集計します。New Relicデータベースの数値として保存される属性ごとにバケットにまとめることができます。

この関数は、以下の3つの引数を取ります。

• 属性名

• サンプル範囲の最大値。外れ値は最終バケットに表示されます。

• バケットの合計数

  詳細と例については、データをバケットに分割を参照してください。

bucketPercentile()関数は、Prometheusのhistogram_quantile関数のNRQL版です。次元メトリックデータとともに使用します。分位数の代わりにNew Relicパーセンタイルを返します。これは分位数*100です。

bucketPercentile()関数を使用して、Prometheus形式のヒストグラムデータから分位数を計算します。

バケット名を引数として取得し、バケットの境界とともにパーセンタイルをレポートします。

SELECT bucketPercentile(duration_bucket) FROM Metric SINCE 1 day ago

オプションで、引数としてパーセンタイル指定を追加できます。

SELECT bucketPercentile(duration_bucket, 50, 75, 90) FROM Metric SINCE 1 day ago

複数のメトリックスを使用してPrometheusヒストグラムデータを構成しているため、関連する<basename>に関して特定のPrometheusメトリックスのクエリを行う必要があります。

たとえば、<basename> prometheus_http_request_duration_secondsがNRQLを使用して、Prometheusヒストグラムからパーセンタイルを計算するには、bucketPercentile(prometheus_http_request_duration_seconds_bucket, 50)を使用します。_bucketがサフィックスとして<basename>の最後に追加されていることに注意してください。

詳細については、Prometheus.ioドキュメントを参照してください。

cardinality()関数を使用して、メトリック上のすべてのディメンション（属性）の組み合わせの数を取得します。

次の3つの引数を取りますが、すべてオプションです。

• メトリック名：ある場合は、cardinality()は指定したメトリックのみを計算します。

• インクルード：ある場合、Includeリストは濃度計算をこの属性に制限します。

• エクスクルード：ある場合、Excludeリストによりこの属性は濃度計算で無視されます。

  SELECT cardinality(metric_name, include:{attribute_list}, exclude:{attribute_list})

  コピー

count()関数を使用して、使用可能レコード数を返します。これは単一の引数を受け入れます (*、属性、または定数値のいずれか)。現在、一般的なSQL動作に従い、その引数に対する値を持つすべてのレコードを計上します。

count(*)は特定の属性を示すものではないため、結果はデフォルトの「humanize」形式でフォーマットされます。

derivative() は、所定のデータセットの変化率を検索します。線形最小二乗回帰を使用して変化率を計算し、微分係数を近似します。この計算では複数のデータポイントの比較が必要であるため、評価範囲にデータポイントが1つしかない場合、解が求められず、結果はnull値になります。

time intervalは、変化率を計算する期間です。たとえば、derivative(attributeName, 1 minute)は1分あたりの変化率を返します。

dimensions()関数を使用して、データ型のすべての次元値を返します。

オプションの引数を使用して、以下の特定の属性を明示的に含めたり、除外したりできます。

• インクルード：ある場合、includeリストはdimensions()をそれらの属性に限定します。

• エクスクルード：ある場合、dimensions()の計算ではそれらの属性は無視されます。

  FROM Metric SELECT count(node_filesystem_size) TIMESERIES FACET dimensions()

  コピー

  FACET句とともに使用する場合、dimensions()は、未集計クエリでのPrometheusの動作と同様に、イベントタイプで使用できるすべてのファセットについて一意の時系列を生成します。

latestrate()関数を使用して、最後の2つのデータポイントに基づく値の変化率を返します。問題となる属性を最初の引数として受け取り、結果である変化率の時間の単位を2番目の引数として受け取ります。この関数は結果をchange in attribute/time intervalの単位で返します。

この関数は、最先端の傾向を確認するために、属性の最新の変化率を提供するのに役立ちます。

SELECT latestrate(duration, 1 SECOND) FROM PageView

max()関数を使用して、指定された時間範囲内に記録された数値属性の最大値を返します。引数として単一の属性名を取得します。属性の値が数字でない場合、集計の際に無視されます。クエリの条件に合うデータが見つからない場合、またはクエリにより数値が返されない場合は、null値を返します。

median()関数を利用して、属性の中央値あるいは50パーセンタイルを返します。パーセンタイルクエリの詳細に関しては、percentile()を参照してください。

SELECT median(duration) FROM PageView TIMESERIES AUTO

min()関数を使用して、指定された時間範囲内に記録された数値属性の最小値を返します。引数として単一の属性名を取得します。属性の値が数字でない場合、集計の際に無視されます。クエリの条件に合うデータが見つからない場合、またはクエリにより数値が返されない場合は、null値を返します。

minuteOf()関数を使用して、有効なタイムスタンプ値を持つ属性の分の部分（つまり、0〜59秒）のみを抽出します。

与えられた数値属性の値（最初の引数、すなわち被除数）を数値（2つ目の引数、すなわち除数）で割った後、mod()関数を使用してfloor係数を返します。このモジュロ演算は、WHERE句の条件内で使用して結果の任意のサブセットにフィルターしたり、FACET句で結果セットをさらに分割したりする方法として使用できます。

FROM Transaction SELECT * WHERE mod(port, 2) = 1

FROM NrDailyUsage SELECT uniques(hostId, 10000) SINCE 1 day AGO FACET mod(hostId, 10)

percentage()関数を使用して、いくつかの条件に一致する目的のデータセットの割合を返します。

最初の引数には、目的の属性に対する集計関数が必要です。必ず2つの引数を使用してください（最初の2つ以外の引数は無視されます）。属性が数値でない場合、この関数は100%を値として返します。

FROM Transaction SELECT percentage(count(*), WHERE error is true ) AS 'Error Percent' Where host LIKE '%west%' EXTRAPOLATE

percentile()関数を使用して、所定の指定パーセンタイルでの属性の概算値を返します。この関数は属性が必須であり、パーセンタイル点を表す引数はいくつでも指定できます。percentile()関数は、小数点以下3桁までの表示を可能にすることで、より厳密な内容を提供できます。パーセンタイルの閾値は小数点値として指定される場合があるものの、大半のデータセットにおいて、互いに0.1よりも近いパーセンタイルは解決されない点に注意してください。

TIMESERIESを使用して、時系列でマッピングされたパーセンタイルで折れ線グラフを生成します。

• TIMESERIESを省略して、パーセンタイルの集計値を示すビルボードと属性シートを生成します。

  パーセンタイルが指定されていない場合、デフォルトで95パーセンタイルとなります。50パーセンタイル値、つまり中央値のみを返すには、median()を使用することもできます。

  基本的なパーセンタイルのクエリ

  このクエリは、5、50、95パーセンタイルの折れ線を表示する折れ線グラフを生成します。

  SELECT percentile(duration, 5, 50, 95) FROM PageView TIMESERIES AUTO

  コピー

predictLinear() はderivative()関数の拡張機能です。同様の方法の最小2乗線形回帰を使用して、データセットの将来値を予測します。

• time intervalは、クエリでどの程度将来まで扱うかを表します。たとえば、predictLinear(attributeName, 1 hour)は、1時間の線形予想をクエリの時間枠の将来に当てはめます。
• 一般に、predictLinear()は、ディスクスペースのような増加が続く値や大きなトレンドの予想などで有用です。
• predictLinear()は線形回帰のため、クエリを行っているデータセットに習熟していると、正確な長期的な予想を行えます。
• 指数的または対数的、その他の非線形的に増加するデータセットでは、非常に短期的な予想でのみ有効な可能性が高いと言えます。
• New Relicでは、TIMESERIESクエリでpredictLinearを使用することを推奨していません。これは、各バケットがクエリ内の相対的な期間に基づき個別に予想を行う、つまり、そうしたクエリは時系列終了以後の予想は示さないためです。

rate()関数を使用して、時間間隔ごとに所定のクエリの頻度またはレートを可視化します。たとえば、1時間の1分あたりのページビュー数や1日間の1時間あたりのサイトのユニークセッション数を把握する必要がある場合があります。

• TIMESERIESを使用して、時系列でマッピングされた評価を示す折れ線グラフを生成します。

• TIMESERIESを省略して、時間で平均化された単一の評価値を示すビルボードを生成します。

  過去6時間にわたる10分あたりのAPMトランザクションのスループット評価を示す折れ線グラフを生成する基本的なクエリを以下に示します。

  SELECT rate(count(*), 10 minute) FROM Transaction SINCE 6 hours ago
  TIMESERIES

  コピー

  ここでは、さまざまな時間枠でデータを比較するためにrateを使用する方法を説明する短いビデオ（3分21秒）を紹介します。

round()関数を使用して、属性の丸め値を返します。

オプションで、round()は2番目の引数to_nearestを取り、最初の引数を2番目の引数の最も近い倍数に切り上げます。to_nearestは分数にすることができます。

SELECT round(n [, to_nearest])

stddev()関数を使用して、指定された時間範囲内に記録された数値属性の標準偏差値を返します。単一の引数を取ります。属性が数値でない場合は、ゼロを値として返します。

stdvar()関数を使用して、指定された時間範囲内に記録された数値属性の標準分散を返します。

単一の引数を取ります。属性が数値でない場合は、ゼロを値として返します。

sum()関数を使用して、指定された時間範囲内に記録された数値属性の合計値を返します。

単一の引数を取ります。最初の引数以外は無視されます。属性が数値でない場合は、ゼロを値として返します。

uniqueCount()関数を使用して、指定された時間範囲内に記録された属性のユニーク値の数を返します。

uniques()関数を使用して、指定された時間範囲内に記録された属性のユニーク値のリストを返します。facet句と共に使用すると、各ファセット値ごとにユニーク属性値リストが返されます。

limitパラメーターはオプションです。提供されない場合は、ファセットあたり1,000のユニーク属性値のデフォルトlimitが適用されます。最大10,000までの、別のlimit値を指定できます。uniques()関数は、limitに達するまで、発見したユニーク属性値の最初のセットを返します。このため、データセットに5,000のユニーク属性値があり、リミットが1,000に設定されている場合は、演算子はその頻度に関わらず、発見した最初の1,000のユニーク値を返します。

クエリ結果で返すことのできる最大数は、uniques()上限とfacet上限を掛け合わせたものになります。以下のクエリでは、論理的に返すことができる値の最大数は500万です（5,000 x 1,000）。

クエリするデータセットとクエリの複雑性に応じて、メモリ保護limitで非常に大きなクエリの実行が阻止される場合があります。

From Transaction SELECT uniques(host,5000) FACET appName LIMIT 1000

FROM NodeStatus SELECT uniques(tuple(index, cellName), 5)

capture()を使用して、RE2構文の正規表現を使用して属性から値を抽出します。

2つの引数が必要です。

• 属性名

• capture構文を使用した正規表現。NRQLの正規表現は、Pythonのような構文r'...'を使用します。

  キャプチャする場合は、RE2名前付きキャプチャ構文...(?P<name> pattern )...は、指定された名前で、含まれるパターンをキャプチャします。現在、サポートされているキャプチャグループは1つのみです。

  正規表現キャプチャを使用してクエリ結果を改善する方法をお読みください。

  capture()を使用して、ダッシュボードの読みやすさを向上する方法を紹介する短いビデオ（3分05秒）もあります。

  詳しくは、以下の例をご覧ください。

  capture() SELECT句条件内

  以下では、ウェブサイトのドメイン名を選択し、https://とに続くパスを削除します。 .com

  SELECT capture(pageUrl, r'https://(?P<baseUrl>.*.com)/.+') FROM PageView SINCE 1 day ago

  コピー

  以下では、エラーメッセージの最初のワードのみがキャプチャされます。

  SELECT capture(errorMessage, r'(?P<firstWord>\S+)\s.+') FROM Transaction SINCE 1 hour ago where errorMessage is not null

  コピー

  capture() FACET句条件内

  キャプチャしたHTTPメソッドによって、以下がファセットされます。

  SELECT count(*) FROM Log WHERE message like '%HTTP%' FACET capture(message, r'.* "(?P<httpMethod>[A-Z]+) .*')

  コピー

  capture() WHERE句条件内

  以下は、キャプチャされたジョブ名がExampleJobである正規表現と一致するmessage属性を持つログイベントに基づいて、結果をフィルター処理します。

  SELECT message FROM Log WHERE capture(message, r'.*Job Failed: (?P<jobName>[A-Za-z]+),.*') = 'ExampleJob' SINCE 10 minutes ago

  コピー

  capture() 数字型変換

  以下では、ログラインからCPU時間の合計をキャプチャします。数学演算を実行するには、明示的に数値にキャストする必要があります。

  SELECT sum(numeric(capture(message, r'.*CpuTime:\s(?P<cpuTime>\d+)'))) FROM Log WHERE message like '%CpuTime:%' SINCE 1 hour ago

  コピー

accountId()関数を使用して、クエリされたデータに関連するアカウントIDを返します。この関数は引数を取りません。以下にいくつかクエリを示します。

SELECT accountId() FROM Transaction SINCE 1 day ago

SELECT count(*) FROM Transaction FACET accountId() SINCE 1 day ago

SELECT count(*) FROM Transaction WHERE accountId() IN (1,2,3) SINCE 1 day ago

earliest()関数を使用して、指定された時間範囲における属性の最も古い値を返します。

単一の引数を取ります。最初の引数以外は無視されます。

FACETと併用する場合、この関数は得られた各ファセットの属性の最新値を返します。

SELECT earliest(countryCode) FROM PageView FACET userAgentName

...WHERE eventType() = 'EventNameHere'...
...FACET eventType()...

FACET句でeventType()関数を使用し、選択したデータ型別に結果を取り出し、またはWHERE句で特定のデータ型に結果をフィルタリングします。これは filter() や percentage() 関数で特定のデータ型を対象とする際に特に便利です。

SELECT 100 * filter(count(*), where eventType() = 'TransactionError') / filter(count(*), where eventType() = 'Transaction') FROM Transaction, TransactionError WHERE appName = 'App.Prod' TIMESERIES 2 Minutes SINCE 6 hours ago

SELECT count(*) FROM Transaction, TransactionError FACET eventType() TIMESERIES

filter()関数を使用して、SELECT文内の集計関数の1つに結果を制限します。filter()はFACETやTIMESERIESとともに使用できます。フィルターは、SELECT filter(sum(x), WHERE attribute='a') AS 'A', filter(sum(x), WHERE attribute='b') AS 'B' ...などの複数の異なる集計を選択する場合にのみ便利です。それ以外の場合は、標準WHERE句を使用するのが良いでしょう。

オファーコードを使用した購入を分析する

filter()は、一連のトランザクションで購入された商品の中で、オファーコードを使用して購入された商品と、オファーコードを使用せずに購入された商品を比較するために使用できます。

funnel()関数を使用して、ファネルチャートを生成します。属性を最初の引数として取ります。その後、カンマで区切られたWHERE句（オプションでラベル付け用にAS句を含める）としてステップを指定します。

詳細な情報と例については、 ファネルのドキュメントを参照してください。

getField()関数を使用して、メトリックデータなどの複合データ型からフィールドを抽出します。

次の引数を取ります。

例：

SELECT max(getField(mySummary, count)) from Metric

SELECT sum(mySummary) from Metric where getField(mySummary, count) > 10

histogram()関数を使用して、ヒストグラムを生成します。この関数は、以下の3つの引数を取ります。

• 属性名

• サンプル範囲の最大値

• バケットの合計数（1～500（500を含む））

  PageViewイベントからのレスポンスタイムのヒストグラム

  このクエリは20バケットにわたって10秒以内のレスポンスタイムのヒストグラムを生成します。

  SELECT histogram(duration, 10, 20) FROM PageView SINCE 1 week ago

  コピー

  Prometheusヒストグラムバケット

  histogram() Prometheusヒストグラムバケットを受け取ります。

  SELECT histogram(duration_bucket, 10, 20) FROM Metric SINCE 1 week ago

  コピー

  New Relicディストリビューションメトリック

  histogram() ディストリビューションメトリックを入力として受け取ります。

  SELECT histogram(myDistributionMetric, 10, 20) FROM Metric SINCE 1 week ago

  コピー

  FACET句があるヒストグラム

  FACET句とともにhistogram()を使用し、ヒートマップチャートを生成します。

  SELECT histogram(duration) FROM PageView FACET appName SINCE 1 week ago

  コピー

keyset()を使用すると、所定の時間範囲における所定のデータ型に対するすべての属性を表示できます。この関数は引数を取りません。文字列型キー、数値型キー、ブール型キー、およびすべてのキーをグループ化したJSON構造体を返します。

SELECT keyset() FROM PageView SINCE 1 day ago

latest()関数を使用して、指定された時間範囲における属性の最新値を返します。

単一の引数を取ります。最初の引数以外は無視されます。

FACETと併用する場合、この関数は得られた各ファセットの属性の最新値を返します。

SELECT latest(countryCode) FROM PageView FACET userAgentName