Activar inyección de agente de explorador de APM
Requisitos
-
Debe adquirir una clave de datos pública que se genere al crear el dominio de APM.
La clave de datos pública se puede obtener haciendo lo siguiente:
- Abra el menú de navegación, haga clic en Observación y gestión. En Application Performance Monitoring, haga clic en Administración.
En la página Administration, seleccione el compartimento y el dominio de APM deseados.
-
Haga clic en Claves de datos en Recursos para mostrar las claves de datos.
Si no existe ninguna clave de datos, haga clic en Generar clave de datos y seleccione la clave de datos pública.
-
Haga clic en Copiar junto a una clave de datos de tipo Público para recuperar el valor. Este valor se utilizará más adelante.
Para obtener más información, consulte Obtención del punto final de carga de datos y las claves de datos.
- Abra el menú de navegación, haga clic en Observación y gestión. En Application Performance Monitoring, haga clic en Administración.
Activar mediante Installer
A partir de APM Agent versión 1.6, puede activar la inyección de APM Browser Agent cuando el agente se aprovisiona mediante la opción -enable-browser-agent-injection
.
Por ejemplo:
java -jar apm-java-agent-installer-1.6 provision-agent -destination=/example/path/destination -service-name=example_apm_service -private-data-key=ExamplePrivateDataKey -data-upload-endpoint=https://dataUploadEndpoint.com -enable-browser-agent-injection -public-data-key=ExamplePublicDataKey
Donde ExamplePublicDataKey se reemplazaría por la clave de datos pública recuperada de la consola de OCI anteriormente en el paso 3 durante los requisitos previos.
El agente Java se configurará automáticamente para realizar la inyección del agente del explorador al iniciar.
Para ver la información de ayuda al aprovisionar el agente, utilice la opción -help
. Por ejemplo:
java -jar ./apm-java-agent-installer-<version>.jar provision-agent -help
Usage:
apm-java-agent-installer-<version>.jar provision-agent [options ...]
options:
...
...
-enable-browser-agent-injection
Enables the APM Agent to automatically inject the browser agent into HTML
pages. Make sure '-public-data-key' is also set, otherwise injection will
not be enabled until one is provided.
-public-data-key=<public_data_key>
APM Agent public data key for Appserver Agents. This property is required
for the injected browser agent to connect to the Oracle APM Cloud, and it
is specific to your APM Cloud Domain.
...
...
Para obtener la lista completa de opciones, consulte Información de uso de ayuda.
Activar mediante el archivo AgentConfig.properties
Si está actualizando desde una versión anterior del agente de APM o no ha activado la inyección del agente del explorador mediante el instalador, deberá activar esta función manualmente después de realizar la actualización o instalación del agente.
-
Navegue hasta el directorio
oracle-apm-agent/config
existente. Desde allí, vaya al directorio de la última versión que ha actualizado. -
Abra el archivo
AgentConfig.properties
y actualice las dos propiedades siguientes:Nota
Es necesario eliminar los comentarios (el símbolo#
se debe eliminar) y actualizarlos.- com.oracle.apm.agent.rum.enable.inject: elimine
#
para esta propiedad y defina el valor entrue
- com.oracle.apm.agent.public.data.key: elimine
#
para esta propiedad y defina el valor en la clave de datos pública adquirida en el paso 3 durante los requisitos previos anteriores.
Una vez actualizadas las propiedades, el archivo tiene un aspecto similar al siguiente:# APM Agent public data key. This property is required for the injected Browser Agent to connect to server, which can be # obtained at APM service sign up. # ... ... ... #--------------------------- Start of Browser Agent (RUM) Injection Properties--------------------------------------- # Enables browser agent injection. # Once enabled, the agent will inject a few lines of JavaScript code into the HTTP pages served by this AppServer. # It is recommended to test the application and exclude any pages that may be adversely affected by this injection. # See "Configure APM Browser Agent Injection using APM Java Agent" in the service documentation for more details. com.oracle.apm.agent.rum.enable.injection=true # APM Agent public data key. This property is required for the injected Browser Agent to connect to server, which can be # obtained at APM service sign up. com.oracle.apm.agent.public.data.key=ExamplePublicDataKey
- com.oracle.apm.agent.rum.enable.inject: elimine
El agente Java de APM ahora está configurado para comenzar a realizar la inyección del agente de explorador de APM y puede recopilar estadísticas detalladas de métricas de usuario reales, como el tiempo de carga de paginación, el tiempo de DNS y el tiempo de SSL.