Abilita inserimento agente browser APM

Prerequisiti

È necessario acquisire una chiave dati pubblica generata quando viene creato il dominio APM.

La chiave dati pubblica può essere ottenuta effettuando le operazioni riportate di seguito.
1. Aprire il menu di navigazione, fare clic su Osservabilità e gestione. In Application Performance Monitoring fare clic su Amministrazione.
  Nella pagina Amministrazione, selezionare il compartimento e il dominio APM desiderati.
2. Fare clic su Chiavi dati in Risorse per elencare le chiavi dati.
  
  Se non esiste alcuna chiave dati, fare clic su Genera chiave dati e selezionare la chiave dati pubblica.
3. Fare clic su Copia accanto a una chiave dati di tipo Pubblico per recuperare il valore. Questo valore verrà utilizzato in un secondo momento.
Per ulteriori dettagli, vedere Ottenere l'endpoint di caricamento dati e le chiavi dati.

Abilita tramite il programma di installazione

A partire da APM Agent versione 1.6, è possibile abilitare l'inserimento dell'agente browser APM quando viene eseguito il provisioning dell'agente utilizzando l'opzione -enable-browser-agent-injection.

Ad esempio:

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

Dove ExamplePublicDataKey verrà sostituito con la chiave dati pubblica recuperata da OCI Console in precedenza al passo 3 durante i prerequisiti.

L'agente Java verrà configurato automaticamente per eseguire l'inserimento dell'agente browser all'avvio.

Per visualizzare le informazioni della Guida durante il provisioning dell'agente, utilizzare l'opzione -help. Ad esempio:

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.
...
...

Per l'elenco completo delle opzioni, vedere Informazioni sull'uso della Guida.

Abilita utilizzo file AgentConfig.properties

Se si sta eseguendo l'aggiornamento da una versione precedente dell'agente APM o l'inserimento dell'agente del browser non è stato abilitato tramite il programma di installazione, sarà necessario abilitare questa funzione manualmente dopo l'esecuzione dell'aggiornamento o dell'installazione dell'agente.

Passare alla directory oracle-apm-agent/config esistente. Passare quindi alla directory per la versione più recente alla quale è stato eseguito l'aggiornamento.

Aprire il file AgentConfig.properties e aggiornare le due proprietà riportate di seguito.

Nota

È necessario rimuovere il commento (il simbolo # deve essere rimosso) e aggiornarlo.

com.oracle.apm.agent.rum.enable.injection: rimuovere # per questa proprietà e impostare il valore su true
com.oracle.apm.agent.public.data.key: rimuovere # per questa proprietà e impostare il valore sulla chiave dati pubblica acquisita dal passo 3 durante i prerequisiti precedenti.

Una volta aggiornate le proprietà, il file ha un aspetto simile al seguente:

# 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

L'agente Java APM è ora configurato per iniziare a eseguire l'inserimento dell'agente browser APM e può raccogliere approfondimenti su metriche utente reali come l'ora di pageload, l'ora DNS e l'ora SSL.

Documentazione di Oracle Cloud Infrastructure

Abilita inserimento agente browser APM