Recuperación de métricas de series temporales para Información de rendimiento
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 AWS Management Console 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.
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 sobre rendimiento.
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 get-resource-metrics
.
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" ...}