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

クエリビルダー New Relic One では、シンプルモードとアドバンスド（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 は、Infrastructure のすべてのサンプルにマッピングされるため、不完全な結果が返される可能性があります。
• 当初は、新しく導入されたメトリックのワイルドカード機能はサポートされていません（例： SELECT average(host.swap%Bytes) FROM Metric ）。