Reubicación de los directorios de configuración y log
Independientemente del escenario de aprovisionamiento del agente Java de APM seleccionado, ya sea un único servidor o una ubicación compartida, por defecto tanto el directorio de configuración como el de log de la instalación del agente se leen y escriben en la misma instalación del agente donde se leen los binarios.
Sin embargo, en algunos escenarios de despliegue, es mejor separar los directorios de configuración y log de la instalación del agente, por lo que puede que desee reubicar el directorio de configuración del agente y/o el directorio de log del agente aprovisionado.
La ubicación de ambos directorios, de configuración y de log, se puede sobrescribir con las propiedades del sistema Java o las variables de entorno:
| Propiedades del sistema | Variables de entorno |
| com.oracle.apm.agent.config.dir | com_oracle_apm_agent_config_dir |
| com.oracle.apm.agent.log.dir | com_oracle_apm_agent_log_dir |
Configuración del agente con un directorio de configuración y/o de log personalizado mediante las propiedades del sistema
Dependiendo del servidor de aplicaciones, la sintaxis para definir las propiedades del sistema Java varía.
- Aprovisione un agente al servidor de aplicaciones o a la ubicación compartida.
- Copie el directorio de configuración (incluidos todos los subdirectorios con números de versión) del destino de agente aprovisionado en una nueva ubicación.
- Agregue la propiedad del sistema com.oracle.apm.agent.config.dir y/o com.oracle.apm.agent.log.dir con nuevas ubicaciones al inicio de JVM. Consulte en el documento del servidor de aplicaciones la manera adecuada de agregar propiedades del sistema Java. Por ejemplo:
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>... - Guarde el script o la configuración y reinicie el servidor de aplicaciones para que el agente seleccione el nuevo directorio de configuración y/o de log.
Configuración del agente con un directorio de configuración y/o de log personalizado mediante las variables de entorno
Defina variables de entorno con el directorio de log y/o de configuración personalizado adecuado.
Escenario 1:
Tengo que crear una imagen de docker que tenga un agente de APM dentro de la imagen, pero quiero que la configuración y los logs residan en NAS.
- Cambiar el script de inicio del servidor de aplicaciones para que incluya rutas de configuración y log que apunten a la configuración y al log en NAS
- Definir variables de entorno de las rutas del log y el directorio de configuración en la imagen del docker.
- Transferir variables de entorno de las rutas del log y el directorio de configuración en el inicio del docker.
Escenario 2:
Quiero aprovisionar un agente a cada host del servidor de aplicaciones para asegurarme de que todos los binarios estén siempre disponibles, pero quiero cargar la configuración desde la unidad compartida.
Puede configurar el agente de APM para que utilice solo el directorio de configuración personalizado definiendo la propiedad del sistema com.oracle.apm.agent.config.dir (o las variables de entorno com_oracle_apm_agent_config_dir). Esto deja los archivos log del agente junto con los binarios de agente.