# Recuperación de métricas de series temporales para Información de rendimiento
<a name="USER_PerfInsights.API.TimeSeries"></a>

La operación `GetResourceMetrics` recupera una o más métricas de series temporales a partir de los datos de Performance Insights. `GetResourceMetrics` requiere una métrica y un periodo de tiempo y devuelve una respuesta con una lista de puntos de datos. 

Por ejemplo, la Consola de administración de AWS usa `GetResourceMetrics` para completar el gráfico **Counter Metrics (Métricas de contador)** y el gráfico **Database Load (Carga de la base de datos)**, como se muestra en la siguiente imagen.

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


Todas las métricas que devuelve `GetResourceMetrics` son métricas de series temporales estándar con la excepción de `db.load`. Esta métrica se muestra en el gráfico **Database Load (Carga de base de datos)**. La métrica `db.load` es distinta de las demás métricas de series temporales porque puede desglosarla en subcomponentes llamados *dimensiones*. En la imagen anterior, `db.load` está desglosado y agrupado por los estados de espera que forman el `db.load`.

**nota**  
`GetResourceMetrics` también puede devolver la métrica `db.sampleload`, pero la métrica `db.load` es apropiada en la mayoría de los casos.

Para obtener información sobre las métricas de contador devueltas por `GetResourceMetrics`, consulte [Métricas de contador de Información de rendimiento](USER_PerfInsights_Counters.md).

Para las métricas se admiten los siguientes cálculos:
+ Media: el valor medio de la métrica durante un período de tiempo. Añada `.avg` al nombre de la métrica.
+ Mínimo: el valor mínimo de la métrica durante un período de tiempo. Añada `.min` al nombre de la métrica.
+ Máximo: el valor máximo de la métrica durante un período de tiempo. Añada `.max` al nombre de la métrica.
+ Suma: la suma de los valores de la métrica durante un periodo de tiempo. Añada `.sum` al nombre de la métrica.
+ Número de muestras: El número de veces que se recopiló la métrica durante un período de tiempo. Añada `.sample_count` al nombre de la métrica.

Supongamos, por ejemplo, que una métrica se recopila durante 300 segundos (5 minutos) y que la métrica se recopila una vez cada minuto. Los valores para cada minuto son 1, 2, 3, 4 y 5. En este caso, se devuelven los siguientes cálculos:
+ Media: 3
+ Mínimo: 1
+ Máximo: 5
+ Suma: 15
+ Número de muestras: 5

Para obtener información acerca del uso del comando `get-resource-metrics` de la 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 la opción `--metric-queries`, especifique una o más consultas para las que desea obtener resultados. Cada consulta consta de un parámetro `Metric` obligatorio y de parámetros opcionales `GroupBy` y `Filter`. A continuación, se muestra un ejemplo de una especificación de opción `--metric-queries`.

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