Configuración del cliente web de CloudWatch RUM - Amazon CloudWatch
ArgumentosIgnoración de erroresOpciones de configuración

Configuración del cliente web de CloudWatch RUM

Las aplicaciones podrán utilizar uno de los fragmentos de código que haya generado CloudWatch RUM para instalar el cliente web de CloudWatch RUM. Los fragmentos generados admiten dos métodos de instalación: como módulo JavaScript a través de NPM o desde una red de entrega de contenido (CDN). Para obtener el máximo desempeño, le recomendamos utilizar el método de instalación de NPM. Para obtener más información sobre cómo utilizar este método, consulte Instalación como módulo JavaScript.

Si utiliza la opción de instalación de CDN, los bloqueadores de anuncios podrían bloquear la CDN predeterminada proporcionada por CloudWatch RUM. Esto deshabilita la supervisión de aplicaciones para los usuarios que tienen bloqueadores de anuncios instalados. Por ello, le recomendamos que utilice la CDN predeterminada solo para la incorporación inicial con CloudWatch RUM. Para obtener más información sobre cómo mitigar este problema, consulte Instrumentar la aplicación.

El fragmento de código se encuentra en la etiqueta <head> de un archivo HTML e instala el cliente web mediante la descarga del cliente web y su configuración para la aplicación que está supervisando. El fragmento es una función de ejecución automática que tiene un aspecto similar a lo que se detalla a continuación. En este ejemplo, se omite el cuerpo de la función del fragmento por motivos de legibilidad.

<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

El fragmento de código acepta seis argumentos:

  • un espacio de nombres para ejecutar comandos en el cliente web, como 'cwr'

  • el ID del monitor de aplicaciones, como '00000000-0000-0000-0000-000000000000'

  • la versión de la aplicación, como '1.0.0'

  • la región de AWSdel monitor de aplicaciones, como 'us-west-2'

  • la URL del cliente web, como 'https://client.rum.us-east-1.amazonaws.com/1.0.2/cwr.js'

  • opciones de configuración específicas de la aplicación. Para más información, consulte la siguiente sección.

Ignoración de errores

El cliente web CloudWatch RUM escucha todo tipo de errores que se producen en sus aplicaciones. Si su aplicación emite errores de JavaScript que no desea ver en el panel de CloudWatch RUM, puede configurar el cliente web de CloudWatch RUM para que filtre tales errores, de modo que solo le aparezcan los eventos de error relevantes en el panel de CloudWatch RUM. Por ejemplo, puede optar por no ver algunos errores de JavaScript en el panel porque ya ha identificado una solución para ellos y el volumen de tales errores oculta otros errores. También puede ignorar los errores que no pueda corregir porque pertenezcan a una biblioteca que sea propiedad de un tercero.

Para obtener más información sobre cómo instrumentar al cliente web para que filtre errores específicos de JavaScript, consulte el ejemplo de Errors (Errores) en la documentación de Github del cliente web.

Opciones de configuración

Para obtener información sobre las opciones de configuración disponibles para el cliente web de CloudWatch RUM, consulte la documentación del cliente web de CloudWatch RUM.