# Recuperar métricas de séries temporais do Insights de Performance
<a name="USER_PerfInsights.API.TimeSeries"></a>

A operação `GetResourceMetrics` recupera uma ou mais métricas de séries temporais dos dados do Performance Insights. `GetResourceMetrics` requer uma métrica e um período de tempo e retorna uma resposta com uma lista de pontos de dados. 

Por exemplo, o Console de gerenciamento da AWS usa `GetResourceMetrics` para preencher o gráfico **Métricas de contador** e o gráfico **Carregamento do banco de dados**, como visto na imagem a seguir.

![\[Gráficos Counter Metrics e Database Load\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/perf-insights-api-charts.png)


Todas as métricas retornadas por `GetResourceMetrics` são métricas de séries temporais padrão, com exceção de `db.load`. Essa métrica é exibida no gráfico **Carregamento do banco de dados**. A métrica `db.load` é diferente das outras métricas da série temporal, pois você pode fragmentá-la em subcomponentes chamados de *dimensões*. Na imagem anterior, `db.load` é dividido e agrupado pelos estados de espera que compõem o `db.load`.

**nota**  
`GetResourceMetrics` também pode retornar a métrica `db.sampleload`, mas a métrica `db.load` é apropriada na maioria dos casos.

Para obter informações sobre as métricas de contador retornadas pelo `GetResourceMetrics`, consulte [Métricas de contadores do Performance Insights](USER_PerfInsights_Counters.md).

Os cálculos a seguir são compatíveis com as métricas:
+ Média: o valor médio para a métrica por um período. Adicione `.avg` ao nome da métrica.
+ Mínimo: o valor mínimo para a métrica por um período. Adicione `.min` ao nome da métrica.
+ Máximo: o valor máximo para a métrica por um período. Adicione `.max` ao nome da métrica.
+ Soma: a soma dos valores da métrica por um período. Adicione `.sum` ao nome da métrica.
+ Contagem de amostra: o número de vezes que a métrica foi coletada por um período. Adicione `.sample_count` ao nome da métrica.

Por exemplo, considere que uma métrica é coletada por 300 segundos (5 minutos) e que a métrica seja coletada uma vez por minuto. Os valores de cada minuto são 1, 2, 3, 4 e 5. Nesse caso, os seguintes cálculos são retornados:
+ Média: 3
+ Mínimo: 1
+ Máximo: 5
+ Soma: 15
+ Contagem de amostras: 5

Para obter informações sobre como usar o comando `get-resource-metrics` AWS CLI, consulte [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).

Para a opção `--metric-queries`, especifique uma ou mais consultas para as quais deseja obter resultados. Cada consulta consiste em um parâmetro obrigatório `Metric` e opcional `GroupBy` e em parâmetros `Filter`. Veja a seguir um exemplo de uma especificação de opção `--metric-queries`.

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