Monitore instâncias da API do Amazon EC2 usando o Amazon CloudWatch - Amazon Elastic Compute Cloud
Habilite métricas da API do Amazon EC2Dimensões e métricas da API do Amazon EC2Retenção de dados de métricasMonitorar solicitações feitas em seu nomeFaturamentoComo trabalhar com o Amazon CloudWatch

Monitore instâncias da API do Amazon EC2 usando o Amazon CloudWatch

Você pode monitorar solicitações de API do Amazon EC2 usando o Amazon CloudWatch, que coleta dados brutos e os processa em métricas legíveis quase em tempo real. Essas métricas oferecem uma maneira simples de rastrear o uso e os resultados das operações da API do Amazon EC2 ao longo do tempo. Essas informações oferecem uma perspectiva melhor sobre a performance de suas aplicações da web e possibilitam identificar e diagnosticar uma série de problemas. Também é possível definir alarmes que observam determinados limites e enviam notificações ou realizam ações quando esses limites são atingidos.

Para obter mais informações sobre o CloudWatch, consulte o Guia do usuário do Amazon CloudWatch.

Importante

As métricas da API do Amazon EC2 são um atributo opcional. É necessário solicitar acesso a ele. Para obter mais informações, consulte Habilite métricas da API do Amazon EC2.

Habilite métricas da API do Amazon EC2

Use o procedimento apresentado a seguir para solicitar acesso a esse atributo para a sua Conta da AWS.

Como solicitar acesso a esse atributo

  1. Abra o AWS Support Center.

  2. Escolha Criar caso.

  3. Escolha Conta e faturamento.

  4. Em Serviço, escolha Informações gerais e introdução.

  5. Em Categoria, escolha Usar a AWS e serviços.

  6. Selecione Próxima etapa: informações adicionais.

  7. Em Subject (Assunto), insira Request access to Amazon EC2 API metrics.

  8. Em Descrição, insira Please grant my account access to Amazon EC2 API metrics. Related page: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/monitor.html. Inclua também a região onde você precisa acessar.

  9. Escolha Próxima etapa: solucione ou entre em contato conosco.

  10. Escolha a guia Fale conosco e selecione o idioma e o método de contato preferidos.

  11. Selecione Enviar.

Dimensões e métricas da API do Amazon EC2

Métricas

As métricas da API do Amazon EC2 estão contidas no namespace AWS/EC2/API. A tabela a seguir lista as métricas disponíveis para solicitações da API do Amazon EC2.

Métrica Descrição

ClientErrors

O número de solicitações de API com falha causadas por erros do cliente.

Esses erros geralmente são causados por uma ação do cliente, como especificar um parâmetro incorreto ou inválido na solicitação ou usar uma ação ou recurso em nome de um usuário que não tem permissão para usar a ação ou o recurso.

Unidade: Contagem

RequestLimitExceeded

O número de vezes que a taxa máxima de solicitação permitida pelas APIs do Amazon EC2 foi excedida para sua conta.

As solicitações de API do Amazon EC2 têm controle de utilização para ajudar a manter a performance do serviço. Se as solicitações tiverem controle de utilização, você receberá o erro Client.RequestLimitExceeded.

Unidade: Contagem

ServerErrors

O número de solicitações de API com falha causadas por erros internos do servidor.

Esses erros geralmente são causados por um erro, uma exceção ou uma falha do servidor da AWS.

Unidade: Contagem

SuccessfulCalls

O número de solicitações de API bem-sucedidas.

Unidade: Contagem

Dimensões

Os dados de métricas do Amazon EC2 podem ser filtrados em todas as ações da API do EC2. Para acessar mais informações sobre dimensões, consulte Conceitos do Amazon CloudWatch.

Retenção de dados de métricas

As métricas da API do Amazon EC2 são enviadas ao CloudWatch em intervalos de um minuto. O CloudWatch mantém os dados de métrica da seguinte forma:

  • Pontos de dados com um período de 60 segundos (1 minuto) ficam disponíveis por 15 dias.

  • Pontos de dados com um período de 300 segundos (5 minutos) ficam disponíveis por 63 dias.

  • Pontos de dados com um período de 3.600 segundos (1 hora) ficam disponíveis por 455 dias (15 meses).

Monitorar solicitações feitas em seu nome

Solicitações de API feitas por serviços da AWS em seu nome, como solicitações feitas por perfis vinculadas a serviços, não contam para seus limites de controle de utilização da API e não enviam métricas ao Amazon CloudWatch para sua conta. Não é possível monitorar essas solicitações usando o CloudWatch.

As solicitações de API feitas em seu nome por provedores de serviços terceiros contam para seus limites de controle de utilização da API e enviam métricas ao Amazon CloudWatch para sua conta. É possível monitorar essas solicitações usando o CloudWatch.

