Atlassian JIRA is an agile project management and issue tracking tool. Install this plugin to monitor the database writes, reads, and the total issues logged in your JIRA servers.
Prerequisites
- Ensure JMX configuration is enabled correctly. Please refer the below section to enable JMX configuration.
- Our Linux/Windows server monitoring agent should be installed in the JIRA server.
- While adding a plugin, the plugin name and its folder name inside the Site24x7 agent should be identical.
- Access JIRA console in a browser and go to Settings > System > JMX Monitoring and enable JMX monitoring.
- Go to jira_home/atlassian-jira-*.*.*/bin and open catalina.sh file for Linux and open catalina.bat file for Windows.
For Windows:set JAVA_OPTS=-Dcom.sun.management.jmxremote %JAVA_OPTS%set JAVA_OPTS=-Dcom.sun.management.jmxremote.port=8099 %JAVA_OPTS%For Linux:JAVA_OPTS="-Dcom.sun.management.jmxremote ${JAVA_OPTS}"JAVA_OPTS="-Dcom.sun.management.jmxremote.port=8099 ${JAVA_OPTS}"
- Go to JAVA_HOME/bin directory and run jconsole
- You can see a service named org.apache.catalina.startup.Bootstrap. It denotes your JMX is running properly. If you face any problems with the configuration, read this documentation
Plugin Installation
Linux
- Download and install the latest version of the Site24x7 Linux agent in the network where you plan to run the plugin. If it is installed successfully, you will see a Linux server monitor in the Site24x7 Control Panel. This confirms that the agent is able to communicate with our data center.
- Download the jira.sh and the Jira.java files from our GitHub repository.
wget https://raw.githubusercontent.com/site24x7/plugins/master/jira/jira.shwget https://raw.githubusercontent.com/site24x7/plugins/master/jira/Jira.java
- Edit the file 'jira.sh' to configure the HOSTNAME, PORT, RMI_UNAME, and RMI_PASSWORD. The values for 'RMI_UNAME' and 'RMI_PASSWORD' can also be set through environmental variables.
- Create a folder with the name 'jira', under the Site24x7 Linux agent plugin directory '/opt/site24x7/monagent/plugins/' and place the 'jira.sh' and 'Jira.java' files under '/opt/site24x7/monagent/plugins/jira/'.
Windows
- Download and install the latest version of the Site24x7 Windows agent in the network where you plan to run the plugin. If it is installed successfully, you will see a Windows server monitor in the Site24x7 Control Panel. This confirms that the agent is able to communicate with our data center.
- Download the jira.bat and the Jira.java files from our GitHub repository.
- Edit the file 'jira.bat' to configure the HOSTNAME, PORT, RMI_UNAME, and RMI_PASSWORD.
- Create a folder with the name 'jira', under the Site24x7 Windows agent plugin directory - C:\Program Files (x86)\Site24x7\WinAgent\monitoring\Plugins\ and place the 'jira.bat' and 'Jira.java' files under 'C:\Program Files (x86)\Site24x7\WinAgent\monitoring\Plugins\jira\'
The agent will automatically execute the plugin within five minutes and send performance data to the Site24x7 data center.
View Data in the Site24x7 Web Client
- Log in to Site24x7 and go to Server > Plugins > click on the name of the plugin monitor.
- You will be able to view the performance charts on the various metrics for your JIRA setup.
Plugin Contribution
Feel free to contribute to our existing plugin and come up with suggestions or feedback on our Community.