Paso 2: Cree un monitor de aplicaciones
Para empezar a utilizar CloudWatch RUM con su aplicación, cree un spp monitor (monitor de aplicaciones). Cuando se crea el monitor de aplicaciones, RUM genera un fragmento de JavaScript para que lo pegue en su aplicación. El fragmento extrae el código del cliente web de RUM. El cliente web de RUM captura datos de un porcentaje de las sesiones de usuario de la aplicación y los envía a RUM.
Para crear un monitor de aplicaciones
Abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/
. En el panel de navegación, elija Señales de aplicación, RUM.
Elija Add app monitor (Agregar monitor de aplicaciones).
Ingrese la información y la configuración para la aplicación:
En App monitor name (Nombre del monitor de aplicaciones), ingrese un nombre que se utilizará para identificar este monitor de aplicaciones en la consola de CloudWatch RUM.
En Application domain (Dominio de aplicación), ingrese el nombre de dominio de nivel superior en el que la aplicación tiene autoridad administrativa. Este debe estar en formato de dominio URL.
Elija Include sub domains (Incluir subdominios) para que el monitor de aplicaciones también recopile datos de todos los subdominios del dominio de nivel superior.
En Configure RUM data collection (Configuración de la recopilación de datos de RUM), especifique si desea que el monitor de aplicaciones recopile cada uno de los siguientes elementos:
Telemetría de rendimiento: recopila información sobre los tiempos de carga de la página y de carga de recursos.
Errores JavaScript: recopila información sobre los errores de JavaScript no controlados generados por su aplicación.
Errores HTTP: recopila información sobre los errores HTTP lanzados por la aplicación.
La selección de estas opciones proporciona más información sobre la aplicación, pero también genera más eventos de CloudWatch RUM y, por lo tanto, incurre en más cargos.
Si no selecciona ninguno de estos, el monitor de aplicaciones seguirá recopilando eventos de inicio de sesión e ID de página para que pueda ver cuántos usuarios están utilizando la aplicación, incluidos los desgloses por tipo y versión del sistema operativo, tipo y versión del navegador, tipo de dispositivo y ubicación.
Seleccione Check this option to allow the CloudWatch RUM Web Client to set cookies (Marque esta opción para permitir que el cliente web de CloudWatch RUM configure cookies) si desea poder recopilar ID de usuario e ID de sesión de sesiones de usuario de muestra. Los ID de usuario se generan de forma aleatoria mediante RUM. Para obtener más información, consulte Cookies del cliente web de CloudWatch RUM (o tecnologías similares).
En Session samples (Muestras de sesiones), ingrese el porcentaje de sesiones de usuario que se utilizarán para recopilar datos de RUM. El valor predeterminado es 100 %. Si reduce este número, obtendrá menos datos, pero reducirá los cargos. Para obtener más información sobre los precios de RUM, consulte Precios de RUM.
Los datos del usuario final que recopila para CloudWatch RUM se conservan durante 30 días y, luego, se eliminan. Si desea conservar copias de eventos de RUM en CloudWatch Logs y configurar el tiempo durante el cual se retendrán estas copias, elija Check this option to store your application telemetry data in your CloudWatch Logs account (Marque esta opción para almacenar los datos de telemetría de aplicaciones en su cuenta de CloudWatch Logs) en Data storage (Almacenamiento de datos). El grupo de registros de CloudWatch Logs conserva los datos durante 30 días de forma predeterminada. Puede administrar su periodo de retención de registros en la consola de CloudWatch Logs.
En Authorization (Autorización), especifique si desea utilizar un grupo de identidades de Amazon Cognito nuevo o existente, o utilizar otro proveedor de identidad. Crear un nuevo grupo de identidades es la opción más sencilla ya que no requiere ningún otro paso de configuración. Para obtener más información, consulte Paso 1: Autorice a la aplicación para enviar datos a AWS.
Para llevar a cabo la creación de un nuevo grupo de identidades de Amazon Cognito se necesitan permisos administrativos. Para obtener más información, consulte Políticas de IAM para utilizar CloudWatch RUM.
(Opcional) De forma predeterminada, cuando agrega el fragmento de código de RUM a la aplicación, el cliente web inyecta la etiqueta JavaScript para supervisar el uso en el código HTML de todas las páginas de la aplicación. Para cambiar esto, elija Configure pages (Configurar páginas) y luego, Include only these pages (Incluir solo estas páginas) o Exclude these pages (Excluir estas páginas). Luego, especifique las páginas que desea incluir o excluir. Para especificar las páginas que desea incluir o excluir, ingrese las URL completas. Para especificar páginas adicionales, elija Add URL (Agregar URL).
Para activar el rastreo AWS X-Ray de las sesiones de usuario que el monitor de aplicaciones ofrece como muestra, seleccione Rastreo activo y, luego, seleccione Rastrear mi servicio con AWS X-Ray.
Si selecciona esta opción, el monitor de aplicaciones rastreará las solicitudes
XMLHttpRequest
yfetch
realizadas durante las sesiones de usuario de muestra. A continuación, podrá ver los seguimientos y segmentos de estas sesiones del usuario en el panel de RUM y las páginas de detalles de seguimiento y del mapa de seguimiento de X-Ray. Estas sesiones del usuario también se mostrarán como páginas de cliente en Application Signals una vez que las haya habilitado para su aplicación.Al realizar cambios de configuración adicionales en el cliente web de CloudWatch RUM, puede agregar un encabezado de seguimiento de X-Ray a las solicitudes HTTP para habilitar el seguimiento de extremo a extremo de las sesiones de usuario hasta los servicios administrados de AWS. Para obtener más información, consulte Habilitación del seguimiento integral de X-Ray.
(Opcional) Para agregar etiquetas al monitor de aplicaciones, elija Tags (Etiquetas), Add new tag (Agregar nueva etiqueta).
Luego, en Key (Clave), ingrese un nombre para la etiqueta. Puede agregar un valor opcional para la etiqueta en Valor.
Para agregar otra etiqueta, vuelva a elegir Add new tag (Agregar nueva etiqueta).
Para obtener más información, consulte Tagging AWS Resources (Etiquetado de recursos de ).
Elija Add app monitor (Agregar monitor de aplicaciones).
En la sección Sample code (Código de muestra), puede copiar el fragmento de código a usar para agregar a la aplicación. Le recomendamos que elija JavaScript o TypeScript y utilice NPM para instalar el cliente web de CloudWatch RUM como módulo JavaScript.
De forma alternativa, puede elegir HTML para utilizar una red de entrega de contenido (CDN) para instalar el cliente web de CloudWatch RUM. La desventaja de utilizar una CDN es que el cliente web suele estar bloqueado por bloqueadores de anuncios.
Elija Copy (Copiar) o Download (Descargar) y luego elija Done (Hecho).