Sie können den APM-Browser-Agent durch Deployment bereitstellen, indem Sie ein JavaScript auf allen Anwendungsseiten einfügen und Application Performance Monitoring das Reporting über die tatsächliche Benutzererfahrung erlauben.

So fügen Sie das JavaScript ein:

1. Bearbeiten Sie die HTML-Quelle der überwachten Anwendungsseiten.
   Hinweis
   
   

   • Bei in einem Package integrierten Webanwendungen wird in der Regel eine Seitenvorlage für alle Seiten der Webanwendung verwendet.

     Stellen Sie sicher, dass Sie gegebenenfalls auch das verpackte anwendungsspezifische Skript aufnehmen. Weitere Informationen finden Sie unter APM-Browser-Agent mit in einem Package integrierten Anwendungen bereitstellen.

   • Die Konfiguration kann entweder im Objekt window.apmrum oder document.apmrum gespeichert werden.

     Stellen Sie sicher, dass Sie dasselbe Objekt konsistent verwenden, um zu verwechselnde Konfigurationen zu vermeiden. Lazy Loading wird für die Objekteigenschaften verwendet, und Updates werden dynamisch angewendet.

2. Geben Sie Werte für die folgenden Eigenschaften an, und fügen Sie das Skript nach dem schließenden Tag </head> ein. Stellen Sie sicher, dass Sie den Code nicht innerhalb eines anderen <script>-Tags hinzufügen:
   • window.apmrum.serviceName: Geben Sie einen Namen für den Service an. Wenn Sie den Servicenamen nicht angeben, wird der Standardservicename APM Browser zugewiesen. Es wird empfohlen, einen Servicenamen anzugeben, um nach Service filtern und die entsprechenden Spans überwachen zu können.
   • window.apmrum.webApplication: Geben Sie einen Namen für die Webanwendung an, mit dem Funktionsbereiche des Deployments klassifiziert werden können. Wenn kein Wert für webApplication angegeben ist, wird der Standardwert "Standard WebApp" verwendet.
   • window.apmrum.ociDataUploadEndpoint: Geben Sie den Datenuploadendpunkt an, der das Data Center und die Domain bestimmt, in die RUM-Daten hochgeladen werden. Der Wert für den Datenuploadendpunkt kann wie folgt abgerufen werden:
     • Navigieren Sie in der OCI-Konsole zu Observability and Management > Application Performance Management > Administration, und wählen Sie die gewünschte Domain aus.
     • Klicken Sie neben Datenuploadendpunkt auf Kopieren, um den Wert in die Zwischenablage zu kopieren, und setzen Sie window.apmrum.ociDataUploadEndpoint auf diesen Wert.
   • window.apmrum.OracleAPMPublicDataKey: Geben Sie den öffentlichen Datenschlüssel an, der beim Erstellen der APM-Domain generiert wird. Der öffentliche Datenschlüssel kann wie folgt abgerufen werden:
     • Navigieren Sie in der OCI-Konsole zu Observability and Management > Application Performance Management > Administration, und wählen Sie das gewünschte Compartment und die gewünschte Domain aus.
     • Klicken Sie unter Ressourcen auf Datenschlüssel. Wenn kein Datenschlüssel vorhanden ist, klicken Sie auf Datenschlüssel generieren, und wählen Sie Öffentlicher Datenschlüssel aus.
     • Klicken Sie neben einem Datenschlüssel des Typs "Öffentlich" auf Kopieren, um den Wert abzurufen, mit dem window.apmrum.OracleAPMPublicDataKey aufgefüllt werden soll.

   Um die Performance für Benutzer der überwachten Anwendung zu optimieren, muss der Speicherort einer JavaScript-Library angegeben werden. Stellen Sie sicher, dass in Ihrem Netzwerk auf die JavaScript-Library zugegriffen werden kann.

   JavaScript-Beispiel

   Das Skript sieht wie folgt aus:

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

   Dabei gilt:

   • <APM Browser> ist der Servicename, den Sie für den APM-Browser-Agent angeben. Wenn Sie keinen Wert festlegen, wird der Standardservicename APM Browser zugewiesen.
   • <Web App Name> ist der Wert für den Namen der Webanwendung.
   • <ociDataUploadEndpoint> ist der Wert für den Datenuploadendpunkt. Er kann auf der Seite APM-Administration abgerufen werden. Siehe Datenuploadendpunkt und Datenschlüssel abrufen.
   • <APM Public Datakey> ist der Wert für den öffentlichen APM-Datenschlüssel, der über das Menü Administration auf der APM-Hauptseite abgerufen werden kann.

   Beispiel: Wenn der Datenuploadendpunkt aaaac5d2kke6waaaaaaaaaaaaaaa.apm-agtTERM:us-ashburn-1.oci.oraclecloud.com und der Wert für den öffentlichen APM-Datenschlüssel IMWJ5UN2C6YOLQSUZ5Q7IGN3QACF4AZD lautet, sieht das Skript wie folgt aus:

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

   Mit der Referenz auf <ociDataUploadEndpoint>/static/jslib/apmrum.min.js in Ihrer Instrumentierung wird sichergestellt, dass die APM-Überwachung immer die neueste verfügbare Version des APM-Browser-Agents nutzt.

   Nach Abschluss finden Sie weitere Informationen unter Deployment des APM-Browser-Agent überprüfen.

   Hinweis
   
   

   • Weitere Informationen zum öffentlichen Datenschlüssel und zum Datenuploadendpunkt finden Sie unter Datenuploadendpunkt und Datenschlüssel abrufen.

   • Wenn Sie über eine in einem Package integrierte Anwendung verfügen, finden Sie weitere Informationen unter APM-Browser-Agent mit in Package integrierten Anwendungen bereitstellen.