Help Docs

Install Java agent in Jira Server

  1. Extract the zip file to a new directory to find agent jar and its configuration files
  2. Open apminsight.conf file in any text editor and add license.key value, which can be obtained from Site24x7 APM Insight page. Refer here to fine tun the agent settings. 
  3. For Windows,
Edit the file < installation_directory>/atlassian/jira/bin/catalina.bat 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.*"
  1. For Windows Services,
  • Follow the Jira documentation to open Jira JVM configuration window 
  • Once the window is opened, navigate to Java tab and Java Options field
  • Add the following arguements (one per line)
-javaagent:[full_path_to_agent_directory]/apminsight-javaagent.jar
-Datlassian.org.osgi.framework.bootdelegation=com.manageengine.*,sun.*,org.apache.xerces,org.apache.xerces.* 
  1. For Linux,
Edit the file <installation_directory>/atlassian/jira/bin/catalina.sh to add the following JVM argument
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.*"
  1. Restart the Jira Server

Was this document helpful?

Would you like to help us improve our documents? Tell us what you think we could do better.


We're sorry to hear that you're not satisfied with the document. We'd love to learn what we could do to improve the experience.


Thanks for taking the time to share your feedback. We'll use your feedback to improve our online help resources.

Shortlink has been copied!