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á.
Usando a opção de consulta métrica para consultar dados do CloudWatch Metrics Insights
nota
O Amazon CloudWatch Metrics Insights está em versão prévia. CloudWatch Os recursos do Metrics Insights estão abertos a todosContas 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 do SQL. Para obter mais informações sobre a sintaxe de consulta do Metrics Insights, consulteSintaxe de consulta e palavras-chave.
Sintaxe de consulta e palavras-chave
CloudWatch O Metrics Insights usa um dialeto do SQL. O exemplo a seguir mostra a sintaxe da consulta.
SELECT
FUNCTION
(metricName
) FROMnamespace
| [ SCHEMA(namespace
[, labelKey [, ...] ]) ] [ WHERElabelKey
OPERATOR labelValue [AND|OR|([...])*] [, ...] ] [ GROUP BYlabelKey
[, ...]] [ ORDER BYFUNCTION
() [DESC | ASC] ] [ LIMITnumber
]
As palavras-chave não diferenciam maiúsculas de minúsculas, mas os identificadores fazem distinção entre maiúsculas e 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 agregada a ser usada e também especifica 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 métrico que contém a métrica a ser consultada ou uma função da tabela SCHEMA. Alguns exemplos de namespace são e. AWS/EC2 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 coincidem. |
WHERE
|
(Opcional) Filtra os resultados para mostrar somente 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 DESC 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 as
CPUUtilization
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 às
CPUUtilization
métricas noAWS/EC2
namespace que não têm dimensões definidas. -
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 partirAWS/ApplicationELB
de exatamente duas dimensões,LoadBalancer
e.AvailabilityZone
Os valores dos rótulos devem estar entre aspas simples.
Personagens 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 métricos, nomes de métricas e chaves de rótulos que contenham caracteres diferentes de letras, números e sublinhados (_
) devem estar entre aspas duplas. Por exemplo, SELECT MAX("My.Metric")
. Se um deles contiver uma aspa dupla em si (comoBytes"Input"
), você deverá escapar 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 Builder
modo ou Code
no modo.
Para criar uma consulta no Builder
modo
-
Procure e selecione um namespace métrico, nome de métrica, filtro, grupo e opções de ordem usando as informações da tabela anterior.
-
Para cada uma dessas opções, escolha na lista de opções possíveis.
Para criar uma consulta no Code
modo
-
Escreva sua consulta no editor de código.
-
Para executar a consulta, escolha Executar consulta no editor de código.
Para criar uma consulta no builder
modo:
-
Navegue e selecione um namespace métrico, nome de 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.
Grafana constrói automaticamente uma consulta SQL com base em suas seleções.
Para criar uma consulta no code
modo:
-
Escreva sua 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 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 de Metrics Insights
nota
CloudWatch O Metrics Insights está em pré-visualizaçã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
Veja as métricas de utilização da 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 agente está coletando uma métrica de utilização da CPU 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"
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
Visualize o máximo, a média e o mínimo dos tempos 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 do Amazon EBS
Veja a média dos 10 bytes de gravação por volume em ordem decrescente
SELECT AVG(VolumeWriteBytes) FROM "AWS/EBS" GROUP BY VolumeId ORDER BY MAX() DESC LIMIT 10
Veja o tempo médio de gravação 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
Visualize o 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
A mazon-simple-notificaation-service - exemplos
SELECT AVG(NumberOfMessagesPublished) FROM "AWS/SNS"
Exibir o número médio de mensagens que falharam 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 principais 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 somente as três horas de dados mais recentes.
Uma consulta única não pode processar mais de 10.000 métricas. Isso significa que
SELECT
FROM
, se asWHERE
cláusulas, e corresponderem a mais de 10.000 métricas, somente as primeiras 10.000 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
ORDER BY
cláusula, todas as métricas que estão sendo processadas serão classificadas e as 500 que tiverem os valores mais altos ou mais baixos de acordo com suaORDER BY
cláusula serão retornadas. Se você não incluir umaORDER BY
cláusula, não poderá controlar quais 500 métricas correspondentes serão retornadas.Cada
GetMetricData
operação pode ter apenas uma consulta, mas você pode ter vários widgets em um painel, cada um incluindo uma consulta.