NRQLでAPMメトリクスのタイムスライスデータを照会する

APM は、メトリクスデータをメトリックタイムスライスデータの形式でレポートします。NRQLを使用して、このタイプのデータのクエリとアラートを実行できます。時間区切りデータを調べるには、「メトリクスを調べる」を参照してください。

メートル法のタイムスライスデータを照会する理由は？

New Relic はいくつかの方法でメトリクスを報告します。 metric timeslice data と呼ばれるメトリクスデータの一種。これは、APM、、 browserで多くのチャートを生成するために使用されるデータのタイプです (詳細については、「メトリックタイムスライスデータ」を参照してください)。

メトリクスは、メトリックタイムスライスデータからより詳細な次元のメトリクスデータに自動的に変換され、NRQL およびNerdGraph APIを介してクエリできるようになります。この機能を使用すると、これらの重要な APM メトリクスの強力で詳細なカスタム視覚化を作成できます。これには、カスタムメトリックをクエリできることも含まれます。

重要

タイムスライスメトリックをディメンションメトリックまたはイベントデータと組み合わせてクエリすることはできません。 newrelic.timeslice.valueまたはapm.*メトリックを含むクエリは、APMメトリックのみを返すことができます。

問い合わせ先は？

クエリビルダーを使用して、APMメトリックタイムスライスデータをクエリすることをお勧めします。このエクスペリエンスは、完全なNRQL機能を提供し、クエリエラーに関する役立つオートコンプリートの提案とフィードバックも提供します。

もできます。

クエリの作成方法

APM では、一部のチャートには、そのチャートを生成した NRQL クエリを表示するオプションがあります。これは、メトリクスをクエリする方法を理解するための良い出発点となります。以下の NRQL クエリは、概要ページのエラー率グラフからわずかに変更されています。

FROM Metric
  SELECT count(apm.service.error.count) / count(apm.service.transaction.duration)
  WHERE (entity.guid = 'AN_ENTITY_GUID')
  AND (transactionType = 'Web')
  SINCE 1 day ago TIMESERIES

ここでは、このクエリの各部分がどのように機能するかを説明します。

問い合わせセグメント	何をするのか？
`FROM Metric`	`Metric` はコアデータ型の1つであり、メトリックタイムスライスデータはこのデータ型として保存されます。 `Metric`データのクエリに関する一般的なヒントについては、メトリッククエリの例を参照してください。
`SELECT count(apm.service.error.count) / count(apm.service.transaction.duration)`	この計算は、トランザクション・メトリクスの合計数からエラーの数を生成します。このクエリは、変換されたメトリック名を使用しています。なお、他のアグリゲータの機能を使うこともできます。
`WHERE (entity.guid = 'AN_ENTITY_GUID')`	少なくとも1つのデータソースを指定する必要があります。ここに示すように、単一のエンティティのGUIDを選択することも、複数のソースを選択することもできます。このクエリは`entity.guid`を使用しますが、 `appId`または`appName`を使用することもできます。
`AND (transactionType = 'Web')`	トランザクションタイプをウェブに設定し、バックグラウンド／非ウェブのトランザクションがカウントされないようにします。
`SINCE 1 day ago`	時間範囲の選択
`TIMESERIES`	このオプション句では、結果を時間軸のチャートで表示します。

FROM 、 FACET 、およびTIMESERIESを含むNRQL構文の一般的な情報については、 NRQLの概要を参照してください。

その他のクエリについては、クエリの例を参照してください。

メートル法のタイムスライスデータの変換方法

元のタイムスライスメトリクスをクエリに使用できるディメンションメトリクスに変換する作業は進行中のプロセスであり、完了していません。このセクションに探しているメトリクスが見つからない場合は、「汎用クエリ」を参照してください。

元のAPM タイムスライスメトリクスがどのように次元メトリクスに変換されるかを次に示します。

メトリック・タイムスライス構造	次元メトリック構造
APMのメトリック名は、スラッシュで区切られたセグメントの1つの文字列として表されます。たとえば、「 `Datastore/statement/MySQL/users/select` 」メトリックは、usersテーブルでのデータベースの選択操作に費やされた時間を表します。	`apm.service.datastore.operation.duration`という名前の1次元メトリックは、データストアメトリックのグループ全体を表します。このメトリックには、メトリック名にエンコードされたデータ値を表す3つの属性、datastoreType、table、operationがあります。 `datastoreType = ‘MySQL’` `table = ‘users’` `operation = ‘select’`

メトリック・タイムスライス構造

次元メトリック構造

APMのメトリック名は、スラッシュで区切られたセグメントの1つの文字列として表されます。

たとえば、「 Datastore/statement/MySQL/users/select 」メトリックは、usersテーブルでのデータベースの選択操作に費やされた時間を表します。

apm.service.datastore.operation.durationという名前の1次元メトリックは、データストアメトリックのグループ全体を表します。

このメトリックには、メトリック名にエンコードされたデータ値を表す3つの属性、datastoreType、table、operationがあります。

datastoreType = ‘MySQL’

table = ‘users’

operation = ‘select’

