Riposiziona directory di configurazione e log
Indipendentemente dallo scenario di provisioning dell'agente Java APM selezionato, sia un singolo server che una posizione condivisa, per impostazione predefinita le directory di configurazione e log dell'installazione dell'agente vengono lette e scritte nella stessa installazione dell'agente in cui vengono letti i file binari.
Tuttavia, in alcuni scenari di distribuzione, è preferibile separare le directory di configurazione e di log dall'installazione dell'agente, pertanto è possibile riposizionare la directory di configurazione dell'agente e/o la directory di log dall'agente di cui è stato eseguito il provisioning.
La posizione della directory di configurazione e di log può essere sovrascritta con le proprietà di sistema Java o con le variabili di ambiente:
| Proprietà di sistema | Variabili di ambiente |
| com.oracle.apm.agent.config.dir | com_oracle_apm_agent_config_dir |
| com.oracle.apm.agent.log.dir | com_oracle_apm_agent_log_dir |
Impostare l'agente con la configurazione personalizzata e/o la directory di log utilizzando le proprietà di sistema
A seconda dell'appserver, la sintassi per impostare le proprietà del sistema java varia.
- Esegue il provisioning dell'agente al server applicazioni o alla posizione condivisa.
- Copiare la directory di configurazione (inclusi tutti i sub-directoies con numeri di versione) dalla destinazione agente di cui è stato eseguito il provisioning in una nuova posizione.
- Aggiungere le proprietà di sistema com.oracle.apm.agent.config.dir e/o com.oracle.apm.agent.log.dir con nuove posizioni all'avvio JVM. Consultare il documento appserver su quale sia il modo appropriato per aggiungere le proprietà del sistema java. Ad esempio:
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>... - Salvare lo script o l'impostazione e riavviare il server applicazioni per consentire all'agente di selezionare nuove directory di configurazione e/o di log.
Imposta l'agente con la configurazione personalizzata e/o la directory di log utilizzando le variabili di ambiente
Impostare le variabili di ambiente con la directory di configurazione e/o log personalizzata appropriata.
Scenario 1:
Devo creare un'immagine docker con un agente APM all'interno dell'immagine, ma voglio che la configurazione e i log risiedano sul NAS.
- Modificare lo script di avvio del server applicazioni per includere sia i percorsi di configurazione che i percorsi di log che puntano a configurare e accedere al NAS
- Impostare le variabili di ambiente della directory di configurazione e dei percorsi di log nell'immagine docker.
- Passa le variabili di ambiente della directory di configurazione e dei percorsi di log all'avvio del docker.
Scenario 2:
Desidero eseguire il provisioning dell'agente su ciascun host appserver per assicurarsi che tutti i file binari siano sempre disponibili, ma desidero caricare la configurazione dall'unità condivisa.
È possibile configurare l'agente APM in modo che utilizzi solo una directory di configurazione personalizzata impostando solo la proprietà di sistema com.oracle.apm.agent.config.dir (o le variabili di ambiente com_oracle_apm_agent_config_dir). In questo modo i file di log dell'agente vengono lasciati insieme ai file binari dell'agente.