Configurar o cliente da Web do CloudWatch RUM - Amazon CloudWatch
ArgumentosIgnorar errosOpções de configuração

Configurar o cliente da Web do CloudWatch RUM

As aplicações podem usar um dos snippets de código gerados pelo CloudWatch RUM para instalar o cliente da Web do CloudWatch RUM. Os snippets gerados oferecem suporte a dois métodos de instalação: como um módulo JavaScript via NPM ou por meio de uma rede de entrega de conteúdo (CDN). Para proporcionar o melhor desempenho, recomendamos usar o método de instalação via NPM. Para obter mais informações sobre o uso desse método, consulte Instalar como um módulo JavaScript.

Se você usar a opção de instalação por CDN, os bloqueadores de anúncios poderão bloquear a CDN padrão fornecida pelo CloudWatch RUM. Isso desabilita o monitoramento de aplicações para usuários com bloqueadores de anúncios instalados. Por isso, recomendamos usar a CDN padrão somente para integração inicial com o CloudWatch RUM. Para obter mais informações sobre as formas de mitigar esse problema, consulte Instrumentar a aplicação.

O snippet de código permanece na etiqueta <head> de um arquivo HTML e instala o cliente da Web fazendo o download o cliente da Web e, em seguida, configurando o cliente da Web para a aplicação monitorada. O snippet é uma função autoexecutável que se parece com a seguinte. Neste exemplo, o corpo da função do snippet foi omitido para legibilidade.

<script>
(function(n,i,v,r,s,c,u,x,z){...})(
'cwr',
'00000000-0000-0000-0000-000000000000',
'1.0.0',
'us-west-2',
'https://client.rum.us-east-1.amazonaws.com/1.0.2/cwr.js',
{ /* Configuration Options Here */ }
);
<script>

Argumentos

O snippet de código aceita seis argumentos:

  • Um namespace para executar comandos no cliente da Web, como'cwr'

  • O ID do monitor de aplicações, como '00000000-0000-0000-0000-000000000000'

  • A versão da aplicação, como '1.0.0'

  • A região da AWS do monitor de aplicações, como 'us-west-2'

  • O URL do cliente da Web, como 'https://client.rum.us-east-1.amazonaws.com/1.0.2/cwr.js'

  • Opções de configuração específicas da aplicação. Para obter mais informações, consulte a seção a seguir.

Ignorar erros

O cliente Web do CloudWatch RUM escuta todos os tipos de erros que ocorrem nas suas aplicações. Se a aplicação emitir erros de JavaScript que você não deseja visualizar no painel do CloudWatch RUM, o cliente Web do CloudWatch RUM poderá ser configurado para filtrar esses erros. Assim, você verá apenas os eventos de erro relevantes no painel do CloudWatch RUM. Por exemplo, você pode optar por não visualizar alguns erros de JavaScript no painel porque já identificou uma correção para eles e o volume desses erros está mascarando outros. Você também pode ignorar erros que não podem ser corrigidos porque pertencem a uma biblioteca de terceiros.

Para obter mais informações sobre como instrumentar o cliente Web para filtrar erros específicos de JavaScript, consulte o exemplo em Errors (Erros) na documentação do cliente Web do Github.

Opções de configuração

Para obter informações sobre as opções de configuração disponíveis para o cliente da Web CloudWatch RUM, consulte aDocumentação do cliente da Web CloudWatch RUM