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)

既知の制限

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

  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)

  コピー