Déplacer les répertoires de configuration et de journalisation
Quel que soit le scénario de provisionnement de l'agent Java APM sélectionné, que ce soit sur un serveur unique ou dans un emplacement partagé, les répertoires de configuration et de journalisation de l'installation de l'agent sont lus et écrits dans la même installation d'agent que celle où les fichiers binaires sont lus.
Toutefois, dans certains scénarios de déploiement, il est préférable de séparer de l'installation de l'agent les répertoires de configuration et de journalisation. Vous voudrez peut-être donc déplacer un de ces répertoires, ou les deux, pour l'agent provisionné.
L'emplacement des répertoires de configuration et de journalisation peut être remplacé au moyen de propriétés de système Java ou de variables d'environnement :
| Propriétés de 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 |
Configurer pour l'agent un répertoire de configuration et/ou de journalisation personnalisé à l'aide des propriétés du système
Selon le serveur d'applications, la syntaxe utilisée pour définir les propriétés de système java varie.
- Provisionnez l'agent sur le serveur d'applications ou dans un emplacement partagé.
- Copiez le répertoire de configuration (y compris tous les sous-répertoires avec les numéros de version) depuis 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 au script de démarrage de la JVM. Consultez la documentation sur votre serveur d'applications pour savoir comment ajouter des propriétés de 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 journalisation.
Configurer pour l'agent un répertoire de configuration et/ou de journalisation personnalisé à l'aide des variables d'environnement
Définir les variables d'environnement en utilisant le répertoire de configuration et/ou de journalisation personnalisé approprié.
Scénario 1 :
Je dois créer une image Docker contenant un agent APM, mais je veux que la configuration et les journaux résident sur le stockage NAS.
- Modifier le script de démarrage du serveur d'applications afin que les chemins de la configuration et des journaux pointent vers les répertoires de configuration et de journalisation sur le stockage NAS.
- Définir les variables d'environnement des chemins de répertoire de configuration et de journalisation dans l'image Docker.
- Transmettre les variables d'environnement des chemins de répertoire de configuration et de journalisation au démarrage de Docker.
scénario 2 :
Je veux provisionner un agent pour chaque hôte de serveur d'applications afin de 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 pour qu'il utilise uniquement le répertoire de configuration personnalisé en définissant uniquement 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 de l'agent sont ainsi conservés avec les fichiers binaires de l'agent.