Install APM Insight Java Agent in IBM Websphere 7.x servers & above

  • Download the latest APM Insight java agent zip file (apminsight-javaagent.zip) here
  • Extract the zip file to a new directory to find the agent jar and its configuration files
  • 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.

  • Open the administrative console of your IBM Websphere server and click on Select Servers → Server Types → WebSphere Application Servers (IBM WAS)

    APM Insight Java Agent for Websphere

  • Select <Your Server Name> → Java and Process Management → Process Definition.

    APM Insight Java Agent for Websphere

  • Under Additional Properties, select Java Virtual Machine.

    APM Insight Java Agent for Websphere
  • Locate Generic JVM Arguments textbox and enter the following parameter:
    -javaagent:<agent_directory_full_path>/apminsight-javaagent.jar

    APM Insight Java Agent for Websphere
  • Save the settings and start the Websphere server.
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

Thank you for your feedback!

Was this content helpful?

We are sorry. Help us improve this page.

How can we improve this page?
Do you need assistance with this topic?
By clicking "Submit", you agree to processing of personal data according to the Privacy Policy.