# 检索性能详情的时间序列指标
<a name="USER_PerfInsights.API.TimeSeries"></a>

`GetResourceMetrics` 操作从 Performance Insights 数据中检索一个或多个时间序列指标。`GetResourceMetrics` 需要指标和时间段，并返回包含数据点列表的响应。

例如，AWS 管理控制台使用 `GetResourceMetrics` 来填充 **Counter Metrics (计数器指标)** 图表和 **Database Load (数据库负载)** 图表，如下图所示。

![\[“Counter Metrics (计数器指标)”和“Database Load (数据库负载)”图表\]](http://docs.aws.amazon.com/zh_cn/AmazonRDS/latest/UserGuide/images/perf-insights-api-charts.png)


`GetResourceMetrics` 返回的所有指标都是标准的时间序列指标，但 `db.load` 除外。此指标显示在 **Database Load (数据库负载)** 图表中。`db.load` 指标不同于其他时间序列指标，因为您可以将它分为称为*维度*的子组件。在上图中，按组成 `db.load` 的等待状态对 `db.load` 进行细分和分组。

**注意**  
`GetResourceMetrics` 也可以返回 `db.sampleload` 指标，但 `db.load` 指标在大多数情况下是合适的。

有关 `GetResourceMetrics` 返回的计数器指标的信息，请参阅[性能详情计数器指标](USER_PerfInsights_Counters.md)。

指标支持以下计算：
+ 平均值 – 指标在一段时间内的平均值。在指标名称后面附加 `.avg`。
+ 最小值 – 指标在一段时间内的最小值。在指标名称后面附加 `.min`。
+ 最大值 – 指标在一段时间内的最大值。在指标名称后面附加 `.max`。
+ 总计 – 指标值在一段时间内的总计。在指标名称后面附加 `.sum`。
+ 样本数 – 在一段时间内收集指标的次数。在指标名称后面附加 `.sample_count`。

例如，假定在 300 秒（5 分钟）时段内收集指标，并且每分钟收集一次指标。各分钟的值为 1、2、3、4 和 5。在本例中，返回以下计算：
+ 平均值 – 3
+ 最小值 – 1
+ 最大值 – 5
+ 总计 – 15
+ 样本数 – 5

有关使用 `get-resource-metrics` AWS CLI 命令的信息，请参阅 [https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html)。

对于 `--metric-queries` 选项，请指定一个或多个要获取其结果的查询。每个查询包括必需的 `Metric` 和可选的 `GroupBy` 和 `Filter` 参数。以下是 `--metric-queries` 选项规范的示例。

```
{
   "Metric": "string",
   "GroupBy": {
     "Group": "string",
     "Dimensions": ["string", ...],
     "Limit": integer
   },
   "Filter": {"string": "string"
     ...}
```