aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGuido G√ľnther <agx@sigxcpu.org>2008-11-20 14:56:23 +0100
committerGuido Guenther <agx@sigxcpu.org>2008-11-20 14:56:23 +0100
commitce18826d4f7e99a6e5e9b6d93685b5b8cfbd7459 (patch)
tree207cfb7aa69a0183192050aa5105eb1c32f08bcd
parent81d6301ff4826ec359355ac3cdd59ced8e75984e (diff)
explain autoconfiguration
-rw-r--r--INSTALL5
-rw-r--r--README20
2 files changed, 21 insertions, 4 deletions
diff --git a/INSTALL b/INSTALL
index 789eb9d..72be58e 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,5 +1,6 @@
Installation is simple:
-make PLUGINDIR=/etc/munin/plugins install
-/etc/init.d/munin-node restart
+make install
+this will install the plugins into /usr/share/munin/plugins. See README on
+howto configure and enable the plugins.
diff --git a/README b/README
index cbb8ab0..4b758c1 100644
--- a/README
+++ b/README
@@ -2,14 +2,30 @@ This is a set of munin plugins to monitor virtual machines managed via libvirt.
See INSTALL for installation instructions.
-The default uri used to connect to libvirt is "qemu:///system". This can be
-changed in the plugin configuration:
+== 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[1] 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: