Relocalisation des répertoires de configuration et de journaux
Quel que soit le scénario de provisionnement de l'agent Java APM sélectionné (serveur unique ou emplacement partagé), les répertoires de configuration et de journaux issus de l'installation de l'agent sont lus et écrits par défaut dans la même installation d'agent que celle dans laquelle sont lus les fichiers binaires.
Toutefois, dans certains scénarios de déploiement, il est préférable de séparer les répertoires de configuration et de journaux de l'installation d'agent. Vous pouvez alors relocaliser le répertoire de configuration et/ou le répertoire de journaux de l'agent provisionné.
L'emplacement du répertoire de configuration et du répertoire de journaux peut être remplacé à l'aide de propriétés système Java ou de variables d'environnement :
| Propriétés système | Variables d'environnement |
| com.oracle.apm.agent.config.dir | com_oracle_apm_agent_config_dir |
| com.oracle.apm.agent.log.dir | com_oracle_apm_agent_log_dir |
Configuration de l'agent avec un répertoire de configuration et/ou de journaux personnalisé à l'aide de propriétés système
La syntaxe de définition des propriétés système Java varie en fonction du serveur d'applications.
- Provisionnez l'agent sur le serveur d'applications ou l'emplacement partagé.
- Copiez le répertoire de configuration (y compris tous ses sous-répertoires avec numéro de version) de la destination de l'agent provisionné vers un nouvel emplacement.
- Ajoutez la propriété système com.oracle.apm.agent.config.dir et/ou com.oracle.apm.agent.log.dir avec les nouveaux emplacements pour le démarrage de la JVM. Consultez le document du serveur d'applications pour en savoir plus sur la façon appropriée d'ajouter des propriétés système Java. Par exemple :
java … -javaagent:<agent_path>/oracle-apm-agent/bootstrap/ApmAgent.jar -Dcom.oracle.apm.agent.config.dir=<config_path> -Dcom.oracle.apm.agent.log.dir=<log_path>... - Enregistrez le script ou le paramètre, puis redémarrez le serveur d'applications pour que l'agent récupère les nouveaux répertoires de configuration et/ou de journaux.
Configuration de l'agent avec un répertoire de configuration et/ou de journaux personnalisé à l'aide de variables d'environnement
Définissez les variables d'environnement avec le répertoire de configuration et/ou de journaux personnalisé approprié.
Scénario 1 :
Je dois créer une image Docker contenant l'agent APM, mais je veux que la configuration et les journaux résident sur NAS.
- Modifiez le script de démarrage du serveur d'applications de façon à inclure les chemins de configuration et de journaux pointant vers la configuration et les journaux sur NAS.
- Définissez les variables d'environnement du répertoire de configuration et des chemins de journaux dans l'image Docker.
- Transmettez les variables d'environnement du répertoire de configuration et des chemins de journaux au démarrage de l'image Docker.
Scénario 2 :
Je veux provisionner l'agent sur chaque hôte du serveur d'applications pour m'assurer que tous les fichiers binaires sont toujours disponibles, mais je veux charger la configuration à partir du lecteur partagé.
Vous pouvez configurer l'agent APM de façon à utiliser uniquement le répertoire de configuration personnalisé en définissant seulement la propriété système com.oracle.apm.agent.config.dir (ou les variables d'environnement com_oracle_apm_agent_config_dir). Les fichiers journaux et les fichiers binaires de l'agent restent ainsi ensemble.