Faturamento

São aplicados cobranças e preços padrão do CloudWatch. Nenhuma cobrança adicional é aplicada pelo uso das métricas da API do Amazon EC2. Para obter mais informações, consulte Preços do Amazon CloudWatch.

Como trabalhar com o Amazon CloudWatch

Visualizar métricas do CloudWatch

Use os procedimentos a seguir para visualizar as métricas da API do Amazon EC2.

Pré-requisito

É necessário habilitar o acesso às métricas da API do Amazon EC2 para sua conta. Para obter mais informações, consulte Habilite métricas da API do Amazon EC2.

Como visualizar as métricas da API do Amazon EC2 usando o console

  1. Abra o console do CloudWatch, em https://console.aws.amazon.com/cloudwatch/.

  2. No painel de navegação, escolha Métricas, Todas as métricas.

  3. Na guia Procurar, em Métricas, selecione a região desejada para visualizar as métricas.

  4. Escolha o namespace de métricas do EC2.

  5. Para visualizar as métricas, selecione a dimensão da métrica, como Métricas por instância.

    nota

    As métricas ficam ocultas após duas semanas de inatividade. Se elas não receberem novos pontos de dados nas últimas duas semanas, não aparecerão mais no console, não aparecerão quando você digitar o nome da métrica ou da dimensão na caixa de pesquisa do console e não serão exibidas pelo comando list-metrics da AWS CLI. Para recuperar essas métricas, use os comandos get-metric-data ou get-metric-statistics.

Como visualizar as métricas da API do Amazon EC2 usando a linha de comandos

Use um dos seguintes comandos:

  • list-metrics (AWS CLI)

    aws cloudwatch list-metrics --namespace "AWS/EC2/API"

  • Get-CWMetricList (AWS Tools for Windows PowerShell)

    Get-CWMetricList -Namespace "AWS/EC2/API"

Criar alarmes do CloudWatch

Você pode criar um alarme do CloudWatch que envia uma mensagem do Amazon SNS quando o alarme muda de estado. Um alarme observa uma única métrica por um período tempo que você especifica. Ele envia uma notificação a um tópico do SNS com base no valor da métrica relativo a um limite especificado em um número de períodos.

Por exemplo, você pode criar um alarme que monitore o número de solicitações da API DescribeInstances que falham devido a erros no servidor. O alarme a seguir envia uma notificação por e-mail quando o número de falhas na solicitação da API DescribeInstances atinge um limite de dez erros no lado do servidor durante um período de 5 minutos.

Pré-requisito

É necessário habilitar o acesso às métricas da API do Amazon EC2 para sua conta. Para obter mais informações, consulte Habilite métricas da API do Amazon EC2.

Como criar um alarme para erros do servidor de solicitações da API DescribeInstances do Amazon EC2

  1. Abra o console do CloudWatch, em https://console.aws.amazon.com/cloudwatch/.

  2. No painel de navegação, escolha Alarms (Alarmes), All alarms (Todos os alarmes).

  3. Selecione Criar alarme.

  4. Escolha Selecionar métrica e especifique o seguinte:

    1. Escolha EC2/API.

    2. Escolha Métricas por ação.

    3. Marque a caixa de seleção ao lado de DescribeInstances que está na mesma linha que o nome da métrica ServerErrors.

    4. Escolha Selecionar métrica.

  5. A página Specify metric and conditions (Especificar métrica e condições) será exibida, mostrando um gráfico e outras informações sobre a métrica e a estatística que você selecionou.

    1. Em Métrica, especifique o seguinte:

      1. Em Estatística, selecione Soma.

      2. Em Período, verifique se a opção 5 minutos está selecionada.

    2. Em Conditions (Condições), especifique o seguinte:

      1. Em Tipo de limite, escolha Estático.

      2. Para Sempre que ServerErrors for, escolha Maior/Igual >=.

      3. Para que..., insira 10.

    3. Escolha Próximo.

  6. A página Configure actions (Configurar ações) é exibida.

    1. Em Notificação, especifique o seguinte:

      1. Em Acionamento do estado do alarme, escolha Em alarme.

      2. Em Selecionar um tópico do SNS, escolha Selecionar um tópico SNS existente ou Criar novo tópico e preencha os campos obrigatórios para a notificação.

      3. Escolha Próximo.

  7. A página Adicionar nome e descrição é exibida.

    1. Em Nome do alarme, digite um nome para o alarme. O nome deve conter somente caracteres ASCII.

    2. Em Descrição do alarme, digite uma descrição opcional para o alarme.

    3. Escolha Próximo.

  8. A página Visualizar e criar é exibida. Verifique se as informações estão corretas e, depois, escolha Criar alarme.

Para obter mais informações, consulte Uso de alarmes do Amazon CloudWatch no Manual do usuário do Amazon CloudWatch.