Oracle Cloud Infrastructure Documentation

Configure Automatic Injection in APM Agent for JD Edwards

To use APM to monitor real time user sessions (browser interactions) in JD Edwards, you need to configure automatic injection in the APM Java agent.

After the APM Java agent is deployed on the JD Edwards server, enable the automatic browser injection by doing the following:

  1. Open the AgentConfig.properties file.
  2. Look for the following existing properties: com.oracle.apm.agent.rum.enable.injection, com.oracle.apm.agent.public.data.key and com.oracle.apm.agent.rum.service.name which are commented out in the file. (The properties have a # sign or hashtag at the beginning of the line).

    Uncomment the above properties, update their values and save the file.

    The file looks like the following: 

    com.oracle.apm.agent.rum.enable.injection=true
com.oracle.apm.agent.public.data.key=<Public_Data_Key> 
com.oracle.apm.agent.rum.service.name=<JD_Edwards_APM_Browser>
    • The value of the <Public Data Key> can be obtained from the APM Domain details page. For information, see Obtain Data Upload Endpoint and Data Keys.
    • The value of the <JD Edwards APM Browser> is the service name value that you specify for your JD Edwards APM Browser Agent. For example: JDE_UI.
  3. For JD Edwards 9.2.8.3 and higher, configure the Content Security Policy (CSP) header by following the instructions here. (Similar documentation exists for different versions of JD Edwards).
    1. Enable browser-script capturing of data.

      To allow the execution of the apmrum javascript, the CSP header's script-src needs to include the apmrum script's HTTP URL Domain name. By default, the apmrum script is loaded from the data upload endpoint, see Obtain Data Upload Endpoint and Data Keys.

      For example:
    2. Enable sending browser-agent data to data upload endpoint.

      The apmrum script sends data to the configured data upload endpoint location. This is only possible when the browser is allowed by the CSP to create a connection to the data upload endpoint. This is done in the connect-src section of the CSP header. Make sure that the data upload endpoint is included in the connect-src section of the CSP. For example: https://mydomain-phoenix-1.oci.oraclecloud.com/

  4. (Optional) Capture the username for the JD Edwards sessions by editing the ProbeConfig.acml file located under the oracle-apm-agent/config directory.

    Go to the general section and update the capture_username property from false to true.