差分
このページの2つのバージョン間の差分を表示します。
| 両方とも前のリビジョン 前のリビジョン 次のリビジョン | 前のリビジョン 次のリビジョン 両方とも次のリビジョン | ||
|
ja:documentation:02_installation:05_configuration_agents [2021/07/10 01:02] junichi [UDP サーバ] |
ja:documentation:02_installation:05_configuration_agents [2021/07/10 02:29] junichi [module_regexp] |
||
|---|---|---|---|
| 行 65: | 行 65: | ||
| === debug === | === debug === | ||
| - | 有効化(([[http:// | + | 有効化すると、エージェントのデータファイルはテンポラリディレクトリ内に名前を変えて保存され、サーバへ送信したあとも削除されません。XML ファイルを開いて内容を確認することができます。 |
| === agent_name === | === agent_name === | ||
| 行 311: | 行 312: | ||
| ==== UDP サーバ ==== | ==== UDP サーバ ==== | ||
| + | |||
| + | <WRAP center round important 60%> | ||
| + | |||
| + | UDPは本質的に安全ではないことに注意してください(ただし、応答を必須としないメッセージを送信するには効率的です)。 </ | ||
| Pandora FMS エージェントは、 [[: | Pandora FMS エージェントは、 [[: | ||
| - | UDP リモートサーバの設定には、いくつかのオプションがあり、// | + | UDP リモートサーバの設定には、いくつかのオプションがあり、// |
| - | * **udp_server**: | + | |
| * **udp_server_port**: | * **udp_server_port**: | ||
| * **udp_server_auth_address**: | * **udp_server_auth_address**: | ||
| + | <WRAP center round important 60%> | ||
| + | |||
| + | すべてのソースからのコマンド受け入れのために 0.0.0.0 に設定できますが、この方法はお勧めしません。複数の Pandora FMS サーバがある場合、または IPv6 を使用している場合は、カンマで区切って異なる IP アドレスを追加できます。たとえば、 IPv6:'' | ||
| + | |||
| * **process_< | * **process_< | ||
| * **process_< | * **process_< | ||
| 行 366: | 行 375: | ||
| </ | </ | ||
| - | より詳しくは、アラート設定の章を参照ください。 | + | より詳しくは、 |
| ==== モジュール定義 ==== | ==== モジュール定義 ==== | ||
| 行 374: | 行 382: | ||
| 一般的な書式は次の通りです。 | 一般的な書式は次の通りです。 | ||
| - | |||
| < | < | ||
| + | |||
| | | ||
| | | ||
| 行 390: | 行 398: | ||
| <WRAP center round important 60%> モジュールのフィールド情報はモジュール作成時にのみ反映されます(モジュールデータ、説明、拡張情報を除く)。モジュールがすでに存在する場合は更新されません。 </ | <WRAP center round important 60%> モジュールのフィールド情報はモジュール作成時にのみ反映されます(モジュールデータ、説明、拡張情報を除く)。モジュールがすでに存在する場合は更新されません。 </ | ||
| - | == **module_begin** == | + | == module_begin == |
| モジュール定義の開始を示す、必須項目です。 | モジュール定義の開始を示す、必須項目です。 | ||
| - | == module_name | + | == module_name == |
| モジュールの名前です(必須)。重複した名前は設定できません。 | モジュールの名前です(必須)。重複した名前は設定できません。 | ||
| + | |||
| + | < | ||
| + | module_name < | ||
| + | |||
| + | </ | ||
| == module_type == | == module_type == | ||
| + | |||
| + | < | ||
| + | module_type < | ||
| + | |||
| + | </ | ||
| モジュールが返すデータタイプです。いずれか一つを選択することが必須です。指定可能なデータタイプは次の通りです。 | モジュールが返すデータタイプです。いずれか一つを選択することが必須です。指定可能なデータタイプは次の通りです。 | ||
| 行 410: | 行 428: | ||
| * **Asynchronous Monitor** | * **Asynchronous Monitor** | ||
| * **Asynchronous Numerical** | * **Asynchronous Numerical** | ||
| - | == module_min < | + | == module_min == |
| + | |||
| + | < | ||
| + | module_min <値> | ||
| + | |||
| + | </ | ||
| そのモジュールが返すことを許容されるデータの最小値です。範囲を外れたデータはサーバにより削除されます。 | そのモジュールが返すことを許容されるデータの最小値です。範囲を外れたデータはサーバにより削除されます。 | ||
| - | == module_max < | + | == module_max == |
| + | |||
| + | < | ||
| + | module_max <値> | ||
| + | |||
| + | </ | ||
| そのモジュールが返すことを許容されるデータの最大値です。範囲を外れたデータはサーバにより削除されます。 | そのモジュールが返すことを許容されるデータの最大値です。範囲を外れたデータはサーバにより削除されます。 | ||
| - | == module_min_warning < | + | == module_min_warning == |
| + | |||
| + | < | ||
| + | module_min_warning <値> | ||
| + | |||
| + | </ | ||
| モジュールが警告状態になる最小値です。 | モジュールが警告状態になる最小値です。 | ||
| - | == module_max_warning < | + | == module_max_warning == |
| + | |||
| + | < | ||
| + | module_max_warning <値> | ||
| + | |||
| + | </ | ||
| モジュールが警告状態になる最大値です。 | モジュールが警告状態になる最大値です。 | ||
| - | == module_min_critical < | + | == module_min_critical == |
| + | |||
| + | < | ||
| + | module_min_critical <値> | ||
| + | |||
| + | </ | ||
| モジュールが障害状態になる最小値です。 | モジュールが障害状態になる最小値です。 | ||
| - | == module_max_critical < | + | == module_max_critical == |
| + | |||
| + | < | ||
| + | module_max_critical <値> | ||
| + | |||
| + | </ | ||
| モジュールが障害状態になる最大値です。 | モジュールが障害状態になる最大値です。 | ||
| - | == module_disabled < | + | == module_disabled == |
| + | |||
| + | < | ||
| + | module_disabled <値> | ||
| + | |||
| + | </ | ||
| モジュールが、有効(0)か無効(1)かを表します。 | モジュールが、有効(0)か無効(1)かを表します。 | ||
| - | == module_min_ff_event < | + | == module_min_ff_event == |
| + | |||
| + | < | ||
| + | module_min_ff_event <値> | ||
| + | |||
| + | </ | ||
| 連続抑制回数を指定します。連続抑制回数とは、収集データに揺らぎがあるような場合に、それを変化としてとらえないように抑止するものです。 | 連続抑制回数を指定します。連続抑制回数とは、収集データに揺らぎがあるような場合に、それを変化としてとらえないように抑止するものです。 | ||
| - | == (>= 6.0 SP4) module_each_ff <値> == | + | == module_each_ff |
| + | |||
| + | <WRAP center round tip 60%> | ||
| + | |||
| + | < | ||
| + | module_each_ff <0|1> | ||
| + | |||
| + | </code> | ||
| 有効化(1)すると、module_min_ff_event の代わりに連続抑制回数に個別状態変化(module_min_ff_event_normal, | 有効化(1)すると、module_min_ff_event の代わりに連続抑制回数に個別状態変化(module_min_ff_event_normal, | ||
| - | == (>= 6.0 SP4) module_min_ff_event_normal < | + | == module_min_ff_event_normal |
| + | |||
| + | <WRAP center round tip 60%> | ||
| + | < | ||
| + | |||
| + | module_min_ff_event_normal <値> | ||
| + | |||
| + | </ | ||
| 個別状態変化で、正常状態へ移行する場合の連続抑制回数です。 | 個別状態変化で、正常状態へ移行する場合の連続抑制回数です。 | ||
| - | == (>= 6.0 SP4) module_min_ff_event_warning < | + | == module_min_ff_event_warning |
| + | |||
| + | <WRAP center round tip 60%> | ||
| + | |||
| + | < | ||
| + | module_min_ff_event_warning <値> | ||
| + | |||
| + | </ | ||
| 個別状態変化で、警告状態へ移行する場合の連続抑制回数です。 | 個別状態変化で、警告状態へ移行する場合の連続抑制回数です。 | ||
| - | == (>= 6.0 SP4) module_min_ff_event_critical < | + | == module_min_ff_event_critical |
| + | |||
| + | <WRAP center round tip 60%> | ||
| + | |||
| + | < | ||
| + | module_min_ff_event_critical <値> | ||
| + | |||
| + | </ | ||
| 個別状態変化で、障害状態へ移行する場合の連続抑制回数です。 | 個別状態変化で、障害状態へ移行する場合の連続抑制回数です。 | ||
| - | == (>= 6.0 SP4) module_ff_timeout < | + | == module_ff_timeout |
| + | |||
| + | <WRAP center round tip 60%> | ||
| + | |||
| + | < | ||
| + | module_ff_timeout <秒> | ||
| + | |||
| + | </ | ||
| 指定した秒数が経過したら連続抑制回数のカウンターをリセットします。これは、// | 指定した秒数が経過したら連続抑制回数のカウンターをリセットします。これは、// | ||
| - | == (>= 734) module_ff_type < | + | == module_ff_type |
| + | |||
| + | <WRAP center round tip 60%> | ||
| + | |||
| + | < | ||
| + | module_ff_type <値> | ||
| + | |||
| + | </ | ||
| これは、連続抑制の高度なオプションで、モジュールの状態を制御します。 " | これは、連続抑制の高度なオプションで、モジュールの状態を制御します。 " | ||
| 行 468: | 行 568: | ||
| 有効(1)か無効(0)かを指定します。 | 有効(1)か無効(0)かを指定します。 | ||
| - | == module_description < | + | == module_description == |
| + | |||
| + | < | ||
| + | module_description < | ||
| + | |||
| + | </ | ||
| モジュールの任意のコメントです。 | モジュールの任意のコメントです。 | ||
| - | == module_interval < | + | == module_interval == |
| + | |||
| + | < | ||
| + | module_interval < | ||
| + | |||
| + | </ | ||
| それぞれのモジュールの実行間隔をエージェントの間隔の倍率で設定することができます。例えば、エージェントが 300 (5 分)間隔の設定であった場合に、あるモジュールだけ 15分間隔にしたいときに、module_interval 3 を設定します。そのモジュールは、300秒 x 3 = 900秒 (15分) 間隔で実行されます。 | それぞれのモジュールの実行間隔をエージェントの間隔の倍率で設定することができます。例えば、エージェントが 300 (5 分)間隔の設定であった場合に、あるモジュールだけ 15分間隔にしたいときに、module_interval 3 を設定します。そのモジュールは、300秒 x 3 = 900秒 (15分) 間隔で実行されます。 | ||
| 行 478: | 行 588: | ||
| <WRAP center round important 60%> ブローカーエージェントで module_interval が動作するようにするには、元のエージェントと同じ間隔に設定する必要があります。 そうしないと、正しく動作しない可能性があります。 </ | <WRAP center round important 60%> ブローカーエージェントで module_interval が動作するようにするには、元のエージェントと同じ間隔に設定する必要があります。 そうしないと、正しく動作しない可能性があります。 </ | ||
| - | == module_timeout < | + | == module_timeout == |
| + | |||
| + | < | ||
| + | module_timeout < | ||
| + | |||
| + | </ | ||
| モジュールの最大実行時間を秒単位で指定します。実行中にこの時間を超過した場合は、実行が中止されます。 | モジュールの最大実行時間を秒単位で指定します。実行中にこの時間を超過した場合は、実行が中止されます。 | ||
| - | == module_postprocess < | + | == module_postprocess == |
| + | |||
| + | < | ||
| + | module_postprocess < | ||
| + | |||
| + | </ | ||
| モジュールから返される値を何倍するかの値です。データの単位を変換するのに便利です。もし、エージェントが取得した値に 1024 を掛けたい場合は、1024 を設定します。また、1024 で割りたい場合は、1/ | モジュールから返される値を何倍するかの値です。データの単位を変換するのに便利です。もし、エージェントが取得した値に 1024 を掛けたい場合は、1024 を設定します。また、1024 で割りたい場合は、1/ | ||
| - | == module_save < | + | == module_save == |
| + | |||
| + | < | ||
| + | module_save < | ||
| + | |||
| + | </ | ||
| このパラメータで定義された名前の変数にモジュールから返された値を保存します。この値はあとから他のモジュールで利用できます。 | このパラメータで定義された名前の変数にモジュールから返された値を保存します。この値はあとから他のモジュールで利用できます。 | ||
| 行 526: | 行 651: | ||
| </ | </ | ||
| - | == module_crontab | + | == module_crontab == |
| バージョン 3.2 から、モジュールを指定した日時に実行させるようにすることができます。この設定は、**module_crontab** | バージョン 3.2 から、モジュールを指定した日時に実行させるようにすることができます。この設定は、**module_crontab** | ||
| + | < | ||
| module_crontab <分> < | module_crontab <分> < | ||
| + | |||
| + | </ | ||
| 指定可能な範囲は次の通りです。 | 指定可能な範囲は次の通りです。 | ||
| 行 566: | 行 694: | ||
| </ | </ | ||
| - | == module_condition < | + | == module_condition == |
| + | |||
| + | < | ||
| + | module_condition < | ||
| + | |||
| + | </ | ||
| バージョン 3.2 から、モジュールが特定の値を返す場合にコマンドを実行させることが可能です。次に示すオプションの一つを定義します。 | バージョン 3.2 から、モジュールが特定の値を返す場合にコマンドを実行させることが可能です。次に示すオプションの一つを定義します。 | ||
| 行 621: | 行 754: | ||
| </ | </ | ||
| - | * 注意**: Windows プラットホームでは、コマンドの実行にはそれが正しく実行されていることを確認するために **cmd.exe /c** を利用することをお勧めします。例えば次の通りです。 | + | * 注意: Windows プラットホームでは、コマンドの実行にはそれが正しく実行されていることを確認するために **cmd.exe /c** を利用することをお勧めします。例えば次の通りです。 |
| + | |||
| + | < | ||
| + | module_begin | ||
| + | module_name condition_test | ||
| + | module_type generic_data | ||
| + | module_exec echo 5 | ||
| + | module_condition (2, 8) cmd.exe /c script.bat | ||
| + | module_end | ||
| + | |||
| + | </ | ||
| + | |||
| + | == module_precondition == | ||
| + | |||
| + | < | ||
| + | module_precondition < | ||
| + | |||
| + | </ | ||
| + | |||
| + | 事前状態定義にマッチした場合モジュールを実行します。次に示すオプションの一つを定義します。 | ||
| + | |||
| + | | ||
| + | | ||
| + | | ||
| + | | ||
| + | | ||
| + | | ||
| + | 以下の例では、precondition で設定した実行結果が 2 と 8 の間の場合に、モジュール // | ||
| + | |||
| + | < | ||
| + | module_begin | ||
| + | module_name Precondition_test1 | ||
| + | module_type generic_data | ||
| + | module_precondition (2, 8) echo 5 | ||
| + | module_exec monitoring_variable.bat | ||
| + | module_end | ||
| + | |||
| + | </ | ||
| + | |||
| + | module_condition と同様に、複数の事前状態定義を利用することができます。モジュールは、すべての事前状態定義にマッチした場合のみ実行されます。 | ||
| + | |||
| + | < | ||
| + | module_begin | ||
| + | module_name Precondition_test2 | ||
| + | module_type generic_data | ||
| + | module_precondition (2, 8) echo 5 | ||
| + | module_precondition <3 echo 5 | ||
| + | module_exec monitoring_variable.bat | ||
| + | module_end | ||
| + | |||
| + | </ | ||
| + | |||
| + | * 注意: Windows プラットホームでは、コマンドの実行にはそれが正しく実行されていることを確認するために **cmd.exe /c** を利用することをお勧めします。例えば次の通りです。 | ||
| < | < | ||
| 行 633: | 行 818: | ||
| </ | </ | ||
| - | == (>= 5.x) module_unit < | + | == module_unit |
| + | |||
| + | <WRAP center round tip 60%> | ||
| + | |||
| + | < | ||
| + | module_unit < | ||
| + | |||
| + | </ | ||
| これは、モジュールの値に付与する単位です。 | これは、モジュールの値に付与する単位です。 | ||
| 行 644: | 行 836: | ||
| </ | </ | ||
| - | == (>= 5.x) module_group < | + | == module_group |
| + | |||
| + | <WRAP center round tip 60%> | ||
| + | |||
| + | < | ||
| + | module_group <値> | ||
| + | |||
| + | </ | ||
| これは、モジュールグループ名です。 | これは、モジュールグループ名です。 | ||
| 行 655: | 行 854: | ||
| </ | </ | ||
| - | == (>= 5.x) module_custom_id < | + | == module_custom_id |
| + | |||
| + | <WRAP center round tip 60%> | ||
| + | |||
| + | < | ||
| + | module_custom_id <値> | ||
| + | |||
| + | </ | ||
| モジュールのカスタム ID です。 | モジュールのカスタム ID です。 | ||
| 行 666: | 行 872: | ||
| </ | </ | ||
| - | == (>= 5.x) module_str_warning < | + | == module_str_warning |
| + | |||
| + | <WRAP center round tip 60%> | ||
| + | |||
| + | < | ||
| + | module_str_warning <値> | ||
| + | |||
| + | </ | ||
| 文字列タイプのモジュールで警告状態を定義する正規表現です。 | 文字列タイプのモジュールで警告状態を定義する正規表現です。 | ||
| 行 677: | 行 890: | ||
| </ | </ | ||
| - | == (>= 5.x) module_str_critical < | + | == module_str_critical |
| + | |||
| + | <WRAP center round tip 60%> | ||
| + | |||
| + | < | ||
| + | module_str_critical <値> | ||
| + | |||
| + | </ | ||
| 文字列タイプのモジュールで障害状態を定義する正規表現です。 | 文字列タイプのモジュールで障害状態を定義する正規表現です。 | ||
| 行 688: | 行 908: | ||
| </ | </ | ||
| - | == (>= 5.x) module_warning_instructions < | + | == module_warning_instructions |
| + | |||
| + | <WRAP center round tip 60%> | ||
| + | |||
| + | < | ||
| + | module_warning_instructions <値> | ||
| + | |||
| + | </ | ||
| モジュールが警告状態に変化したときのオペレータへの指示です。 | モジュールが警告状態に変化したときのオペレータへの指示です。 | ||
| 行 699: | 行 926: | ||
| </ | </ | ||
| - | == (>= 5.x) module_critical_instructions < | + | == module_critical_instructions |
| + | |||
| + | <WRAP center round tip 60%> | ||
| + | |||
| + | < | ||
| + | module_critical_instructions <値> | ||
| + | |||
| + | </ | ||
| モジュールが障害状態に変化したときのオペレータへの指示です。 | モジュールが障害状態に変化したときのオペレータへの指示です。 | ||
| 行 710: | 行 944: | ||
| </ | </ | ||
| - | == (>= 5.x) module_unknown_instructions < | + | == module_unknown_instructions |
| + | |||
| + | <WRAP center round tip 60%> | ||
| + | |||
| + | < | ||
| + | module_unknown_instructions <値> | ||
| + | |||
| + | </ | ||
| モジュールが不明状態に変化したときのオペレータへの指示です。 | モジュールが不明状態に変化したときのオペレータへの指示です。 | ||
| 行 721: | 行 962: | ||
| </ | </ | ||
| - | == (>= 5.x) module_tags < | + | == module_tags |
| + | |||
| + | <WRAP center round tip 60%> | ||
| + | |||
| + | < | ||
| + | module_tags <値> | ||
| + | |||
| + | </ | ||
| カンマ区切りでモジュールに割り当てるタグを指定します。 | カンマ区切りでモジュールに割り当てるタグを指定します。 | ||
| 行 729: | 行 977: | ||
| module_tags tag1, | module_tags tag1, | ||
| - | == (>= 5.x) module_warning_inverse < | + | == module_warning_inverse |
| + | |||
| + | <WRAP center round tip 60%> | ||
| + | |||
| + | < | ||
| + | module_warning_inverse <値> | ||
| + | |||
| + | </ | ||
| 警告閾値範囲の反転を有効化(1)します。 | 警告閾値範囲の反転を有効化(1)します。 | ||
| 行 740: | 行 995: | ||
| </ | </ | ||
| - | == (>= 5.x) module_critical_inverse < | + | == module_critical_inverse |
| + | |||
| + | <WRAP center round tip 60%> | ||
| + | |||
| + | < | ||
| + | module_critical_inverse <値> | ||
| + | |||
| + | </ | ||
| 障害閾値範囲の反転を有効化(1)します。 | 障害閾値範囲の反転を有効化(1)します。 | ||
| 行 751: | 行 1013: | ||
| </ | </ | ||
| - | == (>= 5.x) module_native_encoding | + | == module_native_encoding == |
| - | (Win32 のみ) | + | <WRAP center round tip 60%> |
| + | |||
| + | < | ||
| + | module_native_encoding < | ||
| + | |||
| + | </ | ||
| この設定トークンは、module_exec によってコマンドラインから実行されるモジュールにのみ影響します。 | この設定トークンは、module_exec によってコマンドラインから実行されるモジュールにのみ影響します。 | ||
| 行 779: | 行 1046: | ||
| </ | </ | ||
| - | == (>= 5.x) module_ff_interval < | + | == module_ff_interval |
| + | |||
| + | <WRAP center round tip 60%> | ||
| + | |||
| + | < | ||
| + | module_ff_interval <値> | ||
| + | |||
| + | </ | ||
| 収集データに揺らぎがあるような場合に、それを変化としてとらえるべきかを判断する期間のデータ収集間隔です。(秒単位) | 収集データに揺らぎがあるような場合に、それを変化としてとらえるべきかを判断する期間のデータ収集間隔です。(秒単位) | ||
| 行 790: | 行 1064: | ||
| </ | </ | ||
| - | == (>= 5.x) module_macro< | + | == module_macro |
| + | |||
| + | <WRAP center round tip 60%> | ||
| + | |||
| + | < | ||
| + | module_macro< | ||
| + | |||
| + | </ | ||
| コンソールから、ローカルコンポーネントにのみ適用できます。設定ファイルで直接設定しません。 | コンソールから、ローカルコンポーネントにのみ適用できます。設定ファイルで直接設定しません。 | ||
| - | == (>= 5.1 SP4) module_alert_template < | + | == module_alert_template |
| + | |||
| + | < | ||
| + | module_alert_template < | ||
| + | |||
| + | </ | ||
| このマクロは、パラメータ名([[: | このマクロは、パラメータ名([[: | ||
| 行 823: | 行 1109: | ||
| 次に、それぞれのモジュールで情報を取得するためのディレクティブを示します。それぞれのモジュールで、1回ずつ利用できます。 | 次に、それぞれのモジュールで情報を取得するためのディレクティブを示します。それぞれのモジュールで、1回ずつ利用できます。 | ||
| - | == module_exec < | + | == module_exec == |
| + | |||
| + | < | ||
| + | module_exec < | ||
| + | |||
| + | </ | ||
| 一般的なコマンド実行行です。 1行で情報を取得するコマンドを指定する必要があります。 | 一般的なコマンド実行行です。 1行で情報を取得するコマンドを指定する必要があります。 | ||
| 行 838: | 行 1129: | ||
| Windows エージェントでのデータ取得のためのディレクティブは他にもあります。以下に示します。 | Windows エージェントでのデータ取得のためのディレクティブは他にもあります。以下に示します。 | ||
| - | == module_service < | + | == module_service == |
| + | |||
| + | < | ||
| + | module_service < | ||
| + | |||
| + | </ | ||
| 指定したサービスが実行中であるかどうかをチェックします。サービス名にスペースが含まれる場合は、" | 指定したサービスが実行中であるかどうかをチェックします。サービス名にスペースが含まれる場合は、" | ||
| 行 854: | 行 1150: | ||
| サービスは、Windows サービスマネージャに表示される短い名前 (サービス名) で識別されます。 | サービスは、Windows サービスマネージャに表示される短い名前 (サービス名) で識別されます。 | ||
| - | {{ : | + | [[: |
| // | // | ||
| Pandora FMS は通常、(モジュールによって定義される)一定の秒間隔にてチェックを実行します (デフォルトでは、300秒 = 5分)。そのため、チェックの直後にサービスがダウンすると、それがダウンであると認識するのに、さらに 300秒かかります。非同期モジュールでは、Pandora に " | Pandora FMS は通常、(モジュールによって定義される)一定の秒間隔にてチェックを実行します (デフォルトでは、300秒 = 5分)。そのため、チェックの直後にサービスがダウンすると、それがダウンであると認識するのに、さらに 300秒かかります。非同期モジュールでは、Pandora に " | ||
| - | |||
| < | < | ||
| + | |||
| module_async yes | module_async yes | ||
| 行 901: | 行 1197: | ||
| Unix エージェントでは、ウォッチドッグと非同期検出はできません。 | Unix エージェントでは、ウォッチドッグと非同期検出はできません。 | ||
| - | == module_proc | + | == module_proc == |
| - | 指定した名前のプロセスがいるかどうかをチェックします。プロセス名にスペースが含まれていても、" | + | < |
| + | module_proc < | ||
| + | |||
| + | </ | ||
| + | |||
| + | 指定した名前のプロセスがいるかどうかをチェックします。 | ||
| + | |||
| + | **Windows**< | ||
| 以下に cmd.exe プロセスをモニタリングする例を示します。 | 以下に cmd.exe プロセスをモニタリングする例を示します。 | ||
| 行 916: | 行 1219: | ||
| </ | </ | ||
| - | |||
| - | **Unix** | ||
| - | |||
| - | UNIX では、このモジュールは module_service のように動作します。非同期およびウォッチドッグモードはサポートしません。 | ||
| // | // | ||
| 行 968: | 行 1267: | ||
| <WRAP center round important 60%> Windows Vista 以前のバージョンでは、Pandora FMS サービスプロパティで、" | <WRAP center round important 60%> Windows Vista 以前のバージョンでは、Pandora FMS サービスプロパティで、" | ||
| - | {{ : | + | [[: |
| また、Pandora FMS は " | また、Pandora FMS は " | ||
| 行 975: | 行 1274: | ||
| 特定のプロセスの CPU 使用率を返します。 | 特定のプロセスの CPU 使用率を返します。 | ||
| - | |||
| < | < | ||
| + | |||
| | | ||
| | | ||
| 行 986: | 行 1285: | ||
| </ | </ | ||
| - | == module_memproc < | + | **Unix** |
| + | |||
| + | UNIX では、このモジュールは module_service のように動作します。非同期およびウォッチドッグモードはサポートしません。 | ||
| + | |||
| + | == module_memproc == | ||
| + | |||
| + | < | ||
| + | module_memproc < | ||
| + | |||
| + | </ | ||
| - | 特定のプロセスが利用しているメモリ量を返します。 | + | **Unixのみです。** |
| < | < | ||
| 行 1000: | 行 1308: | ||
| </ | </ | ||
| - | == module_freedisk < | + | == module_freedisk == |
| + | |||
| + | < | ||
| + | module_freedisk < | ||
| + | |||
| + | </ | ||
| このモジュールは、UNIX および Windows 双方で利用できます。ディスクの空き容量をチェックします。(Windows では **ドライブ名** のあとに ":" | このモジュールは、UNIX および Windows 双方で利用できます。ディスクの空き容量をチェックします。(Windows では **ドライブ名** のあとに ":" | ||
| 行 1022: | 行 1335: | ||
| </ | </ | ||
| - | == module_freepercentdisk < | + | == module_freepercentdisk == |
| + | |||
| + | < | ||
| + | module_freepercentdisk < | ||
| + | |||
| + | </ | ||
| このモジュールは、ディスクの空きをパーセントで返します。Windows であれば、ドライブ名: | このモジュールは、ディスクの空きをパーセントで返します。Windows であれば、ドライブ名: | ||
| 行 1044: | 行 1362: | ||
| </ | </ | ||
| - | == module_occupiedpercentdisk | + | == module_occupiedpercentdisk == |
| - | (Unix のみ) | + | < |
| + | module_occupiedpercentdisk < | ||
| + | |||
| + | </ | ||
| - | このモジュールは、/ | + | **Unix のみです。** |
| < | < | ||
| 行 1059: | 行 1380: | ||
| </ | </ | ||
| - | == module_cpuusage <cpu id> | + | == module_cpuusage == |
| + | |||
| + | < | ||
| + | module_cpuusage <cpu id|all> | ||
| + | |||
| + | </code> | ||
| このモジュールは、UNIX および Windows 双方で使えます。指定した CPU 番号の CPU 使用率を返します。CPU が 1つしかない場合は番号を指定しないか、all を指定します。 | このモジュールは、UNIX および Windows 双方で使えます。指定した CPU 番号の CPU 使用率を返します。CPU が 1つしかない場合は番号を指定しないか、all を指定します。 | ||
| 次のように、マルチ CPU 環境で全 CPU の平均使用率を得ることができます。 | 次のように、マルチ CPU 環境で全 CPU の平均使用率を得ることができます。 | ||
| - | |||
| < | < | ||
| + | |||
| | | ||
| | | ||
| 行 1116: | 行 1442: | ||
| == module_tcpcheck == | == module_tcpcheck == | ||
| - | (Windows のみ) | + | **Windows のみです。** |
| - | + | ||
| - | このモジュールは、指定された IPアドレスおよびポート番号への接続確認を行います。成功すると 1 が返り、失敗すると 0 が返ります。なお、タイムアウトを設定する必要があります。 | + | |
| < | < | ||
| 行 1133: | 行 1457: | ||
| == module_regexp == | == module_regexp == | ||
| - | (Windows のみ) | + | Windows のみです。このモジュールは、 |
| - | + | ||
| - | このモジュールは、正規表現を使ってファイル(ログ)の内容の比較を行います。モニタリングを開始した時点ですでに存在している行については無視します。モジュールが返す値はモジュールタイプにより異なります。 | + | |
| * **generic_data_string**, | * **generic_data_string**, | ||
| 行 1142: | 行 1464: | ||
| * **module_noseekeof**: | * **module_noseekeof**: | ||
| < | < | ||
| + | |||
| | | ||
| | | ||
| 行 1152: | 行 1475: | ||
| </ | </ | ||
| - | 正規表現の詳細の書式については、こちら | ||
| == module_wmiquery == | == module_wmiquery == | ||
| - | (Windows のみ) | + | Windows のみです。WMI モジュールは、外部ツールを使わずにローカルで WMI クエリを実行できます。2つのパラメータで設定します。 |
| - | + | ||
| - | WMI モジュールは、外部ツールを使わずにローカルで WMI クエリを実行できます。2つのパラメータで設定します。 | + | |
| * **module_wmiquery**: | * **module_wmiquery**: | ||
| 行 1188: | 行 1508: | ||
| == module_perfcounter == | == module_perfcounter == | ||
| - | (Win32 | + | **Windowsのみです。** |
| - | + | ||
| - | PDH インタフェースを通して、パフォーマンスカウンタ ([[http:// | + | |
| < | < | ||
| 行 1205: | 行 1523: | ||
| パフォーマンスツールから、パフォーマンスカウンターを確認できます。 | パフォーマンスツールから、パフォーマンスカウンターを確認できます。 | ||
| - | {{ : | + | [[: |
| システムツールを用いて新たなパフォーマンスカウンターを追加することができます。その構成には、要素とサブ要素を含む管理構造があります。ここでは、// | システムツールを用いて新たなパフォーマンスカウンターを追加することができます。その構成には、要素とサブ要素を含む管理構造があります。ここでは、// | ||
| - | {{ : | + | [[: |
| このように、OS のツールを使うことにより、システムパフォーマンスのさまざまな要素を取り込むことができます。この場合、モジュールの設定は次のようになります。 | このように、OS のツールを使うことにより、システムパフォーマンスのさまざまな要素を取り込むことができます。この場合、モジュールの設定は次のようになります。 | ||
| - | |||
| < | < | ||
| + | |||
| | | ||
| | | ||
| 行 1273: | 行 1591: | ||
| == module_logevent == | == module_logevent == | ||
| - | (Win32 | + | Windows |
| - | + | ||
| - | 指定されたパターンに基づいて Windows イベントログから情報を取得し、ソースおよびイベントタイプに従ってフィルタリングする機能を提供します。 | + | |
| このモジュールの一般的な書式は次の通りです。 | このモジュールの一般的な書式は次の通りです。 | ||
| 行 1333: | 行 1649: | ||
| その他例として、以下にイベントフィルタリングのスナップショットを示します。 | その他例として、以下にイベントフィルタリングのスナップショットを示します。 | ||
| - | {{ : | + | [[: |
| < | < | ||
| + | |||
| | | ||
| | | ||
| 行 1353: | 行 1669: | ||
| == module_logchannel == | == module_logchannel == | ||
| - | (Windows のみ、7.0OUM715以降) | + | <WRAP center round tip 60%> |
| Windows ログチャネルに関する情報を取得するモジュールです。// | Windows ログチャネルに関する情報を取得するモジュールです。// | ||
| 行 1401: | 行 1717: | ||
| このモジュール設定により、Pandora FMS エージェントは次のようなログを収集します。 | このモジュール設定により、Pandora FMS エージェントは次のようなログを収集します。 | ||
| - | {{ : | + | [[: |
| <WRAP center round important 60%> イベントチャネルの名前を取得するには、チャネルを右クリックして、" | <WRAP center round important 60%> イベントチャネルの名前を取得するには、チャネルを右クリックして、" | ||
| 行 1410: | 行 1726: | ||
| 次のような書式です。 | 次のような書式です。 | ||
| - | |||
| < | < | ||
| + | |||
| module_plugin plugin_filename parameter_1 parameter_2 parameter_3 | module_plugin plugin_filename parameter_1 parameter_2 parameter_3 | ||
| 行 1443: | 行 1759: | ||
| </ | </ | ||
| - | == module_ping | + | == module_ping == |
| - | (バージョン 4.0.1 以降、Windows のみ) | + | **Windows のみ。** |
| + | |||
| + | < | ||
| + | module_ping < | ||
| + | |||
| + | </ | ||
| このモジュールは、指定したホストに ping を行い、応答があれば 1、そうでなければ 0 を返します。 | このモジュールは、指定したホストに ping を行い、応答があれば 1、そうでなければ 0 を返します。 | ||
| 行 1469: | 行 1790: | ||
| == module_snmpget == | == module_snmpget == | ||
| - | (Windows のみ) | + | **Windows のみ。** |
| このモジュールは snmpget を実行し、その応答を返します。 | このモジュールは snmpget を実行し、その応答を返します。 | ||
| 行 1494: | 行 1815: | ||
| </ | </ | ||
| + | == module_wait_timeout == | ||
| + | |||
| + | **Windows のみ。** | ||
| + | < | ||
| + | module_wait_timeout X | ||
| + | |||
| + | </ | ||
| + | |||
| + | モジュールの module_exec および module_plugin 出力がチェックされる際のタイムアウト時間。デフォルトの値は 500ミリ秒です。大量の出力を生成するモジュールで実行が遅い場合は、5に変更します。それ以外の場合は使用しないことをお勧めします。 | ||
| + | |||
| ==== 自動エージェント設定 ==== | ==== 自動エージェント設定 ==== | ||
| 行 1569: | 行 1900: | ||
| スクリプトの実行結果で、標準出力の結果が 0より大きい場合にルールにマッチしたと評価されます。 | スクリプトの実行結果で、標準出力の結果が 0より大きい場合にルールにマッチしたと評価されます。 | ||
| - | ルールスクリプトでは、' | + | **Call to the rule script** |
| - | **_agent_ ** | + | |
| + | * **_agent_ | ||
| + | * **_agentalias_ : ** エージェントの別名に置き換えられます。 | ||
| + | * **_address_ :** エージェントから報告された IP アドレスに置き換えられます。 | ||
| + | * **_agentgroup_ :** エージェントから報告されたグループ名に置き換えられます。 | ||
| + | * **_agentos_ :** | ||
| + | [[: | ||
| - | エージェント名に置き換えられます。 | + | <WRAP center round tip 60%> |
| - | **_agentalias_ ** | ||
| - | |||
| - | エージェントの別名に置き換えられます。 | ||
| - | |||
| - | **_address_** | ||
| - | |||
| - | エージェントから報告された IP アドレスに置き換えられます。 | ||
| - | |||
| - | **_agentgroup_ ** | ||
| - | |||
| - | エージェントから報告されたグループ名に置き換えられます。 | ||
| - | |||
| - | **_agentos_** | ||
| - | |||
| - | エージェントの OS で置き換えられます。 | ||
| - | |||
| - | ルールの適用条件で < | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | **注意: | ||
| - | |||
| - | 全てのエージェントに対して一つの設定でよい場合は、すべての< | ||
| - | |||
| - | < | ||
| - | .* | ||
| - | |||
| - | </ | ||
| == 設定 == | == 設定 == | ||
| 行 1668: | 行 1977: | ||
| ==== Unix/Linux エージェント ==== | ==== Unix/Linux エージェント ==== | ||
| - | UNIX には、簡単にデータを収集できるいくつかのコマンドラインツールがあります。UNIX エージェントはこれをベースにしており、次の 2つの種類があります。 | ||
| - | |||
| - | * ShellScript: | ||
| - | |||
| - | * Perl: | ||
| - | |||
| - | シェルスクリプトエージェントは、古い UNIX (HPUX11.0、AIX 4.1、Solaris 2.6 など) でも動くように作られています。ただし、機能は制限されており、Tentacle クライアントがありません。サーバにモニタデータをアップロードするには、FTP もしくは SSH を利用する必要があります。 | ||
| === Pandora FMS Unix エージェントの設定 === | === Pandora FMS Unix エージェントの設定 === | ||
| 行 1680: | 行 1982: | ||
| 把握しておくべき基本的なファイルとディレクトリは次のとおりです。 | 把握しておくべき基本的なファイルとディレクトリは次のとおりです。 | ||
| - | * /// | + | * /// |
| * /// | * /// | ||
| * /// | * /// | ||
| 行 1749: | 行 2051: | ||
| - 行の終わりに ";" | - 行の終わりに ";" | ||
| - コマンドが ' ' でくくられているか確認 | - コマンドが ' ' でくくられているか確認 | ||
| - | - ' を使う場合は、次のように | + | - ' を使う場合は、次のように でエスケープしているか確認 |
| < | < | ||
| 行 1767: | 行 2069: | ||
| === Pandora FMS Windows エージェントの設定 === | === Pandora FMS Windows エージェントの設定 === | ||
| - | Windows エージェントの基本的なパスやディレクトリは、エージェントをインストールした場所になります。デフォルトでは // | + | Windows エージェントの基本的なパスやディレクトリは、エージェントをインストールした場所になります。デフォルトでは // |
| + | |||
| + | {{ : | ||
| + | |||
| + | 理解しておきたい基本的なファイルは次の通りです。 | ||
| * // | * // | ||
| 行 1777: | 行 2083: | ||
| * // | * // | ||
| * // | * // | ||
| + | ==== ソフトウエアエージェントの自動デプロイ ==== | ||
| + | |||
| + | 自動検出システムを通したデプロイの仕組みを使ってソフトウエアエージェントをデプロイすることができます。より詳細は、 [[: | ||
| + | |||
| + | |||
| ==== ソフトウエアエージェントの自動アップグレード ==== | ==== ソフトウエアエージェントの自動アップグレード ==== | ||