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 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).
**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](#enable-ec2-api-metrics).
**Topics**
+ [Ative as métricas da EC2 API da Amazon](#enable-ec2-api-metrics)
+ [Métricas e dimensões EC2 da API da Amazon](#monitor-metrics_dimensions)
+ [Retenção de dados de métricas](#monitor-retention)
+ [Monitorar solicitações feitas em seu nome](#throttling-metrics)
+ [Faturamento](#monitor-billing)
+ [Trabalhando com a Amazon CloudWatch](#monitor-using)
## 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](https://console.aws.amazon.com/support/home#/).
1. Escolha **Criar caso**.
1. Escolha **Conta e faturamento**.
1. Em **Serviço**, escolha **Informações gerais e introdução**.
1. Em **Categoria**, escolha **Uso AWS e serviços**.
1. Selecione **Próxima etapa: informações adicionais**.
1. Em **Subject (Assunto)**, insira **Request access to Amazon EC2 API metrics**.
1. 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.
1. Escolha **Próxima etapa: solucione ou entre em contato conosco**.
1. Escolha a guia **Fale conosco** e selecione o idioma e o método de contato preferidos.
1. 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 |
| `AwsTriggeredRequestLimitExceeded` | O número de solicitações de API com falha causadas pela limitação aplicada devido a um problema operacional. AWS Quando essa limitação ocorre, você recebe um `Client.RequestLimitExceeded` erro com uma mensagem indicando que sua solicitação foi limitada devido a um problema operacional. AWS Essa limitação é temporária e é resolvida automaticamente quando o problema operacional é resolvido. Implemente uma lógica de recuo exponencial e tente novamente para lidar com esses aceleradores temporários sem problemas. 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html).
## 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](https://aws.amazon.com/cloudwatch/pricing/).
## Trabalhando com a Amazon CloudWatch
**Contents**
+ [Visualizando CloudWatch métricas](#monitor-using-viewing)
+ [Criação de CloudWatch alarmes](#monitor-creating)
### 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](#enable-ec2-api-metrics).
**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/](https://console.aws.amazon.com/cloudwatch/).
1. No painel de navegação, escolha **Métricas**, **Todas as métricas**.
1. Na guia **Procurar**, em **Métricas**, selecione a região desejada para visualizar as métricas.
1. Escolha o namespace da **EC2**métrica.
1. 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](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html) da AWS CLI . Para recuperar essas métricas, use os [get-metric-statistics]()comandos [get-metric-data]()ou.
**Para visualizar as métricas da EC2 API da Amazon usando a linha de comando**
Use um dos seguintes comandos:
+ [list-metrics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html) (AWS CLI)
```
aws cloudwatch list-metrics --namespace "AWS/EC2/API"
```
+ [Obter CWMetric uma lista](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-CWMetricList.html) (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](#enable-ec2-api-metrics).
**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/](https://console.aws.amazon.com/cloudwatch/).
1. No painel de navegação, selecione **Alarmes**, **Todos os alarmes**.
1. Selecione **Criar alarme**.
1. Escolha **Selecionar métrica** e especifique o seguinte:
1. Escolha **EC2/API**.
1. Escolha **Métricas por ação**.
1. Marque a caixa de seleção ao lado da **DescribeInstances**que está na mesma linha do nome da **ServerErrors**métrica.
1. Escolha **Selecionar métrica**.
1. 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**.
1. Em **Período**, verifique se a opção **5 minutos** está selecionada.
1. Em **Conditions (Condições)**, especifique o seguinte:
1. Em **Tipo de limite**, escolha **Estático**.
1. **Para **Sempre que ServerErrors for**, escolha **Maior/Igual >=**.**
1. Para **que...**, insira **10**.
1. Escolha **Próximo**.
1. 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**.
1. 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.
1. Escolha **Próximo**.
1. 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.
1. Em **Descrição do alarme**, digite uma descrição opcional para o alarme.
1. Escolha **Próximo**.
1. 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) no *Guia do CloudWatch usuário da Amazon*.