ウェブサイト検索

Icinga 2 によって監視される新しいホストとサービスを追加する


このチュートリアルでは、Icinga 2 によって監視される新しいホストを追加する方法と、Web HTTP サーバーなどのホストのサービスを Icinga によって監視する方法を示します。また、ネットワーク インフラストラクチャで UDP サービスを監視するために、独自のカスタム Icinga プラグイン コマンドを作成する方法も示します。

Icinga 2 をまだインストールしていない場合は、このチュートリアルを確認してください。 gpt-ad-howtoforge_com-medrectangle-3-0;var ffid=1;var alS=1021%1000;var container=document.getElementById(slotId);container.style.width=100%;var ins=document.createElement( ins);ins.id=slotId+-asloaded;ins.className=adsbygoogle ezasloaded;ins.dataset.adClient=pid;ins.dataset.adChannel=cid;if(ffid==2){ins.dataset.fullWidthResponsive=true; }

Icinga 2 は、サーバーとサービスのチェックと通知を簡単に実装できるプラグイン インフラストラクチャを提供します。この事実により、システム管理者とプログラマーは Icinga 2 の新しい機能を構築し、ホスト、ネットワーク サービス、またはネットワーク機能のさまざまな側面を検証することに特化した特別なコマンドを作成できます。

Icinga 2 は、/etc/icinga2/conf.d/ ディレクトリにある hosts.conf ファイルに、サービス ルール、通知、依存関係、スケジュールされたダウンタイム オブジェクトに使用されるオブジェクト属性を含むホスト定義を保存します。このファイルでは、Icinga2 監視プロセスによってチェックされるように、新しいホスト定義を追加できます。以下の例では、デフォルト ゲートウェイ ルーターが Icinga2 によって定期的にチェックされ、ICMP チェックを介してオンラインであるかどうかを確認できるように、新しい定義を追加します。

nano /etc/icinga2/conf.d/hosts.conf

ファイルの最後に移動し、次の行を追加して、新しいホスト定義を追加します。

object Host "Router" {
address = "192.168.1.1"
check_command = "hostalive"
}

たとえば、メイン ルーターでは、認証とセットアップに使用される HTTP Web サーバーのステータスも確認したいと考えています。以下の行は、ルーター上の Web サーバーをチェックして、HTTP サーバーが有効であり、適切な HTTP コードで応答するかどうかを確認します。

object Service "http" {
host_name = "Router"
check_command = "http"
}

Icinga 2 が新しいホスト定義を取得し、新しいリソースの定期的な監視を開始するには、次のコマンドを発行してプロセスを再起動する必要があります。

systemctl restart icinga2.service

新しく追加されたホスト (この場合はルーター) の状態を確認するには、Icinga 2 Web パネルにログインし、[概要] -> [ホスト] に移動します。ルーターのステータスを説明する下の画像に示すように、右側のプレーンに新しく追加されたホストのステータスが表示されます。ホスト チェックは基本的に ICMP プロトコルを介して実行され、Icinga2 は Web パネルにホストのラウンド タイム トリップの平均を表示します。

ホスト HTTP サービス チェックのステータスを表示する場合は、[概要] -> [サービスグループ] に移動し、[HTTP チェック] をクリックします。次のスクリーンショットに示すように、右側の平面に、ルーターの HTTP サービスのステータスが表示されます。

Icinga 2 には、さまざまなサービスを監視するために使用できる一連の定義済みコマンドが付属しています。ただし、これらのデフォルト コマンドでは、カスタム サービスを確認するには不十分な場合があります。この場合、1 つのアプローチは、サービスを監視するために Icinga 2 によって呼び出される独自のカスタム コマンド スクリプトを作成することです。以下の例では、ネットワーク上のさまざまな UDP サービスの状態を確認するために、新しいカスタム コマンド スクリプトを追加する方法を示します。カスタム コマンドはパラメータ化する必要があり、少なくとも 2 つのパラメータを –H ホスト名 または IP および –p ポート番号 の形式で含める必要があります。 UDP サービス ポートを確認するためのカスタム コマンド スクリプトは、/usr/lib/nagios/plugins/ ディレクトリに配置する必要があり、以下のサンプルで宣言されている内容が含まれている必要があります。

nano /usr/lib/nagios/plugins/check_udpport

check_udpport ファイルの抜粋。

#!/bin/bash
while getopts H:p: option
do
case "${option}"
in
H) addr=${OPTARG};;
p) port=${OPTARG};;
esac
done

/bin/nc -vz -u "$addr" "$port" > /dev/null 2>&1

stat=`echo $?`

if test $stat -eq 0; then
echo "Port $port is opened on $addr"
exit 0
else
echo "Port $port is not opened on $addr"
exit 2
fi

