Install APM Insight Java Agent in Jira server
Follow the below steps to install APM Insight Java agent in Jira server:
- Download the latest APM Insight Java agent (apminsight-javaagent.zip) file.
- Extract the zip file to a new directory to find 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.
- For Windows, edit the catalina.bat file located under <Installation_Directory>/atlassian/jira/bin/directory to add the following JVM argument:
set "JAVA_OPTS=%JAVA_OPTS% -javaagent:{full_path_to_agent_directory}/apminsight-javaagent.jar -Datlassian.org.osgi.framework.bootdelegation=com.manageengine.*,sun.*,org.apache.xerces,org.apache.xerces.*"
- For Linux, edit the catalina.sh file located under <Installation_Directory>/atlassian/jira/bin/directory to add the following JVM argument:
#!/bin/sh
JAVA_OPTS="$JAVA_OPTS -javaagent:{full_path_to_agent_directory}/apminsight-javaagent.jar -Datlassian.org.osgi.framework.bootdelegation=com.manageengine.*,sun.*,org.apache.xerces,org.apache.xerces.*"
- Restart the Jira 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