Etude des scénarios de provisionnement pour l'agent Java APM

Différents scénarios de provisionnement de l'agent Java APM illustrent la façon dont le provisionnement de l'agent Java APM fonctionne dans un environnement réel. Avant de procéder à l'installation, passez en revue cette section et choisissez le scénario de provisionnement qui répond le mieux à vos besoins.

Scénarios de provisionnement

Agent à serveur unique

Il s'agit de l'installation d'agent de serveur Java APM standard dans laquelle l'agent est provisionné pour chaque installation de serveur d'applications.

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

  • Si différentes instances de serveur d'applications doivent utiliser différentes configurations, la configuration de groupe peut être utilisée. Pour plus d'informations, reportez-vous à Définition d'une configuration de groupe sous Réalisation des tâches de configuration facultatives.

  • La mise à niveau vers l'agent Java APM doit être effectuée sur chaque serveur d'applications si vous voulez mettre à niveau l'agent Java ultérieurement.

Exemple 3-1 : déploiement de l'agent Java APM dans un petit environnement

Si vous disposez d'un petit environnement (par exemple, seulement 3 serveurs Tomcat) sans stockage connecté au réseau, l'agent APM peut être provisionné séparément pour chaque serveur d'applications car il est exécuté indépendamment.

Exemple 3-2 : chargement de fichiers binaires à partir d'un emplacement partagé non autorisé

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

Exemple 3-3 : moyen d'éviter les dépendances réseau

Si vous voulez éviter de rencontrer des erreurs de démarrage de l'agent du serveur APM en cas d'erreurs réseau ou de mise hors ligne d'un serveur NAS, vous devez provisionner et configurer l'agent de serveur APM pour chaque installation de serveur d'applications.

Agent partagé

Le provisionnement d'agent partagé fonctionne de la même manière que le provisionnement d'agent à serveur unique, mais à plus grande échelle.

Avec le provisionnement à serveur unique, les agents APM de plusieurs instances de serveur d'applications sur un même hôte sont chargés à partir de la même installation d'agent. Le provisionnement d'agent partagé étend cela en provisionnant un agent APM sur 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.

  • Le principal avantage de l'utilisation du provisionnement d'agent partagé au lieu de la méthode à serveur unique réside dans la centralisation du déploiement de l'agent : l'emplacement de l'agent est cohérent indépendamment de l'hôte et du serveur d'applications. En outre, le processus de mise à niveau de l'agent est simplifié : il se fait sur une seule installation au lieu de mettre à niveau chaque serveur.

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

  • Les journaux sont écrits dans le répertoire de journaux de l'agent provisionné (oracle-apm-agent/log) sur l'emplacement partagé.

  • Si différentes instances de serveur d'applications doivent utiliser différentes configurations, la configuration de groupe peut être utilisée. Pour plus d'informations, reportez-vous à Définition d'une configuration de groupe sous Réalisation des tâches de configuration facultatives.

  • La mise à niveau sur l'agent APM n'est requise que pour l'agent provisionné sur l'emplacement partagé. Tous les fichiers de configuration sont également mis à niveau en même temps.

  • L'emplacement partagé doit être fiable. En cas de problème avec l'emplacement partagé, l'agent APM risque de ne pas démarrer. Le démarrage de l'agent APM s'appuie sur l'API d'instrumentation Java. Par conséquent, si les bibliothèques d'agent ne sont pas accessibles au démarrage de la JVM, le démarrage complet de cette dernière peut échouer.