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=https://[HOST]:[PORT]/

    Example:

    license.key=APMI_74447444b666d7ab5174cc3021a9b68dd4b3364d50f99c2969360810313e8fac
    apm.host=https://app-w8-test:9007/
    To learn more about the configurations, visit our Configuration Guide page.

For standalone setup:

  1. Open <ORACLE_HOME>/user_projects/domains/<doman_name>/bin/startManagedWebLogic.bat(.sh) file 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:

      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.