1. Monitoring Alfresco with Nagios/Icinga
Toni de la Fuente
Alfresco Senior Solutions Engineer
Blog: blyx.com Twitter: @ToniBlyx

2. Monitoring Alfresco with Nagios/Icinga
Toni de la Fuente
Alfresco Senior Solutions Engineer
Blog: blyx.com Twitter: @ToniBlyx

3. Agenda
• Monitoring Alfresco
• What is Nagios and Icinga?
• How it works?
• Alfresco Plugin
• Installation and configuration
• Screenshots
• Resources

4. Monitoring Alfresco
• Why monitoring? • Several ways:
• Control • JMX
• Metrics • Logging
• Provisioning • TCP/UDP
• Bottlenecks • ICMP
• Problems • Profiling
• Performance
• Scalation
• Alerts
• Threshold
• Historic

5. How Can I Get Full Monitoring of Alfresco?

6. How Can I Get Full Monitoring of Alfresco?
• Nagios or Icinga + nagios4alfresco plugin

7. What is Nagios and Icinga?
Nagios Icinga
• Open Source • Nagios fork 2009
monitoring software
• Supports DB backend
• 1999 – NetSaint
• Icinga-web PHP
• Thousands of
downloads and live • Icinga Reports based
installations on Jasper Reports
• Very flexible (optional)
• Various notification
options, alerts and
scalations
• Plugins and modules

8. How it works?
Check plugins
• “check_smth”
• Standard (TCP and UDP) plugins
• Service specific (MySQL, IMAP, SMTP, etc.)
• Custom plugins (check_jmx)
• Derivates check_jmx  check_alfresco

9. How to monitoring Alfresco?
• TCP and JMX
• Nagios plugin for Alfresco 1.1
• http://addons.alfresco.com/addons/alfresco-nagios-icinga-plugin/
• For Alfresco Enterprise 3.2 and above
• Easy and quick install
• README file
• Copy check_alfresco and check_alfresco.jar files to plugins/libexec
directory
• Copy and edit alfresco-server.cfg
• Copy and edit alfresco-commands.cfg
• Reload Nagios config
• Install pnp4nagios
• Performance data supported on plugin
• Enable performance data on Nagios

10. How to monitoring Alfresco?
• TCP and JMX
• Nagios plugin for Alfresco 1.1
• http://addons.alfresco.com/addons/alfresco-nagios-icinga-plugin/
• For Alfresco Enterprise 3.2 and above
• Easy and quick install
• README file
• Copy check_alfresco and check_alfresco.jar files to plugins/libexec
directory
• Copy and edit alfresco-server.cfg
• Copy and edit alfresco-commands.cfg
• Reload Nagios config
• Install pnp4nagios
• Performance data supported on plugin
• Enable performance data on Nagios

11. alfresco-commands.cfg
• Config file with all Alfresco specific check commands definitions
• Sample command definition:
alfresco-server.cfg
• Sample config file for an Alfresco server (template, name, IP address,
icon, etc.)
• Sample check:

12. Default Monitoring Checks
• 28 Alfresco JMX specific
• 11 OS and network
checks
related checks
•
• Ping •
•
•
• TCP ports availability and •
•
response time •
•
•
• App Server (8080) •
•
• SSH (22) •
•
•
• Web Server (80) •
•
• Jetty (SPP – 7070) •
•
• FTP (21) •
•
•
• CIFS (139 and 445) •
•
• RMI (50500) •
•
• SMTP (inbound – 25) •
•
•

13. New plugin version 1.2
• New version of nagios4alfresco plugin
• Tested with Alfresco Enterprise 4.1.1
• Added SOLR + Workflow info
• Commented Lucene, Hibernate, Audit storage checks
• Changed default CIFS ports to 1445 and 1139
• Released Nov 13th
• Next releases and roadmap
• Add more SOLR information
• Add more OS related and protocol specific checks

14. Monitoring Community with JMX
Not Alfresco EE - JMX layer specific, but Tomcat, for example:
• check_alfresco connections to Tomcat variables (File Descriptors,
Load Average, Heap Memory Used, Number of Threads or Share
Caches)
• 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
• check_mysqld for nice mysql graph stats and db net traffic

15. Access
• http://<yourserver>/nagios - classic web interface for
Nagios
• http://<yourserver>/icinga - classic web interface for Icinga
• http://<yourserver>/icinga-web - new web interface
• http://<yourserver>/pnp4nagios - graphs (and mobile
access)

16. Icinga classic web interface (Nagios)
• Always monitoring!
• Nagios4Alfresco Plugin
+33 checks

17. How Icinga Looks Like?

18. pnp4nagios: Graphs Everywhere
• Rrd tool + nagios pefdata

19. Mobile Monitoring
• pnp4nagios has its own
mobile interface

20. Troubleshooting
• Ports and firewall (open only to your monitoring server!):
### RMI service ports ###
alfresco.rmi.services.port=50500
avm.rmi.service.port=50501
avmsync.rmi.service.port=50502
attribute.rmi.service.port=50503
authentication.rmi.service.port=50504
repo.rmi.service.port=50505
action.rmi.service.port=50506
deployment.rmi.service.port=50507
• Credentials
•Change alfresco-jmxrmi.access and alfresco-jmxrmi.password (out
of class path)
•Read only for checks!!
•Test with jconsole

21. Resources
• Nagios • Hyperic
• http://www.nagios.org • http://www.hyperic.com
• Icinga • NewRelic
• http://www.icinga.org • http://www.newrelic.com
• pnp4nagios • AppDynamics
• http://www.pnp4nagios.org • http://www.appdynamics.com
• Nagios4alfresco plugin • blyx.com
• http://addons.alfresco.com/add • http://blyx.com
ons/alfresco-nagios-icinga-
plugin
• JavaMelody
• http://code.google.com/p/java
melody/

22. I would like to share my monitor server for
testing purposes
• Not for production just test, gathering stats and add
commands to the plugin
• No alerts mails or sms.
• Drop me an email: toni@blyx.com
• IP address
• JMX port
• JMX read only user and password
• I will give you web access to see your server stats
• Remember, personal project! Not SLA to apply :P
• Up to 20 servers total

23. # while you=applause; do
echo THANKS!;
done
Toni de la Fuente
Alfresco Senior Solutions Engineer
Blog: blyx.com Twitter: @ToniBlyx

24. # while you=applause; do
echo THANKS!;
done
Toni de la Fuente
Alfresco Senior Solutions Engineer
Blog: blyx.com Twitter: @ToniBlyx