Using Nagios 4 to monitor Alfresco Server

This article shows how to setup Nagios/Icinga Java plugin to check via JMX values to Alfresco Enterprise 3.2 and above. It contains 39 checks and supports performance data to graph results of checks with pnp4nagios. The ones not Alfresco EE – JMX layer specific, but Tomcat, for example:

– check_jmx connections to Tomcat variables (File Descriptors, Load Average, Heap Memory Used, Number of Threads or Share Caches)

Besides you can check:

– check_http 80 and 8080 ports for apache web proxy and tomcat
– check_snmp for several general parameter (disks, memory, cpu, load, swap)
– check_tcp conections to CIFS, FTP, RMI ports of Alfresco ECM
– check_tomcat for servlet container monitorization via server status (this is an alternative of the plugin)
– check_mysqld for nice mysql graph stats and db net traffic

Installation

  1. Download Nagios Alfresco plugin from https://code.google.com/archive/p/alfresco-nagios-and-icinga-plugin/downloads
  2. Copy next two files to your Nagios plugin directory: /usr/local/nagios/libexec
    – check_alfresco
    – check_alfresco.jar
  3. For a couple of sample command definitions copy:- alfresco-commands.cfg
    to your Nagios plugin configuration directory: /usr/local/nagios/etc/objects
  4. Add next lines to nagios.cfg file in : /usr/local/nagios/etc# Definitions for monitoring Alfresco Enterprise
    cfg_file=/usr/local/nagios/etc/objects/alfresco-commands.cfg
    cfg_file=/usr/local/nagios/etc/objects/alfresco-server.cfg
  5. Edit alfresco-server.cfg to fits your needs in terms of alerts threshold for warning and critical and Alfresco server host name in
    • define host{
              use             linux-server
              host_name       AlfrescoServer      ; The name were giving to this host
              alias           My Alfresco Enterprise Server   ; A longer name associated with the host
              address         127.0.0.1       ;192.168.0.1         ; IP address of the Alfresco host
              }
  6. Edit last 3 commands in alfresco-commands.cfg to set your Repository Path i.e /opt/alfresco/alf_data
  7. In order to use command definitions you can use something like next line in your “define service” for each host (USERNAME and PASSWORD are jmxrmi configured credentials see /opt/alfresco/tomcat/webapps/alfresco/WEB-INF/classes/alfresco/alfresco-jmxrmi.access and /opt/alfresco/tomcat/webapps/alfresco/WEB-INF/classes/alfresco/alfresco-jmxrmi.password):
    -check_alfresco_HeapMemoryUsage_Used!PORT!USERNAME!PASSWORD!750000000!800000000
  8. Copy alfresco.gif logo to your Nagios/Icinga logos directory ($NAGIOS_PATH/share/images/logos)

Screenshot from 2016-04-16 19:37:22

Reference

admin has written 55 articles