NAME

tomcat_ - Munin plugin to monitor tomcat servers.

APPLICABLE SYSTEMS

Tomcat 5.0 or higher with the default tomcat manager webapp.

USAGE

Needs access to http://<user>:<password>@localhost:8080/manager/status?XML=true (or modify the address for another host).

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: <user username="munin" password="<set this>" roles="standard,manager"/>

CONFIGURATION

The following environment variables are used by this plugin:

host

Destination host

port

Connector post number (legacy parameter, use connector instead)

timeout

Connection timeout

request

Override default status-url

user

Manager username

password

Manager password

connector

Connector to query, defaults to "http-".$port

CONFIGURATION EXAMPLE

  [tomcat_*]
  env.host 127.0.0.1
  env.port 8080
  env.request /manager/status?XML=true
  env.user munin
  env.password pass
  env.timeout 30
  env.connector jk-8009

AUTHORS

  Based on plugins by Rune Nordboe Skillingstad <runesk@linpro.no>
  Rewrite and expansion in ruby: laxis <laxis@magex.hu> 2008.05
  Converted to rexml and integrated as default tomcat plugin
  by Erik Inge Bolsoe <knan@redpill-linpro.com> 2009.09

MAGIC MARKERS

 #%# family=auto
 #%# capabilities=autoconf suggest