Specify Proxy Arguments
You can specify proxy arguments in the java
command when
provisioning the APM Java agent, or you can do it at a later time by specifying values for
the arguments in the AgentConfig.properties
file in the
<Destination Directory>/oracle-apm-agent/config
directory, and
restarting the application server.
Note that <Destination Directory>
in the previous sentence is the
directory in which the APM Java agent is provisioned.
Specify a Proxy Environment
If using a proxy server, you must specify the proxy environment details.
- If you are provisioning the APM Java agent:
Add
-property=com.oracle.apm.agent.data.upload.proxy.url=http://<host>:<port>
to thejava
command. Here's an example:java -jar ./apm-java-agent-installer-<version>.jar provision-agent -service-name=apm_service -destination=$DOMAIN_HOME -private-data-key=IMWJ5UN2C6YOLQSUZ5Q7IGN3QACF4AZD -data-upload-endpoint=https://dataUploadEndpoint.com -property=com.oracle.apm.agent.data.upload.proxy.url=http://proxy.example.com:80
- If you have already provisioned the APM Java agent:
Specify a value for the
com.oracle.apm.agent.data.upload.proxy.url
argument in theAgentConfig.properties
file, and restart the application server. - If you are using Management Gateway:Configure the APM Java Agent with the following arguments to route all traffic of APM Java Agent or Tracer through the Management Gateway:
com.oracle.apm.agent.data.upload.proxy.url=<Management Gateway URL> com.oracle.apm.agent.data.upload.proxy.username=<User name for Proxy Server authentication> com.oracle.apm.agent.data.upload.proxy.password=<Password for Proxy Server authentication> com.oracle.apm.agent.data.upload.proxy.scheme=basic
Management Gateway can be used to communicate to APM Agent. For information about installing and configuring Management Gateway, see Management Gateway.
If the proxy server needs authentication, then you must specify the
authentication arguments in the -property=<key>=<value>
format when provisioning the APM Java agent or update the
AgentConfig.properties
file if you've already provisioned the
agent:
- Specify the proxy user name and password in the following
arguments:
com.oracle.apm.agent.data.upload.proxy.username=<User name for proxy server authentication> com.oracle.apm.agent.data.upload.proxy.password=<Password for proxy server authentication>
-
Default authentication scheme is digest.
An additional argument can be set for basic authentication scheme:com.oracle.apm.agent.data.upload.proxy.scheme=basic