È possibile distribuire l'agente del browser APM inserendo un valore JavaScript in tutte le pagine dell'applicazione e consentire a Application Performance Monitoring di creare report sull'esperienza utente reale.

Per inserire il JavaScript:

1. Modificare l'origine HTML delle pagine dell'applicazione monitorata.
   Nota
   
   

   • Per le applicazioni Web pacchettizzate, in genere esiste un modello di pagina utilizzato per tutte le pagine appartenenti all'applicazione Web.

     Assicurarsi di includere anche lo script specifico dell'applicazione pacchettizzata, se applicabile. Per informazioni dettagliate, vedere Distribuire l'agente browser APM con applicazioni in package.

   • La configurazione può essere memorizzata nell'oggetto window.apmrum o document.apmrum.

     Assicurati di utilizzare lo stesso oggetto in modo coerente per evitare configurazioni confuse. Il caricamento ritardato viene utilizzato per le proprietà dell'oggetto e gli aggiornamenti vengono applicati in modo dinamico.

2. Specificare i valori per le seguenti proprietà e inserire lo script dopo la chiusura del tag </head>. Assicurarsi di non aggiungere il codice all'interno di un'altra tag <script>:
   • window.apmrum.serviceName: specificare un nome per il servizio. Se non si specifica il nome del servizio, viene assegnato il nome di servizio predefinito, APM Browser. Si consiglia di specificare un nome di servizio per poter filtrare in base al servizio e monitorare gli intervalli corrispondenti.
   • window.apmrum.webApplication: specificare un nome per l'applicazione Web, che può essere utilizzato per classificare le aree funzionali della distribuzione. Se non è stato specificato alcun valore per webApplication, verrà utilizzato il valore predefinito "WebApp".
   • window.apmrum.ociDataUploadEndpoint: specificare l'endpoint di caricamento dati che determina il data center e il dominio in cui verranno caricati i dati RUM. È possibile ottenere il valore dell'endpoint di caricamento dati effettuando le operazioni riportate di seguito.
     • Andare a OCI Console, andare a Osservabilità e gestione > Gestione prestazioni applicazione > Amministrazione e selezionare il dominio desiderato.
     • Fare clic su Copia accanto a Endpoint caricamento dati per copiare il valore negli Appunti e utilizzarlo per impostare il valore di window.apmrum.ociDataUploadEndpoint.
   • window.apmrum.OracleAPMPublicDataKey: specificare il valore dataKey pubblico generato quando viene creato il dominio APM. Il pubblico dataKey può essere ottenuto facendo quanto segue:
     • Andare a OCI Console, andare a Osservabilità e gestione > Gestione prestazioni applicazione > Amministrazione e selezionare il compartimento e il dominio desiderati.
     • Fare clic su Chiavi dati in Risorse. Se non esiste alcuna chiave dati, fare clic su Genera chiave dati e selezionare Chiave dati pubblica.
     • Fare clic su Copia accanto a una chiave dati di tipo 'Pubblico' per recuperare il valore da utilizzare per popolare il valore di window.apmrum.OracleAPMPublicDataKey.

   Per ottimizzare le prestazioni per gli utenti dell'applicazione monitorata, è necessario specificare la posizione di una libreria JavaScript ed è necessario assicurarsi che la libreria JavaScript sia accessibile nella rete.

   JavaScript Esempio

   Lo script è simile al seguente:

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

   Dove:

   • <APM Browser> è il valore del nome del servizio specificato per l'agente del browser APM. Se non si imposta un valore, viene assegnato il nome servizio predefinito APM Browser.
   • <Web App Name> è il valore del nome dell'applicazione Web.
   • <ociDataUploadEndpoint> è il valore dell'endpoint di caricamento dati. È possibile ottenerlo dalla pagina Amministrazione APM. Vedere Ottenere l'endpoint di caricamento dati e le chiavi dati.
   • <APM Public Datakey> è il valore di chiave dati pubblica APM che può essere ottenuto dal menu Administration nella pagina principale di APM.

   Ad esempio, se il valore dell'endpoint di caricamento dati è aaaac5d2kke6waaaaaaaaaaaala.apm-agt.us-ashburn-1.oci.oraclecloud.com e il valore della chiave dati pubblica APM è IMWJ5UN2C6YOLQSUZ5Q7IGN3QACF4AZD, lo script avrà l'aspetto seguente:

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

   L'utilizzo del riferimento a <ociDataUploadEndpoint>/static/jslib/apmrum.min.js nella strumentazione garantisce che il monitoraggio APM sfrutti sempre la versione più recente disponibile dell'agente browser APM.

   Al termine, vedere Verifica distribuzione agente browser APM

   Nota
   
   

   • Per ulteriori informazioni su DataKey e DataUploadEndpoint pubblici, vedere Ottenere l'endpoint e le chiavi dati di caricamento dati.

   • Se si dispone di un'applicazione all'interno di package, vedere Distribuire l'agente browser APM con applicazioni all'interno di package.