NagiosGrapherとは、Nagiosが出力したデータをグラフ表示するためのアドオンだ。
今回は、このNagiosのパフォーマンスデータをグラフ表示するためのアドオンであるNagiosGrapherのインストール方法を紹介する。
NagiosGrapherは、Nagiosのグラフ表示アドオンとして昔から有名ではあるが、日本語で検索してみると実に情報が少ないのがわかる。
NagiosGrapherは、RRDToolのフロントエンドであり、RRDTool特有のグラフ表示となる。
同じくRRDToolのフロントエンドにcactiというツールがある。
cactiは、昔からNagiosと一緒に使われることが多いが、cactiは自分が監視収集したデータをグラフ化するのであって、Nagiosのパフォーマンスデータをグラフ表示するわけではない。
Nagiosを利用するのであれば、やはりNagiosのパフォーマンスデータをグラフ表示することにこだわりたい。
また、NagiosGrapherは設定も難しく、理解するまでは大変だが、Nagiosのユーザ認証をサポートしており、閲覧権限のない監視対象のグラフは表示されないなど、他のグラフ表示アドオンにはない機能を備えている。
確かに扱いづらいアドオンではあるが、一度使いこなしてしまえば、なかなか便利なツールである。
このブログを書いている現在時点でのNagiosGrapherの最新版は1.7.1 だ。
以前、インストールしたNagios（3.1.0）にインストールを行う。
サーバOSは、CentOS 5.3 である。

ダウンロード

今回必要なものは以下の通りだ。

●NagiosGrapher　：　NagiosGrapher-1.7.1.tar.gz　（NagiosGrapherのダウンロードページ）

ダウンロードしたtarballは、/usr/local/src に置くものとする。

インストールマニュアル

NagiosGrapherのインストールマニュアルは、NagiosGrapherのtarball（NagiosGrapher-1.7.1.tar.gz）に含まれている。
tarballを解凍すると以下にインストールマニュアルがある。

./NagiosGrapher-1.7.1/doc/INSTALL

また、全ての作業は特に断りがない限りrootアカウントで行うものとする。

システム要求

NagiosGrapherのインストールマニュアルによれば、以下の通り。

– Nagios
– RRDTool
– 以下のPerlモジュール
CGI
CGI::Carp
Calendar::Simple
Carp
Data::Dumper
File::Basename
File::Copy
GD
IO::Handle
Image::Magick
POSIX
RRDs
Storable
Time::HiRes
Time::Local
URI::Escape
– autoconf

Nagiosは、当然インストール済みだ。
RRDToolは、yumでインストールすればOKだ。
Perlモジュールとautoconfについては確認して、なければインストールする。
まずは、確認から。

上記の結果から、以下のPerlモジュールがないことがわかった。
Calendar::Simple
GD
Image::Magick

RRDToolと上記のPerlモジュールをインストールする。

NagiosGrapherのインストール

NagiosGrapherはインストール自体は実に簡単だ。

Serviceexttype, MULTIPLE:
	Add these line to your nagios.cfg.
	cfg_dir=/usr/local/nagios/etc/serviceext


 Optional - get informed on left over seviceext .cfg files.
   patch your nagios init script:
   patch -p0 < contrib/nagios.initscript.patch

=============================================================
To tell nagios to write service perfdata, please modify the following files:

nagios.cfg:
    cfg_dir=/usr/local/nagios/etc/serviceext
    process_performance_data=1
    service_perfdata_file=/usr/local/nagios/var/service-perfdata
    service_perfdata_file_template=$HOSTNAME$\t$SERVICEDESC$\t$SERVICEOUTPUT$\t$SERVICEPERFDATA$\t$TIMET$
    service_perfdata_file_mode=a
    service_perfdata_file_processing_interval=30
    service_perfdata_file_processing_command=process-service-perfdata-file

commands.cfg:
    define command{
            command_name process-service-perfdata-file
            command_line mv /usr/local/nagios/var/service-perfdata /usr/local/nagios/var/service-perfdata.$TIMET$
            }