APMメトリクスの一部は、ディメンションメトリクスとして利用可能です。

メトリクス名	説明	属性	メートル単位
`apm.service.cpu.usertime.utilization`	ユーザーモードのコードでの滞在時間	percentage	percentage
`apm.service.datastore.operation.duration`	テーブル操作別のデータベースコールの応答時間	`datastoreType`、 `table` 、 `operation`	秒
`apm.service.error.count`	サマリーエラーカウントメトリクス	`transactionType`	count
`apm.service.external.host.duration`	外部からの問い合わせに対する応答時間（外部ホスト名別	`external.host`	秒
`apm.service.instance.count`	エージェントのインスタンス数のカウント		count
`apm.service.memory.physical`	プロセスメモリ（MB		メガバイト
`apm.service.transaction.apdex`	トランザクションごとのApdexスコア	`transactionName`, `transactionType`	apdex
`apm.service.transaction.duration`	トランザクションごとの応答時間	`keyTransactionName`、 `transactionName` 、 `transactionType`	秒
`apm.service.transaction.error.count`	トランザクションごとのエラー数	`keyTransactionName`、 `transactionName` 、 `transactionType`	count
`apm.service.transaction.external.duration`	トランザクションタイプ別の外部通話応答時間	`transactionType`	秒

利用可能なすべての指標を表示する方法を学びます。特定のメトリック名のメトリック単位を取得するには、次のようなクエリを使用できます。

FROM Metric
  SELECT unit
  WHERE appName = 'YOUR_APP_NAME'
  AND metricName = 'METRIC_NAME'

メトリック・タイムスライス・データの一般的な構造について、一般的な例を含めて詳しく理解するには、 Metric timeslice data を参照してください。

属性

これらの属性は、上記のメトリクスの表にリストされているメトリクス固有の属性に加えて使用できます。

名前	説明
`appName`	アプリケーションの名前です。
`appId`	アプリケーションのIDです。
`entity.guid`	アプリケーションのGUIDです。
`host`	監視対象のプロセスのホストです。
`host.bootId`	ホストのブートのIDがあれば、それを入力します。
`host.displayName`	エージェントに設定されている場合は、ホストの`display_name` 。
`instanceName`	Java エージェントの場合、 `host : port`
`metricName`	次元メトリックの名前です。
`metricTimesliceName`	レガシーメトリックのタイムスライス名です。
`scope`	（オプション）このメトリックが「スコープ」されるレガシーメトリックのタイムスライス名。スコープを持つメトリックはそれに属します-それらの測定値は、 `scope`属性で指定されたメトリックのコンテキストに適用されます。例については、以下を参照してください。

概要指標

概要メトリックを使用すると、実行中に費やされた場所の内訳を取得できます。これらの指標はいくつかの点でユニークです。

それらは多くのタイムスライスの組み合わせです。
これらは、 average アグリゲーター関数のみで動作するように設計されています。
同時に実行されたコードは、合計実行時間を示します。

たとえば、サービスが 3 つの同時スレッドで MySQL データベースを呼び出し、各スレッドの平均応答時間が 0.1 秒の場合、MySQL セグメントは 0.3 と表示されます。

さまざまな目的のために、いくつかの概要メトリックが提供されています。

メトリクス名	説明	属性
`apm.service.overview.web`	Web トランザクションのサービスのさまざまな部分で費やされた時間の内訳	セグメント名
`apm.service.overview.other`	バックグラウンド/非 Web トランザクションのサービスのさまざまな部分で費やされた時間の内訳	セグメント名
`apm.service.transaction.overview`	特定のトランザクションに費やされた時間の内訳	metricTimesliceName
`apm.key.transaction.overview`	特定のキートランザクションに費やされた時間の内訳	セグメント名

`newrelic.timeslice.value`メトリックを使用した一般的なクエリ

ディメンションメトリックに変換されていないメトリックの場合、または独自のカスタムメトリックの場合、 newrelic.timeslice.valueという名前のディメンションメトリックがあります。

重要

可能な場合は、上記の表のディメンションメトリックを使用することをお勧めします。

`newrelic.timeslice.value`を使用する場合

メトリックのタイムスライス名を指定すると、それが変換された次元メトリックに相当するものかどうかを、この構文で問い合わせることができます。

FROM Metric
SELECT uniques(metricName)
WHERE metricTimesliceName = 'Datastore/statement/MySQL/test/select'

返されるメトリック名がnewrelic.timeslice.valueのみの場合は、この一般的なアプローチを使用してデータをクエリする必要があります。

利用可能なメトリクスの取得

あるアプリケーションで利用可能なメトリクスのリストを取得するには、次のようなクエリを使用します。

SELECT uniques(metricTimesliceName) 
FROM Metric WHERE appName='YOUR_APP_NAME' 
AND newrelic.timeslice.value IS NOT NULL

ワイルドカードで指定されたメトリック名セグメントのファセット

一部のメトリクスタイムスライス名には、メトリクス名のセグメントとして属性値が含まれています。たとえば、エージェントは、次の形式を使用して外部通話の継続時間を追跡することによってメトリクスをレポートします。

