Documentation sur Oracle Cloud Infrastructure

Réviser les scénarios de provisionnement pour l'agent Java APM

Il existe différents scénarios de provisionnement qui montrent le fonctionnement du provisionnement d'un agent Java APM dans un environnement réel. Avant de commencer l'installation, consultez cette section et sélectionnez le scénario de provisionnement qui répond le mieux à vos besoins.

Scénarios de provisionnement

Agent de serveur unique

Il s'agit de l'installation typique de l'agent Java APM sur un serveur où l'agent est provisionné pour chaque installation du serveur d'applications.

  • Si l'installation du serveur d'applications permet l'exécution simultanée de plusieurs instances, chaque instance du serveur d'applications partage la même configuration d'agent APM.

  • Si différentes instances du serveur d'applications doivent utiliser des configurations différentes, la configuration de groupe peut être utilisée. Pour plus de détails, voir Définir une configuration de groupe sous Exécuter des tâches de configuration facultatives.

  • La mise à niveau de l'agent Java APM doit être effectuée sur chaque serveur d'applications, si vous souhaitez mettre l'agent Java à niveau dans le futur.

Exemple 3-1 : Déployer l'agent Java APM dans un environnement restreint.

Si vous disposez d'un petit environnement (c.à-d. 3 serveurs Tomcat seulement) stockage attaché au réseau, l'agent APM peut être provisionné séparément à chaque serveur d'applications, car les agents APM s'exécutent indépendamment les uns des autres.

Exemple 3-2 : Le chargement de fichiers binaires à partir d'un emplacement partagé n'est pas autorisé.

Si votre politique informatique ne permet pas le chargement de fichiers binaires à partir d'un emplacement partagé, l'agent de serveur APM doit être provisionné pour chaque installation du serveur d'applications et configuré en conséquence.

Exemple 3-3 : Éviter les dépendances de réseau.

Si vous souhaitez éviter les erreurs de démarrage de l'agent de serveur APM en cas d'erreurs réseau ou si un volume de stockage NAS est hors ligne, l'agent de serveur APM doit être provisionné à chaque installation du serveur d'applications et configuré en conséquence.

Agent partagé

Le provisionnement d'un agent partagé est similaire au provisionnement d'un agent de serveur unique, mais à une plus grande échelle.

Dans le cas du provisionnement d'un seul serveur, les agents APM des multiples instances du serveur d'applications sur le même hôte sont chargés à partir de la même installation d'agent. Le provisionnement d'un agent partagé va plus loin en provisionnant un agent APM à un emplacement partagé. Par conséquent, les serveurs d'applications des différents hôtes partagent une installation d'agent et la même configuration globale.

  • L'avantage principal du provisionnement d'un agent partagé sur la méthode du serveur unique est la centralisation du déploiement d'agents : l'emplacement d'agent est cohérent, quels que soient l'hôte et le serveur d'applications. En outre, le processus de mise à niveau de l'agent est simplifié à une seule installation au lieu de mettre à niveau chaque serveur.

  • Toutes les configurations sont lues à partir de l'agent de provisionnement, situé dans le répertoire oracle-apm-agent/config/<version> à l'emplacement partagé.

  • Les journaux sont écrits dans le répertoire de journalisation de l'agent provisionné : oracle-apm-agent/log à l'emplacement partagé.

  • Si différentes instances du serveur d'applications doivent utiliser des configurations différentes, la configuration de groupe peut être utilisée. Pour plus de détails, voir Définir une configuration de groupe sous Exécuter des tâches de configuration facultatives.

  • La mise à niveau de l'agent APM n'est requise que pour l'agent provisionné à l'emplacement partagé. En outre, tous les fichiers de configuration sont mis à niveau ensemble.

  • L'emplacement partagé doit être fiable. En cas de problème avec l'emplacement partagé, l'agent APM peut ne pas démarrer. Le démarrage de l'agent APM repose sur l'API Java Instrumentation. Par conséquent, si les bibliothèques d'agent ne sont pas accessibles au démarrage de la machine virtuelle Java, celle-ci pourrait ne pas démarrer complètement.