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á. # Usar o editor de consultas de métricas O editor de consultas de métricas permite que você crie dois tipos de consultas: **Pesquisa de métrica** e **Consulta de métrica**. A opção **Metric Query consulta** dados usando o CloudWatch Metrics Insights. ## Campos comuns do editor de consultas Há três campos que são comuns aos modos **Pesquisa de métrica** e **Consulta de métrica**. **Campos comuns** **Id** A API `GetMetricData` requer que todas as consultas tenham um ID exclusivo. Use este campo para especificar um ID de escolha. Ele pode incluir números, letras e sublinhados e deve começar com letra minúscula. Se nenhum ID for especificado, o Amazon Managed Grafana vai gerar um ID usando o seguinte padrão: `query[refId of the current query row]`. Por exemplo, `queryA` representa a primeira linha de consulta no editor de painéis. **Período** Um período é o período de tempo associado a uma CloudWatch estatística específica. Os períodos são definidos em segundos. Os valores válidos incluem 1, 5, 10, 30 ou qualquer múltiplo de 60. Se você mantiver o campo de período em branco ou definido como`auto`, ele será calculado automaticamente com base no intervalo de tempo e na política CloudWatch de retenção. A fórmula usada é `time range in seconds / 2000` e, em seguida, passa para o próximo valor mais alto em uma matriz de períodos predefinidos [60, 300, 900, 3600, 21600, 86400] após remover os períodos com base na retenção. Para ver qual período o Amazon Managed Grafana está usando, escolha **Mostrar pré-visualização da consulta** no editor de consultas. **Alias** Os padrões de alias a seguir se aplicam. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/grafana/latest/userguide/CloudWatch-using-the-metric-query-editor.html) # Usar a opção de pesquisa de métrica Para criar uma consulta válida em **Pesquisa de métrica**, você deve especificar o namespace, o nome da métrica e pelo menos uma estatística. Se a opção **Correspondência exata** estiver ativada, você também deverá especificar todas as dimensões da métrica que está consultando. O esquema de métricas deve ser uma correspondência exata. Para obter mais informações, consulte a [sintaxe CloudWatch da expressão de pesquisa](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/search-expression-syntax.html). Se **Correspondência exata** estiver desativado, você poderá especificar qualquer número de dimensões pelas quais deseja filtrar. Até cem métricas que correspondem aos seus critérios de filtro são retornadas. ## Consultas dinâmicas usando caracteres curinga de dimensão Você pode monitorar uma lista dinâmica de métricas usando o caractere curinga asterisco (`*`) para um ou mais valores de dimensão. Isso ajuda você a monitorar métricas de AWS recursos, como instâncias ou contêineres do EC2. Por exemplo, quando novas instâncias são criadas como parte de um evento de auto scaling, elas aparecem automaticamente no gráfico sem que você precise rastrear a nova instância IDs. Atualmente, esse recurso está limitado à recuperação de até cem métricas. Você pode escolher **Mostrar pré-visualização da consulta** para ver a expressão de pesquisa criada automaticamente para ser compatível com caracteres curinga. Por padrão, a expressão de pesquisa é definida de forma que as métricas consultadas correspondam exatamente aos nomes das dimensões definidas. Isso significa que, no exemplo, somente métricas com exatamente uma dimensão com o nome `InstanceId` serão retornadas. Para incluir métricas que tenham outras dimensões definidas, você pode desativar a opção **Correspondência exata**. Desativar a opção **Correspondência exata** também cria uma expressão de pesquisa, mesmo que você não use caracteres curinga. O Grafana pesquisa qualquer métrica que corresponda pelo menos ao namespace, ao nome da métrica e a todas as dimensões definidas. ## Variáveis de modelo de vários valores Ao definir valores de dimensão com base em variáveis de modelo de vários valores, uma expressão de pesquisa é usada para consultar as métricas correspondentes. Isso permite o uso de várias variáveis de modelo em uma consulta. Você também pode usar variáveis de modelo para consultas que tenham a opção **Correspondência exata** desativada. Atualmente, as expressões de pesquisa estão limitadas a 1.024 caracteres, portanto, sua consulta pode falhar se você tiver uma lista longa de valores. Se você quiser consultar todas as métricas que tenham algum valor para um determinado nome de dimensão, recomendamos usar o caractere curinga asterisco (`*`) em vez da opção `All`. O uso de variáveis de modelo com vários valores só é compatível com os valores de dimensão. O uso de variáveis de modelo de vários valores para `Region`, `Namespace` ou `Metric Name` não é compatível. ## Expressões matemáticas de métricas Você pode criar novas métricas de séries temporais operando com base nas CloudWatch métricas usando funções matemáticas. Operadores aritméticos, subtração unária e outras funções são suportados e podem ser aplicados às métricas. CloudWatch Para obter mais informações sobre funções matemáticas CloudWatch métricas, consulte [Usando matemática métrica](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html). Por exemplo, para aplicar operações aritméticas em uma métrica, forneça um ID (uma string exclusiva) à métrica bruta. Você pode então usar esse ID e aplicar operações aritméticas a ele no campo `Expression` da nova métrica. Se você usar o campo `Expression` para referenciar outra consulta, como `queryA * 2`, não poderá criar uma regra de alerta com base nessa consulta. ## Período Um período é o período de tempo associado a uma CloudWatch estatística específica da Amazon. Os períodos são definidos em segundos. Os valores válidos incluem 1, 5, 10, 30 ou qualquer múltiplo de 60. Se você mantiver o campo do período em branco ou definido como **automático**, ele será calculado automaticamente com base no intervalo de tempo. A fórmula usada é `time range in seconds / 2000`, e depois passa para o próximo valor mais alto em uma matriz de períodos predefinidos de `[60, 300, 900, 3600, 21600, 86400]`. Para ver qual período o Amazon Managed Grafana está usando, escolha **Mostrar pré-visualização da consulta** no editor de consultas. ## Vinculação profunda dos painéis Grafana ao console CloudWatch A escolha de uma série temporal no painel mostra um menu de contexto com um link para **Exibir no CloudWatch console**. A escolha desse link abre uma nova guia que leva você ao CloudWatch console e exibe todas as métricas dessa consulta. Se você ainda não estiver conectado ao CloudWatch console, o link o encaminhará para a página de login. O link fornecido é válido para qualquer um Conta da AWS , mas só exibe as métricas corretas se você estiver conectado ao Conta da AWS que corresponde à fonte de dados selecionada no Grafana. Esse recurso não está disponível para métricas baseadas em expressões matemáticas de métrica. # 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 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](#metrics-insights-syntax-keywords). ## 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 | Description | | --- | --- | | 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 \$1= '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. 1. 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. 1. 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). ### Exemplos do EC2 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 **LoadBalancer**e **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.