munin.war[Munin用Tomcat plugin servlet] version 1.00

概要

Munin用のTomcat pluginです。すでにperl等で作られたものはありますが、似たような機能をjava servletで実装しました。
muninのpluginの機能は全てservletで実装してあります。
あとはshell scriptからwget -q -O-を呼ぶだけです。
このpluginはここで動いています。
JDK1.6で動作しているtomcat6,tomcat7で動作を確認しています。

Install

1.munin.warをここからdownloadする。
2.munin.warをtomcatのwebappsにコピーする。
3.http://localhost:8080/munin/をaccessして、このpageが表示されることを確認する。
4.webapps/munin/shにあるcatalina_*をmuninのplugin directory(fedora の場合/usr/share/munin/plugins)にcopyする。
5.copyしたcatalina_*に実行権限を与える。(chmod +x catalina_*)
6.copyしたpluginを所定のdirectory(fedoraの場合/etc/munin/plugins)にsymbolic linkするか、以下のcommandで自動追加する。

/usr/sbin/munin-node-configure --shell | grep catalina | sh

7.munin-nodeを再起動(fedoraの場合はservice munin-node restart)して完了。

仕様

munin.warは以下のようなservletを提供します。


http://localhost:8080/munin/plugin?g=graph&a=arg1&o=option

gにはgraphの種類を指定します。
	sessions	各ApplicationのSession数.
	threads TomcatのThread数.
	access Tomcatのaccess状況.
	volume Tomcatのdata転送量.
	jvm java vmのheapの状況.
	gccount Java VM のgc回数.
	gctime Java VM のgc時間(ms).
	mempool Java VM の各種Memory poolの状態.

aには以下の値を指定します。
	autoconf	常にyesを返す.
	config		Graphに応じたconfig情報を返す.
	上記以外	各値を返す.
	
oには各機能ごとのoption値を設定します。
	sessionsの場合"o=appname1+appneme2"のようにgraphに表示するapplication名を指定します。
	指定しない場合全てのapplicationになります。
	threads,access,volum の場合"o=http-8080"のようにconnectorの名称を指定します。
	指定しない場合8009を含むコネクター(tomcat6の場合"jk-8009")を選択します。
	

cataline_*はテスト用に作ったものですが一応autoconfに対応しています。
またmunin-nodeの設定fileにURLを指定することもできます。

[catalina*]
env.url http://localhost:8080/munin/plugin


munin.warの中にはjavaのsource fileも入っています。
eclipseのwarのimport機能を使えばcompile環境ができます。

著作権

このsoftwareはW2Ch作者が作ったものです。
MUNINにならいGNU General Public Licenseで公開します。
このsoftwareは無料で利用できますが、無保証です。