Monitore solicitações de EC2 API da Amazon usando a Amazon CloudWatch - Amazon Elastic Compute Cloud
Ative as métricas da EC2 API da AmazonMétricas e dimensões EC2 da API da AmazonRetenção de dados métricosMonitorando solicitações feitas em seu nomeFaturamentoTrabalhando com a Amazon CloudWatch

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á.

Monitore solicitações de EC2 API da Amazon usando a Amazon CloudWatch

Você pode monitorar solicitações de EC2 API da Amazon usando a Amazon CloudWatch, que coleta dados brutos e os processa em métricas legíveis, quase em tempo real. Essas métricas fornecem uma maneira simples de rastrear o uso e os resultados das operações de EC2 API da Amazon ao longo do tempo. Essas informações oferecem uma perspectiva melhor sobre o desempenho de seus aplicativos da Web e permitem identificar e diagnosticar uma variedade de problemas. Você também pode definir alarmes que observem determinados limites e enviar notificações ou realizar ações específicas quando esses limites forem atingidos.

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

Importante

As métricas EC2 da API da Amazon são um recurso opcional. Você deve solicitar acesso a esse recurso. Para obter mais informações, consulte Ative as métricas da EC2 API da Amazon.

Ative as métricas da EC2 API da Amazon

Use o procedimento a seguir para solicitar acesso a esse recurso para seu Conta da AWS.

Para solicitar acesso a esse recurso

  1. AWS Support Centro aberto.

  2. Escolha Criar caso.

  3. Escolha Conta e faturamento.

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

  5. Em Categoria, escolha Uso 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. Na guia Fale conosco, escolha seu idioma de contato preferido e método de contato.

  11. Selecione Enviar.

Métricas e dimensões EC2 da API da Amazon

Métricas

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

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 algo que o cliente fez, 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 pela Amazon EC2 APIs foi excedida para sua conta.

As solicitações de EC2 API da Amazon são limitadas para ajudar a manter o desempenho do serviço. Se suas solicitações foram limitadas, você receberá o Client.RequestLimitExceeded erro.

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, exceção ou falha no AWS servidor.

Unidade: contagem

SuccessfulCalls

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

Unidade: contagem

Dimensões

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

Retenção de dados métricos

As métricas EC2 da API da Amazon são enviadas CloudWatch em intervalos de 1 minuto. CloudWatch retém os dados métricos da seguinte forma:

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

  • Os pontos de dados com um período de 300 segundos (5 minutos) estão disponíveis por 63 dias.

  • Os pontos de dados com um período de 3600 segundos (1 hora) estão disponíveis por 455 dias (15 meses).

Monitorando solicitações feitas em seu nome

Solicitações de API feitas por AWS serviços em seu nome, como solicitações feitas por funções vinculadas a serviços, não contam para seus limites de limitação de API e não enviam métricas para a Amazon CloudWatch para sua conta. Essas solicitações não podem ser monitoradas usando CloudWatch.

As solicitações de API feitas em seu nome por provedores de serviços terceirizados contam para seus limites de limitação de API e enviam métricas para a Amazon CloudWatch para sua conta. Essas solicitações podem ser monitoradas usando CloudWatch.

Faturamento

Aplicam-se CloudWatch preços e encargos padrão. Nenhuma cobrança adicional é aplicada pelo uso das métricas da EC2 API da Amazon. Para obter mais informações, consulte Amazon CloudWatch Pricing.

Trabalhando com a Amazon CloudWatch

Visualizando CloudWatch métricas

Use o procedimento a seguir para visualizar as métricas da EC2 API da Amazon.

Pré-requisito

Você deve habilitar o acesso às métricas de EC2 API da Amazon para sua conta. Para obter mais informações, consulte Ative as métricas da EC2 API da Amazon.

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

  1. Abra o CloudWatch console 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 EC2métrico.

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

    nota

    As métricas ficam ocultas após duas semanas de inatividade. Se eles não receberem novos pontos de dados nas últimas duas semanas, eles 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 retornados pelo comando list-metrics AWS CLI . Para recuperar essas métricas, use os get-metric-statisticscomandos get-metric-dataou.

Para visualizar as métricas da EC2 API da Amazon usando a linha de comando

Use um dos seguintes comandos:

Criação de CloudWatch alarmes

Você pode criar um CloudWatch alarme 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 para um tópico do SNS com base no valor da métrica em relação a um determinado limite em vários períodos.

Por exemplo, você pode criar um alarme que monitore o número de solicitações de DescribeInstances API 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 de DescribeInstances API atinge um limite de 10 erros do lado do servidor durante um período de 5 minutos.

Pré-requisito

Você deve habilitar o acesso às métricas da EC2 API da Amazon para sua conta. Para obter mais informações, consulte Ative as métricas da EC2 API da Amazon.

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

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

  2. No painel de navegação, selecione Alarmes, 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. DescribeInstancesMarque a caixa de seleção ao lado da mesma linha do nome da ServerErrorsmétrica.

    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 5 minutos estão selecionados.

    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. Por mais de... , insira 10.

    3. Escolha Próximo.

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

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

      1. Para o gatilho do estado de alarme, escolha Em alarme.

      2. Em Selecionar um tópico do SNS, escolha Selecionar um tópico do 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, insira um nome para o alarme. O nome deve conter somente caracteres ASCII.

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

    3. Escolha Próximo.

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

Para obter mais informações, consulte Usando CloudWatch alarmes da Amazon no Guia do CloudWatch usuário da Amazon.