Metricデータタイプの問い合わせ

メトリクスがメトリクス API (その API を使用する統合からのものを含む) を介して New Relic に報告されると、データはMetricデータ型として報告され、クエリに使用できます。

このドキュメントでは、次のことを説明しています。

• メトリクスの表示と問い合わせ方法
• メトリック・クエリの例
• ワイルドカードを使って複数のメトリクスを照会する方法
• メトリクスデータの調べ方

APMメトリクスのタイムスライスデータの照会

APMでは、メトリックタイムスライスデータと呼ばれる特定のタイプのデータを報告しています。このデータを照会する方法については、 Query metric timeslice data を参照してください。

他のタイプのメトリクスについては、 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はメトリック・データのチャート化、探索、分析にも使用できます。

FROM Metric 
  SELECT latest(container_memory_usage_bytes), latest(container_spec_memory_limit_bytes) 
  WHERE containerName = 'inventory' 
  TIMESERIES

FROM Metric 
  SELECT (latest(container_spec_memory_limit_bytes) - latest(container_memory_usage_bytes)) 
    / latest(container_spec_memory_limit_bytes) 
    * 100 
    AS '% Memory Available' 
  WHERE containerName = 'inventory' 
  TIMESERIES

FROM Metric 
  SELECT filter(
    latest(
      container_memory_usage_bytes), 
    WHERE containerName = 'discovery') 
  + filter(
    latest(
      container_memory_usage_bytes), 
    WHERE containerName = 'my-proxy') 
  AS 'Total (k8s)' 
  WHERE clusterName = 'my-cluster' AND podName LIKE 'my-pilot-%' 
  TIMESERIES

FROM Metric SELECT * WHERE metricName = 'container_fs_usage_bytes' LIMIT 20 RAW

ワイルドカードを使って複数のメトリクスを検索

ワイルドカードは、NRQLでは%文字で表されます。標準の命名規則を使用する複数のメトリックをクエリする場合は、ワイルドカード機能を使用して、各メトリック名を個別に指定しなくても、すべてのメトリックの結果を返すことができます。

ワイルドカードがあなたをサポートします。

• 指標を集約し、結果をグラフ化する
• FACET グラフのメトリック名による結果
• 指定された命名規則に合致するすべてのメトリクスを検索し、チャート化する。

ワイルドカードは、既存の命名規則に一致する新しいメトリックを後で追加する場合に特に役立ちます。クエリで各メトリック名を書き出す代わりに%を使用することで、新しいメトリックを追加するときにクエリを書き直す必要がなくなります。

同様のタスクを実行する複数のアルゴリズムがあるとします。次のようなメトリクスを定義して、異なるアルゴリズムの持続時間を表示することができます。

• myNeatProcess.algorithm1.duration
• myNeatProcess.algorithm2.duration
• myNeatProcess.algorithm3.duration

クエリで使用する場合、 myNeatProcess.%.durationは上記の3つのアルゴリズムすべての結果を返します。後でalgorithm4 、 algorithm5 、およびalgorithm6という名前の新しいアルゴリズムを作成すると、同じクエリで6つのアルゴリズムすべての結果が返されます。

FROM Metric 
    SELECT average(myNeatProcess.%.duration) 
    FACET metricName TIMESERIES

FROM Metric 
    SELECT average(myNeatProcess.%.duration) TIMESERIES

FROM Metric 
    SELECT myNeatProcess.algorithm1.duration / sum(myNeatProcess.%.duration) TIMESERIES

を使用して個々のフィールドの結果を返します。 getField()

Metricデータには複数のタイプ( gaugeやcountなど) があり、各タイプには複数の関連するfieldsがあります。 使用可能なフィールドの種類の詳細については、 getField()を参照してください。

これらのフィールドを抽出するには、 getField()を使用できます。 たとえば、 WHERE句で比較を行うために Metrics 内の単一の値を使用する場合は、 getField(metricName, field)または短縮構文metricName[field]を使用できます。

FROM Metric 
SELECT average(apm.service.transaction.duration) 
WHERE appName = 'MyApp' 
AND getField(apm.service.transaction.duration, total) / getField(apm.service.transaction.duration, count) > 2

FROM Metric 
SELECT average(apm.service.transaction.duration) 
WHERE appName = 'MyApp' 
AND apm.service.transaction.duration[total] / apm.service.transaction.duration[count] > 2

FROM Metric 
SELECT uniques(metricName) 
WHERE getField(%, type) = 'gauge'

FROM Metric 
SELECT uniques(metricName) 
WHERE %[type] = 'gauge'

メトリクスデータを見る

NRQL keysetおよびuniques関数をmetricName属性（すべてのメトリックで使用可能）と一緒に使用して、アカウントで使用可能なすべてのメトリックを一覧表示したり、特定のメトリックで使用可能な属性を検出したりすることができます。

FROM Metric SELECT uniques(metricName)

FROM Metric SELECT uniques(metricName) WHERE hostname = 'host1.mycompany.com'

FROM Metric SELECT keyset() WHERE metricName = METRIC_NAME