diff options
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 41 |
1 files changed, 41 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..d015e4a --- /dev/null +++ b/README.md @@ -0,0 +1,41 @@ +This is a set of munin plugins to monitor virtual machines managed via libvirt. + +See INSTALL for installation instructions. + +Setting things up +================= + +Autoconfiguration is simple. Run: + + munin-libvirt-plugins-detect + +this will try to detect the hypervisor, create an apropriate configuration and +enable all plugins. + +If you prefer to configure things by hand: The default uri used to connect to +libvirt is "qemu:///system". This can be changed in the plugin configuration: + + cat <<EOF >/etc/munin/plugin-conf.d/libvirt + [libvirt-*] + env.uri xen:/// + EOF + +Enabling plugins by hand is the same as with any other munin plugin: + + ln -s /usr/share/munin/plugins/libvirt-<plugin> /etc/munin/plugins/ + /etc/init.d/munin-node restart + +Plugin Configuration +==================== + +libvirt-mem and libvirt-cputime support [limits][] for critical and warning +values. These are set to 90% (warning) and 95% (critical) by default. However +you can change them in /etc/munin/munin.conf: + + [somehost.example.com] + libvirt_cputime.total_pc.warning 60 + libvirt_cputime.total_pc.critical 75 + libvirt_mem.total_pc.warning 25 + libvirt_mem.total_pc.critical 50 + +[limits]: http://munin.projects.linpro.no/wiki/HowToContact |