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 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 CloudWatch, consulte o Guia CloudWatch do usuário da Amazon.

Importante

As métricas EC2 da API da Amazon são um recurso opcional. É necessário solicitar acesso a ele. 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 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 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. Escolha a guia Fale conosco e selecione o idioma e o método de contato preferidos.

11. Selecione Enviar.

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

Metrics

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	Description
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 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 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, 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 de métricas

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.

• 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 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

Sumário

• Visualizando CloudWatch métricas

• Criação de CloudWatch alarmes

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 da EC2métrica.

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 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:

• list-metrics (AWS CLI)

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

• Obter CWMetric uma lista (AWS Tools for Windows PowerShell)

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

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 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 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. Marque a caixa de seleção ao lado da DescribeInstancesque está na 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 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 Usando CloudWatch alarmes da Amazon no Guia do CloudWatch usuário da Amazon.