Documentação do Oracle Cloud Infrastructure

Realocar Diretórios de Configuração e Log

Independentemente do cenário de provisionamento do Agente Java do APM selecionado, seja servidor único ou local compartilhado, por padrão, os diretórios de configuração e de log da instalação do agente são lidos e gravados na mesma instalação do agente em que os binários são lidos.

No entanto, em alguns cenários de implementação, é melhor separar os diretórios de configuração e de log da instalação do agente, portanto, você pode relocar o diretório de configuração do agente e/ou o diretório de log do agente provisionado.

Os locais do diretório de configuração e de log podem ser substituídos pelas propriedades do sistema Java ou por variáveis de ambiente:

Configurar agente com um diretório de configuração personalizada e/ou de log usando propriedades do sistema

Dependendo do appserver, a sintaxe para definir as propriedades do sistema java varia.

Em geral, se você precisar alterar o script de inicialização para adicionar propriedades do sistema ao comando Java, será necessário prefixar o argumento da propriedade com um traço e a letra d maiúscula ( -D ) e separar a chave e o valor por um sinal de igual ( = ).
  1. Provisione o agente para o appserver ou o local compartilhado.
  2. Copie o diretório de configuração (incluindo todos os subdiretórios com números de versão) do destino do agente provisionado para um novo local.
  3. Adicione a propriedade do sistema com.oracle.apm.agent.config.dir e/ou com.oracle.apm.agent.log.dir com novos locais para a inicialização da JVM. Consulte a documentação do appserver sobre qual é a maneira adequada de adicionar propriedades do sistema java. Por exemplo: 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>...
  4. Salve o script ou a definição e reinicie o appserver para que o agente selecione novos diretórios de configuração e/ou de log.

Configurar agente com um diretório de configuração personalizada e/ou de log usando variáveis de ambiente

Defina variáveis de ambiente com um diretório de configuração personalizada e/ou de log apropriado.

Cenário 1:

Tenho que criar uma imagem do docker com o agente do APM dentro da imagem, mas que a configuração e os logs residam no NAS.

Há 3 maneiras de fazer isso:
  • Altere o script de inicialização do appserver para incluir caminhos de configuração e log apontando para a configuração e logs no NAS
  • Defina variáveis de ambiente do diretório de configuração e caminhos de log na imagem do docker.
  • Passe variáveis de ambiente do diretório de configuração e caminhos de log na inicialização do docker.

Cenário 2:

Quero provisionar o agente para cada host do appserver para garantir que todos os binários estejam sempre disponíveis, mas quero carregar a configuração da unidade compartilhada.

Você pode configurar o agente do APM para usar apenas o diretório de configuração personalizado definindo apenas a propriedade do sistema com.oracle.apm.agent.config.dir (ou variáveis de ambiente com_oracle_apm_agent_config_dir). Isso deixa os arquivos de log do agente junto com os binários do agente.