NAME

tomcat__ – Munin plugin with multiple connectors support to monitor tomcat servers.

APPLICABLE SYSTEMS

Tomcat 5.0 or higher with the default tomcat manager webapp.

USAGE

Needs access to http://:@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"/>

Symlink the tomcat__ script to tomcat_CONNECTOR_CONFIG where CONNECTOR is Tomcat connector name.

e.g. tomcat_http-bio-8080_access

CONFIGURATION

The following environment variables are used by this plugin:

host

Destination host

port

Connector port number to access manager application

timeout

Connection timeout

request

Override default status-url

user

Manager username

password

Manager password

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

AUTHORS

Based on plugins by Erik Inge Bolsoe <[email protected]> Customized to handle multiple connectors by Masakazu Matsushita <[email protected]> 2011.12