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

Note: Enterprise applications like Oracle - JDEdwards Spine that runs on Oracle WebLogic server can also be instrumented using our APM Insight JAVA agent to perform Application Performance Monitoring (APM Insight)

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.
Note:
  • You can also configure a secure APM URL. Ensure that the connection is stable and free from certificate-related issues.
    Example: https://apm-prod-server:8443
  • For an Applications Manager failover setup, you can specify multiple hosts in a comma-separated format (supported from Java Agent v6.8), as shown below:
    apm.host=http://apm-prod-server-A:9090, http://apm-prod-server-B:9090

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.