From d704cf7062110e267b85102c986d8020ad368d6b Mon Sep 17 00:00:00 2001 From: Guido Günther Date: Mon, 16 Jan 2017 18:46:21 +0100 Subject: Rename README it was markdown like already --- README.md | 41 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 README.md (limited to 'README.md') 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 </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- /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 -- cgit v1.2.3