NRQLを使ってインフラストラクチャ次元のメトリクスを検索

ディメンション メトリックは、 メトリック データの保存とクエリの業界標準です。すべてのインフラストラクチャ メトリクスは New Relic に イベント データとして保存されます が、ディメンション メトリクスとしてクエリを実行することもできます。

このページでは、以下のことを学ぶことができます。

• ディメンション・メトリクスの の利点.
• いくつかの 例 をどのように、どこで使うかについて。
• ディメンション メトリックとイベント データのクエリの違い。

重要な理由

New Relic では、 メトリクス をいくつかの方法で報告しています。その中には、 ディメンション メトリクス が含まれており、メトリクス API、Telemetry SDK、いくつかのオープンソース インテグレーション、およびインフラストラクチャ サービスで使用されています。

このタイプのメトリックでは、以下のことが可能です。

• インフラストラクチャ データのクエリ エクスペリエンスが向上しました。
• すべてのメトリクスを1つの場所で確認できます。
• Prometheus のような、よりメートル単位のソースを利用することができます。

例えば、Lambda関数の最大継続時間を取得するクエリは簡素化されています。

FROM ServerlessSample
SELECT max(provider.duration.Maximum)
WHERE provider = 'LambdaFunction'

FROM Metric
SELECT max(aws.lambda.function.duration)

始めましょう

これらのメトリクスを使用するために、エージェントや統合の更新は必要ありません。

ディメンションメトリクスに基づくNRQLアラート もサポートされています。ただし、クラウド統合からのデータ（つまり、 AWSポーリング統合からのメトリクス, GCP, Azure ）は除きます。AWS CloudWatch Metric Streamsのメトリクスはディメンションメトリクスとして取り込まれ、NRQLアラートが推奨されます。

ディメンション・メトリクスのクエリの場所と方法

現在のすべてのNRQLクエリ機能がサポートされています。クエリでは、 WHERE 、 FACET 、およびSINCE 、 UNTIL 、 COMPARE WITHなどの時間選択関数を使用できます。

メトリクスとアトリビュートの命名規則

ディメンションメトリックのすべてのメトリック名と属性は、見つけて使用しやすいように、同じ命名規則に従います。メトリクス名と属性名はドットで名前空間が設定されます。たとえば、 host.プレフィックスはホストメトリクスに使用され、 k8s.プレフィックスはKubernetesメトリクスに使用され、 aws.はAWSメトリクスに使用されます。

次の図は、3つの指標（ cpuPercent 、 ioTotalReadBytes 、およびioTotalWriteBytes ）を含むProcessSampleが3つの個別の指標に分割される方法を示しています。メトリックと属性の名前が更新されていることに注意してください。

例

ここでは、次元メトリクスを使用した場合と使用しない場合のNQRLクエリの例を紹介します。

FROM BlockDeviceSample
SELECT sum('provider.volumeTotalWriteTime.Sum')
WHERE provider = 'EbsVolume'
FACET entityName

FROM Metric
SELECT sum(aws.ebs.volume.TotalWriteTime)
FACET entity.name

FROM AzureServiceBusTopicSample
SELECT max(activeMessages.Maximum)
FACET resourceGroupName

FROM Metric
SELECT max(azure.servicebus.topic.activeMessages)
FACET azure.resourceGroup

FROM AzureFunctionsAppSample
SELECT sum(functionExecutionCount.Total)
FACET regionName
TIMESERIES SINCE 6 hours ago

FROM Metric
SELECT sum(azure.functions.app.functionExecutionCount)
FACET azure.region
TIMESERIES SINCE 6 hours ago

FROM AzureVirtualMachineScaleSetSample
SELECT uniqueCount(vMName)
FACET name
SINCE 30 MINUTES AGO COMPARE WITH 1 WEEK AGO

FROM Metric
SELECT uniqueCount(azure.vms.vmName)
FACET azure.resourceName
WHERE azure.resourceType='Microsoft.Compute/virtualMachineScaleSets'
SINCE 30 MINUTES AGO COMPARE WITH 1 WEEK AGO

FROM NginxSample
SELECT average(net.requestsPerSecond)
TIMESERIES

FROM Metric
SELECT average(nginx.server.net.requestsPerSecond)
TIMESERIES

FROM MysqlSample
SELECT max(net.maxUsedConnections)

FROM Metric
SELECT max(mysql.node.net.maxUsedConnections)

ディメンションメトリクスとイベントのクエリの違い

ディメンション メトリックは、イベント データとは根本的に異なるタイプのデータです。データ型の違いの概要については、 「New Relic データ型」を参照してください。

ディメンション メトリックをクエリする場合の顕著な違いをいくつか示します。

• * を使用したメトリック クエリは インフラストラクチャ サンプル データを返しません。例えば：

  SELECT * FROM Metric

  コピー

• metricName LIKE を使用したメトリクス クエリはインフラストラクチャ サンプル データを返しません。例えば：

  SELECT uniques(metricName) FROM Metric where metricName like 'k8%'

  コピー

• tags.で始まる属性を選択するには、メトリック名を指定する必要があります。たとえば、これはWHERE句なしでは機能しません。

  SELECT uniques(tags.environment) FROM Metric WHERE metricName='aws.lambda.function.duration'

  コピー

• 選択基準に一致するサンプルが多すぎると、結果が不完全になる可能性があります。たとえば、これはすべてのインフラストラクチャ サンプルにマップされ、不完全な結果が返される可能性があります。

  SELECT uniqueCount(entity.guid) FROM Metric

  コピー

• 最初は、新しく導入されたメトリック ワイルドカード機能はサポートされていません。次に例を示します。

  SELECT average(host.swap%Bytes) FROM Metric

  コピー

• 複数のメトリクスで使用される関数は、 失敗したり、誤った結果を返したりする場合があります。次に例を示します。

  FROM Metric SELECT latest(metricNameA + metricNameB)

  コピー