Oracle Cloud Infrastructure-Dokumentation

APM-Browser-Agent-Injection mit APM-Dotnet Agent aktivieren

Voraussetzungen

  • Sie müssen eine öffentliche Datenerfassung anfordern, die beim Erstellen der APM-Domain generiert wird.

    Der öffentliche Datenschlüssel kann wie folgt abgerufen werden:

    1. Öffnen Sie das Navigationsmenü, und klicken Sie auf Observability and Management. Klicken Sie unter Application Performance Monitoring auf Administration.

      Wählen Sie auf der Seite "Administration" das gewünschte Compartment und die APM-Domain aus.

    2. Click on Data Keys under Resources to list the data keys.

      Wenn kein Datenschlüssel vorhanden ist, klicken Sie auf Datenschlüssel generieren, und wählen Sie den öffentlichen Datenschlüssel aus.

    3. Klicken Sie neben einem Datenschlüssel des Typs Öffentlich auf Kopieren, um den Wert abzurufen. Dieser Wert wird später verwendet.

    Weitere Details finden Sie unter Datenuploadendpunkt und Datenschlüssel abrufen.

APM-Browser-Agent-Injection aktivieren

Standardmäßig ist die APM-Browser-Agent-Injection deaktiviert.

Um dieses Feature zu aktivieren, müssen Sie die folgenden Umgebungsvariablen während des Deploy the APM Dotnet Agent hinzufügen. 

OTEL_BA_ENABLED=true
OTEL_BA_PUBLIC_KEY=<public data key>

Sie müssen die entsprechenden Windows-Dienste oder IIS neu starten, wenn die Umgebungsvariable in Windows Registry hinzugefügt wird.

Der Wert <public data key> wird beim Erstellen der APM-Domain generiert. Weitere Informationen finden Sie unter Datenuploadendpunkt und Datenschlüssel abrufen. Dies ist der Installationsschlüssel des Browser-Agent, der vom APM Dotnet-Agent verwendet wird. Beispiel:IMWJ5UN2C.

Zusätzlicher Schritt für .NET Framework

Um die Browser-Agent-Injection in .NET Framework zu aktivieren, muss in der Datei applicationHost.config eine HTTPModule hinzugefügt werden.

Öffnen Sie die Datei C:\Windows\System32\inetsrv\config\applicationHost.config, und fügen Sie eine HTTPModule wie folgt hinzu:
<location path="" overrideMode="Allow">
  <system.webServer>
    <modules>
       <add name="OracleApmHttpModule" type="OracleApmNetAgentEx.BrowserAgent.Netfx.OracleAPMIisModule,  OracleApmNetAgentEx,
Version=1.0.0.0, Culture=neutral,  PublicKeyToken=ba1a243c3b2207e1" preCondition="managedHandler" />
    </modules>
  </system.webServer>
</location>