Usando a opção de consulta métrica para consultar dados do CloudWatch Metrics Insights

nota

O Amazon CloudWatch Metrics Insights está com a previsualização. CloudWatch Os recursos do Metrics Insights estão abertos a todosContas da AWS. Os recursos podem estar sujeitos a alteração.

Você pode consultar dados do CloudWatch Metrics Insights escolhendo ometric query modo no editor de consultas de métricas.

CloudWatch O Metrics Insights é um poderoso mecanismo de consulta SQL de alta performance que você pode usar para consultar suas métricas em escala. É um mecanismo de consulta rápido, flexível e baseado em SQL que você pode usar para identificar tendências e padrões em todas as suas CloudWatch métricas em tempo real. Ele usa um dialeto do SQL. Para obter mais informações sobre a sintaxe de consulta do Metrics Insights, consulteSintaxe e palavras-chave da consulta.

Sintaxe e palavras-chave da consulta

CloudWatch O Metrics Insights usa um dialeto do SQL. O exemplo a seguir mostra a sintaxe da 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]
    

As palavras-chave não diferenciam maiúsculas de minúsculas, mas os identificadores diferenciam maiúsculas de minúsculas. Os identificadores incluem os nomes das métricas, namespaces e dimensões.

A tabela a seguir fornece as palavras-chave da consulta e suas descrições.

Palavra-chave	Descrição
FUNCTION	Obrigatório. Especifica a função de agregação a ser usada, e também o nome da métrica a ser consultada. Os valores válidos são AVG, COUNT, >MAX, MIN e SUM.
MetricName	Obrigatório. Por exemplo, CPUUtilization.
FROM	Obrigatório. Especifica a fonte da métrica. Você pode especificar o namespace da métrica que contém a métrica a ser consultada ou uma função de tabela SCHEMA. Alguns exemplos de namespace sãoAWS/EC2AWS/Lambda e.
SCHEMA	(Opcional) Filtra os resultados da consulta para mostrar somente as métricas que correspondem exatamente ou as métricas que não correspondem.
WHERE	(Opcional) Filtra os resultados para mostrar apenas as métricas que correspondem à expressão especificada serão mostradas apenas as métricas que correspondem à expressão especificada. Por exemplo, WHERE InstanceType != 'c3.4xlarge'.
GROUP BY	(Opcional) Agrupa os resultados da consulta em várias séries temporais. Por exemplo, GROUP BY ServiceName.
ORDER BY	(Opcional) Especifica a ordem da série temporal a ser retornada. As opções sãoASCDESC e.
LIMIT	(Opcional) Limita o número de séries temporais a serem retornadas.

Veja os seguintes exemplos:

• SELECT AVG(CPUUtilization) FROM "AWS/EC2" 

  Corresponde a todas asCPUUtilization métricas noAWS/EC2 namespace, ignorando suas dimensões e retorna uma única série temporal agregada.

• SELECT AVG(CPUUtilization) FROM SCHEMA("AWS/EC2")

  Corresponde somente àsCPUUtilization métricas noAWS/EC2 namespace que não têm dimensões definidas.

• SELECT AVG(CPUUtilization) FROM SCHEMA("AWS/EC2", InstanceId)

  Corresponde somente àsCPUUtilization métricas que foram relatadas CloudWatch com exatamente uma dimensão,InstanceId.

• SELECT SUM(RequestCount) FROM SCHEMA("AWS/ApplicationELB", LoadBalancer,
      AvailabilityZone) 

  Corresponde somente àsRequestCount métricas que foram reportadas CloudWatch a umAWS/ApplicationELB formulário com exatamente duas dimensões,LoadBalancerAvailabilityZone e.

Os valores do rótulo devem ser incluídos por aspas simples.

Personagens de fuga

Em uma consulta, os valores de rótulo devem sempre estar cercados por aspas simples.   Por exemplo, SELECT MAX(CPUUtilization) FROM "AWS/EC2" WHERE AutoScalingGroupName = 'my-production-fleet'.

