Install APM Insight Java Agent in Oracle WebLogic 10.3.x & above

Following are the steps to install APM Insight Java agent in Oracle WebLogic:

  1. Download latest the APM Insight java agent zip file (apminsight-javaagent.zip) here
  2. Extract the zip file to a new directory to find agent jar and its configuration files
  3. Open the apminsight.conf file in any text editor and include the following keys:
    license.key=[LICENSE KEY]
    apm.host=http://[HOST]:[PORT]

    Example:

    license.key=APMI_74447444b666d7ab5174cc3021a9b68dd4b3364d50f99c2969360810313e8fac
    apm.host=http://apm-prod-server:9090
    To learn more about the configurations, visit our Configuration Guide page.

For Standalone setup:

  1. Open the startManagedWebLogic.bat(.sh) file located under <ORACLE_HOME>/user_projects/domains/<doman_name>/bin/ directory in any text editor.
  2. Add the following lines at the top of the script file:
    • For Windows:

      set JAVA_OPTIONS=-DUseSunHttpHandler=true -javaagent:<agent_directory_full_path>apminsight-javaagent.jar %JAVA_OPTIONS%

    • For Linux:

      #!/bin/sh
      set JAVA_OPTIONS="-DUseSunHttpHandler=true -javaagent:<agent_directory_full_path>/apminsight-javaagent.jar $JAVA_OPTIONS"

For Cluster setup:

    1. Open the administrative console of Weblogic server, Select Environment > Servers > Configuration tab.
    2. Select <Your Server Name> > Configuration > Server Start tab.
    3. Locate Arguments textbox and enter the following argument:

      -DUseSunHttpHandler=true -javaagent:<agent_directory_full_path>/apminsight-javaagent.jar

      Admin Console

    4. Save the settings and start the WebLogic server.

Note: The application server user must have access to the agent-installed folder.