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などの時間選択関数を使用できます。

クエリビルダーは、シンプルモードとアドバンスト（NRQL）モードの両方でメトリックをサポートします。

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

ディメンションメトリックのすべてのメトリック名と属性は、見つけて使用しやすいように、同じ命名規則に従います。メトリクス名と属性名はドットで名前空間が設定されます。たとえば、 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 ）を返しません。
• tags.で始まる属性を選択するには、メトリック名を指定する必要があります。たとえば、 SELECT uniques(tags.environment) FROM Metric WHERE metricName='aws.lambda.function.duration'はWHERE句がないと機能しません。
• 選択基準が一致するサンプルが多すぎると、結果が完全でない場合があります。たとえば、 SELECT uniqueCount(entity.guid) FROM Metricはすべてのインフラストラクチャサンプルにマップされ、不完全な結果を返す場合があります。
• 最初は、新しく導入されたメトリックワイルドカード機能（たとえば、 SELECT average(host.swap%Bytes) FROM Metric ）はサポートされていません。