aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMicah Anderson <micah@riseup.net>2013-01-09 15:56:57 -0500
committerMicah Anderson <micah@riseup.net>2013-01-09 15:56:57 -0500
commit711a471ae8c77f0fce3f05dd57ebd308d0144f57 (patch)
treeca3ce5c2efa5836ee4559a5c2540b9c5a82ab940
parent276ed43bac3c6a38f77bd71c5f47be0f8d179d22 (diff)
downloadpuppet-virtual-711a471ae8c77f0fce3f05dd57ebd308d0144f57.tar.gz
puppet-virtual-711a471ae8c77f0fce3f05dd57ebd308d0144f57.tar.bz2
switch to xen-multi munin plugin. This removes the buggy and slow xen_mem and xen_vm and replaces it with a plugin that does those and more
-rw-r--r--files/munin/xen-multi243
-rw-r--r--manifests/xen.pp11
2 files changed, 251 insertions, 3 deletions
diff --git a/files/munin/xen-multi b/files/munin/xen-multi
new file mode 100644
index 0000000..c57a2b8
--- /dev/null
+++ b/files/munin/xen-multi
@@ -0,0 +1,243 @@
+#! /usr/bin/perl
+
+# -*- perl -*-
+
+=head1 NAME
+
+xen_multi - Munin multigraph plugin to monitor Xen domains activity
+
+=head1 APPLICABLE SYSTEMS
+
+This plugin should work on any system running a Xen hypervisor and where xentop
+is installed. It also needs Munin 1.4.0 or higher, since it uses AREASTACK
+(available from 1.3.3) and multigraph (available from 1.4.0).
+
+=head1 CONFIGURATION
+
+xentop requires superuser privileges, so you need to include in your
+configuration:
+
+ [xen-multi]
+ user root
+
+Then restart munin-node and you're done.
+
+=head1 INTERPRETATION
+
+This plugin produces four different graphs: CPU usage, memory usage, disk IOs
+and network traffic.
+
+In each graph, all Xen domains (including dom0) have their data stacked, giving
+an overall amount of ressources used.
+
+NOTE: xentop always reports 0 for dom0's disk IOs and network traffic, but
+both graphs show its entry all the same, so each domain can keep its own color
+along the different graphs.
+
+=head2 CPU usage
+
+This graph shows a percentage of the CPU time used by each domain.
+
+=head2 Memory usage
+
+This graph shows the amount of memory (in bytes) used by each domain.
+
+=head2 Disk IOs
+
+This graph shows the number of disk read and write operations for each domain.
+
+=head2 Network traffic
+
+This graph shows the amount of bits received and transmitted for each domain.
+
+=head1 ACKNOWLEDGEMENTS
+
+Michael Renner for the C<diskstats> plugin which I borrowed some code from.
+
+=head1 VERSION
+
+0.90
+
+=head1 MAGIC MARKERS
+
+ #%# family=auto
+ #%# capabilities=autoconf
+
+=head1 AUTHOR
+
+Raphael HALIMI <raphael.halimi@gmail.com>
+
+=head1 LICENSE
+
+GPLv2
+
+=cut
+
+use strict;
+use Munin::Plugin;
+
+# autoconf - quite simple
+if ($ARGV[0] eq "autoconf") {
+ if (`which xentop`) {
+ print "yes\n";
+ } else {
+ print "no (xentop not found)\n";
+ }
+ exit 0;
+}
+
+
+#
+# Common steps for both "config" and a normal run
+#
+
+#
+# trim_label
+#
+# Trims a given label to it's non-wrapping size
+# $type = 'pos' for normal graphs and 'neg' for mirror graphs
+# pos: nnn.nnU_ times 4
+# neg: nnn.nnU/nnn.nnU_ times 4
+
+sub trim_label {
+ my ($type, $label) = @_; my $data_characters;
+ my ($graph_width, $graph_border_width, $padding_characters, $pixels_per_character) = (400,97,10,6);
+ if ($type eq 'pos') {$data_characters = 32;} elsif ($type eq 'neg') {$data_characters = 64;} else {return $label;}
+
+ my $available_characters = abs(($graph_width+$graph_border_width)/$pixels_per_character)-$padding_characters-$data_characters;
+
+ # If the label is longer than the available space, we write as many
+ # characters as we can on both left and right, and two dots in the middle
+ if ( $available_characters < length $label ) {
+ my $center = ($available_characters-2)/2;
+ $label = substr($label,0,($center)) . '..' . substr($label,-$center);
+ }
+
+ return $label;
+}
+
+# Global variables
+my (%domains,$domain,$munindomain,$cpusecs,$memk,$nettxk,$netrxk,$vbdrd,$vbdwr);
+
+open (XENTOP,"xentop -b -f -i1 |") or die "Could not execute xentop, $!";
+
+# Now we build a hash of hashes to store information
+while (<XENTOP>) {
+ # Some cleaning first
+ s/^\s+//; chomp;
+ # Skip the headers
+ next if /^NAME/;
+
+ # We define only what we need
+ ($domain,undef,$cpusecs,undef,$memk,undef,undef,undef,undef,undef,$nettxk,$netrxk,undef,undef,$vbdrd,$vbdwr,undef,undef,undef) = split(/\s+/);
+
+ # We have to store the sanitised domain name in a separate variable
+ $domains{$domain}{'munindomain'} = clean_fieldname($domain);
+
+ # We need the remaining data only for a normal run
+ if ($ARGV[0] eq "") {
+ $domains{$domain}{'cpusecs'} = $cpusecs;
+ $domains{$domain}{'mem'} = $memk;
+ $domains{$domain}{'nettx'} = $nettxk;
+ $domains{$domain}{'netrx'} = $netrxk;
+ $domains{$domain}{'vbdrd'} = $vbdrd;
+ $domains{$domain}{'vbdwr'} = $vbdwr;
+ }
+}
+
+
+#
+# config - quite simple, too
+#
+
+if ($ARGV[0] eq "config") {
+ print "multigraph xen_cpu_time\n";
+ print "graph_title Xen domains CPU time\n";
+ print "graph_args --base 1000 -l 0\n";
+ print "graph_vlabel %\n";
+ print "graph_scale no\n";
+ print "graph_category xen\n";
+ print "graph_info This graph shows CPU time for each Xen domain.\n";
+ for $domain (sort(keys(%domains))) {
+ print "$domains{$domain}{'munindomain'}_cpu_time.label ".trim_label('pos',$domain)."\n";
+ print "$domains{$domain}{'munindomain'}_cpu_time.type DERIVE\n";
+ print "$domains{$domain}{'munindomain'}_cpu_time.cdef $domains{$domain}{'munindomain'}_cpu_time,100,*\n";
+ print "$domains{$domain}{'munindomain'}_cpu_time.min 0\n";
+ print "$domains{$domain}{'munindomain'}_cpu_time.draw AREASTACK\n";
+ }
+
+ print "\nmultigraph xen_mem\n";
+ print "graph_title Xen domains memory usage\n";
+ print "graph_args --base 1024 -l 0\n";
+ print "graph_vlabel bytes\n";
+ print "graph_category xen\n";
+ print "graph_info This graph shows memory usage for each Xen domain.\n";
+ for $domain (sort(keys(%domains))) {
+ print "$domains{$domain}{'munindomain'}_mem.label ".trim_label('pos',$domain)."\n";
+ print "$domains{$domain}{'munindomain'}_mem.cdef $domains{$domain}{'munindomain'}_mem,1024,*\n";
+ print "$domains{$domain}{'munindomain'}_mem.draw AREASTACK\n";
+ }
+
+ print "\nmultigraph xen_net\n";
+ print "graph_title Xen domains network traffic\n";
+ print "graph_args --base 1000\n";
+ print "graph_vlabel bits per \${graph_period} in (-) / out (+)\n";
+ print "graph_category xen\n";
+ print "graph_info This graph shows network traffic for each Xen domain.\n";
+ for $domain (sort(keys(%domains))) {
+ print "$domains{$domain}{'munindomain'}_netrx.label none\n";
+ print "$domains{$domain}{'munindomain'}_netrx.cdef $domains{$domain}{'munindomain'}_netrx,8192,*\n";
+ print "$domains{$domain}{'munindomain'}_netrx.type COUNTER\n";
+ print "$domains{$domain}{'munindomain'}_netrx.graph no\n";
+ print "$domains{$domain}{'munindomain'}_nettx.label ".trim_label('neg',$domain)."\n";
+ print "$domains{$domain}{'munindomain'}_nettx.cdef $domains{$domain}{'munindomain'}_nettx,8192,*\n";
+ print "$domains{$domain}{'munindomain'}_nettx.type COUNTER\n";
+ print "$domains{$domain}{'munindomain'}_nettx.draw AREASTACK\n";
+ print "$domains{$domain}{'munindomain'}_nettx.negative $domains{$domain}{'munindomain'}_netrx\n";
+ }
+
+ print "\nmultigraph xen_disk\n";
+ print "graph_title Xen domains disk IOs\n";
+ print "graph_args --base 1000\n";
+ print "graph_vlabel IOs per \${graph_period} read (-) / write (+)\n";
+ print "graph_category xen\n";
+ print "graph_info This graph shows disk IOs for each Xen domain.\n";
+ for $domain (sort(keys(%domains))) {
+ print "$domains{$domain}{'munindomain'}_vbdrd.label none\n";
+ print "$domains{$domain}{'munindomain'}_vbdrd.type COUNTER\n";
+ print "$domains{$domain}{'munindomain'}_vbdrd.graph no\n";
+ print "$domains{$domain}{'munindomain'}_vbdwr.label ".trim_label('neg',$domain)."\n";
+ print "$domains{$domain}{'munindomain'}_vbdwr.type COUNTER\n";
+ print "$domains{$domain}{'munindomain'}_vbdwr.draw AREASTACK\n";
+ print "$domains{$domain}{'munindomain'}_vbdwr.negative $domains{$domain}{'munindomain'}_vbdrd\n";
+ }
+
+ exit 0;
+}
+
+
+#
+# Normal run
+#
+
+print "multigraph xen_cpu_time\n";
+for $domain (sort(keys(%domains))) {
+ print "$domains{$domain}{'munindomain'}_cpu_time.value $domains{$domain}{'cpusecs'}\n";
+}
+
+print "\nmultigraph xen_mem\n";
+for $domain (sort(keys(%domains))) {
+ print "$domains{$domain}{'munindomain'}_mem.value $domains{$domain}{'mem'}\n";
+}
+
+print "\nmultigraph xen_net\n";
+for $domain (sort(keys(%domains))) {
+ print "$domains{$domain}{'munindomain'}_nettx.value $domains{$domain}{'nettx'}\n";
+ print "$domains{$domain}{'munindomain'}_netrx.value $domains{$domain}{'netrx'}\n";
+}
+
+print "\nmultigraph xen_disk\n";
+for $domain (sort(keys(%domains))) {
+ print "$domains{$domain}{'munindomain'}_vbdrd.value $domains{$domain}{'vbdrd'}\n";
+ print "$domains{$domain}{'munindomain'}_vbdwr.value $domains{$domain}{'vbdwr'}\n";
+}
diff --git a/manifests/xen.pp b/manifests/xen.pp
index 3dbb12c..516a59c 100644
--- a/manifests/xen.pp
+++ b/manifests/xen.pp
@@ -4,12 +4,17 @@
class munin::plugins::xen {
munin::remoteplugin {
- xen_mem:
+ xen-multi:
source => "puppet:///modules/virtual/munin/xen_mem",
- config => "user root";
+ config => "user root",
+ ensure => absent;
xen_vm:
source => "puppet:///modules/virtual/munin/xen_vm",
- config => "user root";
+ config => "user root",
+ ensure => absent;
+ 'xen-multi':
+ source => 'puppet:///modules/virtual/munin/xen-multi',
+ config => 'user root';
}
}