External/{externalHost}/all

ここで、 {externalHost}はアウトバウンドネットワークコールのホスト名を表します。

ワイルドカードメトリックセグメントにファセットするカスタムメトリックの一般的なnewrelic.timeslice.valueクエリの例を次に示します。

FROM Metric SELECT count(newrelic.timeslice.value) 
  WHERE appName = 'MY APP' 
  WITH METRIC_FORMAT 'Custom/Labels/{action}' 
  TIMESERIES FACET action

このクエリでは、 {action}は一時属性actionを作成し、それがFACET actionによって使用されます。クエリ中に存在するのは属性のみであるため、任意の名前を使用できます。既存の属性名と競合しない名前を選択する必要があります。

推奨するアグリゲーター機能

推奨されるNRQL アグリゲータ機能があります。

apdex
average
sum
count
rate
uniques

クエリの例

メトリック・タイムスライス・データのクエリの例をいくつか紹介します。

このクエリはWHERE… INを使用して2つのアプリケーションを指定し、それらによってファセットを作成します。

FROM Metric
  SELECT rate(count(apm.service.transaction.duration), 1 minute) as 'Web throughput' 
  WHERE appName IN ('MY_APPLICATION', 'MY_OTHER_APPLICATION')
  AND (transactionType = 'Web')
  FACET appName
  TIMESERIES

このクエリは、 rate関数を使用して1分あたりのリクエスト数のグラフを表示します。

FROM Metric 
  SELECT rate(count(apm.service.transaction.duration), 1 minute) as 'HttpDispatcher requests_per_minute' 
  WHERE appName = 'MY_APPLICATION' 
  AND (transactionType = 'Web')
  TIMESERIES SINCE 3 days ago

このクエリは、ホスト名でファセットされた1分あたりのリクエスト数のチャートを表示します。

FROM Metric 
  SELECT count(apm.service.transaction.duration) as 'HttpDispatcher requests_per_minute' 
  WHERE appName = 'MY_APPLICATION' 
  AND (transactionType = 'Web')
  TIMESERIES SINCE 3 hours ago 
  FACET host 
  LIMIT 20

hostを使用する代わりに、 host.bootIdなどの他のホスト関連の属性でファセットすることができます。

これは、 averageを使用してメトリックの平均期間を照会します。

FROM Metric
  SELECT average(apm.service.transaction.duration) as 'HttpDispatcher average duration' 
  WHERE appName = 'MY_APPLICATION' 
  AND (transactionType = 'Web') 
  TIMESERIES SINCE 3 days ago

このクエリは、単一のトランザクション（この場合、 MY_APPLICATIONという名前のRailsアプリのUsersControllerのshowアクション）の平均期間を、上位20の個々のセグメント（データベースクエリ、外部サービス呼び出し、ガベージコレクション）ごとに分類します。時間など）。これは、サービスエンティティのAPMトランザクションページに表示される「アプリケーションの内訳」チャートの多くを再現しています。

FROM Metric 
  SELECT average(newrelic.timeslice.value, exclusiveTime: true) as 'duration, seconds' 
  WHERE appName = 'MY_APPLICATION' 
  AND scope = 'Controller/users/show'
  LIMIT 20 
  FACET metricTimesliceName
  TIMESERIES SINCE 3 days ago

この機械翻訳は参考用に提供されます。

NRQLでAPMメトリクスのタイムスライスデータを照会する

メートル法のタイムスライスデータを照会する理由は？

重要

問い合わせ先は？

クエリの作成方法

メートル法のタイムスライスデータの変換方法

属性

概要指標

`newrelic.timeslice.value`メトリックを使用した一般的なクエリ

重要

`newrelic.timeslice.value`を使用する場合

利用可能なメトリクスの取得

ワイルドカードで指定されたメトリック名セグメントのファセット

推奨するアグリゲーター機能

クエリの例

複数のアプリ名によるファセット

スループットパーミニッツレート

ホスト関連属性によるファセット

メトリックの平均継続時間の問い合わせ

トランザクションにかかる平均時間を構成要素ごとに分類する

この機械翻訳は参考用に提供されます。

NRQLでAPMメトリクスのタイムスライスデータを照会する

メートル法のタイムスライスデータを照会する理由は？ .css-21sua1{background:none;border:none;width:0;padding:0;}

重要

問い合わせ先は？

クエリの作成方法

メートル法のタイムスライスデータの変換方法

属性

概要指標

newrelic.timeslice.valueメトリックを使用した一般的なクエリ

重要

newrelic.timeslice.valueを使用する場合

利用可能なメトリクスの取得

ワイルドカードで指定されたメトリック名セグメントのファセット

推奨するアグリゲーター機能

クエリの例

スループットパーミニッツレート

ホスト関連属性によるファセット

メトリックの平均継続時間の問い合わせ

トランザクションにかかる平均時間を構成要素ごとに分類する

メートル法のタイムスライスデータを照会する理由は？

`newrelic.timeslice.value`メトリックを使用した一般的なクエリ

`newrelic.timeslice.value`を使用する場合