このスクリプトがどのように機能するかを理解してみましょう。ご覧のとおり、プラグインは単純な Bash スクリプトに他なりません。 while 制御式を使用して、H と p の文字で定義された 2 つのパラメーターをループします。 H と p の 2 つのシェル変数文字はパラメーター化され、case ステートメントを使用してコマンド ライン引数として解析されます。 case ステートメントは、パラメータが存在するかどうかをテストし、addr および port 変数に対してそれらを宣言します。次に、$addr 変数と $port 変数が netcat コマンドのコマンド オプションとして追加されます。これは、代わりに、$port 変数で定義されたポート番号がプローブされます。 $addr 変数で定義された IP アドレスを持つホストに対して開かれます。 netcat コマンドの出力と最終的なエラーは、このプラグインにとって重要ではないため、Linux のブラックホール /dev/null ファイルに破棄されます。必要なのは netcat コマンドの終了コードです。 netcat がホストのポートをチェックした後、プローブされた UDP ポートが開いている場合、常に 0 終了コードを返します。コマンドの残りの部分は非常に単純です。 if-else ケース条件ステートメントは次を出力します: 指定された IP アドレスで UDP ポートが開いている場合、そのホスト IP アドレスの「ポートが開かれています」という内容の文字列を追加して出力します。終了コード 0.0 終了コードは常に、Linux のプロセスによって返される成功またはエラーなしのコードです。 UDP ポートが開いていない場合 (netcat の終了コードは 0 以外になります)、ホストの「ポートが開いていません」という文字列を出力し、終了コード 2 を追加します。それぞれのエコー出力の後に追加された終了コードこのスクリプトの文字列は、以下で説明するように、Icinga2 チェックにとって大きな意味を持ちます。

Icinga 2 のサービス状態またはホスト状態のコマンド プラグイン リターン コード:

0=サービスは OK、ホストは UP

1=サービスは WARNING、ホストは UP または DOWN/UNREACHABLE (ホストがフラッピングしているか、状態が頻繁に変化している)

2=サービスは CRITICAL、ホストは DOWN/UNREACHABLE

3=不明ダウン/到達不能

したがって、基本的に、Icinga 2 はホストとポートのパラメーターを指定してこのスクリプトを実行し、次の 2 つの状態を返します。UDP ポートに到達できず、ホストの UDP サービスがクリティカルであることを警告するか、または UDP ポートに到達可能であり、それを通知します。 UDP サービスは良好な状態で実行されており、問題ありません。

スクリプト ファイルを編集したら、保存して閉じ、次のコマンドで実行権限を追加することにより、実行時にファイルを起動できることを確認します。

chmod +x /usr/lib/nagios/plugins/check_udpport

次に、スクリプトが期待どおりに機能しているかどうかをテストするために、次の構文を発行して、ネットワーク内のホストを介して、UDP が開いているポートと UDP が閉じているポートに対してコマンドを実行します。

ここでは、TFTP サーバーで 192.168.1.2 ホストがチェックされます。

/usr/lib/nagios/plugins/check_udpport –H 192.168.1.2 –p 69 

確実に閉じていることがわかっているUDPポートに対するチェックをシミュレートします

/usr/lib/nagios/plugins/check_udpport –H 192.168.1.2 –p 68

この新しいカスタム プラグインを Icinga 2 で広く使用するには、以下の例に示すように、Icinga 2 コマンドの構成ファイルに新しいコマンド定義を追加します。

nano /etc/icinga2/conf.d/commands.conf

このファイルの最後に移動し、次のようにコマンド定義を追加します。

object CheckCommand "myudp" {
command = [ PluginDir + "/check_udpport" ]

arguments = {
"-H" = "$addr$"
"-p" = "$port$"
}
vars.addr = "$address$"
}

ckeck_udpport コマンドを呼び出すために Icinga 2 構成で使用されるコマンドの名前は、\myudp になります。サービス ホストのコマンドを呼び出すときに、アドレスを指定する必要はありません。定義は、Icinga 2 マクロ $address$ 変数によってハードコードされているためです。

コマンドが期待どおりに機能しているかどうかを確認するには、ホストの新しいサービス定義を追加して、特定の UDP サービスがそのホスト上で開かれているかどうかを確認します。たとえば、DHCP ポートが 192.168.1.2 ホスト用に開いているかどうかを確認するには、Icinga2 hosts.conf ファイルに次の定義を追加します。

object Service "dhcp" {
host_name = "Pi.hole"
check_command = "myudp"
vars.port = "67"
}

その後、Icinga 2 を再起動して変更を反映し、Icinga 2 Web パネルの [概要] -> [ホスト] に移動し、特定のホストをクリックして、以下のスクリーンショットに示すように UDP サービスのステータスを確認します。

それで全部です!ホストが正常に追加され、そのサービスは Icinga 2 ネットワーク監視アプリケーションによって定期的にチェックされます。 Icinga 2 監視エンジンとカスタム コマンド スクリプトに関するその他のカスタム構成については、次のアドレスのドキュメント ページにアクセスしてください。コマンド

関連記事: