メトリクスがメトリクス API (その API を使用する統合からのものを含む) を介して New Relic に報告されると、データはMetric
データ型として報告され、クエリに使用できます。
このドキュメントでは、次のことを説明しています。
APMメトリクスのタイムスライスデータの照会
APMでは、メトリックタイムスライスデータと呼ばれる特定のタイプのデータを報告しています。このデータを照会する方法については、 Query metric timeslice data を参照してください。
重要
タイムスライスメトリックをディメンションメトリックまたはイベントデータと組み合わせてクエリすることはできません。 newrelic.timeslice.value
またはapm.*
メトリックを含むクエリは、APMメトリックのみを返すことができます。
他のタイプのメトリクスについては、 Metric data types を参照してください。
メトリクスの表示と照会
NRQLを使用して、クエリビルダーまたはNerdGraphAPIを使用してメトリックデータをクエリできます。
メトリックをクエリするには、次のクエリ形式を使用できます。
FROM Metric SELECT function(metric_name) WHERE attribute=value FACET attribute TIMESERIES
どのメトリック データ型に対してどの関数がサポートされているかについては、「メトリック データ構造」を参照してください。
グラフ化するメトリックの名前を、適切な値関数を使用してSELECT
句に追加します。 WHERE
}句とFACET
句は、属性値とともに使用できます。データをグラフ化する場合は、キーワードTIMESERIES
を含めることを忘れないでください。
この例は、クラスターfoo
のCPU使用率を秒単位でグラフ化する方法を示しています。このクエリは、属性containerName
およびclusterName
を持つcontainer_cpu_usage_seconds_total
という名前のcount
メトリックが与えられた場合に、コンテナごとにCPU使用率を分類します。
FROM Metric select sum(container_cpu_usage_seconds_total) WHERE clusterName = 'foo' FACET containerName TIMESERIES
1分ごとのCPU使用率(変化率)を知りたい場合は、上記のクエリにrate関数を追加します。
FROM Metric select rate(sum(container_cpu_usage_seconds_total), 1 minute) WHERE clusterName = 'foo' FACET containerName TIMESERIES
メトリクスクエリの例を見る
前述の例では、メトリック・クエリの基本的な形式を示しましたが、NRQLはメトリック・データのチャート化、探索、分析にも使用できます。
ワイルドカードを使って複数のメトリクスを検索
ワイルドカードは、NRQLでは%
文字で表されます。標準の命名規則を使用する複数のメトリックをクエリする場合は、ワイルドカード機能を使用して、各メトリック名を個別に指定しなくても、すべてのメトリックの結果を返すことができます。
ワイルドカードがあなたをサポートします。
- 指標を集約し、結果をグラフ化する
FACET
グラフのメトリック名による結果- 指定された命名規則に合致するすべてのメトリクスを検索し、チャート化する。
ワイルドカードは、既存の命名規則に一致する新しいメトリックを後で追加する場合に特に役立ちます。クエリで各メトリック名を書き出す代わりに%
を使用することで、新しいメトリックを追加するときにクエリを書き直す必要がなくなります。
同様のタスクを実行する複数のアルゴリズムがあるとします。次のようなメトリクスを定義して、異なるアルゴリズムの持続時間を表示することができます。
myNeatProcess.algorithm1.duration
myNeatProcess.algorithm2.duration
myNeatProcess.algorithm3.duration
クエリで使用する場合、 myNeatProcess.%.duration
は上記の3つのアルゴリズムすべての結果を返します。後でalgorithm4
、 algorithm5
、およびalgorithm6
という名前の新しいアルゴリズムを作成すると、同じクエリで6つのアルゴリズムすべての結果が返されます。
を使用して個々のフィールドの結果を返します。 getField()
複数のタイプのMetric
データ(たとえば、 gauge
とcount
) があり、各タイプにはいくつかの関連フィールドがあります。使用可能なフィールドのタイプの詳細については、 getField()
を参照してください。
getField()
を使用してこれらのフィールドを抽出できます。たとえば、メトリック内の単一の値を使用してWHERE
句で比較を行う場合は、 getField(metricName, field)
またはmetricName[field]
を使用できます。
メトリクスデータを見る
NRQL keyset
およびuniques
関数をmetricName
属性(すべてのメトリックで使用可能)と一緒に使用して、アカウントで使用可能なすべてのメトリックを一覧表示したり、特定のメトリックで使用可能な属性を検出したりすることができます。