Icingaのソースを表示

[[Category:ネットワーク監視]]
[[en:Icinga]]
[http://www.icinga.org/ Icinga] はオープンソースのホスト・サービス・ネットワーク監視プログラムです。指定されたホストやサービスを監視して、何か問題が発生したら警告を発します。この記事では Icinga のインストールと設定方法について説明します。

== インストール ==

[[ウェブアプリケーションパッケージガイドライン]]に従ってください。

パッケージをインストールする前に以下のコマンドで {{ic|icinga:icinga}} ユーザーを作成してください:
 # groupadd -g 667 icinga
 # useradd -u 667 -g icinga -G http -d /dev/null -s /bin/false icinga
[[AUR]] から {{AUR|icinga}} または {{AUR|icinga2}} パッケージを[[インストール]]してください。

また、{{Pkg|monitoring-plugins}} パッケージもインストールすると良いでしょう。

== Icinga の設定 ==

root でサンプル設定ファイルをコピーしてください:

 # cd /etc/icinga
 # cp cgi.cfg.sample cgi.cfg
 # cp resource.cfg.sample resource.cfg
 # cp icinga.cfg.sample icinga.cfg
 # cp objects/commands.cfg.sample objects/commands.cfg
 # cp objects/contacts.cfg.sample objects/contacts.cfg
 # cp objects/localhost.cfg.sample objects/localhost.cfg
 # cp objects/templates.cfg.sample objects/templates.cfg
 # cp objects/timeperiods.cfg.sample objects/timeperiods.cfg

{{ic|/etc/icinga/resource.cfg}} を編集:
{{hc|head=/etc/icinga/resource.cfg|
output=# Default monitoring plugins
$USER1$=/usr/lib/monitoring-plugins
# or legacy Nagios plugins 
#$USER1$=/usr/share/nagios/libexec
}}

== Icinga2 の設定 ==

デフォルトで Icinga 2 は以下のファイルとディレクトリを使用します:

 # /etc/icinga2	                Contains Icinga 2 configuration files.
 # /etc/init.d/icinga2	        The Icinga 2 init script.
 # /usr/sbin/icinga2*	        The Icinga 2 binary.
 # /usr/share/doc/icinga2	Documentation files that come with Icinga 2.
 # /usr/share/icinga2/include	The Icinga Template Library and plugin command configuration.
 # /var/run/icinga2	        PID file.
 # /var/run/icinga2/cmd	        Command pipe and Livestatus socket.
 # /var/cache/icinga2	        status.dat/objects.cache, icinga2.debug files
 # /var/spool/icinga2	        Used for performance data spool files.
 # /var/lib/icinga2	        Icinga 2 state file, cluster log, local CA and configuration files.
 # /var/log/icinga2	        Log file location and compat/ directory for the CompatLogger feature.

== ウェブサーバーの設定 ==

{{ic|htpasswd.users}} ファイルを作成してください:

 # htpasswd -c /etc/icinga/htpasswd.users icingaadmin

他のユーザーを定義する場合、そのユーザーにもアクセス権限を与えてください。{{ic|/etc/icinga/cgi.cfg}} を以下のように編集:

 authorized_for_system_information=icingaadmin,foo
 authorized_...
 ...

=== Nginx の設定 ===

認証の設定:

  location /icinga/ {
    alias                   /usr/share/webapps/icinga/;
    auth_basic              "Restricted";
    auth_basic_user_file    /etc/icinga/htpasswd.users;
  }

CGI の設定:

    location ~ ^/icinga/(.*)\.cgi$ {
      root           /usr/share/webapps/;
      fastcgi_pass   unix:/var/run/fcgiwrap.sock;
      include        fastcgi.conf;
      fastcgi_param  AUTH_USER          $remote_user;
      fastcgi_param  REMOTE_USER        $remote_user;
    }

== Icinga-web ==

[[ウェブアプリケーションパッケージガイドライン]]に従ってください。

[[AUR]] から {{AUR|icinga-web}} パッケージをインストールしてください。

=== IDOUtils の設定 ===
  
 # cd /etc/icinga
 # mv idomod.cfg-sample idomod.cfg
 # mv ido2db.cfg-sample ido2db.cfg
  
 # cd /etc/icinga/modules
 # mv idoutils.cfg-sample idoutils.cfg

=== ウェブサーバーの設定 ===

サンプル設定ファイルは以下のパスに存在します:

 /etc/icinga-web/apache.example.conf
 /etc/icinga-web/nginx.example.conf

503 'Access denied' エラーが表示される場合、設定ファイルの ''<Directory "/usr/local/icinga-web/lib/ext3/">'' と ''<Directory "/usr/local/icinga-web/pub/">'' セクションに以下の設定を追加してください:
 Order allow,deny
 Allow from all

==== PHP の設定 ====

{{ic|/etc/php.ini}} を編集:
 extension=pdo_mysql.so
 extension=xsl.so
 extension=sockets.so

==== データベースの設定 ====

データベースとユーザーを作成:
 # mysql -u root -p
 > CREATE USER 'icinga_web'@'localhost' IDENTIFIED BY 'icinga_web';
 > CREATE DATABASE icinga_web;
 > GRANT USAGE ON icinga_web.* TO 'icinga_web'@'localhost' WITH MAX_QUERIES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0;
 > GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, ALTER, INDEX ON icinga_web.* TO 'icinga_web'@'localhost';
 > quit
   
スキーマをインポート:
 # mysql -u root -p icinga_web < /usr/share/icinga-web/etc/schema/mysql.sql

== 起動 ==

データベースとウェブサーバーを立ち上げて {{ic|ido2db}} と {{ic|icinga}} を[[起動]]してください。

それから http://localhost/icinga-web を開いて 'root' と 'password' でログインしてください。

== データベースのアップグレード ==

新しいバージョンを使うにはデータベースをアップグレードする必要があります。SQL のアップグレードスクリプトが以下のフォルダに存在します:
 /usr/share/icinga/idoutils/db/mysql/upgrade
 /usr/share/icinga-web/etc/schema/updates/mysql
以下のコマンドでスクリプトを使ってアップグレードできます:
 # mysql -u root -p icinga < ./mysql-upgrade-1.8.0.sql
 # mysql -u root -p icinga_web < ./mysql_v1-7-2_to_v1-8-0.sql
アップグレードしたら {{ic|icinga}} を再起動してください。

== 参照 ==

* [http://www.icinga.org/ icinga.org] - 公式ウェブサイト
* [https://www.monitoring-plugins.org/ monitoring-plugins] - Icinga などの管理アプリケーションのデフォルトプラグイン
* [http://www.nagiosplugins.org/ Nagios Plugins] - The home of the legacy plugins 
* [[Wikipedia:ja:Icinga]] - Wikipedia 記事
* [http://www.nagiosexchange.org NagiosExchange] - Overview of plugins, addons, mailing lists for Icinga