差分
このページの2つのバージョン間の差分を表示します。
| 両方とも前のリビジョン 前のリビジョン | |||
| ja:documentation:03_monitoring:02_operations [2024/01/15 02:27] – [プロキシモード] junichi | ja:documentation:03_monitoring:02_operations [Unknown date] (現在) – 削除 - 外部編集 (Unknown date) 127.0.0.1 | ||
|---|---|---|---|
| 行 1: | 行 1: | ||
| - | ====== ソフトウエアエージェントを使った監視 ====== | ||
| - | |||
| - | {{indexmenu_n> | ||
| - | |||
| - | [[: | ||
| - | |||
| - | ===== ソフトウエアエージェントを使った監視 ===== | ||
| - | |||
| - | The Software Agents are running on the operating systems from which they collect information, | ||
| - | |||
| - | ソフトウェアエージェントは、情報を収集するオペレーティングシステム上で実行され、**モジュール**ごとに**チェック**を実行します。 | ||
| - | |||
| - | The Software Agent' | ||
| - | |||
| - | ソフトウェアエージェント独自のディレクティブは、オペレーティングシステムから特定のデータ (CPU 使用率、メモリ、イベントなど) を直接収集するために使用され、事前定義されたスクリプトの指示に従って **オペレーティングシステム独自のコマンド** を実行します。 | ||
| - | |||
| - | The Pandora FMS Dataserver processes and stores in the database all the information generated and sent in XML files by the software agents. | ||
| - | |||
| - | Pandora FMS データサーバは、ソフトウェア エージェントによって生成され XML ファイルで送信されたすべての情報を処理し、データベースに保存します。 | ||
| - | |||
| - | ==== エージェント設定 ==== | ||
| - | |||
| - | All the configuration and parameters are stored in the pandora_agent.conf file, which is also installed locally together with your Software Agent. The basic configuration is dealt with in [[: | ||
| - | |||
| - | すべての設定とパラメータは pandora_agent.conf ファイルに保存され、このファイルはソフトウェアエージェントと一緒にローカルにインストールされます。 基本的な設定については [[: | ||
| - | |||
| - | === ローカル設定 === | ||
| - | |||
| - | ソフトウエアエージェントの設定ファイルでは、以下のテキストの基本構造でモジュールが定義されています。 | ||
| - | < | ||
| - | module_begin | ||
| - | module_name <your module name> | ||
| - | module_type generic_data | ||
| - | module_exec <your command> | ||
| - | module_description <your description> | ||
| - | module_end | ||
| - | |||
| - | </ | ||
| - | |||
| - | * '' | ||
| - | * '' | ||
| - | * '' | ||
| - | |||
| - | * '' | ||
| - | * '' | ||
| - | * '' | ||
| - | |||
| - | **例 1** | ||
| - | < | ||
| - | module_begin | ||
| - | module_name Files in var spool | ||
| - | module_type generic_data | ||
| - | module_exec ls /var/spool | wc -l | ||
| - | module_description Number of files incoming dir | ||
| - | module_end | ||
| - | |||
| - | </ | ||
| - | |||
| - | In [[: | ||
| - | |||
| - | [[: | ||
| - | |||
| - | <WRAP center round info 75%> | ||
| - | |||
| - | For the Software Agent on MS Windows® and '' | ||
| - | |||
| - | </ | ||
| - | |||
| - | <WRAP center round info 75%> | ||
| - | |||
| - | MS Windows® のソフトウェアエージェントで、'' | ||
| - | |||
| - | </ | ||
| - | |||
| - | **例 2** | ||
| - | < | ||
| - | |||
| - | module_exec vmstat 1 2 | tail -1 | awk '{ print $13 }' | ||
| - | |||
| - | </ | ||
| - | |||
| - | **vmstat** コマンドは、仮想メモリの統計をレポートします。この例では、必要な情報を " | ||
| - | < | ||
| - | |||
| - | $> vmstat 1 2 | tail -1 | awk '{ print $13 }' | ||
| - | |||
| - | </ | ||
| - | |||
| - | 結果が要件を満たしていたら、設定ファイルに追加します。ソフトウェアエージェントを介した実行によって返される値は、モジュールデータとして XML に格納されます。 | ||
| - | |||
| - | **例3** | ||
| - | |||
| - | 出力が Pandora FMS で受け入れられる値(数値、英数字、または、ブール値)をサポートしていれば、// | ||
| - | < | ||
| - | |||
| - | module_exec myScript.pl --h 127.0.0.1 -v cpu | ||
| - | |||
| - | </ | ||
| - | |||
| - | この場合も、エージェントはシェルを実行し、オペレーターによって実行されたかのように結果を取得します。 | ||
| - | |||
| - | < | ||
| - | $> myScript.pl --h 127.0.0.1 -v cpu | ||
| - | |||
| - | </ | ||
| - | |||
| - | === リモート設定 === | ||
| - | |||
| - | <WRAP center round info 60%> | ||
| - | |||
| - | To enable remote configuration, | ||
| - | |||
| - | </ | ||
| - | |||
| - | <WRAP center round info 60%> | ||
| - | |||
| - | リモート設定を有効にするには、パラメータ '' | ||
| - | |||
| - | </ | ||
| - | |||
| - | In the Enterprise version it is possible to remotely manage the files of the Software Agents from the Pandora FMS Web Console. The configuration of each agent is stored in the Pandora FMS server in two files: < | ||
| - | |||
| - | Enterprise 版では、Pandora FMS ウェブコンソールからソフトウェアエージェントのファイルをリモートで管理できます。 各エージェントの設定は、Pandora FMS サーバの < | ||
| - | |||
| - | < | ||
| - | |||
| - | / | ||
| - | |||
| - | </ | ||
| - | |||
| - | and | ||
| - | |||
| - | および | ||
| - | |||
| - | < | ||
| - | / | ||
| - | |||
| - | </ | ||
| - | |||
| - | |||
| - | <WRAP center round tip 75%> | ||
| - | |||
| - | Once remote agent configuration is enabled, any changes made locally to the configuration file will be overwritten by the configuration stored in the console. To return to local administration of the Software Agent, stop its service, reset '' | ||
| - | |||
| - | </ | ||
| - | |||
| - | <WRAP center round tip 75%> | ||
| - | |||
| - | エージェントのリモート設定を有効にしたあとは、ローカルの設定ファイルを変更してもコンソールに保存されている設定で上書きされます。これをソフトウェアエージェントのローカル管理に戻したい場合は、ソフトウエアエージェントのサービスを停止し、'' | ||
| - | |||
| - | </ | ||
| - | |||
| - | === カスタムフィールド === | ||
| - | |||
| - | Custom fields allow you to add additional information to the agent. Custom fields can be created with the PFMS 1.0 API and the command [[: | ||
| - | |||
| - | カスタムフィールドを使用すると、エージェントに追加情報を追加できます。 カスタムフィールドは、PFMS 1.0 API とコマンド [[: | ||
| - | |||
| - | * The options **Enabled combo**, **Password type** | ||
| - | * By activating the **Display up front** | ||
| - | * **Enabled combo**: This parameter allows you to activate the configuration of selectable parameters from a drop-down menu. Once activated, a new field will appear in the configuration window of the corresponding **custom field** | ||
| - | * **Password type**: The value of the field (password) will be shown using asterisks in the Web Console. | ||
| - | * **Link type**: It allows you to add a custom field that will host a web link to be filled in by the Web Console or in a [[: | ||
| - | |||
| - | * オプション **選択肢の有効化(Enabled combo)**、**パスワードタイプ(Password type)**、**リンクタイプ(Link type)** は相互に排他的です。つまり、いずれか 1 つだけを使用できます (または、デフォルト値のなし)。 | ||
| - | * **前面に表示(Display up front)** フィールドを有効にすると、値が設定されている場合、カスタムフィールドの情報がエージェントの概要に表示されます。 さらに、カスタムフィールド情報を **コマンドセンター** (メタコンソール) に送信するには、このトークンを有効にする必要があります。 | ||
| - | * **選択肢の有効化(Enabled combo)**: このパラメーターを使用すると、ドロップダウンリストからのパラメータ選択を有効化できます。 有効化した場合、対応するカスタムフィールドの構成ウィンドウに新しいフィールドが表示され、カンマで区切で値を入力します。 | ||
| - | * **パスワードタイプ(Password type)**: ウェブコンソールでは、フィールド (パスワード) の値がアスタリスクを使用して表示されます。 | ||
| - | * **リンクタイプ(Link type)**: ウェブコンソールまたは [[: | ||
| - | |||
| - | < | ||
| - | |||
| - | ["Web name"," | ||
| - | |||
| - | </ | ||
| - | |||
| - | The XML would have this syntax: | ||
| - | |||
| - | XML は次のような書式になります。 | ||
| - | |||
| - | <code xml> | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | </ | ||
| - | |||
| - | |||
| - | </ | ||
| - | |||
| - | See " | ||
| - | |||
| - | [[: | ||
| - | |||
| - | Custom fields can also be passed from the agent configuration file, using the tokens [[: | ||
| - | |||
| - | カスタムフィールドは、[[: | ||
| - | 例: | ||
| - | |||
| - | < | ||
| - | |||
| - | custom_field1_name Serial Number | ||
| - | custom_field1_value 56446456KS7000 | ||
| - | |||
| - | </ | ||
| - | |||
| - | The custom field called '' | ||
| - | |||
| - | '' | ||
| - | |||
| - | < | ||
| - | custom_field11_name Simple custom field name | ||
| - | custom_field11_value Simple custom field value | ||
| - | |||
| - | custom_field12_name Custom field Link type | ||
| - | custom_field12_value [" | ||
| - | |||
| - | custom_field13_name Custom field Password type | ||
| - | custom_field13_value My; | ||
| - | |||
| - | custom_field14_name Custom field Combo type | ||
| - | custom_field14_value Two | ||
| - | |||
| - | </ | ||
| - | |||
| - | In the custom fields '' | ||
| - | |||
| - | カスタムフィールド '' | ||
| - | |||
| - | === 共通設定パラメータ === | ||
| - | |||
| - | Most important parameters for the basic configuration of [[: | ||
| - | |||
| - | 基本的なエージェント設定における、最も重要なパラメータ (より詳細は、[[: | ||
| - | |||
| - | * **server_ip**: | ||
| - | * **server_path**: | ||
| - | * **temporary**: | ||
| - | * **logfile**: | ||
| - | * **interval**: | ||
| - | |||
| - | * **server_ip**: | ||
| - | * **server_path**: | ||
| - | * **temporal**: | ||
| - | * **logfile**: | ||
| - | * **interval**: | ||
| - | |||
| - | === パスワード保護グループ === | ||
| - | |||
| - | By default, when an agent sends data for the first time to the Pandora FMS server, it is automatically added to the group that has been defined in the agent' | ||
| - | |||
| - | デフォルトでは、エージェントが初めて Pandora FMS サーバにデータを送信すると、そのデータはエージェント設定ファイルで定義されているグループに自動的に追加されます。 | ||
| - | |||
| - | is possibleIt is possible to set a password for a group, so an agent will not be added to a group unless the correct password is specified in the agent' | ||
| - | |||
| - | オプションで、Pandora FMS コンソールからグループのパスワードを設定できます。この場合、エージェント設定ファイルで正しいパスワードが指定されていない限り、エージェントはグループに追加されません。 | ||
| - | |||
| - | To edit and add a group password go to **Management** menu → **Profiles** → **Manage agent groups** → click on group name. | ||
| - | |||
| - | グループパスワードを編集して追加するには、**管理(Management)** メニュー → **プロファイル(Profiles)** → **エージェントグループ管理(Manage agent groups)** に移動し、グループ名をクリックします。 | ||
| - | |||
| - | To add a new agent to this group, edit its configuration file and add the following configuration option '' | ||
| - | |||
| - | このグループに新しいエージェントを追加するには、その設定ファイルを編集し、設定オプション '' | ||
| - | |||
| - | ==== エージェントおよびソフトウエアエージェントのモジュール ==== | ||
| - | |||
| - | === モジュールの種類 === | ||
| - | |||
| - | データのタイプに応じた、ソフトウエアエージェントのモジュールのタイプは次の通りです。 | ||
| - | |||
| - | * **generic_data**: | ||
| - | * **generic_data_inc**: | ||
| - | * **generic_data_inc_abs**: | ||
| - | * **generic_proc**: | ||
| - | * **generic_data_string**: | ||
| - | * **async_data**: | ||
| - | * **async_string**: | ||
| - | * **async_proc**: | ||
| - | * **Image module**: テキスト文字列型モジュール(generic_data_string または async_string)をもとにしたものです。モジュール内のデータが base64 イメージの場合、つまり文字列の一部に " | ||
| - | |||
| - | === ローカルモジュールの実行間隔 === | ||
| - | |||
| - | ローカルモジュール(ソフトウエアエージェントのモジュール)には、ベースとしてエージェントの実行間隔があります。ただし、module_interval パラメータにゼロより大きい整数を設定することによって、エージェントの実行間隔にそれを乗じた値をモジュールの実行間隔とすることができます。例: | ||
| - | |||
| - | < | ||
| - | module_interval 2 | ||
| - | |||
| - | </ | ||
| - | |||
| - | この場合、エージェントの実行間隔が 300 のとき、モジュールの実行間隔は 300×2 (600) になります。 | ||
| - | |||
| - | === モジュール作成インタフェース === | ||
| - | |||
| - | <WRAP center round tip 60%> | ||
| - | |||
| - | {{: | ||
| - | |||
| - | </ | ||
| - | |||
| - | <WRAP center round tip 60%> | ||
| - | |||
| - | {{: | ||
| - | |||
| - | </ | ||
| - | |||
| - | The creation of local modules in the console is done through a form where, in addition to the common configuration of all modules (thresholds, | ||
| - | |||
| - | コンソールからのローカルモジュールの作成は、リモートモジュール(の閾値、タイプ、グループなど)と同様に、フォームを利用して行います。設定データを指定するテキストボックスがあり、ソフトウエアエージェントの設定ファイルが表示されています。 | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | * When clicking on the **Load basic (template)** button, the content of Data configuration will be deleted with a basic template that we must modify according to the need for monitoring. | ||
| - | * Once modified, clicking **Check (syntax)** will verify that the template syntax is still correct, however the rest of the commands will not be checked. | ||
| - | |||
| - | * **基本(テンプレート)のロード(Load basic (template)** | ||
| - | * 変更後、**チェック(構文)(Check (syntax))** | ||
| - | |||
| - | When a module is loaded from a local component, it can have macros. If you have macros, the configuration box will be hidden and a field will appear for each macro, see more information in [[: | ||
| - | |||
| - | モジュールがローカルコンポーネントからロードされる場合、マクロが含まれる場合があります。 マクロがある場合、設定ボックスは非表示のままになり、マクロごとにフィールドが表示されます。詳細については、[[: | ||
| - | |||
| - | ==== 状態にもとづくモニタリング ==== | ||
| - | |||
| - | === 事後処理 === | ||
| - | |||
| - | Pandora FMS ソフトウエアエージェントは、モジュールの実行結果の値に応じたスクリプトの実行をサポートしています。これは、モジュールの実行で得られた値に応じてアクションを行えることを意味します。 | ||
| - | |||
| - | **例 1** | ||
| - | |||
| - | 値または値の範囲を示す // | ||
| - | |||
| - | // | ||
| - | < | ||
| - | |||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | **例 2** | ||
| - | |||
| - | 同じモジュールに対して、範囲内や最小しきい値を指定した複数の条件を指定できます(数学的には、両方のオプションのいずれかが実行されるか、まったく実行されません)。 | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | **例 3** | ||
| - | |||
| - | 前の例に似ていますが、両方の条件を実行することも、1つまたはまったく実行しないこともできます(選択した値で試してください: | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | </ | ||
| - | |||
| - | === 事前処理 === | ||
| - | |||
| - | **module_precondition** | ||
| - | |||
| - | <WRAP center round tip 60%> module_precondition に想定する値を割り当て、条件と比較する必要があります。 </ | ||
| - | |||
| - | **例 1** | ||
| - | |||
| - | アクティブなプロセスが 10 を超える場合、CPU 使用率のパーセンテージを取得し、Pandora FMS サーバにレポートします。 | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | **例 2** | ||
| - | |||
| - | 同じモジュールに対して複数の前提条件を定義でき、それらすべてが満たされている必要があります。 | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | この場合、アクティブなプロセスが 10 を超えており、そのうちの少なくとも 1つが重要なプロセスである場合にのみモジュールが実行されます。 | ||
| - | |||
| - | ==== 高頻度モニタリング ==== | ||
| - | |||
| - | 重要な実行プロセスやサービスなど、特に重要なモジュールが存在する場合があります。 これらのケース向けに、より制御された監視を可能にする集中監視が利用できます。 | ||
| - | |||
| - | エージェントの通常の実行間隔を短くすることなく、問題が発生した場合にのみ短い間隔で監視をします。 | ||
| - | |||
| - | ソフトウエアエージェントの設定: | ||
| - | |||
| - | * **Interval**: | ||
| - | * **Intensive_interval**: | ||
| - | モジュール設定: | ||
| - | |||
| - | * **module_intensive_condition = 0**: モジュールの値がこのパラメータで指定した値(この場合 0)の場合、エージェントで定義された高頻度の間隔で監視します。 | ||
| - | |||
| - | === 例 === | ||
| - | |||
| - | **sshd** | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | サービスがダウンすると、次の 10秒で再度チェックされます。サービスが起動していれば、次のチェックは通常通り 5分後です。 | ||
| - | |||
| - | ==== 指定時間モニタリング ==== | ||
| - | |||
| - | ソフトウエアエージェントは、モジュールを指定時間に実行する設定ができます。書式は crontab と同じです。モジュールの設定例は次の通りです。以下は、モジュールを毎月曜の 12 から 15時の間に実行する例です。 | ||
| - | < | ||
| - | |||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | モジュールを毎時 10分に実行したい場合は、次のようにします。 | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | <WRAP center round tip 60%> モジュールがデータを出力しない期間を設定した場合、モジュールは " | ||
| - | |||
| - | ===== ソフトウエアエージェントでのリモートチェック ===== | ||
| - | |||
| - | Pandora FMS サーバが(セキュリティ上の理由などから)直接アクセスできないシステムに対してリモートチェックを行う場合に使用します。ソフトウェアエージェントをインストールし、そこからリモートチェックを実行し、ブローカエージェントで配布することができます。 | ||
| - | |||
| - | ==== ICMP チェック ==== | ||
| - | |||
| - | ICMP もしくは ping の監視は、マシンがネットワークにつながっているかどうかを確認するのに便利です。単一のソフトウェアエージェントがすべてのマシンのステータスを簡単に監視できます。 | ||
| - | |||
| - | **Unix** | ||
| - | |||
| - | Using the system commands (all parameters in the " | ||
| - | |||
| - | システムコマンドを利用して ping チェックを実行するモジュールを作成することができます。 (すべてのパラメータは '' | ||
| - | |||
| - | < | ||
| - | module_begin | ||
| - | module_name Ping | ||
| - | module_type generic_proc | ||
| - | module_exec ping -c 1 192.168.100.54>/ | ||
| - | module_end | ||
| - | |||
| - | </ | ||
| - | |||
| - | このモジュールの例では、192.168.100.54 宛の ping チェックを実行します。他のホストをチェックしたければ、IP アドレスを変更するだけです。 | ||
| - | |||
| - | **Windows** | ||
| - | |||
| - | The parameters must be specified in '' | ||
| - | |||
| - | パラメータは、'' | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | Note: '' | ||
| - | |||
| - | 注意: '' | ||
| - | |||
| - | ==== TCP チェック ==== | ||
| - | |||
| - | TCP チェックは、ホストのポートが開いているかを確認するのに便利です。アプリケーションがネットワーク上で応答するかどうかを確認することができます。 | ||
| - | |||
| - | **Unix** | ||
| - | |||
| - | Unix のソフトウエアエージェントでは、次のようなモジュール設定にて TCP チェックを実行します。 | ||
| - | |||
| - | < | ||
| - | module_begin | ||
| - | module_name PortOpen | ||
| - | module_type generic_proc | ||
| - | module_exec nmap 192.168.100.54 -p 80 | grep open> /dev/null 2>& | ||
| - | module_timeout 5 | ||
| - | module_end | ||
| - | |||
| - | </ | ||
| - | |||
| - | このモジュールでは、ホスト 192.168.100.54 の 80番ポートが開いているかどうかをチェックします。 | ||
| - | |||
| - | **Windows** | ||
| - | |||
| - | Windows のソフトウエアエージェントを使っている場合は、TCP チェックを設定するためのパラメータがあります。パラメータは次の通りです。 | ||
| - | |||
| - | * module_tcpcheck: | ||
| - | * module_port: | ||
| - | * module_timeout: | ||
| - | |||
| - | モジュールの設定例を以下に示します。 | ||
| - | < | ||
| - | |||
| - | module_begin | ||
| - | module_name TcpCheck | ||
| - | module_type generic_proc | ||
| - | module_tcpcheck 192.168.100.54 | ||
| - | module_port 80 | ||
| - | module_timeout 5 | ||
| - | module_end | ||
| - | |||
| - | </ | ||
| - | |||
| - | このモジュールも同様に、192.168.100.54 の 80番ポートに対してチェックを行います。 | ||
| - | |||
| - | ==== SNMP チェック ==== | ||
| - | |||
| - | SNMP チェックは、一般的にネットワークデバイスのインタフェースのステータス、送受信トラフィックなどをチェックするのに利用します。 | ||
| - | |||
| - | **Unix** | ||
| - | |||
| - | Unix のソフトウエアエージェントを利用している場合は、次のように snmpget コマンドを使ったモジュールを作成します。 | ||
| - | |||
| - | < | ||
| - | module_begin | ||
| - | module_name SNMP get | ||
| - | module_type generic_data | ||
| - | module_exec snmpget 192.168.100.54 -v 1 -c public .1.3.6.1.2.1.2.2.1.1.148 | awk ' | ||
| - | module_end | ||
| - | |||
| - | </ | ||
| - | |||
| - | このモジュールは、ホスト 192.168.100.54 の OID .1.3.6.1.2.1.2.2.1.1.148 の値を返します。 | ||
| - | |||
| - | **Windows** | ||
| - | |||
| - | Windows のソフトウエアエージェントでは、モジュールを設定するための次のパラメータがあります。 | ||
| - | |||
| - | * module_snmpversion [1,2c,3]: SNMP version (Default value is ' | ||
| - | * module_snmp_community < | ||
| - | * module_snmp_agent < | ||
| - | * module_snmp_oid < | ||
| - | * [[: | ||
| - | |||
| - | * module_snmpversion [1,2c,3]: SNMP バージョン (デフォルトは 1) | ||
| - | * module_snmp_community < | ||
| - | * module_snmp_agent < | ||
| - | * module_snmp_oid < | ||
| - | * [[: | ||
| - | |||
| - | モジュールの設定例を以下に示します。 | ||
| - | < | ||
| - | |||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | このモジュールは、Unix のソフトウエアエージェントと同じ動作をします。 | ||
| - | |||
| - | ===== プロキシモード ===== | ||
| - | |||
| - | <WRAP center round important 60%> Linux/Unix システムで、エージェントのプロキシモードを利用するためには、**エージェントを root 以外のユーザで実行** する必要があります。そのため、Pandora FMS エージェントのカスタムインストールが必要です。カスタムインストールの詳細については、[[: | ||
| - | |||
| - | Pandora FMS ソフトウエアエージェントには、エージェントから Pandora FMS サーバへの通信をプロキシするする、プロキシモードがあります。プロキシモードを有効にしたソフトウエアエージェントは、モニタリング処理も実行可能です。 | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | プロキシモードは、1台のマシンのみ Pandora FMS サーバと通信できないといったネットワークの場合にとても便利です。この場合、すべてのマシンにインストールされたソフトウエアエージェントは直接 Pandora FMS サーバへは通信できず、XML ファイルをプロキシとして動作しているエージェントに送ります。プロキシはそれを Pandora FMS サーバへ送信します。 | ||
| - | |||
| - | プロキシモードでは、XML ファイル送信をプロキシすることに加えて、// | ||
| - | |||
| - | これらの機能により、プロキシモードは接続が制限されたネットワークでのソフトウエアエージェントの「透過的な操作」を提供します。 | ||
| - | |||
| - | プロキシモードを有効にするには、ソフトウエアエージェントにて次のパラメータを設定します。 | ||
| - | |||
| - | * **server_ip**: | ||
| - | * **proxy_mode**: | ||
| - | * **proxy_max_connection**: | ||
| - | * **proxy_timeout**: | ||
| - | * **proxy_address**: | ||
| - | * **proxy_port**: | ||
| - | |||
| - | * server_ip: Pandora FMS サーバの IP アドレスです。 | ||
| - | * proxy_mode: 有効(1) または 無効(0)。 | ||
| - | * proxy_max_connection: | ||
| - | * proxy_timeout: | ||
| - | * proxy_address: | ||
| - | * proxy_port: プロキシのポート番号です。 | ||
| - | |||
| - | 設定例を以下に示します。 | ||
| - | < | ||
| - | |||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | ソフトウエアエージェントの接続を中継するには、ソフトウエアエージェントの設定で接続先の Pandora FMS サーバのアドレスとしてプロキシモードのエージェントのアドレスを指定します。例えば次の通りです。 | ||
| - | |||
| - | プロキシモードが有効なエージェントの IP アドレスが、192.168.100.24 とします。 | ||
| - | |||
| - | 直接 Pandora FMS サーバへ接続できないソフトウエアエージェントでは、**server_ip** | ||
| - | |||
| - | < | ||
| - | server_ip 192.168.100.24 | ||
| - | |||
| - | </ | ||
| - | |||
| - | この設定により、Pandora FMS サーバと直接通信ができないソフトウエアエージェントが、プロキシモードの他のソフトウエアエージェントを経由して通信できるようになります。リモート設定、ポリシー、ファイルコレクションといったすべての機能が利用できます。 | ||
| - | |||
| - | ===== ブローカーモード ===== | ||
| - | |||
| - | ソフトウエアエージェントには、複数のソフトウエアエージェントがインストールされているかのように一つのエージェントを設定し、モニターするブローカーモードがあります。 | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | ブローカーモードを有効にしたソフトウエアエージェントは、新たな設定ファイルを生成します。同一のマシンで複数のソフトウエアエージェントを動かすのと同じように、オリジナルのソフトウエアエージェントと新たなブローカーがそれぞれの設定ファイルで動作します。 | ||
| - | |||
| - | ブローカーモードのメインの機能は次の通りです。 | ||
| - | |||
| - | * ローカルのデータを他のエージェントとして送信します。異なるソフトウエアの状態を異なるエージェントとしてモニタリングするのに便利です。 | ||
| - | * リモートチェックを行ったデータを、ソフトウエアエージェントがインストールされているマシンから送られたかのように送信します。 | ||
| - | |||
| - | ブローカーを設定するには、**broker_agent < | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | ブローカーを設定したら、オリジナルのソフトウエアエージェントの設定と同じような内容で、エージェント名の設定が異なる // | ||
| - | |||
| - | Pandora FMS ウェブコンソールで、**プローカーが表示され、他のエージェントと同じように管理できます** 。2つのブローカーでソフトウエアエージェントをインストールしていれば、ウェブコンソールでは、異なる 3つのエージェントでそれぞれのモジュールや設定が参照できることを意味します。 | ||
| - | |||
| - | **注意**: ブローカーエージェントインスタンスは、ファイルコレクションを利用できません。コレクションを利用したい場合は、インスタンスのコレクションからファイルの " | ||
| - | |||
| - | <WRAP center round important 60%> ブローカーエージェントが有効な場合、実行中にメモリ内にデータを保持しているモジュール (module_logevent と MS Windows® における module_regexp) は動作しません。 </ | ||
| - | |||
| - | ==== 利用例 ==== | ||
| - | |||
| - | === 異なるエージェントとしてのローカルデータベースのモニタリング === | ||
| - | |||
| - | マシンの基本的な情報(CPU、メモリ、ディスク)および、インストールされているデータベースの情報を分けてモニタリングしたいとします。 | ||
| - | |||
| - | このモニタリングを行うには次のような手段をとります。 | ||
| - | |||
| - | * インストールしたソフトウエアエージェント: | ||
| - | * データベース用のブローカー: | ||
| - | |||
| - | これを行うには、ソフトウエアエージェントを CPU、メモリ、ディスクをモニタするマシンにインストールします。ソフトウエアエージェントの設定で次の行を追加します。 | ||
| - | |||
| - | < | ||
| - | broker_agent DBApp | ||
| - | |||
| - | </ | ||
| - | |||
| - | この設定を追加することにより、DBApp というブローカーエージェントを作成します。それにより、dbapp.conf という設定ファイルができます。この設定ファイルには、データベースの状態をチェックするモジュールを追加します。 | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | これにより、Pandora ウェブコンソールに 2つのエージェントが現れます。一つはマシン名で CPU、メモリ、ディスクのモジュールがあり、もう一つは、DBApp という名前で Num Users および Num slow queries というモジュールがあります。 | ||
| - | |||
| - | === ブローカーを使ったリモートデバイスのモニタリング === | ||
| - | |||
| - | この例では、Windows マシンにソフトウエアエージェントをインストールし、(CPU、メモリ、ディスクを)モニタリングしています。また、エージェントのインストールなしに 192.168.100.54 の IP を持ったルータをモニタリングしたいとします。この問題を解決するためにブローカーを利用できます。 | ||
| - | |||
| - | 次の設定で、ブローカーを作成します。 | ||
| - | |||
| - | < | ||
| - | broker_agent routerFloor5 | ||
| - | |||
| - | </ | ||
| - | |||
| - | これにより、routerFloor5 という名のブローカーエージェントを作成します。ソフトウエアエージェントが Windows マシンにインストールされているので、Windows のソフトウエアエージェントの機能で ping および snmp でルータをモニタできます。それには、routerFloor5.conf ファイルに次の設定を行います。 | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | この例では、Pandora FMS のウェブコンソールには 2つのエージェントが表示されます。一つは CPU、メモリ、ディスクのモジュールを持った Windows マシン、もう一つは、Ping、Eth 1 up、Eth 2 up というモジュールを持った // | ||
| - | |||
| - | === 直接通信できないネットワークのリモートモニタリング === | ||
| - | |||
| - | デバイスをリモートからモニタする必要があるが、Pandora FMS のリモートサーバがそれらに直接通信できない場合があります。 | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | この例では、本社からある会社のサイトのデバイスをリモートからモニタする必要があるとします。Pandora FMS サーバは本社にあり、他の会社のサイトに VPN で接続しています。何らかの制限により Pandora のリモートサーバはリモートでアクセスできません。会社のサイトをモニタリングするには、ブローカーモードを使います。ソフトウエアエージェントは、異なるデバイスとして Pandora サーバに XML を送信できます。 | ||
| - | |||
| - | ソフトウエアエージェントの設定ファイルでは、モニタするデバイスの数だけブローカーを追加します。設定例は次の通りです。 | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | ... | ||
| - | |||
| - | </ | ||
| - | |||
| - | ブローカーが作成されると、それぞれのデバイスのモニタリングをそれぞれのブローカーの設定ファイルで設定できます。例えば、Windows マシンで、device_1 の設定は次の通りです。 | ||
| - | |||
| - | < | ||
| - | module_begin | ||
| - | module_name Ping | ||
| - | module_type generic_proc | ||
| - | module_ping 192.168.100.54 | ||
| - | module_ping_count 2 | ||
| - | module_ping_timeout 500 | ||
| - | module_end | ||
| - | |||
| - | module_begin | ||
| - | module_name CPU_Load | ||
| - | module_type generic_data | ||
| - | module_wmiquery SELECT LoadPercentage FROM Win32_Processor | ||
| - | module_wmicolumn LoadPercentage | ||
| - | module_end | ||
| - | |||
| - | module_begin | ||
| - | module_name Mem_Free | ||
| - | module_type generic_data | ||
| - | module_wmiquery SELECT LoadPercentage FROM Win32_Memory | ||
| - | module_wmicolumn FreeMemory | ||
| - | module_end | ||
| - | |||
| - | module_begin | ||
| - | module_name Disk_Free | ||
| - | module_type generic_data | ||
| - | module_wmiquery SELECT LoadPercentage FROM Win32_Disk | ||
| - | module_wmicolumn FreeSpace | ||
| - | module_end | ||
| - | |||
| - | </ | ||
| - | |||
| - | この設定で、異なる会社のサイト間で通信に制限があったとしても、リモート設定機能を利用でき、また、モニタした情報を Pandora FMS サーバへ送信することができます。 | ||
| - | |||
| - | === ブローカーを使ったモニタリング負荷分散 === | ||
| - | |||
| - | ブローカーモードは、複数のネットワークでモニタリングの負荷を分散するのにとても便利です。 | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | この例では、A から Z の複数のネットワークがあり、それぞれ 1000のデバイスがあります。Pandora FMS のリモートサーバの許容量は、役 2000エージェントです。そのため、負荷分散のためにブローカーモードでソフトウエアエージェントを利用することにします。ブローカーモードを有効にしたソフトウエアエージェントは、リモートでネットワークから全てのデバイスをモニタし、データを XML で Pandora FMS の中央サーバへ送ります。 | ||
| - | |||
| - | それぞれのネットワークに、ブローカーモードを有効にしたエージェントがあります。モニタするデバイスの分だけブローカーを作成します。ソフトウエアエージェントの // | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | ... | ||
| - | |||
| - | </ | ||
| - | |||
| - | さらに、それぞれのブローカーには、モニタするデバイスのモジュールを追加します。例えば、ブローカー // | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | 他の例として、ブローカー // | ||
| - | |||
| - | < | ||
| - | module_begin | ||
| - | module_name Ping | ||
| - | module_type generic_proc | ||
| - | module_ping 192.168.100.54 | ||
| - | module_ping_count 2 | ||
| - | module_ping_timeout 500 | ||
| - | module_end | ||
| - | |||
| - | module_begin | ||
| - | module_name CPU_Load | ||
| - | module_type generic_data | ||
| - | module_wmiquery SELECT LoadPercentage FROM Win32_Processor | ||
| - | module_wmicolumn LoadPercentage | ||
| - | module_end | ||
| - | |||
| - | module_begin | ||
| - | module_name Mem_Free | ||
| - | module_type generic_data | ||
| - | module_wmiquery SELECT LoadPercentage FROM Win32_Memory | ||
| - | module_wmicolumn FreeMemory | ||
| - | module_end | ||
| - | |||
| - | module_begin | ||
| - | module_name Disk_Free | ||
| - | module_type generic_data | ||
| - | module_wmiquery SELECT LoadPercentage FROM Win32_Disk | ||
| - | module_wmicolumn FreeSpace | ||
| - | module_end | ||
| - | |||
| - | </ | ||
| - | |||
| - | ソフトウエアエージェントをブローカーモードを有効にして使うことで、数千のデバイスからのデータを簡単に負荷分散して収集することができます。 | ||
| - | |||
| - | ===== ソフトウエアエージェントを使ったインベントリ ===== | ||
| - | |||
| - | Pandora FMS ソフトウエアエージェントは、ハードウエアおよびソフトウエアのインベントリの機能をサポートします。インベントリシステムは、企業のサーバで使われている CPU、拡張カード、メモリ、パッチ、ソフトウエアなどの情報を取得することができます。また、インベントリに変化が発生したときにアラートを上げることもできます。例えば、ディスクを交換したり、アプリケーションが削除されたときです。 | ||
| - | |||
| - | より詳細の情報は、[[: | ||
| - | |||
| - | ===== ソフトウエアエージェントを使ったログ収集 ===== | ||
| - | |||
| - | For more information visit the topic [[: | ||
| - | |||
| - | 詳細に関しては、[[: | ||
| - | |||
| - | |||
| - | ===== UDP リモートコマンド ===== | ||
| - | |||
| - | ソフトウェアエージェントは、リモートリクエストを受信して処理を実行することができます。 | ||
| - | |||
| - | <WRAP center round important 60%> UDP は本質的に安全ではないことに注意してください(ただし、応答を損なうことなくメッセージを送信するには効率的です)。 </ | ||
| - | |||
| - | Pandora FMS サーバが担当するソフトウェアエージェントに要求を送信できるようにするには、以下を設定します。 | ||
| - | |||
| - | * **udp_server**: | ||
| - | * **udp_server_port**: | ||
| - | * **udp_server_auth_address**: | ||
| - | 変更を適用するためにソフトウエアエージェントを再起動します。 | ||
| - | |||
| - | <WRAP center round important 75%> どこからでも要求を受け入れるために // | ||
| - | |||
| - | ==== ソフトウエアエージェントへのサービス再起動要求の送信方法 ==== | ||
| - | |||
| - | You must use the script located at: | ||
| - | |||
| - | 以下のスクリプトを利用する必要があります。 | ||
| - | |||
| - | < | ||
| - | |||
| - | / | ||
| - | |||
| - | </ | ||
| - | |||
| - | It can be executed from the command line or used in an alert, through the command that comes [[: | ||
| - | |||
| - | コマンドラインやから実行したり、コンソールの [[: | ||
| - | |||
| - | {{ : | ||
| - | ==== カスタムリモートアクション ==== | ||
| - | |||
| - | In addition to the Software Agent service restart action, custom actions can be specified. | ||
| - | |||
| - | ソフトウェアエージェントサービスの再起動アクションに加えて、カスタムアクションを指定できます。 | ||
| - | |||
| - | < | ||
| - | |||
| - | process_< | ||
| - | |||
| - | </ | ||
| - | |||
| - | 例えば、リモートから sshd サービスを起動したい場合は次のようにします。 | ||
| - | |||
| - | < | ||
| - | |||
| - | process_sshd_start / | ||
| - | |||
| - | </ | ||
| - | |||
| - | <WRAP center round tip 60%> | ||
| - | |||
| - | You can also create commands that call scripts to perform multiple remote actions with the click of a button. | ||
| - | |||
| - | </ | ||
| - | |||
| - | <WRAP center round tip 60%> | ||
| - | |||
| - | ボタンをクリックするだけで複数のリモートアクションを実行するスクリプトを呼び出すコマンドを作成することもできます。 | ||
| - | |||
| - | </ | ||
| - | ===== ソフトウエアエージェントでのプラグインの利用 ===== | ||
| - | |||
| - | プラグインは、ソフトウェアエージェントから複雑で高度なチェックを実行することができるものです。単一の値だけではなく、複数のモジュールを返すことができます。 Pandora FMS サーバによって実行されるサーバプラグインとは異なり、エージェントプラグインはXMLでデータを返し、同時に1つまたは複数のモジュールのデータを返します。 | ||
| - | |||
| - | ==== Windows システムでの実行 ==== | ||
| - | |||
| - | Windows では、デフォルトの全プラグインは、VBScript でプログラムされています。これらを実行するには、フルパスで適切なインタプリタを使用する必要があります。 | ||
| - | |||
| - | 以下に、Windows エージェントにデフォルトで含まれているプラグインのいくつかの使い方を示します。 | ||
| - | |||
| - | < | ||
| - | module_plugin cscript.exe //B " | ||
| - | module_plugin cscript.exe //B " | ||
| - | module_plugin cscript.exe //B " | ||
| - | </ | ||
| - | |||
| - | Windows エージェントでは、さまざまなプラグインを使用できます。 | ||
| - | |||
| - | ==== Unix システムでの実行 ==== | ||
| - | |||
| - | Unix プラグインは、デフォルトでエージェントのディレクトリの "/ | ||
| - | |||
| - | いくつかのプラグイン利用例を以下に示します。 | ||
| - | |||
| - | < | ||
| - | module_plugin grep_log / | ||
| - | module_plugin pandora_df tmpfs /dev/sda1 | ||
| - | |||
| - | </ | ||
| - | |||
| - | Unix ソフトウエアエージェントには、デフォルトでいくつかのプラグインが含まれています。 | ||
| - | |||
| - | ==== コンソールからのエージェントプラグインの管理 ==== | ||
| - | |||
| - | <WRAP center round info 90%> | ||
| - | |||
| - | {{: | ||
| - | |||
| - | </ | ||
| - | |||
| - | <WRAP center round info 90%> | ||
| - | |||
| - | {{: | ||
| - | |||
| - | </ | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | === 例 1 === | ||
| - | |||
| - | ソフトウエアエージェントのプラグインは、一つのデータもしくはグループ化したデータを返すことができます。Windows で一つのデータを返す // | ||
| - | |||
| - | < | ||
| - | module_plugin cscript.exe //B " | ||
| - | |||
| - | </ | ||
| - | |||
| - | プロセスがダウンしている場合は 0 を返し、プロセスがいる場合は 1 を返すモジュールです。 | ||
| - | |||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | </ | ||
| - | |||
| - | </ | ||
| - | |||
| - | === 例 2 === | ||
| - | |||
| - | 次に Windows で複数のデータを返す // | ||
| - | |||
| - | < | ||
| - | module_plugin cscript.exe //B " | ||
| - | |||
| - | </ | ||
| - | |||
| - | プラグインは見つけたモジュールごとにモジュールを返します。出力結果は次の通りです。 | ||
| - | |||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | </ | ||
| - | |||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | </ | ||
| - | </ | ||
| - | |||
| - | ==== コンソールからの高度なエージェントプラグイン管理 ==== | ||
| - | |||
| - | <WRAP center round tip 60%> | ||
| - | |||
| - | Version NG 750 or later. | ||
| - | |||
| - | </ | ||
| - | |||
| - | <WRAP center round tip 60%> | ||
| - | |||
| - | バージョン NG 750 以上 | ||
| - | |||
| - | </ | ||
| - | |||
| - | It is possible to add a token in the agent plugins configuration that when enabled allows the option to ' | ||
| - | |||
| - | '' | ||
| - | |||
| - | This enabled token allows you to insert configuration blocks such as '' | ||
| - | |||
| - | '' | ||
| - | |||
| - | ==== 独自エージェントプラグインの作成方法 ==== | ||
| - | |||
| - | Plugins can be created in any programming language. Just bear in mind the [[: | ||
| - | |||
| - | プラグインは、任意のプログラミング言語で作成することができます。[[: | ||
| - | |||
| - | <WRAP center round important 60%> | ||
| - | |||
| - | Make sure you finish the output of your plugin (if it is a script) with an '' | ||
| - | |||
| - | </ | ||
| - | |||
| - | <WRAP center round important 60%> | ||
| - | |||
| - | カスタムプラグインの終了コードは 0 になるようにしてください。そうでないと、Pandora FMS エージェントはプラグインでエラーが発生したものと認識し、出力を無視します。 | ||
| - | |||
| - | </ | ||
| - | |||
| - | === シェルスクリプト(Linux/ | ||
| - | |||
| - | < | ||
| - | |||
| - | #!/bin/bash | ||
| - | # Detect if local Mysql is without password | ||
| - | # First, do we have a running MySQL? | ||
| - | CHECK_MYSQL=`netstat -an | grep LISTEN | grep ":3306 "` | ||
| - | if [ ! -z " | ||
| - | then | ||
| - | |||
| - | CHECK_MYSQL_ROOT=`echo " | ||
| - | if [ -z " | ||
| - | then | ||
| - | echo "< | ||
| - | echo "< | ||
| - | echo "< | ||
| - | echo "< | ||
| - | echo "< | ||
| - | echo "</ | ||
| - | else | ||
| - | echo "< | ||
| - | echo "< | ||
| - | echo "< | ||
| - | echo "< | ||
| - | echo "< | ||
| - | echo "</ | ||
| - | fi | ||
| - | fi | ||
| - | |||
| - | exit 0 | ||
| - | |||
| - | </ | ||
| - | |||
| - | === VBScript (Windows) によるプラグインの例 === | ||
| - | |||
| - | < | ||
| - | |||
| - | ' df.vbs | ||
| - | ' Returns free space for avaible drives. | ||
| - | ' -------------------------------------- | ||
| - | |||
| - | Option Explicit | ||
| - | On Error Resume Next | ||
| - | |||
| - | ' Variables | ||
| - | Dim objWMIService, | ||
| - | |||
| - | ' Parse command line parameters | ||
| - | argc = Wscript.Arguments.Count | ||
| - | Set argv = CreateObject(" | ||
| - | For i = 0 To argc - 1 | ||
| - | argv.Add Wscript.Arguments(i), | ||
| - | Next | ||
| - | |||
| - | ' Get drive information | ||
| - | Set objWMIService = GetObject (" | ||
| - | Set colItems = objWMIService.ExecQuery (" | ||
| - | |||
| - | For Each objItem in colItems | ||
| - | If argc = 0 Or argv.Exists(objItem.Name) Then | ||
| - | If objItem.FreeSpace <> "" | ||
| - | Wscript.StdOut.WriteLine "< | ||
| - | Wscript.StdOut.WriteLine " | ||
| - | Wscript.StdOut.WriteLine " | ||
| - | Wscript.StdOut.WriteLine " | ||
| - | Wscript.StdOut.WriteLine "</ | ||
| - | Wscript.StdOut.flush | ||
| - | End If | ||
| - | End If | ||
| - | Next | ||
| - | |||
| - | </ | ||
| - | |||
| - | ==== エージェントでの nagios プラグインの利用 ==== | ||
| - | |||
| - | Nagios has a large number of plugins that you can use with Pandora FMS. One way to do this is to use the remote plugins with the Plugin Server, using the [[: | ||
| - | |||
| - | Nagios には多くのプラグインがあり、Pandora FMS で利用することができます。プラグインサーバで [[: | ||
| - | ただし、ステータスを取得するのみで、いくつかの nagios プラグインが持っている詳細情報を扱うことができません。 | ||
| - | |||
| - | この問題は、ソフトウエアエージェントで nagios プラグインラッパーを使うことで解決できます。ラッパーは、Unix エージェントにデフォルトで付属しています。Pandora FMS Windows エージェント用の同様のプラグインは、 [[https:// | ||
| - | |||
| - | nagios プラグイン用のプラグインラッパーは何をするのでしょうか。 | ||
| - | |||
| - | nagios プラグインをそれ独自のパラメータを使って実行し、出力データを Pandora FMS で使いやすいように、次のような 2種類のデータに変換します。 | ||
| - | |||
| - | * ステータス情報: | ||
| - | * 詳細情報: | ||
| - | |||
| - | < | ||
| - | |||
| - | < | ||
| - | |||
| - | </ | ||
| - | |||
| - | |||
| - | === 例 === | ||
| - | |||
| - | 実行権限がついた pop3 プラグイン (/ | ||
| - | |||
| - | < | ||
| - | / | ||
| - | |||
| - | </ | ||
| - | |||
| - | 次のような結果が返ってきます。 | ||
| - | |||
| - | < | ||
| - | OK: successfully logged in. | ||
| - | |||
| - | </ | ||
| - | |||
| - | 異常の場合はつぎのようになります。 | ||
| - | |||
| - | < | ||
| - | Critical: unable to log on | ||
| - | |||
| - | </ | ||
| - | |||
| - | ラッパーの利用は簡単で、コマンドの前に、ラッパーとモジュール名を設定します。 | ||
| - | |||
| - | < | ||
| - | / | ||
| - | |||
| - | </ | ||
| - | |||
| - | これで、エージェントプラグイン用に完全な XML を生成します。 | ||
| - | |||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | </ | ||
| - | |||
| - | </ | ||
| - | |||
| - | または、 | ||
| - | |||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | </ | ||
| - | |||
| - | </ | ||
| - | |||
| - | pandora_agent.conf の全設定は次のようになります。 | ||
| - | |||
| - | < | ||
| - | module_plugin nagios_plugin_wrapper POP3_artica.es / | ||
| - | |||
| - | </ | ||
| - | |||
| - | これは、モジュール内で次のように表示されます。(障害時) | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | ===== KeepAlive によるモニタリング ===== | ||
| - | |||
| - | <WRAP center round tip 60%> | ||
| - | |||
| - | The KeepAlive module can only be created from the Console, **even if remote configuration is not enabled** and it does not leave any trace in the '' | ||
| - | |||
| - | </ | ||
| - | |||
| - | <WRAP center round tip 60%> | ||
| - | |||
| - | KeepAlive モジュールは、**リモート設定が有効になっていない場合でも** コンソールから作成することができます。また、'' | ||
| - | |||
| - | </ | ||
| - | |||
| - | A unique module in Pandora FMS is the type called '' | ||
| - | |||
| - | Pandora FMS の固有のモジュールで '' | ||
| - | |||
| - | You must go to the modules tab (**Management** → **Manage agents** → click on agent name → **Modules**). | ||
| - | |||
| - | 設定には、モジュールタブに移動する必要があります (**管理(Management)** → **エージェント管理(Manage agents)** → エージェント名をクリック → **モジュール(Modules)**)。 | ||
| - | |||
| - | Click **Create module** and select **Create a new data server module** → **Create** → enter the name of the new module → **Create**. | ||
| - | |||
| - | **モジュールの作成(Create module)** をクリックし、**データサーバモジュールの新規作成(Create a new data server module)** → **作成(Create)** → 新しいモジュールの名前を入力 → **作成(Create)** を選択します。 | ||
| - | |||
| - | ===== コマンドスナップショット ===== | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | Commands that have extensive outputs, such as '' | ||
| - | |||
| - | '' | ||
| - | |||
| - | < | ||
| - | module_begin | ||
| - | module_name process_table | ||
| - | module_type generic_data_string | ||
| - | module_exec ps aux | ||
| - | module_description Command snapshot of running processes | ||
| - | module_group System | ||
| - | module_end | ||
| - | |||
| - | </ | ||
| - | |||
| - | <WRAP center round important 60%> | ||
| - | |||
| - | * In order for it to work like this, it is necessary to configure properly both Pandora FMS console (setup) and the agent that collects this information, | ||
| - | * In Console, option **Command line snapshot** | ||
| - | |||
| - | </ | ||
| - | |||
| - | <WRAP center round important 60%> | ||
| - | |||
| - | * 動作させるには、Pandora FMS コンソール (セットアップ) とこの情報を収集するエージェントの両方を適切に設定し、情報が // | ||
| - | * コンソールでは、**コマンドラインスナップショット** オプションを有効化する必要があります。 | ||
| - | |||
| - | </ | ||
| - | |||
| - | ===== 画像の監視と表示 ===== | ||
| - | |||
| - | This method allows defining modules of the string type ('' | ||
| - | |||
| - | この監視では、base64 エンコードを使用したテキスト形式の画像を含む文字列型 ('' | ||
| - | |||
| - | For example: | ||
| - | |||
| - | 例: | ||
| - | |||
| - | < | ||
| - | #!/bin/bash | ||
| - | echo "< | ||
| - | echo "< | ||
| - | echo "< | ||
| - | echo "< | ||
| - | echo "</ | ||
| - | |||
| - | </ | ||
| - | |||
| - | Write that content to a file on the agent (or distribute by [[: | ||
| - | |||
| - | 上記のファイルをエージェント上で保存し(または[[: | ||
| - | |||
| - | < | ||
| - | |||
| - | module_plugin < | ||
| - | |||
| - | </ | ||
| - | |||
| - | < | ||
| - | |||
| - | module_plugin < | ||
| - | |||
| - | </ | ||
| - | |||
| - | ===== Windows における特定の監視 ===== | ||
| - | |||
| - | <WRAP center round info 90%> | ||
| - | |||
| - | * If the process name contains white spaces **do not use ** **'' | ||
| - | * The process name must be the same as the one displayed in the Windows Task Manager ( '' | ||
| - | * It is important to **respect upper and lower case letters**. | ||
| - | |||
| - | </ | ||
| - | |||
| - | <WRAP center round info 90%> | ||
| - | |||
| - | * プロセスの名前に空白が含まれている場合は、 **''" | ||
| - | * プロセスの名前は、拡張子 '' | ||
| - | * **大文字と小文字を尊重する** | ||
| - | |||
| - | </ | ||
| - | |||
| - | ==== プロセスモニタリングと、プロセスウォッチドック ==== | ||
| - | |||
| - | === プロセスモニタリング === | ||
| - | |||
| - | The **module_proc** parameter checks if a certain process name is running on this machine. Example: | ||
| - | |||
| - | **module_proc** | ||
| - | |||
| - | < | ||
| - | module_begin | ||
| - | module_name CMDProcess | ||
| - | module_type generic_proc | ||
| - | module_proc cmd.exe | ||
| - | module_description Process Command line | ||
| - | module_end | ||
| - | |||
| - | </ | ||
| - | |||
| - | The parameter **[[: | ||
| - | |||
| - | **module_async yes** のパラメータを指定する必要があります。 | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | === プロセスウォッチドック === | ||
| - | |||
| - | Windows のソフトウエアエージェントのウォッチドック機能は、プロセスがダウンしたときに再起動することができます。ウォッチドックは、モジュールが非同期の場合にのみ動作します。 | ||
| - | |||
| - | ウォッチドックモジュールの設定例を以下に示します。 | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | Each time the notepad.exe process is deactivated and the command: | ||
| - | |||
| - | notepad.exe プロセスがいなくなるたびに、 | ||
| - | |||
| - | < | ||
| - | %SystemRoot%\notepad.exe | ||
| - | |||
| - | </ | ||
| - | |||
| - | will be executed (see common rules at the beginning of the Windows section). The process reactivation will be attempted 5 times with an initial waiting time of 3 seconds and a waiting time between retries of 2 seconds in the user's active session. | ||
| - | |||
| - | が実行されます(Windows の章の冒頭にある一般的なルールを参照してください)。 | ||
| - | |||
| - | |||
| - | ==== サービスモニタリングと、サービスウォッチドック ==== | ||
| - | |||
| - | === サービスモニタリング === | ||
| - | |||
| - | **module_service** | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | サービス名にスペースが含まれる場合、«" | ||
| - | |||
| - | サービスがダウンしたときにソフトウエアエージェントがすぐに通知して欲しい場合は、**module_async yes** を追加する必要があります。モジュールの設定例を以下に示します。 | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | === サービスウォッチドック === | ||
| - | |||
| - | プロセスと同様に、ダウンしたサービスを再起動できるウォッチドックモードがあります。ウォッチドックを使ったモジュール定義例は次の通りです。 | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | ウォッチドックの定義には、特別なパラメータは必要ありません。サービスの定義内にあるためです。 | ||
| - | |||
| - | ==== 基本リソースのモニタリング ==== | ||
| - | |||
| - | When installing the PFMS Software Agent for MS Windows® the necessary basic modules are included, some of them come active and others must be activated by **Remote Configuration** (or locally editing the agent' | ||
| - | |||
| - | MS Windows® 用 Pandora FMS ソフトウェアエージェントをインストールすると、必要な基本モジュールが含まれています。その一部は有効になっていますが、その他は **リモート設定** (またはエージェントの '' | ||
| - | |||
| - | === CPU のモニタリング === | ||
| - | |||
| - | CPU をモニタするには、CPU 使用率を返す **module_cpuusage** | ||
| - | |||
| - | 次のような設定で、CPU の ID を元に CPU をモニタすることができます。 | ||
| - | |||
| - | < | ||
| - | module_begin | ||
| - | module_name CPU_1 | ||
| - | module_type generic_data | ||
| - | module_cpuusage 1 | ||
| - | module_description CPU usage for CPU 1 | ||
| - | module_end | ||
| - | |||
| - | </ | ||
| - | |||
| - | また、次のように、すべての CPU の平均使用率をモニタすることもできます。 | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | === メモリのモニタリング === | ||
| - | |||
| - | メモリをモニタするには、システムの空きメモリ容量を返す **module_freememory** と、空き率をパーセンテージで返す **module_freepercentmemory** | ||
| - | |||
| - | **module_freememory** | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | **module_freepercentmemory** | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | === ディスクのモニタリング === | ||
| - | |||
| - | ディスクスペースをモニタするには、空き容量を返す **module_freedisk** | ||
| - | |||
| - | **module_freedisk** | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | **module_freepercentdisk** | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | === WMI クエリ === | ||
| - | |||
| - | Pandora FMS のソフトウエアエージェントは、システムに関連した情報や外部の情報を保持するのに使われる共通の技術である WMI クエリおよび ODBC 接続を使って情報を取得することができます。 | ||
| - | |||
| - | **module_wmiquery** | ||
| - | |||
| - | 例えば、次の設定ではインストールされているサービス一覧を取得できます。 | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | WMI を使って、CPU ロードも取得できます。 | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | [[: | ||
| - | |||
| - | ===== (OBSOLETE) バージョン 7 NG 以前 ===== | ||
| - | |||
| - | ==== エージェントの名前 ==== | ||
| - | |||
| - | Pandora FMS バージョン 7 以降では、エージェントには、別名と名前(またはユニークな識別子)があります。デフォルトでは、エージェントはランダムの 16進数から成る文字列の名前(または識別子)を生成します。また、マシンのホスト名から成る別名(または表示名)を生成します。 | ||
| - | |||
| - | 以前のバージョンでは、マシンの " | ||
| - | |||
| - | 以下の設定トークンにより、この動作を変更できます。 | ||
| - | |||
| - | < | ||
| - | | ||
| - | | ||
| - | |||
| - | </ | ||
| - | |||
| - | デフォルトでは、設定ファイルのいずれかを使用しないので、マシンのホスト名を別名として取得し、非常に大きなランダムな16進数を名前または識別子として取得します。エージェント名は表示されなくなり(エージェント詳細表示を除く)、変更することはできません。 エージェントの一意の識別子はエージェントの「名前」であるため、エージェントの別名はソフトウェアエージェントの設定を心配することなく、いつでも変更できます。 | ||
| - | |||
| - | |||
| - | |||