Set Up Group Configuration

Group configuration is an optional post installation task that can be performed to a single server or share agent provisioning type.

Group configuration allows to have the same APM agent installation, but with a different configuration. It can be performed during APM agent deployment.

Group configuration can be defined in a sub-directory under the oracle-apm-agent/config/<version> directory which is the global config directory. For example, oracle-apm-agent/config/<version>/development directory where development is the group name.

Group configuration can partially or completely overwrite the global config depending on the config file. For the config file in group config directory to overwrite the global config, it must have the same file name as global config. For the agent to pick up the correct group config directory at startup, the config group name must be defined by the com.oracle.apm.agent.config.group.name property. The property can be set in AgentConfig.properties file of global config or as a JVM system property. The value can contain a combination of a static value, environment variables and other properties. When environment variables or properties are used, they must be enclosed in ${ and }.

See the following examples:

Example of a group based on DEPARTMENT environment variable:

com.oracle.apm.agent.config.group.name = ${DEPARTMENT}
Example of a group based on Weblogic server name:
com.oracle.apm.agent.config.group.name = ${weblogic.Server}
Example of a group based on HOSTNAME and Weblogic server name:
com.oracle.apm.agent.config.group.name = ${HOSTNAME}_${weblogic.Server}
Example of a group based on a static value:
com.oracle.apm.agent.config.group.name = sales-department