=============================================================
Please do not forget to set a proper loglevel!
Default loglevel is set to 511 which means all. That is why the logfile can grow very fast!

インストール時、起動スクリプト（/etc/rc.d/init.d/nagios_grapher）にRedhat用を指定したが、一部修正が必要。

DAEMON=/usr/lib/nagios/contrib/nagios_grapher/collect2.pl
	↓
DAEMON=/usr/local/nagios/contrib/collect2.pl

また、/usr/local/nagios/var/nagios_grapherの権限の変更を行う。

Nagiosとの連携

次にNagiosGrapherをNagiosと連携させる。
make install時に出たメッセージに従って、Nagiosの設定ファイルにNagiosGrapherの実行に必要な設定を追加する。
今回インストールしたNagios（3.x）に合わせて cfg_dir=/usr/local/nagios/etc/serviceext は、以下のように変更したほうがいいだろう。

●nagios.cfgへの設定追加

　cfg_dir=/usr/local/nagios/etc/objects/serviceext
　process_performance_data=1
　service_perfdata_file=/usr/local/nagios/var/service-perfdata
　service_perfdata_file_template=$HOSTNAME$\t$SERVICEDESC$\t$SERVICEOUTPUT$\t$SERVICEPERFDATA$\t$TIMET$
　service_perfdata_file_mode=a
　service_perfdata_file_processing_interval=30
　service_perfdata_file_processing_command=process-service-perfdata-file

また、NagiosGrapherのインストール時に/usr/local/nagios/etc/serviceextディレクトリが作成されている。
これを削除し、/usr/local/nagios/etc/objects/serviceextを新たに作成する。

●commands.cfgへの設定追加

　define command{
　        command_name process-service-perfdata-file
　        command_line mv /usr/local/nagios/var/service-perfdata /usr/local/nagios/var/service-perfdata.$TIMET$
　}

これをNagiosQLで設定する場合、以下のようにする。
上記のcommand_nameの設定をNagiosQLの下記の画面のCommand*のところに入力する。
上記のcommand_lineの設定をNagiosQLの下記の画面のCommand line*のところに入力する。
また、NagiosQLの下記の画面のCommand typeのところでmisc commandを選択し、Activeのチェックボックスにチェックをつけ、Saveボタンを押す。

図１：NagiosQL3によるcommands.cfgへの設定追加

NagiosGrapherのメイン設定

NagiosGrapherのメイン設定ファイルは、/usr/local/nagios/etc/ngraph.ncfg　だ。
これを以下のように変更する。

Nagiosとの連携の設定で
/usr/local/nagios/etc/serviceext を
/usr/local/nagios/etc/objects/serviceext に変更したため、
NagiosGrapherの設定でも同様に変更する。

    serviceext_path         /usr/local/nagios/etc/serviceext
	↓
    serviceext_path         /usr/local/nagios/etc/objects/serviceext

NagiosGrapherのログレベルの設定を511に変更。

    log_level               1023
	↓
    log_level               511

Nagiosのユーザ認証をサポートするように変更する。

    use_authentication      true
	↓
    use_authentication      false

NagiosGrapherのグラフ設定

NagiosGrapherは、監視プラグインの出力情報からグラフデータを取得し、グラフ表示するのだが、そのためには各サービス監視用のグラフ設定ファイルを作成する必要がある。
このグラフ設定ファイルは、NagiosGrapherのインストール時にテンプレートが以下のディレクトリにインストールされている。

/usr/local/nagios/etc/ngraph.d/templates/standard

