#!/usr/bin/perl =head1 NAME tomcat_jvm - Plugin to monitor the memory of the JVM in Tomcat servers. =head1 CONFIGURATION The following environment variables are used by this plugin: =over 4 =item url Override default status-url =item port HTTP port number =item user Manager username =item password Manager password =back =head1 USAGE Needs access to http://:@localhost:8080/manager/status?XML=true (or modify the address for another host). Tomcat 5.0 or higher. A munin-user in $CATALINA_HOME/conf/tomcat-users.xml should be set up for this to work. Tip: To see if it's already set up correctly, just run this plugin with the parameter "autoconf". If you get a "yes", everything should work like a charm already. tomcat-users.xml example: =head1 AUTHOR Rune Nordbøe Skillingstad =head1 LICENSE GPLv2 =head1 MAGIC MARKERS #%# family=manual #%# capabilities=autoconf =cut use strict; use warnings; use Munin::Plugin::HTTP; use URI::Escape; my $ret = undef; if(!eval "require XML::Simple;") { $ret .= "XML::Simple not found"; } my $UA = Munin::Plugin::HTTP->new; my $URL = exists $ENV{'url'} ? $ENV{'url'} : "http://%s:%s\@%s:%d/manager/status?XML=true"; my $PORT = exists $ENV{'port'} ? $ENV{'port'} : exists $ENV{'ports'} ? $ENV{'ports'} : 8080; my $HOST = exists $ENV{'host'} ? $ENV{'host'} : "127.0.0.1"; my $USER = exists $ENV{'user'} ? $ENV{'user'} : "munin"; my $PASSWORD = exists $ENV{'password'} ? $ENV{'password'} : "munin"; my $url = sprintf $URL, uri_escape($USER), uri_escape($PASSWORD), $HOST, $PORT; if(exists $ARGV[0] and $ARGV[0] eq "autoconf") { if($ret) { print "no ($ret)\n"; exit 0; } my $response = $UA->get($url); if($response->is_success and $response->content =~ /.*<\/status>/im) { print "yes\n"; exit 0; } else { print "no (no tomcat status)\n"; exit 0; } } if(exists $ARGV[0] and $ARGV[0] eq "config") { print "graph_title Tomcat JVM memory\n"; print "graph_args --base 1024 -l 0\n"; print "graph_vlabel Bytes\n"; print "graph_category appserver\n"; print "graph_order used free max OldGenUsed OldGenMax\n"; print "free.label free bytes\n"; print "free.draw STACK\n"; print "used.label used bytes \n"; print "used.draw AREA\n"; print "max.label maximum bytes\n"; print "max.draw LINE2\n"; print "OldGenUsed.label Old Gen used bytes\n"; print "OldGenUsed.draw LINE1\n"; print "OldGenMax.label Old Gen max bytes\n"; print "OldGenMax.draw LINE2\n"; exit 0; } my $xs = new XML::Simple; my $response = $UA->get($url); my $xml = $xs->XMLin($response->content); if($xml->{'jvm'}->{'memory'}->{'free'} && $xml->{'jvm'}->{'memory'}->{'total'} && $xml->{'jvm'}->{'memory'}->{'max'}) { print "free.value " . $xml->{'jvm'}->{'memory'}->{'free'} . "\n"; print "used.value " . ($xml->{'jvm'}->{'memory'}->{'total'} - $xml->{'jvm'}->{'memory'}->{'free'}) . "\n"; print "max.value " . $xml->{'jvm'}->{'memory'}->{'max'} . "\n"; } else { print "free.value U\n"; print "used.value U\n"; print "max.value U\n"; } if( $xml->{'jvm'}->{'memorypool'}->{'PS Old Gen'}->{'usageUsed'} && $xml->{'jvm'}->{'memorypool'}->{'PS Old Gen'}->{'usageMax'}) { print "OldGenUsed.value " . $xml->{'jvm'}->{'memorypool'}->{'PS Old Gen'}->{'usageUsed'} . "\n"; print "OldGenMax.value " . $xml->{'jvm'}->{'memorypool'}->{'PS Old Gen'}->{'usageMax'} . "\n"; } else { print "OldGenUsed.value U\n"; print "OldGenMax.value U\n"; }