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á.
# Monitorando um aplicativo Amplify com a Amazon CloudWatch
AWS Amplify é integrado à Amazon CloudWatch, permitindo que você monitore métricas para seus aplicativos Amplify quase em tempo real e crie alarmes que enviam notificações quando uma métrica excede um limite definido por você. Para obter mais informações sobre como o CloudWatch serviço funciona, consulte o [Guia CloudWatch do usuário da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html).
## CloudWatch Métricas suportadas
O Amplify suporta sete CloudWatch métricas no `AWS/AmplifyHosting` namespace para monitorar tráfego, erros, transferência de dados, latência e tokens de solicitação para seus aplicativos. Essas métricas são agregadas em intervalos de um minuto. CloudWatch as métricas de monitoramento são gratuitas e não contam para as [cotas CloudWatch de serviço](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_limits.html).
A tabela a seguir descreve cada métrica com suporte e lista as estatísticas mais relevantes. Nem todas as estatísticas são aplicáveis a todas as métricas.
| Métrica | Description |
| --- | --- |
| Solicitações | O número total de solicitações de visualizadores recebidas pelo seu aplicativo. A estatística mais relevante é `Sum`. Use a estatística `Sum` para obter o número total de solicitações. |
| BytesDownloaded | A quantidade total de dados transferidos do seu aplicativo (baixados) em bytes pelos visualizadores para as solicitações `GET`, `HEAD` e `OPTIONS`. A estatística mais relevante é `Sum`. |
| BytesUploaded | A quantidade total de dados transferidos para a sua aplicação (enviados) em bytes para qualquer solicitação, incluindo os cabeçalhos. O Amplify não cobra pelos dados enviados em suas aplicações. A estatística mais relevante é `Sum`. |
| 4xxErrors | O número de solicitações que retornaram um erro no intervalo do código de status HTTP 400-499. A estatística mais relevante é `Sum`. Use a estatística `Sum` para obter o total de ocorrências desses erros. |
| 5xxErrors | O número de solicitações que retornaram um erro no intervalo do código de status HTTP 500-599. A estatística mais relevante é `Sum`. Use a estatística `Sum` para obter o total de ocorrências desses erros. |
| Latência | O tempo até o primeiro byte em segundos. Este é o tempo total entre o momento em que o Amplify Hosting recebe uma solicitação e o momento em que retorna uma resposta à rede. Isso não inclui a latência da rede encontrada para que uma resposta alcance o dispositivo do visualizador. As estatísticas mais relevantes são `Average`, `Maximum`, `Minimum`, `p10`, `p50`, `p90`, `p95` e `p100`. Use a estatística `Average` para avaliar as latências esperadas. |
| TokensConsumed | Os tokens de solicitação consumidos pela sua aplicação. A estatística `Sum` representa o consumo total de tokens de solicitação. É possível comparar essa estatística com sua cota de serviço `Request tokens per second` atual para determinar se é necessário solicitar um aumento de cota para evitar possíveis limitações durante um futuro evento de alto tráfego. A estatística `Average` representa o consumo de tokens de solicitação nos horários normais e de pico. O maior consumo de tokens normalmente leva a um tempo maior até o primeiro byte (TTFB). Portanto, é possível usar essa estatística ao avaliar a latência da sua aplicação. Se sua latência for baixa, você pode melhorar seu downstream APIs para reduzir o consumo de tokens e evitar a limitação que pode ocorrer quando o consumo de tokens excede a cota de serviço do seu aplicativo. `Request tokens per second` Para obter mais informações sobre as cotas de serviço `Request tokens per second`, consulte [Service quotas do Amplify Hosting](quotas-chapter.md). |
O Amplify fornece as seguintes dimensões CloudWatch métricas.
| Dimensão | Description |
| --- | --- |
| App | Os dados métricos são fornecidos pelo aplicativo. |
| Conta da AWS | Os dados métricos são fornecidos em todos os aplicativos no Conta da AWS. |
## Acessando CloudWatch métricas
Você pode acessar CloudWatch as métricas diretamente do console do Amplify usando o procedimento a seguir.
**nota**
Você também pode acessar CloudWatch as métricas Console de gerenciamento da AWS em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
**Para acessar métricas usando o console do Amplify**
1. Faça login no Console de gerenciamento da AWS e abra o console do [Amplify](https://console.aws.amazon.com/amplify/).
1. Escolha o serviço do qual você deseja visualizar as métricas.
1. No painel de navegação, selecione **Monitoramento** e, em seguida, escolha **Métricas**.
## Criação de CloudWatch alarmes
Você pode criar CloudWatch alarmes no console do Amplify que enviam notificações quando critérios específicos são atendidos. Um alarme monitora uma única CloudWatch métrica e envia uma notificação do Amazon Simple Notification Service quando a métrica ultrapassa o limite de um número específico de períodos de avaliação.
Você pode criar alarmes mais avançados que usam expressões matemáticas métricas no CloudWatch console ou usando o. CloudWatch APIs Por exemplo, é possível criar um alarme que envie uma notificação quando o percentual 4xxErrors ultrapassar 15% por três períodos consecutivos. Para obter mais informações, consulte [Criação de um CloudWatch alarme com base em uma expressão matemática métrica](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Create-alarm-on-metric-math-expression.html) no *Guia CloudWatch do usuário da Amazon*.
O CloudWatch preço padrão se aplica aos alarmes. Para obter mais informações, consulte os [ CloudWatchpreços da Amazon](https://aws.amazon.com/cloudwatch/pricing/).
Use o procedimento a seguir para criar um alarme no console do Amplify.
**Para criar um CloudWatch alarme para uma métrica do Amplify**
1. Faça login no Console de gerenciamento da AWS e abra o console do [Amplify](https://console.aws.amazon.com/amplify/).
1. Escolha o aplicativo no qual deseja definir um alarme.
1. No painel de navegação, selecione **Monitoramento** e, em seguida, escolha **Alarmes**.
1. Na página **Alarmes**, escolha **Criar alarme**.
1. Na janela **Criar alarme**, configure seu alarme da seguinte forma:
1. Em **Métrica**, escolha o nome da métrica a ser monitorada na lista.
1. Em **Nome de alarme**, digite um nome para o alarme. Por exemplo, se você estiver monitorando *Solicitações*, poderá nomear o alarme **HighTraffic**. O nome deve conter somente caracteres ASCII.
1. Para **Definir notificações**, utilize um dos seguintes procedimentos:
+
1. Escolha **Novo** para configurar um novo tópico do Amazon SNS.
1. Em **Endereço de e-mail**, insira o endereço de e-mail do destinatário das notificações.
1. Escolha **Adicionar novo endereço de e-mail** para adicionar mais destinatários.
+
1. Escolha **Existente** para reutilizar um tópico do Amazon SNS.
1. Para **Tópico existente do SNS**, selecione o nome do tópico Amazon SNS na lista.
1. Para **Sempre que a *Estatística* da *Métrica***, defina as condições para seu alarme da seguinte forma:
1. Especifique se a métrica deve ser maior que, menor que ou igual ao valor limite.
1. Especifique o valor do limite.
1. Especifique o número de períodos de avaliação consecutiva que devem estar no estado do alarme para acionar o alarme.
1. Especifique a duração do período de avaliação.
1. Escolha **Confirmar**.
**nota**
Cada destinatário do Amazon SNS que você especificar recebe um e-mail de confirmação das Notificações AWS . O e-mail contém um link que o destinatário deve seguir para confirmar sua assinatura e receber notificações.
## Acessando CloudWatch registros para aplicativos SSR
Amplify envia informações sobre seu tempo de execução de SSR para o Amazon CloudWatch Logs em seu. Conta da AWS Ao implantar uma aplicação de SSR na computação do Amplify Hosting, a aplicação requer um perfil de serviço do IAM que o Amplify assume ao chamar outros serviços em seu nome. É possível permitir que a computação do Amplify Hosting crie automaticamente um perfil de serviço ou especificar um perfil que criou.
Se você optar por permitir que o Amplify crie uma função do IAM para você, a função já terá as permissões para criar CloudWatch registros. Se você criar sua própria função do IAM, precisará adicionar as seguintes permissões à sua política para permitir que o Amplify acesse o Amazon CloudWatch Logs.
```
logs:CreateLogStream
logs:CreateLogGroup
logs:DescribeLogGroups
logs:PutLogEvents
```
Para obter mais informações sobre a adição de um perfil de serviço, consulte [Adição de um perfil de serviço com permissões para implantar recursos de backend](amplify-service-role.md). Para mais informações sobre como implantar aplicativos renderizados no lado do servidor, consulte [Implantação de aplicações renderizadas do lado do servidor com o Amplify Hosting](server-side-rendering-amplify.md).
Você pode visualizar os registros computacionais do Amplify Hosting para um aplicativo SSR no console ou no CloudWatch console do Amplify. Use as instruções a seguir para visualizar os logs no console do Amplify.
**Para visualizar CloudWatch os registros de um aplicativo SSR no console do Amplify**
1. Faça login no Console de gerenciamento da AWS e abra o console do [Amplify](https://console.aws.amazon.com/amplify/).
1. Escolha o aplicativo SSR para ver os CloudWatch registros.
1. No painel de navegação, escolha **Monitoramento** e, em seguida, escolha **Logs de computação do Hosting**.
1. Na página **Hosting compute logs**, pesquise e selecione um grupo de CloudWatch registros para uma ramificação específica.