Documentation Oracle Cloud Infrastructure

Provisionner et déployer l'agent Java APM sur Oracle E-Business Suite

La surveillance APM requiert le déploiement de l'agent Java APM pour capturer ce qui se passe sur le serveur WebLogic. Dans ce cas, cela doit se produire sur les clusters oacore et oafm WebLogic.

Télécharger l'agent Java APM

  1. Connectez-vous à la console Oracle Cloud Infrastructure.
  2. Ouvrez le menu de navigation et cliquez sur Observation & gestion. Sous Surveillance des performances des applications, cliquez sur Administration.
  3. Sur la page Administration, cliquez sur Télécharger les agents APM dans le menu de gauche pour ouvrir la page Télécharger les agents APM.
  4. Sur la page Télécharger les agents APM, sélectionnez Agent Java pour télécharger l'agent Java APM.

    Le fichier logiciel de l'agent Java APM est téléchargé et contient le fichier apm-java-agent-installer-<version>.jar.

Provisionnement de l'agent Java APM

  1. Connectez-vous à l'hôte sur lequel le serveur d'applications est installé, connectez-vous en tant que même utilisateur qui a installé le serveur d'applications et vérifiez que l'utilisateur du serveur d'applications dispose de droits d'accès en lecture et en écriture sur le répertoire dans lequel le fichier d'agent Java APM est téléchargé. Copiez le fichier logiciel de l'agent Java APM que vous avez téléchargé dans le répertoire souhaité :
  2. Assurez-vous que vous êtes connecté en tant qu'utilisateur qui a installé le serveur d'applications et accédez au répertoire dans lequel vous avez copié le logiciel d'agent Java APM. Vous devez disposer des droits d'accès en lecture et en écriture sur le répertoire qui héberge l'agent Java APM.
  3. Passez en revue les arguments obligatoires suivants qui doivent être spécifiés pour provisionner un agent Java APM.
    • -service-name : nom du service surveillé. Cet argument vous permet de filtrer les résultats par service et de visualiser les traces dans l'interface utilisateur de l'explorateur de traces. Pour l'environnement EBS, utilisez EBS_WLS comme valeur temporaire. Par la suite, vous remplacerez la configuration par des valeurs spécifiques pour chacun des clusters WLS surveillés.
    • -destination : répertoire de destination dans lequel l'agent Java APM sera provisionné. Dans ce cas, cela doit pointer vers le répertoire de destination EBS : <PATH_TO_fs_ne> , qui est le chemin complet EBS pour le répertoire non édition. Par exemple : répertoire /u01/ebs122/fs_ne/.
    • -private-data-key : clé d'installation d'agent utilisée par les agents Java APM (de données privées), qui est générée lors de la création du domaine APM.
    • -data-upload-endpoint : URL d'adresse de téléchargement de données générée lors de la création du domaine APM.

      Pour plus d'informations sur le jeu de données privé et dataUploadEndpoint, reportez-vous à Obtention de l'adresse de téléchargement de données et des clés de données.

    Facultatif :

    • Vous pouvez spécifier des arguments supplémentaires lors du provisionnement de l'agent Java APM. Pour plus d'informations, reportez-vous à la section Specify Proxy Arguments.

    • Vous pouvez exécuter la commande suivante pour afficher l'aide sur les arguments provision-agent :
      java -jar ./apm-java-agent-installer-<version>.jar provision-agent -help
  4. Provisionnez l'agent en spécifiant les arguments obligatoires décrits à l'étape précédente et en exécutant la commande java suivante :
    java -jar ./apm-java-agent-installer-<version>.jar provision-agent -service-name=EBS_WLS -destination=/u01/ebs122/fs_ne/ -private-data-key=<Agent installation key generated during APM domain creation> -data-upload-endpoint=<dataUploadEndpoint URL generated during APM domain creation>

    Voici un exemple :

    java -jar ./apm-java-agent-installer-1.1.jar provision-agent -service-name=apm_service -destination=$DOMAIN_HOME -private-data-key=IMWJ5UN2C6YOLQSUZ5Q7IGN3QACF4AZD -data-upload-endpoint=https://dataUploadEndpoint.com
    Lors de l'exécution de la commande java, si l'agent Java APM a été provisionné, les opérations suivantes sont effectuées :
    • Le message Action [provision-agent] completed successfully apparaît.
    • Le répertoire oracle-apm-agent est créé dans le répertoire de destination. Par exemple, /u01/ebs122/fs_ne/oracle-apm-agent.

      Le répertoire oracle-apm-agent doit contenir les éléments suivants :

      • bin : contient le déclencheur de l'opérateur d'agrégation.
      • bootstrap : contient les fichiers .jar de démarrage de l'agent utilisés par la commande -javaagent pour déployer l'agent Java APM.
      • config : contient les fichiers de configuration globale. Ces fichiers sont modifiables. Le répertoire contient les fichiers suivants :
        • Le fichier AgentConfig.properties, qui contient les arguments de configuration de l'agent Java APM.
        • Le fichier ProbeConfig.acml, qui contient les informations de configuration relatives aux sondes.
      • install : contient le répertoire <release-version>/config, qui comporte les fichiers de configuration par défaut et les fichiers binaires de l'agent Java APM. Les fichiers de ce répertoire ne doivent pas être modifiés.
      • version : fichier de version contenant des informations sur la version (release) de l'agent Java APM et la date d'activation.

    Si la commande java prend fin et que l'agent Java APM n'est pas provisionné, vous pouvez examiner les détails de l'erreur dans le fichier ApmAgentInstall.log et dans le journal de sortie du serveur d'applications pour corriger le problème.

