Para começar a usar o CloudWatch RUM com sua aplicação, você cria um app monitor (monitor de aplicações). Quando o monitor da aplicação é criado, o RUM gera um snippet do JavaScript para você colar em sua aplicação. O snippet extrai o código do cliente da Web RUM. O cliente da Web do RUM captura dados de uma porcentagem das sessões de usuário da aplicação e os envia para o RUM.
Para criar um monitor de aplicações
Abra o console do CloudWatch em https://console.aws.amazon.com/cloudwatch/
. No painel de navegação, escolha Application Signals e, em seguida, RUM.
Escolha Add app monitor (Adicionar monitor de aplicações).
Inserir as informações e as configurações da aplicação:
Em App monitor name (Nome do monitor de aplicações), insira um nome a ser usado para identificar esse monitor de aplicações no console do CloudWatch RUM.
Em Application domain (Domínio da aplicação), insira o nome do domínio de nível superior em que sua aplicação tem autoridade administrativa. Ele deve estar em um formato de domínio de URL.
Escolha Include sub domains (Incluir subdomínios) para que o monitor de aplicações também colete dados de todos os subdomínios sob o domínio de nível superior.
Em Configure RUM data collection (Configurar a coleta de dados do RUM), especifique se você deseja que o monitor de aplicações colete cada um dos seguintes dados:
Performance telemetry (Telemetria de performance) – Coleta informações sobre o carregamento da página e os tempos de carregamento de recursos
Erros de JavaScript (Erros de JavaScript): coleta informações sobre erros de JavaScript não tratados gerados pela sua aplicação
HTTP Errors (Erros HTTP): coleta informações sobre erros de HTTP lançados pela aplicação
A seleção dessas opções fornece mais informações sobre sua aplicação, mas também gera mais eventos RUM do CloudWatch e, portanto, incorre em mais cobranças.
Se você não selecionar nenhuma delas, o monitor de aplicações ainda coletará eventos de início de sessão e IDs de página para que você possa ver quantos usuários estão usando sua aplicação, incluindo falhas por tipo e versão do sistema operacional, tipo e versão do navegador, tipo de dispositivo e localização.
Selecione Check this option to allow the CloudWatch RUM Web Client to set cookies (Marque esta opção para permitir que o CloudWatch RUM Web Client defina cookies) se quiser coletar IDs de usuário e IDs de sessão de sessões de usuário amostradas. As IDs de usuário são geradas aleatoriamente pelo RUM. Para ter mais informações, consulte Cookies do cliente da Web do CloudWatch RUM (ou tecnologias semelhantes).
Em Sessions sample (Exemplos de sessão), insira a porcentagem de sessões do usuário que serão usadas para coletar dados do RUM. O padrão é 100%. A redução desse número fornece menos dados, mas diminui suas cobranças. Para obter mais informações sobre a definição de preços do RUM, consulte Definição de preços do RUM.
Os dados do usuário final coletados para o CloudWatch RUM são retidos por 30 dias e depois excluídos. Se você quiser manter cópias de eventos RUM no CloudWatch Logs e configurar por quanto tempo reter essas cópias, escolha Check this option to store your application telemetry data in your CloudWatch Logs account (Marque esta opção para armazenar os dados de telemetria da aplicação em sua conta do CloudWatch Logs) abaixo de Data storage (Armazenamento de dados). Por padrão, o grupo de logs do CloudWatch Logs retém os dados por 30 dias. Você pode ajustar seu período de retenção de logs no console de Logs do CloudWatch.
Em Autorization (Autorização), especifique se deve ser usado um grupo de identidades do Amazon Cognito novo ou existente ou se deve se usar um provedor de identidade diferente. A criação de um novo grupo de identidades é a opção mais simples, que não requer outras etapas de configuração. Para obter mais informações, consulte Etapa 1: Autorizar sua aplicação a enviar dados para a AWS.
A criação de um novo grupo de identidades do Amazon Cognito requer permissões administrativas. Para ter mais informações, consulte Políticas do IAM para uso do CloudWatch RUM.
(Opcional) Por padrão, quando você adiciona o snippet de código RUM à aplicação, o cliente da Web injeta a etiqueta JavaScript para monitorar o uso no código HTML de todas as páginas da aplicação. Para alterar isso, escolha Configure pages (Configurar páginas) e, em seguida, escolha Include only these pages (Incluir somente essas páginas) ou Exclude these pages (Excluir essas páginas). Em seguida, especifique as páginas a serem incluídas ou excluídas. Para especificar uma página a ser incluída ou excluída, insira as URLs completas. Para especificar páginas adicionais, escolha Add URL (Adicionar URL).
Para habilitar o rastreamento do AWS X-Ray para as sessões de usuário incluídas na amostra obtida pelo monitor de aplicações, escolha Rastreamento ativo e selecione Rastrear meu serviço com o AWS X-Ray.
Se você fizer essa seleção, as solicitações
XMLHttpRequestefetchfeitas durante as sessões do usuário amostradas pelo monitor de aplicações serão rastreadas. Você pode visualizar os rastreamentos e segmentos dessas sessões de usuário no painel do RUM e no mapa de rastreamento e nas páginas de detalhes do rastreamento do X-Ray. Essas sessões de usuário também aparecerão como páginas de clientes no Application Signals depois que você as tiver habilitado para a aplicação.Ao fazer alterações de configuração adicionais no cliente da Web do CloudWatch RUM, você pode adicionar um cabeçalho de rastreamento do X-Ray às solicitações HTTP para permitir o rastreamento de ponta a ponta das sessões do usuário até o downstream de serviços gerenciados pela AWS. Para ter mais informações, consulte Habilitar o rastreamento do X-Ray de ponta a ponta.
(Opcional) Para adicionar etiquetas ao monitor de aplicações, escolha Tags (Etiquetas), Add new tag (Adicionar nova etiqueta).
Em seguida, em Key (Chave), insira um nome para a etiqueta. É possível adicionar um valor opcional para a tag em Valor.
Para adicionar outra etiqueta, escolha novamente Add new tag (Adicionar nova etiqueta).
Para obter mais informações, consulte Etiquetar recursos daAWS.
Escolha Add app monitor (Adicionar monitor de aplicações).
Na seção Código de exemplo, é possível copiar o snippet de código a ser usado para adicioná-lo à aplicação. Recomendamos escolher JavaScript ou TypeScript e usar o NPM para instalar o cliente web CloudWatch RUM como um módulo JavaScript.
Como alternativa, é possível escolher HTML para usar uma rede de entrega de conteúdo (CDN) para instalar o cliente da Web do CloudWatch RUM. A desvantagem de usar uma CDN é que o cliente da Web muitas vezes é bloqueado por bloqueadores de anúncios.
Escolha Copy (Copiar) ou Download (Fazer download) e, em seguida, escolha Done (Pronto).
