Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Uso de la opción de consulta de métricas para consultar datos de CloudWatch Metrics Insights
nota
Amazon CloudWatch Metrics Insights está en versión preliminar. CloudWatch Las funciones de Metrics Insights están abiertas a todos Cuentas de AWS. Las funciones pueden estar sujetas a cambios.
Puede consultar los datos de CloudWatch Metrics Insights seleccionando el metric
query
modo en el editor de consultas de Metric.
CloudWatch Metrics Insights es un potente motor de SQL consultas de alto rendimiento que puedes utilizar para consultar tus métricas a escala. Se trata de un motor de SQL consultas rápido y flexible que puedes utilizar para identificar tendencias y patrones en todas tus CloudWatch métricas en tiempo real. Utiliza un dialecto deSQL. Para obtener más información sobre la sintaxis de consulta de Metrics Insights, consulteSintaxis y palabras clave de la consulta.
Sintaxis y palabras clave de la consulta
CloudWatch Metrics Insights usa un dialecto deSQL. El siguiente ejemplo muestra la sintaxis de la consulta.
SELECT
FUNCTION
(metricName
) FROMnamespace
| [ SCHEMA(namespace
[, labelKey [, ...] ]) ] [ WHERElabelKey
OPERATOR labelValue [AND|OR|([...])*] [, ...] ] [ GROUP BYlabelKey
[, ...]] [ ORDER BYFUNCTION
() [DESC | ASC] ] [ LIMITnumber
]
Las palabras clave no distinguen entre mayúsculas y minúsculas, pero los identificadores sí lo hacen. Los identificadores incluyen los nombres de las métricas, los espacios de nombres y las dimensiones.
La siguiente tabla proporciona las palabras clave de la consulta y sus descripciones.
Palabra clave | Descripción |
---|---|
FUNCTION
|
Obligatorio. Especifica la función de agregado que se va a utilizar y también especifica el nombre de la métrica que se va a consultar. Los valores válidos son AVG , COUNT , MAX , MIN y SUM . |
MetricName
|
Obligatorio. Por ejemplo, CPUUtilization . |
FROM
|
Obligatorio. Especifica el origen de la métrica. Puede especificar el espacio de nombres de la métrica que contiene la métrica que se va a consultar o una función de SCHEMA tabla. Algunos ejemplos de espacios de nombres son y. AWS/EC2 AWS/Lambda |
SCHEMA
|
(Opcional) Filtra los resultados de la consulta para mostrar solo las métricas que coinciden exactamente o las que no coinciden. |
WHERE
|
(Opcional) Filtra los resultados para mostrar solo las métricas que coinciden con la expresión especificada. Por ejemplo, WHERE InstanceType !=
'c3.4xlarge' . |
GROUP BY
|
(Opcional) Agrupa los resultados de la consulta en varias series temporales. Por ejemplo, GROUP BY
ServiceName . |
ORDER BY
|
(Opcional) Especifica el orden de las series temporales que se van a devolver. Las opciones son ASC yDESC . |
LIMIT
|
(Opcional) Limita el número de series temporales que se van a devolver. |
A continuación se muestran algunos ejemplos:
-
SELECT AVG(CPUUtilization) FROM "AWS/EC2"
Hace coincidir todas
CPUUtilization
las métricas del espacio deAWS/EC2
nombres, ignora sus dimensiones y devuelve una única serie temporal agregada. -
SELECT AVG(CPUUtilization) FROM SCHEMA("AWS/EC2")
Solo coincide con las
CPUUtilization
métricas del espacio deAWS/EC2
nombres que no tienen ninguna dimensión definida. -
SELECT AVG(CPUUtilization) FROM SCHEMA("AWS/EC2", InstanceId)
Solo coincide con las
CPUUtilization
métricas sobre las que se informó CloudWatch con exactamente una dimensión,.InstanceId
-
SELECT SUM(RequestCount) FROM SCHEMA("AWS/ApplicationELB", LoadBalancer, AvailabilityZone)
Solo coincide con las
RequestCount
métricas CloudWatch de las que se informóAWS/ApplicationELB
con exactamente dos dimensiones,LoadBalancer
yAvailabilityZone
.
Los valores de las etiquetas deben ir entre comillas simples.
Caracteres de escape
En una consulta, los valores de etiqueta siempre deben estar rodeados de comillas simples. Por ejemplo, SELECT
MAX(CPUUtilization) FROM "AWS/EC2" WHERE
AutoScalingGroupName = 'my-production-fleet'
.
Los espacios de nombres métricos, los nombres de las métricas y las claves de etiqueta que contengan caracteres distintos de letras, números y guiones bajos (_
) deben ir entre comillas dobles. Por ejemplo, SELECT MAX("My.Metric")
. Si una de ellas contiene una comilla doble en sí misma (por ejemploBytes"Input"
), debe evitar las comillas dobles con barras invertidas, como en. SELECT
AVG("Bytes\"Input\"")
Si un espacio de nombres de métrica, un nombre de métrica o una clave de etiqueta contienen una palabra que es una palabra clave reservada en Metrics Insights, también debe rodearse de comillas dobles. Por ejemplo, si tiene una métrica denominada LIMIT
, utilizaría SELECT
AVG("LIMIT")
. También es válido incluir cualquier espacio de nombres, nombre de métrica o etiqueta entre comillas dobles, incluso si no contiene una palabra clave reservada.
Modo constructor y modo código
Puede crear una consulta en Builder
modo o Code
modo.
Para crear una consulta en Builder
modo
-
Busque y seleccione las opciones de espacio de nombres, nombre de métrica, filtro, grupo y orden de una métrica utilizando la información de la tabla anterior.
-
Para cada una de estas opciones, elija una opción de la lista de opciones posibles.
Para crear una consulta en Code
modo
-
Escribe tu consulta en el editor de código.
-
Para ejecutar la consulta, selecciona Ejecutar consulta en el editor de código.
Para crear una consulta en el builder
modo:
-
Busque y seleccione las opciones de espacio de nombres, nombre de métrica, filtro, grupo y orden de una métrica utilizando la información de la tabla anterior.
-
Para cada una de estas opciones, elija una de las opciones posibles de la lista.
Grafana crea automáticamente una SQL consulta en función de sus selecciones.
Para crear una consulta en el code
modo:
-
Escribe tu consulta en el editor de código.
-
Para ejecutar la consulta, selecciona Ejecutar consulta en el editor de código.
El editor de código tiene una función de autocompletar integrada que ofrece sugerencias de palabras clave, agregaciones, espacios de nombres, métricas, etiquetas y valores de etiquetas. Las sugerencias se muestran al introducir un espacio, una coma o un signo de dólar. También puede utilizar la combinación CTRL+Space
de teclas.
El editor de código puede completar automáticamente la consulta. Sin embargo, el uso de variables de plantilla en el editor de código puede interferir con la finalización automática.
CloudWatch Ejemplos de Metrics Insights
nota
CloudWatch Metrics Insights está en versión preliminar abierta. La vista previa está abierta a todas AWS las cuentas y no es necesario que solicites acceso. Es posible que se agreguen o cambien funciones antes de anunciar la disponibilidad general.
Esta sección contiene ejemplos de consultas útiles de CloudWatch Metrics Insights que puedes copiar y usar directamente o copiar y modificar en el editor de consultas. Algunos de estos ejemplos ya están disponibles en la consola; para obtener acceso a ellos, elija Add query (Agregar consulta) en la vista de Metrics (Métricas).
EC2ejemplos
Vea las métricas de CPU utilización por instancia
SELECT AVG(CPUUtilization) FROM "AWS/EC2" GROUP BY InstanceId
Vea la CPU utilización media de toda la flota
SELECT AVG(CPUUtilization) FROM SCHEMA("AWS/EC2", InstanceId)
Vea las 10 instancias con el promedio de CPU utilización más alto
SELECT MAX(CPUUtilization) FROM "AWS/EC2" GROUP BY InstanceId LIMIT 10
Vea las 10 instancias con mayor CPU utilización, ordenadas por el máximo y en orden descendente
SELECT AVG(CPUUtilization) FROM "AWS/EC2" GROUP BY InstanceId ORDER BY MAX() DESC LIMIT 10
En este caso, el CloudWatch agente recopila una CPUUtilization métrica por aplicación. Esta consulta filtra el promedio de esta métrica para un nombre de aplicación específico.
SELECT AVG(CPUUtilization) FROM "AWS/CWAgent" WHERE ApplicationName = 'eCommerce' SELECT AVG(ConcurrentExecutions) FROM "AWS/Lambda"
Vea el tiempo medio de ejecución de las 10 principales funciones de Lambda, ordenadas por el máximo y en orden descendente
SELECT AVG(Duration) FROM "AWS/Lambda" GROUP BY FunctionName ORDER BY MAX() DESC LIMIT 10
Vea el máximo, el promedio y el mínimo de los tiempos de ejecución de Lambda
SELECT MAX(Duration) FROM "AWS/Lambda"
Ejemplos de Application Load Balancer
Vea las métricas que tienen las dimensiones LoadBalancery AvailabilityZone
SELECT SUM(RequestCount) FROM SCHEMA("AWS/ApplicationELB", LoadBalancer, AvailabilityZone)
Vea las métricas con el número de conexiones simultáneas TCP activas
SELECT AVG(ActiveConnectionCount) FROM "AWS/ApplicationELB"
EBSEjemplos de Amazon
Vea los 10 principales bytes de escritura promedio por volumen en orden descendente
SELECT AVG(VolumeWriteBytes) FROM "AWS/EBS" GROUP BY VolumeId ORDER BY MAX() DESC LIMIT 10
Ver el tiempo medio de escritura por EBS volumen de Amazon
SELECT AVG(VolumeTotalWriteTime) FROM "AWS/EBS"
Ver el tiempo medio de inactividad EBS del volumen de Amazon
SELECT AVG(VolumeIdleTime) FROM "AWS/EBS" View average burst balance per volume SELECT AVG(BurstBalance) FROM "AWS/EBS" GROUP BY VolumeId View average read bytes across Amazon EBS volumes SELECT AVG(VolumeReadBytes) FROM "AWS/EBS"
Ver el promedio de bytes de escritura en los EBS volúmenes de Amazon
SELECT AVG(VolumeWriteBytes) FROM "AWS/EBS"
Ejemplos de Amazon Simple Storage Service
Vea el grupo de latencia promedio por nombre de bucket
SELECT AVG(TotalRequestLatency) FROM "AWS/S3" GROUP BY BucketName
Vea la cantidad media de objetos por depósito en todos los depósitos de Amazon S3
SELECT AVG(NumberOfObjects) FROM "AWS/S3" GROUP BY BucketName
Ejemplos de Amazon Simple Notification Service
Amazon-simple-notificaation-service: ejemplos
SELECT AVG(NumberOfMessagesPublished) FROM "AWS/SNS"
Ver el número promedio de mensajes fallidos para cada nombre de tema
SELECT AVG(NumberOfNotificationsFailed) FROM "AWS/SNS" GROUP BY TopicName
AWS APIejemplos de uso
Consulta las 20 principales AWS APIs según el número de llamadas en tu cuenta
SELECT COUNT(CallCount) FROM "AWS/Usage" WHERE "Type" = 'API' GROUP BY "Service", "Resource" ORDER BY SUM() DESC LIMIT 20
CloudWatch Límites de Metrics Insights
CloudWatch Actualmente, Metrics Insights tiene los siguientes límites:
Solo puedes consultar los datos de las últimas tres horas.
Una única consulta puede procesar un máximo de 10 000 métricas. Esto significa que si las
WHERE
cláusulasSELECT
FROM
, y coinciden con más de 10 000 métricas, la consulta solo procesará las 10 000 primeras métricas que se encuentren.Una única consulta puede devolver un máximo de 500 series temporales. Esto significa que si la consulta procesa más de 500 métricas, no todas las métricas se devolverán en los resultados de la consulta. Si utilizas una
ORDER BY
cláusula, se ordenarán todas las métricas que se estén procesando y se devolverán las 500 que tengan los valores más altos o más bajos según tuORDER BY
cláusula. Si no incluye unaORDER BY
cláusula, no podrá controlar qué 500 métricas coincidentes se devolverán.Cada
GetMetricData
operación solo puede tener una consulta, pero puede tener varios widgets en un panel y cada uno de los cuales incluya una consulta.