MonAMI v0.10 User Guide

Paul Millar


Table of Contents

1. Introduction
1.1. MonAMI architecture
1.2. The three monitoring flows
1.3. Datatrees
2. Running MonAMI
2.1. Options for monamid
2.2. Testing a configuration
2.3. Running in production environment
2.4. Running from within the CVS tree
3. Configuring MonAMI
3.1. Structure of a configuration file.
3.2. The [monami] stanza.
3.2.1. Logging Messages from MonAMI
3.2.2. Dropping root privileges
3.2.3. Auxiliary configuration file directories
3.2.4. Attributes
3.3. Features common across plugins
3.3.1. The name attribute
3.3.2. The cache attribute
3.3.3. The map attribute
3.3.4. Estimating future data-gathering delays
3.4. Monitoring Plugins
3.4.1. AMGA
3.4.2. Apache
3.4.3. dCache
3.4.4. Disk Pool Manager (DPM)
3.4.5. Filesystem
3.4.6. GridFTP
3.4.7. Maui
3.4.8. MySQL
3.4.9. null
3.4.10. NUT
3.4.11. Process
3.4.12. Stocks
3.4.13. TCP
3.4.14. Tomcat
3.4.15. Torque
3.4.16. Varnish
3.5. Reporting plugins
3.5.1. filelog
3.5.2. FluidSynth
3.5.3. Ganglia
3.5.4. GridView
3.5.5. grmonitor
3.5.6. KsysGuard
3.5.7. MonALISA
3.5.8. MySQL
3.5.9. Nagios
3.5.10. null
3.5.11. SAM
3.5.12. Snapshot
3.5.13. R-GMA
3.6. sample
3.6.1. The read attribute
3.6.2. Timed sample targets
3.6.3. Named vs Anonymous samples.
3.6.4. Adaptive monitoring
3.6.5. Sample attributes
3.7. Configuring Event-based Monitoring
3.7.1. dispatch
3.8. Example configurations
3.8.1. On-demand monitoring example
3.8.2. Polling monitoring example
3.8.3. Event monitoring example
3.8.4. A more complex example
4. Security
4.1. General comments
4.2. Risks arising from running MonAMI
4.2.1. Information distributed too readily.
4.2.2. Passwords being stored insecurely
4.2.3. A bug in MonAMI is exploitable
4.2.4. MonAMI tricked into providing a Denial-of-Service attack
5. Further Information

List of Figures

1.1. Illustration of MonAMI architecture
1.2. Illustration of the three data flows
3.1. Data from DPM displayed within Ganglia.
3.2. Ganglia graphs showing data from dpm and tcp targets
3.3. gr_Monitor showing data from apache and mysql targets
3.4. KSysGuard showing data from the nut plugin
3.5. Example deployment with key elements of MonALISA shown.
3.6. Nagios service status page showing two MonAMI-provided outputs.
3.7. Adaptive monitoring increasing sampling interval in response to excessive server load.