Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

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

Modo de foco
Usando a opção de consulta métrica para consultar dados do CloudWatch Metrics Insights - Amazon Managed Grafana

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

nota

O Amazon CloudWatch Metrics Insights está em versão prévia. CloudWatch Os recursos do Metrics Insights estão abertos a todos Contas da AWS. Os recursos podem estar sujeitos a alterações.

Você pode consultar dados do CloudWatch Metrics Insights escolhendo o metric query modo no editor de consultas Metric.

CloudWatch O Metrics Insights é um poderoso mecanismo de consulta SQL de alto desempenho que você pode usar para consultar suas métricas em grande 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 de SQL. Para obter mais informações sobre a sintaxe de consulta do Metrics Insights, consulte Palavras-chave e sintaxe de consulta.

Palavras-chave e sintaxe de consulta

CloudWatch O Metrics Insights usa um dialeto do SQL. O exemplo a seguir mostra a sintaxe de 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. Os identificadores incluem os nomes das métricas, namespaces e dimensões.

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

Palavra-chave Descrição
FUNCTION Obrigatório. Especifica a função agregada 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 da tabela SCHEMA. Alguns exemplos de namespace são AWS/EC2 e AWS/Lambda.
SCHEMA (Opcional) Filtra os resultados da consulta para mostrar somente as métricas que são uma correspondência exata ou as métricas que não correspondem.
WHERE (Opcional) Filtra os resultados para mostrar 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 das séries temporais a serem retornadas. As opções são ASC e DESC.
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 as métricas de CPUUtilization no namespace AWS/EC2, ignorando suas dimensões, e retorna uma única série temporal agregada.

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

    Corresponde somente às métricas de CPUUtilization no namespace AWS/EC2 que não têm nenhuma dimensão definida.

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

    Corresponde somente às CPUUtilization métricas que foram reportadas CloudWatch com exatamente uma dimensão,InstanceId.

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

    Corresponde somente às RequestCount métricas que foram reportadas a CloudWatch partir AWS/ApplicationELB de exatamente duas dimensões, LoadBalancer e. AvailabilityZone

Os valores de rótulo devem sempre ser incluídos com aspas simples.

Caracteres de escape

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 estar entre aspas duplas. Por exemplo, SELECT MAX("My.Metric"). Se algum deles contiver aspas duplas (como Bytes"Input"), você deverá fazer o escape dessa aspa dupla com barras invertidas, como em SELECT 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 no modo Builder ou no modo Code.

Para criar uma consulta no modo Builder
  1. Procure e selecione um namespace da métrica, o nome da métrica, o filtro, o grupo e as 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 no modo Code
  1. Escreva a consulta no editor de código.

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

Para criar uma consulta no modo builder:

  • Procure e selecione um namespace da métrica, o nome da métrica, o filtro, o grupo e as 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 no modo code:

  • Escreva a consulta no editor de código.

  • Para executar a consulta, escolha Executar consulta 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 teclado CTRL+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 de Metrics Insights

nota

CloudWatch O Metrics Insights está em pré-visualização aberta. A pré-visualização está aberta para todas as AWS contas e você não precisa solicitar acesso. Alguns 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).

EC2 exemplos

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

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

Visualizar a média de utilização de CPU em toda a frota

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

Visualizar as dez instâncias com a maior média de utilização de CPU

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

Visualizar as dez instâncias com a maior utilização de CPU, ordenadas pelo valor máximo, em ordem decrescente

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

Nesse caso, o CloudWatch agente está coletando uma CPUUtilization métrica por aplicativo. 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"

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

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

Visualizar os tempos de execução médio, mínimo e máximo 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)

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

SELECT AVG(ActiveConnectionCount) FROM "AWS/ApplicationELB"

Exemplos do Amazon EBS

Visualizar as dez maiores médias de bytes de gravação por volume em ordem decrescente

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

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

SELECT AVG(VolumeTotalWriteTime) FROM "AWS/EBS"

Visualizar o tempo médio de ociosidade de 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"

Visualizar 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

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

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

Visualizar 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

A mazon-simple-notificaation-service - exemplos

SELECT AVG(NumberOfMessagesPublished) FROM "AWS/SNS"

Visualizar o número médio de mensagens que falharam para cada nome de tópico

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

AWS Exemplos de uso da API

Veja as 20 melhores AWS APIs 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 Atualmente, o Metrics Insights tem os seguintes limites:

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

  • Uma consulta única não pode processar mais de 10.000 métricas. Isso significa que se as cláusulas SELECT, FROM e WHERE corresponderem a mais de 10 mil métricas, apenas as primeiras 10 mil dessas métricas encontradas serão processadas pela consulta.

  • Uma consulta única não pode retornar mais de 500 séries temporais. Isso significa que se a consulta estiver processando mais de 500 métricas, nem todas as métricas serão retornadas nos resultados da consulta. Se você usar uma cláusula ORDER BY, todas as métricas sendo processadas serão classificadas, e as 500 que tiverem os valores mais altos ou mais baixos de acordo com a cláusula ORDER BY serão retornadas. Se você não incluir uma cláusula ORDER BY, não poderá controlar quais 500 métricas correspondentes serão retornadas.

  • Cada operação GetMetricData pode ter apenas uma consulta. No entanto, você pode ter vários widgets em um dashboard para que cada um inclua uma consulta.

PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.