Performance Insightsのメトリクスに指定可能な値について

Question

Performance Insightsの値をAWS CLIを使用して取得したいと考えております。
```
aws pi get-resource-metrics --service-type RDS --identifier db-****** --start-time 2025-05-14T03:00:00Z --end-time 2025-05-14T03:01:00Z --period-in-seconds 1 --metric-queries file://E:\query.json --region ap-northeast-1 --output json > $outputFile
```
を実行すると下記のエラーメッセージがでました。

`An error occurred (ValidationException) when calling the GetResourceMetrics operation: Validation error(s) detected: Value at 'metricQueries' failed to satisfy constraints.`

query.jsonで指定しているメトリクスの値が正しくないことによるエラーかと思いますが、メトリクス名は間違いないことを確認できております。
となるとメトリクス毎に指定している値(min/max/total/avg)の条件に触れているかと思われるのですが、
メトリクス毎に指定可能な値(min/max/total/avg)を知る方法はないでしょうか。
指定しているメトリクスの数が多く1つずつの検証は難しいため、指定可能な値を知りたいです。

re:Post Agent · Answer

AWS CLI の get-resource-metrics コマンドは、GetResourceMetrics API に対応しております[1]。

この GetResourceMetrics API では、MetricQueries に指定できる要素の数に最小 1、最大 15 という制限がございます[2]。

今回「指定しているメトリクスの数が多く」とお伝えいただいておりますので、get-resource-metrics コマンドの --metric-queries オプションで指定している「E:\query.json」内の要素の数が 15 個以上である可能性がございます。

つきまして、「E:\query.json」に含まれる要素の数をご確認いただくとともに、15 個以上の場合には 15 個以下に減らすことで該当のエラーを回避できるかご確認いただけますと幸いです。

もし、上記に該当しない、または上記対応でもエラーを回避できない場合には、詳細調査が必要となりますので、下記情報とともに AWS サポートへお問い合わせいただけますと幸いです。

1. 実行した AWS CLI コマンド
2. 実行時に発生したエラー
3. 対象 DB インスタンスの ARN
4. --metric-queries オプションで指定した JSON ファイルの内容

**参考:**

[1] [Performance Insights API for Aurora によるメトリクスの取得 - Amazon Aurora](https://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.API.html)

[2] [GetResourceMetrics - Amazon RDS Performance Insights](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetResourceMetrics.html#performanceinsights-GetResourceMetrics-request-MetricQueries)

MetricQueries
    An array of one or more queries to perform. Each query must specify a Performance Insights metric and specify an aggregate function, and you can provide filtering criteria. You must append the aggregate function to the metric. For example, to find the average for the metric db.load you must use db.load.avg. Valid values for aggregate functions include .avg, .min, .max, and .sum.

Type: Array of MetricQuery objects

Array Members: Minimum number of 1 item. Maximum number of 15 items.

Required: Yes

Performance Insightsのメトリクスに指定可能な値について

回答を追加する

関連するコンテンツ