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.

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.

A tabela a seguir descreve cada métrica compatível e lista as estatísticas mais relevantes. Nem todas as estatísticas são aplicáveis a todas as métricas.

Métrica	Descrição
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 pelo seu aplicativo. A Sum estatística representa o consumo total de tokens de solicitação. Você pode comparar essa estatística com sua cota de Request tokens per second serviço atual para determinar se precisa solicitar um aumento de cota para evitar possíveis limitações durante um futuro evento de alto tráfego. A Average estatística 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, você pode usar essa estatística ao avaliar a latência do seu aplicativo. 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 a cota Request tokens per second de serviço, consulteService quotas do Amplify Hosting.

O Amplify fornece as seguintes dimensões CloudWatch métricas.

Dimensão	Descrição
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 AWS Management Console em https://console.aws.amazon.com/cloudwatch/.

Para acessar métricas usando o console do Amplify

1. Faça login AWS Management Console e abra o console do Amplify.

2. Escolha o serviço do qual você deseja visualizar as métricas.

3. No painel de navegação, escolha 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 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.

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 AWS Management Console e abra o console do Amplify.

2. Escolha o aplicativo no qual deseja definir um alarme.

3. No painel de navegação, escolha Monitoramento e, em seguida, escolha Alarmes.

4. Na página Alarmes, escolha Criar alarme.

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

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

   3. Para Definir notificações, utilize um dos seguintes procedimentos:

      • 1. Escolha Novo para configurar um novo tópico do Amazon SNS.

        2. Em Endereço de e-mail, insira o endereço de e-mail do destinatário das notificações.

        3. Escolha Adicionar novo endereço de e-mail para adicionar mais destinatários.

      • 1. Escolha Existente para reutilizar um tópico do Amazon SNS.

        2. Para Tópico existente do SNS, selecione o nome do tópico Amazon SNS na lista.

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

      2. Especifique o valor do limite.

      3. Especifique o número de períodos de avaliação consecutiva que devem estar no estado do alarme para acionar o alarme.

      4. Especifique a duração do período de avaliação.

   5. 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 Quando você implanta um aplicativo SSR na computação do Amplify Hosting, o aplicativo exige uma função 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 como adicionar uma função de serviço, consulteAdicionar uma função de serviço com permissões para implantar recursos de back-end. 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.

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 registros no console do Amplify.

Para visualizar CloudWatch os registros de um aplicativo SSR no console do Amplify

1. Faça login AWS Management Console e abra o console do Amplify.

2. Escolha o aplicativo SSR para ver os CloudWatch registros.

3. No painel de navegação, escolha Monitoramento e, em seguida, escolha Hospedagem de registros computacionais.

4. Na página Hosting compute logs, pesquise e selecione um grupo de CloudWatch registros para uma ramificação específica.