Namespaces de métricas, nomes de métricas e chaves de rótulo que contenham caracteres diferentes de letras, números e sublinhados (_) devem ser cercados por aspas duplas. Por exemplo, SELECT MAX("My.Metric"). Se um deles contiver aspas duplas (comoBytes"Input"), você deve fazer o escape dessa aspa dupla com barras invertidas, como emSELECT AVG("Bytes\"Input\""). Se um namespace de métrica, nome da métrica ou chave de rótulo contiver uma palavra que seja palavra-chave reservada no Metrics Insights, eles também deverão estar entre aspas duplas. Por exemplo, se você tiver uma métrica chamada LIMIT, você pode usar SELECT AVG("LIMIT"). Também é válido colocar qualquer namespace, nome da métrica ou rótulo entre aspas duplas, mesmo que não inclua uma palavra-chave reservada.

Modo Builder e modo de código

Você pode criar uma consulta noBuilder modo ou noCode modo.

Para criar uma consulta noBuilder modo

1. Procure e selecione um namespace métrico, nome da métrica, filtro, grupo e opções de ordem usando as informações da tabela anterior.

2. Para cada uma dessas opções, escolha na lista de opções possíveis.

Para criar uma consulta noCode modo

1. Escreva sua consulta no editor de código.

2. Para executar a consulta, escolha Executar consulta no editor de código.

Para criar uma consulta nobuilder modo:

• Procure e selecione um namespace métrico, nome da métrica, filtro, grupo e opções de ordem usando as informações da tabela acima.

• Para cada uma dessas opções, escolha na lista de opções possíveis.

O Grafana constrói automaticamente uma consulta SQL com base em suas seleções.

Para criar uma consulta nocode modo:

• Escreva sua consulta no editor de código.

• Para executar a consulta, escolha a consulta Executar no editor de código.

O editor de código tem um recurso de preenchimento automático integrado que fornece sugestões de palavras-chave, agregações, namespaces, métricas, rótulos e valores de rótulos. As sugestões são mostradas quando você insere um espaço, vírgula ou cifrão. Você também pode usar a combinação de teclasCTRL+Space.

O editor de código pode preencher automaticamente a consulta. No entanto, o uso de variáveis de modelo no editor de código pode interferir no preenchimento automático.

CloudWatch Exemplos do Metrics Insights

nota

CloudWatch O Metrics Insights está com a previsualização aberta. A previsualização está disponível para todas as contas da AWS e você não precisa solicitar acesso. Recursos poderão ser adicionados ou alterados antes do anúncio de disponibilização para o público.

Esta seção contém exemplos de consultas úteis do CloudWatch Metrics Insights que você pode copiar e usar diretamente ou copiar e modificar no editor de consultas. Alguns desses exemplos já estão disponíveis no console, e você pode acessá-los escolhendo Add query (Adicionar consulta) na visualização de Metrics (Métricas).

Exemplos do EC2

Exibir métricas de utilização de CPU por instância

SELECT AVG(CPUUtilization)
FROM "AWS/EC2"
GROUP BY InstanceId
    

Veja a utilização média da CPU em toda a frota

SELECT AVG(CPUUtilization)
FROM SCHEMA("AWS/EC2", InstanceId)
    

Veja as 10 instâncias com a maior média de utilização da CPU

SELECT MAX(CPUUtilization)
FROM "AWS/EC2"
GROUP BY InstanceId
LIMIT 10
    

Veja as 10 instâncias com a maior utilização da CPU, ordenadas pelo máximo, em ordem decrescente

SELECT AVG(CPUUtilization)
FROM "AWS/EC2"
GROUP BY InstanceId
ORDER BY MAX() DESC
LIMIT 10 

Nesse caso, o CloudWatch atendente está coletando uma métrica de utilização de CPU por aplicação. Esta consulta filtra a média dessa métrica por um nome de aplicação específico.

SELECT AVG(CPUUtilization)
FROM "AWS/CWAgent"
WHERE ApplicationName = 'eCommerce'
SELECT AVG(ConcurrentExecutions)
FROM "AWS/Lambda"

