Activation de l'injection de l'agent de navigateur APM à l'aide de l'agent Dotnet APM

Prérequis

  • Vous devez acquérir une entité de données publique générée lors de la création du domaine APM.

    Vous pouvez obtenir la clé de données publique comme suit :

    1. Ouvrez le menu de navigation et cliquez sur Observation & gestion. Sous Surveillance des performances des applications, cliquez sur Administration.

      Sur la page Administration, sélectionnez le compartiment et le domaine APM souhaités.

    2. Cliquez sur Clés de données sous Ressources pour répertorier les clés de données.

      S'il n'existe aucune clé de données, cliquez sur Générer une clé de données, puis sélectionnez la clé de données publique.

    3. Pour extraire la valeur, cliquez sur Copier en regard d'une clé de données publique. Cette valeur sera utilisée ultérieurement.

    Pour plus de détails, reportez-vous à Obtention de l'adresse de téléchargement de données et des clés de données.

Activation de l'injection de l'agent de navigateur APM

Par défaut, l'injection d'agent de navigateur APM est désactivée.

Pour activer cette fonctionnalité, vous devez ajouter les variables d'environnement ci-dessous lors du déploiement de l'agent Dotnet APM.

OTEL_BA_ENABLED=true
OTEL_BA_PUBLIC_KEY=<public data key>

Vous devez redémarrer les services Windows ou IIS correspondants si la variable d'environnement est ajoutée dans le registre Windows.

La valeur <public data key> est générée lors de la création du domaine APM. Pour plus de détails, reportez-vous à Obtention de l'adresse de téléchargement de données et des clés de données. Il s'agit de la clé d'installation de l'agent de navigateur utilisée par l'agent Dotnet APM. Par exemple :IMWJ5UN2C.

Etape supplémentaire pour .NET Framework

Pour activer l'injection d'agent de navigateur dans l'environnement .NET, un fichier HTTPModule doit être ajouté dans le fichier applicationHost.config.

Ouvrez le fichier C:\Windows\System32\inetsrv\config\applicationHost.config et ajoutez HTTPModule comme suit :
<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>