Puede desplegar el agente de explorador de APM insertando un JavaScript en todas las páginas de la aplicación, así como permitir que Application Performance Monitoring informe sobre la experiencia de usuario real.

Para insertar el JavaScript:

1. Edite el origen HTML de las páginas de aplicación supervisadas.
   Nota
   
   

   • Para las aplicaciones web empaquetadas, suele haber una plantilla de página utilizada para todas las páginas que pertenecen a la aplicación web.

     Asegúrese de incluir también el script específico de la aplicación empaquetada, si corresponde. Para obtener más información, consulte Despliegue del agente de explorador de APM con aplicaciones empaquetadas.

   • La configuración se puede almacenar en el objeto window.apmrum o document.apmrum.

     Asegúrese de utilizar el mismo objeto de forma consistente para evitar configuraciones confusas. La carga diferida se utiliza para las propiedades del objeto y las actualizaciones se aplican de forma dinámica.

2. Especifique valores para las siguientes propiedades e inserte el script después de la etiqueta de cierre </head>. Asegúrese de no agregar el código dentro de otra etiqueta <script>:
   • window.apmrum.serviceName: especifique un nombre para el servicio. Si no especifica el nombre de servicio, se asigna el nombre de servicio por defecto, APM Browser. Se recomienda especificar un nombre de servicio para poder filtrar por servicio y supervisar los períodos correspondientes.
   • window.apmrum.webApplication: especifique un nombre para la aplicación web, que se puede utilizar para clasificar áreas funcionales de despliegue. Si no se especifica ningún valor para webApplication, se utilizará el valor predeterminado "WebApp".
   • window.apmrum.ociDataUploadEndpoint: especifique el punto final de carga de datos que determina el centro de datos y el dominio en el que se cargarán los datos de RUM. El valor de punto final de carga de datos se puede obtener de la siguiente forma:
     • Vaya a la consola de OCI, desplácese a Observación y gestión > Application Performance Management > Administración y seleccione el dominio deseado.
     • Haga clic en Copiar junto a Punto final de carga de datos para copiar el valor en el portapapeles y utilizarlo para definir el valor de window.apmrum.ociDataUploadEndpoint.
   • window.apmrum.OracleAPMPublicDataKey: especifique la clave de datos pública que se genera cuando se crea el dominio APM. La clave de datos pública se puede obtener haciendo lo siguiente:
     • Vaya a la consola de OCI, desplácese a Observación y gestión > Application Performance Management > Administración y seleccione el compartimento y el dominio deseados.
     • Haga clic en Claves de datos en Recursos. Si no existe ninguna clave de datos, haga clic en Generar clave de datos y seleccione Clave de datos públicos.
     • Haga clic en la opción Copiar, situada junto a una clave de datos del tipo 'Public' para recuperar el valor que se utilizará para rellenar el valor de window.apmrum.OracleAPMPublicDataKey.

   Para optimizar el rendimiento de los usuarios de la aplicación supervisada, se debe especificar la ubicación de una biblioteca de JavaScript y debe asegurarse de que se puede acceder a la biblioteca de JavaScript en la red.

   Ejemplo de JavaScript

   El script tiene el siguiente aspecto:

   <script>
   window.apmrum = (window.apmrum || {}); 
   window.apmrum.serviceName='<APM Browser>';
   window.apmrum.webApplication='<Web App Name>';
   window.apmrum.ociDataUploadEndpoint='<ociDataUploadEndpoint>';
   window.apmrum.OracleAPMPublicDataKey='<APM_Public_Datakey>';
   </script>
   <script async crossorigin="anonymous" src="<ociDataUploadEndpoint>/static/jslib/apmrum.min.js"></script>

   Donde:

   • <APM Browser> es el valor del nombre de servicio que especifique para el agente de explorador de APM. Si no define un valor, se asignará el nombre de servicio por defecto APM Browser.
   • <Web App Name> es el valor del nombre de la aplicación web.
   • <ociDataUploadEndpoint> es el valor del punto final de carga de datos. Se puede obtener de la página Administración de APM. Consulte Obtención del punto final de carga de datos y las claves de datos.
   • <APM Public Datakey> es el valor de la clave de datos pública de APM que se puede obtener del menú Administración en la página principal de APM.

   Por ejemplo, si el valor del punto final de carga de datos es aaaac5d2kke6waaaaaaaaaaala.apm-agt.us-ashburn-1.oci.oraclecloud.com y el valor de la clave de datos pública de APM es IMWJ5UN2C6YOLQSUZ5Q7IGN3QACF4AZD, el script tendrá el siguiente aspecto:

   <script>
   window.apmrum = (window.apmrum || {});
   window.apmrum.serviceName='Apm Browser1';
   window.apmrum.webApplication='Webapp';
   window.apmrum.ociDataUploadEndpoint='https://aaaac5d2kke6waaaaaaaaaaala.apm-agt.us-ashburn-1.oci.oraclecloud.com';
   window.apmrum.OracleAPMPublicDataKey='IMWJ5UN2C6YOLQSUZ5Q7IGN3QACF4AZD';
   </script>
   <script async crossorigin="anonymous" src="https://aaaac5d2kke6waaaaaaaaaaala.apm-agt.us-ashburn-1.oci.oraclecloud.com/static/jslib/apmrum.min.js"></script>

   El uso de la referencia a <ociDataUploadEndpoint>/static/jslib/apmrum.min.js en la instrumentación garantiza que la supervisión de APM siempre aproveche la última versión disponible del agente de explorador de APM.

   Una vez completado, consulte Verificación del despliegue del agente de explorador de APM

   Nota
   
   

   • Para obtener más información sobre la clave de datos pública y el punto final de carga de datos, consulte Obtención del punto final de carga de datos y las claves de datos.

   • Si tiene una aplicación empaquetada, consulte Despliegue del agente de explorador de APM con aplicaciones empaquetadas.