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 del editor de consultas de La fuente de CloudWatch datos de Amazon Managed Grafana proporciona un potente editor de consultas que le permite recuperar y analizar métricas y registros de varios AWS servicios a los que se envían datos. CloudWatch El editor de consultas admite dos modos de consulta distintos: búsqueda métrica y CloudWatch registros. El modo de editor de consultas para las métricas utiliza la CloudWatch API para buscar las métricas cargadas en CloudWatch. El modo de registros utiliza los CloudWatch registros APIs para buscar registros. Cada modo tiene su propio editor de consultas especializado. Para seleccionar la API con la que desea hacer la consulta, utilice el conmutador de modo de consulta situado en la parte superior del editor. **Topics** + [ # Uso del editor de consultas de métricas ](CloudWatch-using-the-metric-query-editor.md) + [ # Uso del editor de consultas CloudWatch de Amazon Logs ](CloudWatch-using-the-logs-query-editor.md) # Uso del editor de consultas de métricas El editor de consultas métricas le permite crear dos tipos de consultas: **búsqueda de métricas** y **consulta de métricas**. La opción **Consulta de métricas consulta** los datos mediante CloudWatch Metrics Insights. ## Campos comunes del editor de consultas Hay tres campos que son comunes a los modos **Búsqueda de métricas** y **Consulta de métricas**. **Campos comunes** **Id** La API de `GetMetricData` requiere que todas las consultas tengan un ID único. Utilice este campo para especificar un ID de su elección. El ID puede contener números, letras y guiones bajos, y debe comenzar por una letra minúscula. Si no se especifica ningún ID, Amazon Managed Grafana genera un ID utilizando el siguiente patrón: `query[refId of the current query row]`. Por ejemplo, `queryA` representa la primera fila de consulta en el editor del panel. **Periodo** Un período es el período de tiempo asociado a una CloudWatch estadística específica. Los periodos se definen en números de segundos. Los valores válidos incluyen 1, 5, 10, 30 o cualquier múltiplo de 60. Si deja el campo de período en blanco o se establece en`auto`, se calculará automáticamente en función del intervalo de tiempo y de la política CloudWatch de retención. La fórmula utilizada es `time range in seconds / 2000`, y a continuación, pasa al siguiente valor superior de una matriz de periodos predefinidos [60, 300, 900, 3600, 21 600, 86 400] tras eliminar los periodos en función de la retención. Para ver qué periodo utiliza Amazon Managed Grafana, seleccione **Mostrar vista previa de consultas** en el editor de consultas. **Alias** Se aplican los siguientes patrones de alias. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/CloudWatch-using-the-metric-query-editor.html) # Uso de la opción de búsqueda de métricas Para crear una consulta válida en **Búsqueda de métricas**, debe especificar el espacio de nombres, el nombre de la métrica y al menos una estadística. Si la opción **Coincidir con exactitud** está activada, también debe especificar todas las dimensiones de la métrica que está consultando. El esquema de métricas debe coincidir exactamente. Para obtener más información, consulte la [sintaxis de las expresiones de CloudWatch búsqueda](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/search-expression-syntax.html). Si la opción **Coincidir con exactitud** está desactivada, puede especificar cualquier número de dimensiones por las que desee filtrar. Se muestran hasta 100 métricas que coinciden con sus criterios de filtro. ## Consultas dinámicas que utilizan caracteres comodín de dimensión Puede supervisar una lista dinámica de métricas utilizando el carácter comodín asterisco (`*`) para uno o más valores de dimensión. Esto le ayuda a supervisar las métricas de los AWS recursos, como las instancias o los contenedores de EC2. Por ejemplo, cuando se crean nuevas instancias como parte de un evento de escalado automático, aparecerán automáticamente en el gráfico sin que tengas que realizar un seguimiento de la nueva instancia IDs. Actualmente, esta capacidad se limita a recuperar un máximo de 100 métricas. Puede seleccionar **Mostrar vista previa de consultas** para ver la expresión de búsqueda que se crea automáticamente para admitir caracteres comodín. De forma predeterminada, la expresión de búsqueda se define de tal manera que las métricas consultadas deben coincidir exactamente con los nombres de las dimensiones definidas. Esto significa que en el ejemplo solo se devuelven las métricas con exactamente una dimensión llamada `InstanceId`. Para incluir métricas que tengan definidas otras dimensiones, puede desactivar **Coincidir con exactitud**. Al desactivar **Coincidir con exactitud**, también se crea una expresión de búsqueda aunque no utilice caracteres comodín. Grafana busca cualquier métrica que coincida al menos con el espacio de nombres, el nombre de la métrica y todas las dimensiones definidas. ## Variables de plantilla de varios valores Al definir los valores de las dimensiones en función de variables de plantilla con varios valores, se utiliza una expresión de búsqueda para consultar las métricas coincidentes. Esto permite el uso de varias variables de plantilla en una consulta. También puede usar variables de plantilla para las consultas que tengan la opción **Coincidir con exactitud** desactivada. Actualmente, las expresiones de búsqueda están limitadas a 1024 caracteres, por lo que la consulta podría fallar si tiene una lista de valores larga. Si desea consultar todas las métricas que tengan algún valor para un nombre de dimensión determinado, le recomendamos que utilice el carácter comodín asterisco (`*`) en lugar de la opción (`All`). El uso de variables de plantilla con varios valores solo se admite para los valores de dimensión. El uso de variables de plantilla con varios valores para `Region`, `Namespace`, o `Metric Name` no se admite. ## Expresiones matemáticas de métricas Para crear nuevas métricas de series temporales, utilice funciones matemáticas sobre las CloudWatch métricas. Se admiten los operadores aritméticos, la resta unaria y otras funciones, que se pueden aplicar a las métricas. CloudWatch [Para obtener más información sobre las funciones matemáticas CloudWatch métricas, consulte Uso de la matemática métrica.](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html) Por ejemplo, para aplicar operaciones aritméticas a una métrica, asigne un ID (una cadena única) a la métrica sin procesar. A continuación, puede usar este ID y aplicarle operaciones aritméticas en el campo `Expression` de la nueva métrica. Si usa el campo `Expression` para hacer referencia a otra consulta, por ejemplo `queryA * 2`, no puede crear una regla de alerta basada en esa consulta. ## Periodo Un período es el período de tiempo asociado a una CloudWatch estadística específica de Amazon. Los periodos se definen en números de segundos. Los valores válidos incluyen 1, 5, 10, 30 o cualquier múltiplo de 60. Si deja el campo de periodo en blanco o se establece en **Automático**, se calculará automáticamente en función del intervalo de tiempo. La fórmula utilizada es `time range in seconds / 2000` y, a continuación, pasa al siguiente valor superior de una matriz de periodos predefinidos `[60, 300, 900, 3600, 21600, 86400]`. Para ver qué periodo utiliza Amazon Managed Grafana, seleccione **Mostrar vista previa de consultas** en el editor de consultas. ## Conexión profunda entre los paneles de Grafana y la consola CloudWatch Al elegir una serie temporal en el panel, se muestra un menú contextual con un enlace a **Ver en la CloudWatch consola**. Al seleccionar ese enlace, se abre una nueva pestaña que lo lleva a la CloudWatch consola y muestra todas las métricas de esa consulta. Si actualmente no has iniciado sesión en la CloudWatch consola, el enlace te redirigirá a la página de inicio de sesión. El enlace proporcionado es válido para todos Cuenta de AWS , pero solo muestra las métricas correctas si has iniciado sesión en la Cuenta de AWS que corresponde a la fuente de datos seleccionada en Grafana. Esta característica no está disponible para métricas que se basan en expresiones de matemáticas de métricas. # 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 características pueden estar sujetas a cambios. Puedes consultar los datos de CloudWatch Metrics Insights eligiendo el `metric query` modo en el **editor de consultas de Metric**. CloudWatch Metrics Insights es un potente motor de consultas SQL de alto rendimiento que puedes utilizar para consultar tus métricas a escala. Se trata de un motor de consultas rápido y flexible basado en SQL que puede utilizar para identificar tendencias y patrones en todas sus CloudWatch métricas en tiempo real. Utiliza un dialecto de SQL. Para obtener más información sobre la sintaxis de consultas de Información de métricas, consulte [Sintaxis y palabras clave de las consultas](#metrics-insights-syntax-keywords). ## Sintaxis y palabras clave de las consultas CloudWatch Metrics Insights utiliza un dialecto de SQL. En el siguiente ejemplo se muestra la sintaxis de la consulta. ``` SELECT FUNCTION(metricName) FROM namespace | [ SCHEMA(namespace[, labelKey [, ...] ]) ] [ WHERE labelKey OPERATOR labelValue [AND|OR|([...])*] [, ...] ] [ GROUP BY labelKey [, ...]] [ ORDER BY FUNCTION() [DESC | ASC] ] [ LIMIT number] ``` Las palabras clave no distinguen entre mayúsculas y minúsculas, pero los identificadores sí. Los identificadores incluyen los nombres de las métricas, los espacios de nombres y las dimensiones. En la siguiente tabla se facilitan las palabras clave de consulta y sus descripciones. | Palabra clave | Description (Descripción) | | --- | --- | | FUNCTION | Obligatorio. Especifica la función de agregado que se va a utilizar y también 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 métricas que contiene la métrica consultada o una función de tabla de SCHEMA. Algunos ejemplos de espacios de nombres son AWS/EC2 y 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 \$1= '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 y DESC. | | LIMIT | (Opcional) Limita el número de series temporales que se devuelven. | A continuación se muestran algunos ejemplos: + ``` SELECT AVG(CPUUtilization) FROM "AWS/EC2" ``` Hace coincidir todas las métricas `CPUUtilization` del espacio de nombres `AWS/EC2`, ignora sus dimensiones y devuelve una única serie temporal agregada. + ``` SELECT AVG(CPUUtilization) FROM SCHEMA("AWS/EC2") ``` Solo coincide con las métricas `CPUUtilization` del espacio de nombres `AWS/EC2` 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` y`AvailabilityZone`. Los valores de etiqueta deben rodearse con 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 de métricas, los nombres de métricas y las claves de etiquetas que contienen caracteres que no son letras, números y guiones bajos (`_`) deben estar rodeados de comillas dobles. Por ejemplo, `SELECT MAX("My.Metric")`. Si uno de ellos contiene comillas dobles en sí (como `Bytes"Input"`), debe escapar esas 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 Información de métricas, 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 de creador y modo de código Puede crear una consulta en modo `Builder` o modo `Code`. **Creación de una consulta en modo `Builder`** 1. Examine y seleccione un espacio de nombres de métricas, un nombre de métrica, un filtro, un grupo y unas opciones de orden mediante la información de la tabla anterior. 1. Para cada una de estas opciones, elija una opción de la lista de opciones posibles. **Creación de una consulta en modo `Code`** 1. Escriba su consulta en el editor de código. 1. Para ejecutar la consulta, seleccione **Ejecutar consulta** en el editor de código. Para crear una consulta el modo `builder`, haga lo siguiente: + Examine y seleccione un espacio de nombres de métricas, un nombre de métrica, un filtro, un grupo y unas opciones de orden mediante la información de la tabla anterior. + Para cada una de estas opciones, elija una opción de la lista de opciones posibles. Grafana crea automáticamente una consulta SQL en función de sus selecciones. Para crear una consulta el modo `code`, haga lo siguiente: + Escriba su consulta en el editor de código. + Para ejecutar la consulta, seleccione **Ejecutar consulta** en el editor de código. El editor de código tiene la característica 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 ingresar un espacio, una coma o un signo de dólar. También puede utilizar la combinación de teclado `CTRL+Space`. 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 característica de autocompletar. ## 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. Las características se pueden agregar o cambiar 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). ### Ejemplos de EC2 Ver métricas de uso de CPU por instancia: ``` SELECT AVG(CPUUtilization) FROM "AWS/EC2" GROUP BY InstanceId ``` Ver la utilización promedio de CPU en toda la flota: ``` SELECT AVG(CPUUtilization) FROM SCHEMA("AWS/EC2", InstanceId) ``` Ver las 10 instancias con el uso promedio de CPU más alto: ``` SELECT MAX(CPUUtilization) FROM "AWS/EC2" GROUP BY InstanceId LIMIT 10 ``` Ver las 10 instancias con el mayor uso de CPU, 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" ``` Ver el tiempo promedio 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 ``` Ver el tiempo de ejecución de Lambda promedio, mínimo y máximo: ``` SELECT MAX(Duration) FROM "AWS/Lambda" ``` ### Ejemplos de Application Load Balancer Vea las métricas que tienen las dimensiones **LoadBalancer**y **AvailabilityZone** ``` SELECT SUM(RequestCount) FROM SCHEMA("AWS/ApplicationELB", LoadBalancer, AvailabilityZone) ``` Ver las métricas con el número de conexiones TCP simultáneas activas: ``` SELECT AVG(ActiveConnectionCount) FROM "AWS/ApplicationELB" ``` ### Ejemplos de Amazon EBS Ver 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 promedio de escritura del volumen de Amazon EBS: ``` SELECT AVG(VolumeTotalWriteTime) FROM "AWS/EBS" ``` Ver el tiempo promedio de inactividad del volumen de Amazon EBS: ``` 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 volúmenes de Amazon EBS: ``` SELECT AVG(VolumeWriteBytes) FROM "AWS/EBS" ``` ### Ejemplos de Amazon Simple Storage Service Ver el grupo de latencia promedio por nombre de bucket: ``` SELECT AVG(TotalRequestLatency) FROM "AWS/S3" GROUP BY BucketName ``` Ver el número promedio de objetos por bucket en todos los buckets 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 Ejemplos de uso de API 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 puede consultar las tres horas de datos más recientes. + Una única consulta puede procesar un máximo de 10 000 métricas. Esto significa que, si las cláusulas `SELECT`, `FROM` y `WHERE` coinciden con más de 10 000 métricas, la consulta solo procesará las primeras 10 000 de las métricas encontradas. + Una única consulta puede devolver un máximo de 500 series temporales. Esto significa que, si la consulta está procesando más de 500 métricas, no se devolverán todas las métricas en los resultados de la consulta. Si usa una cláusula `ORDER BY`, se ordenan todas las métricas que se procesan y se devuelven las 500 que tienen los valores más altos o más bajos según su cláusula `ORDER BY`. Si no incluye una cláusula `ORDER BY`, no puede controlar qué 500 métricas coincidentes se devuelven. + Cada operación `GetMetricData` puede tener solo una consulta, pero puede tener varios widgets en un panel y que cada uno incluya una consulta. # Uso del editor de consultas CloudWatch de Amazon Logs Para consultar CloudWatch los registros, seleccione la región y hasta 20 grupos de registros que desee consultar. Utilice el área de entrada principal para escribir la consulta. Para obtener más información, consulte [Sintaxis de consultas de CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html). También puede escribir consultas que devuelvan datos de series temporales mediante el `stats` comando de CloudWatch Logs Insights. Al hacer consultas de `stats` en Explore, debe asegurarse de que está en el modo Explorador de métricas. A la derecha del campo de entrada de la consulta hay un enlace de CloudWatch Logs Insights que abre la consola de CloudWatch Logs Insights con la consulta. Puede continuar la exploración allí si es necesario. ## Uso de variables de plantilla Al igual que ocurre con otras fuentes de datos, la fuente de CloudWatch datos admite el uso de variables de plantilla en las consultas. Para obtener más información, consulte [Plantillas y variables](templates-and-variables.md). ## Enlaces profundos desde los paneles de Grafana a la consola Logs CloudWatch Si quieres ver tu consulta en la consola de CloudWatch Logs Insights, pulsa el botón **CloudWatch Logs Insights** situado junto al editor de consultas. Si actualmente no has iniciado sesión en la CloudWatch consola, el enlace te redirige a la página de inicio de sesión. El enlace proporcionado es válido para todos Cuenta de AWS , pero solo muestra las métricas correctas si has iniciado sesión en la Cuenta de AWS que corresponde a la fuente de datos seleccionada en Grafana. ## Alertas Como las consultas de CloudWatch registros pueden devolver datos numéricos, por ejemplo, mediante el uso del `stats` comando, se admiten las alertas. Para obtener más información, consulte [Alertas de Grafana](alerts-overview.md).