Visualize o tempo médio de execução das 10 principais funções do Lambda, ordenadas pelo máximo, em ordem decrescente

SELECT AVG(Duration)
FROM "AWS/Lambda"
GROUP BY FunctionName
ORDER BY MAX() DESC
LIMIT 10

Veja os tempos máximo, médio e mínimo de execução do Lambda

SELECT MAX(Duration)
FROM "AWS/Lambda"

Exemplos do Application Load Balancer

Visualize métricas que têm as dimensões LoadBalancere AvailabilityZone

SELECT SUM(RequestCount)
FROM SCHEMA("AWS/ApplicationELB", LoadBalancer, AvailabilityZone)

Visualize métricas com o número de conexões TCP simultâneas ativas

SELECT AVG(ActiveConnectionCount)
FROM "AWS/ApplicationELB"

Exemplos de Amazon EBS

Veja os 10 principais bytes médios de gravação por volume em ordem decrescente

SELECT AVG(VolumeWriteBytes)
FROM "AWS/EBS"
GROUP BY VolumeId
ORDER BY MAX() DESC
LIMIT 10

Exibir o tempo médio de gravação do volume do volume do Amazon EBS

SELECT AVG(VolumeTotalWriteTime)
FROM "AWS/EBS"

Exibir o tempo médio de inatividade do volume do 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"

Visualize a média de bytes de gravação nos volumes do Amazon EBS

SELECT AVG(VolumeWriteBytes)
FROM "AWS/EBS"

Exemplos do Amazon Simple Storage Service para PHP

Exibir grupo de latência média por nome do bucket

SELECT AVG(TotalRequestLatency)
FROM "AWS/S3"
GROUP BY BucketName

Visualize o número médio de objetos por bucket em todos os buckets do Amazon S3

SELECT AVG(NumberOfObjects)
FROM "AWS/S3"
GROUP BY BucketName
    

Exemplos do Amazon Simple Notification Service

Amazon-simple-notificaation-service - exemplos

SELECT AVG(NumberOfMessagesPublished)
FROM "AWS/SNS"

Exibir o número médio de mensagens falhadas para cada nome de tópico

SELECT AVG(NumberOfNotificationsFailed)
FROM "AWS/SNS"
GROUP BY TopicName

Exemplos de uso de API da AWS

Veja as 20 principaisAWS APIs da pelo número de chamadas em sua conta

SELECT COUNT(CallCount)
FROM "AWS/Usage"
WHERE "Type" = 'API'
GROUP BY "Service", "Resource"
ORDER BY SUM() DESC
LIMIT 20

CloudWatch Limites do Metrics Insights

CloudWatch No momento, o Metrics Insights tem os seguintes limites:

• Você só pode consultar os dados das três últimas horas.

• Uma consulta única não pode processar mais de 10.000 métricas. Isto significa que, se asWHERE cláusulasSELECTFROM, e corresponderem a mais de 10.000 métricas, apenas as primeiras 10.000 dessas métricas encontradas serão processadas pela consulta serão processadas pela consulta serão processadas pela consulta.

• Uma consulta única não pode retornar mais de 500 séries temporais. Isto significa que, se a consulta estiver sendo processada em mais de 500 métricas, nem todas as métricas serão processadas no resultado da consulta. Se você usar umaORDER BY cláusula, todas as métricas que estão sendo processadas serão classificadas serão classificadas serão classificadas serão classificadas serão classificadas serão classificadas serão classificadas serão classificadas serão classificadas serão classificadas serão classificadas serão classificadas, e as 500 que têm os valores mais altos ou mais baixos de acordo com suaORDER BY cláusula serão process Se você não incluir umaORDER BY cláusula, não poderá controlar quais 500 métricas correspondentes serão processadas.

• CadaGetMetricData operação pode ter apenas uma consulta, mas você pode ter vários widgets em um painel para que cada um inclua uma consulta.