drwxr-sr-x 2 apache nagios 4096  1月 11 04:36 .
drwxr-sr-x 4 apache nagios 4096 12月 29 11:10 ..
-rw-r--r-- 1 apache nagios  688  1月 11 04:36 check_disk.ncfg
-rw-r--r-- 1 apache nagios  259  1月 11 04:36 check_dns.ncfg_disabled
-rw-r--r-- 1 apache nagios  259  1月 11 04:36 check_ftp.ncfg_disabled
-rw-r--r-- 1 apache nagios  441  1月 11 04:36 check_http.ncfg_disabled
-rw-r--r-- 1 apache nagios  262  1月 11 04:36 check_imap.ncfg_disabled
-rw-r--r-- 1 apache nagios  270  1月 11 04:36 check_ldap.ncfg_disabled
-rw-r--r-- 1 apache nagios 2565  1月 11 04:36 check_load.ncfg
-rw-r--r-- 1 apache nagios  438  1月 11 04:36 check_mailq.ncfg_disabled
-rw-r--r-- 1 apache nagios 4795  1月 11 04:36 check_mysql.ncfg_disabled
-rw-r--r-- 1 apache nagios  706  1月 11 04:36 check_nagios.ncfg_disabled
-rw-r--r-- 1 apache nagios  297  1月 11 04:36 check_ntp.ncfg_disabled
-rw-r--r-- 1 apache nagios  745  1月 11 04:36 check_ping.ncfg
-rw-r--r-- 1 apache nagios  477  1月 11 04:36 check_pop.ncfg_disabled
-rw-r--r-- 1 apache nagios 1162  1月 11 04:36 check_procs.ncfg
-rw-r--r-- 1 apache nagios  258  1月 11 04:36 check_smtp.ncfg_disabled
-rw-r--r-- 1 apache nagios  521  1月 11 04:36 check_swap.ncfg
-rw-r--r-- 1 apache nagios  256  1月 11 04:36 check_users.ncfg

ここにあるテンプレートの中で、ファイル名の拡張子が .ncfg のものは、NagiosGrapherが設定内容を読み込む。
使用しない設定ファイルは、他のファイル同様、ファイル名の拡張子を .ncfg_disabled にしておけばよい。

NagiosGrapherの起動

次は、NagiosGrapherを起動させる。
chkconfigで管理できるようにしておくと便利だ。

nagios_grapher  0:off   1:off   2:on    3:on    4:on    5:on    6:off

Starting collector: collect2.pl                            [  OK  ]

NagiosGrapherの動作確認を行う。
グラフ設定ファイルを読み込んで、正常動作している場合は、以下のようになっている。（SWAP監視の例）

2010-01-23 18:47:58 PIPE: manager       SWAP    SWAP OK - 100% free (2047 MB out of 2047 MB)    swap=2047MB;409;204;0;2047      1264240043
2010-01-23 18:47:58 REGEX: 1 blocks for 'SWAP' found.
2010-01-23 18:47:58 REGEX: graph_value=swap
2010-01-23 18:47:58 REGEX: output=plugin.
2010-01-23 18:47:58 REGEX: regex=m/(\d+)%/i
2010-01-23 18:47:58 REGEX: perfdata=swap ok - 100% free (2047 mb out of 2047 mb)
2010-01-23 18:47:58 REGEX: match=100
2010-01-23 18:47:58 VALUES: [manager][SWAP]: swap=100
2010-01-23 18:47:58 RRD: rrdtool update /usr/local/nagios/var/rrd/manager/13dbe470cf9c9ac9586663ca46c2e2c2.rrd --template=swap 1264240043:100

グラフ設定ファイルがなかったり、設定内容が間違っていた場合は、以下のようになっている。（SWAP監視の例）

2010-01-23 15:57:00 PIPE: manager       SWAP    SWAP OK - 100% free (2047 MB out of 2047 MB)    swap=2047MB;409;204;0;2047      1264229785
2010-01-23 15:57:00 REGEX: No blocks for 'SWAP' found.

Nagiosの再起動

NagiosGrapherは、Nagiosからグラフデータを取得するとNagiosのサービス拡張設定ファイルを作成する。
今回の設定の場合、/usr/local/nagios/etc/objects/serviceext に作成される。
そのため、Nagiosを再起動し、サービス拡張設定ファイルを読み込ませることで、以下のようにNagiosのサービス監視画面のサービス名のところにNagiosGrapherのグラフアイコンを表示させることができる。

図２：グラフアイコンが表示されたNagiosのサービス監視画面

また、グラフアイコンをクリックすることで、グラフを表示させることができる。

図３：NagiosGrapher

Categories: Nagios ,NagiosGrapher