Remarque

Pour plus d'informations sur le téléchargement et le provisionnement de l'agent Java APM, reportez-vous à Provisionnement et déploiement de l'agent Java APM sur des serveurs d'applications.

Activation de l'agent Java APM dans le serveur géré WebLogic

Pour permettre l'accès à Oracle E-Business Suite à partir d'Oracle Application Performance Monitoring, des modifications de configuration JVM doivent être apportées aux serveurs gérés WebLogic.

Effectuez les étapes suivantes sur chacun des serveurs gérés des services oacore et oafm :

  1. Connectez-vous à la console d'administration du serveur WebLogic en tant qu'utilisateur doté du rôle de sécurité Admin. Par défaut, il s'agit de l'utilisateur weblogic.
  2. Cliquez sur Serveurs. La page de récapitulatif du serveur d'administration et des serveurs gérés WebLogic s'affiche.
  3. Choisissez les serveurs gérés WebLogic pour déployer l'agent Java APM sur : oacore et oafm.
  4. Une page contenant différents onglets pour les paramètres du serveur géré s'affiche.

    Cliquez sur l'onglet Démarrage du serveur.

  5. Dans le centre des modifications, cliquez sur Verrouiller et modifier. Mettez à jour le champ Arguments avec les paramètres requis pour Oracle Application Performance Monitoring. Assurez-vous que les arguments existants ne sont pas modifiés.

    Pour le service oacore, ajoutez les éléments suivants : 

    -javaagent:<PATH_TO_fs_ne>/oracle-apm-agent/bootstrap/ApmAgent.jar -Dcom.oracle.apm.agent.service.name=oacore

    Pour le service oafm, ajoutez les éléments suivants : 

    -javaagent:<PATH_TO_fs_ne>/oracle-apm-agent/bootstrap/ApmAgent.jar -Dcom.oracle.apm.agent.service.name=oafm
  6. Cliquez sur Enregistrer.
  7. Dans le centre des modifications, cliquez sur Activer les modifications pour activer les modifications.
  8. Répétez toutes les étapes ci-dessus pour chacun des serveurs gérés des services oacore et oafm jusqu'à ce que les arguments JVM de chaque serveur géré soient mis à jour.
  9. Redémarrez les serveurs gérés à l'aide du script disponible à l'adresse $ADMIN_SCRIPTS_HOME dans l'environnement Oracle E-Business Suite pour arrêter et démarrer les serveurs gérés.

Une fois que vous avez installé un agent APM, vous pouvez activer la surveillance de l'utilisateur final dans un environnement Oracle E-Business Suite en configurant des agents de navigateur avec le type d'injection Référence pour les agents APM associés aux serveurs gérés oacore.