Atlassian Confluence is a Java-based team collaboration software. Monitoring Confluence is critical to know underlying issues in JVM, email delivery bottlenecks, latencies in searching, and connection failures. Install this plugin to be instantly notified on resource contentions and abnormal thread activity at the JVM-level.
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 Confluence server.
- While adding a plugin, the plugin name and its folder name inside the Site24x7 agent should be identical.
- Go to your *confluence_home*/atlassian-confluence-\*.\*.*/bin directory.
- For Windows, open 'setenv.bat' and for Linux, open 'setenv.sh'.
- Go to the section where CATALINA_OPTS properties are set and add the following lines at the end, based on the platform.
For Windows:set CATALINA_OPTS=-Dcom.sun.management.jmxremote %CATALINA_OPTS%set CATALINA_OPTS=-Dcom.sun.management.jmxremote.port=8099 %CATALINA_OPTS%For Linux:CATALINA_OPTS="-Dcom.sun.management.jmxremote ${CATALINA_OPTS}"CATALINA_OPTS="-Dcom.sun.management.jmxremote.port=8099 ${CATALINA_OPTS}"
- Go to *JAVA_HOME*/bin directory and run jconsole.
- You can see a service named org.apache.catalina.startup.Bootstrap running. 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 confluence.sh and the Confluence.java files from our GitHub repository.
wget https://raw.githubusercontent.com/site24x7/plugins/master/confluence/confluence.shwget https://raw.githubusercontent.com/site24x7/plugins/master/confluence/Confluence.java
- Edit the file 'confluence.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 'confluence', under the Site24x7 Linux agent plugin directory '/opt/site24x7/monagent/plugins/' and place the 'confluence.sh' and 'Confluence.java' files under '/opt/site24x7/monagent/plugins/confluence/'.
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 confluence.bat and the Confluence.java files from our GitHub repository.
- Edit the file 'confluence.bat' to configure the HOSTNAME, PORT, RMI_UNAME, and RMI_PASSWORD.
- Create a folder with the name 'confluence', under the Site24x7 Windows agent plugin directory - C:\Program Files (x86)\Site24x7\WinAgent\monitoring\Plugins\ and place the 'confluence.bat' and 'Confluence.java' files under 'C:\Program Files (x86)\Site24x7\WinAgent\monitoring\Plugins\confluence\'
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 Confluence setup.
Plugin Contribution
Feel free to contribute to our existing plugin and come up with suggestions or feedback on our Community.