両方とも前のリビジョン 前のリビジョン 次のリビジョン | 前のリビジョン |
ja:documentation:pandorafms:monitoring:02_operations [2025/07/10 07:58] – [コンソールからの高度なエージェントプラグイン管理] junichi | ja:documentation:pandorafms:monitoring:02_operations [2025/09/12 23:25] (現在) – [高頻度モニタリング] junichi |
---|
<wrap #ks1 /> | <wrap #ks1 /> |
| |
===== エンドポイントを使った監視 ===== | ===== 概要 ===== |
| |
The EndPoints are running on the operating systems from which they collect information, performing a **check** for each **module**. | EndPoints [[:en:documentation:pandorafms:installation:01_installing#ks2|are installed]] and run on the operating systems from which they collect information, performing a **check** for each **module**. |
| |
エンドポイントは、情報を収集するオペレーティングシステム上で実行され、**モジュール**ごとに**チェック**を実行します。 | エンドポイントは、情報を収集するオペレーティングシステム上で[[:ja:documentation:pandorafms:installation:01_installing#ks2|インストール]]、実行され、**モジュール**ごとに**チェック**を実行します。 |
| |
The EndPoint's own directives are used to collect certain data directly from the operating system (eg CPU usage, memory, events, etc.), executing **operating system's own commands** following instructions from predefined scripts. | The EndPoint's own directives are used to collect certain data directly from the operating system (such as CPU usage, memory, events, etc.), executing **operating system's own commands** following instructions from predefined scripts. |
| |
エンドポイント独自のディレクティブは、オペレーティングシステムから特定のデータ (CPU 使用率、メモリ、イベントなど) を直接収集するために使用され、事前定義されたスクリプトの指示に従って **オペレーティングシステム独自のコマンド** を実行します。 | エンドポイント独自のディレクティブは、オペレーティングシステムから特定のデータ (CPU 使用率、メモリ、イベントなど) を直接収集するために使用され、事前定義されたスクリプトの指示に従って **オペレーティングシステム独自のコマンド** を実行します。 |
| |
The Pandora FMS Dataserver processes and stores in the database all the information generated and sent in XML files by the EndPoints. | [[:en:documentation:pandorafms:introduction:02_architecture#data_server|Pandora FMS Dataserver]] processes and stores in the database all the information generated and sent in XML files by the EndPoints. |
| |
Pandora FMS データサーバは、エンドポイントによって生成され XML ファイルで送信されたすべての情報を処理し、データベースに保存します。 | [[:ja:documentation:pandorafms:introduction:02_architecture#data_server|Pandora FMS データサーバ]]は、エンドポイントによって生成され XML ファイルで送信されたすべての情報を処理し、データベースに保存します。 |
| |
<wrap #ks1_1 /> | <wrap #ks1_1 /> |
</code> | </code> |
| |
See "[[:en:documentation:pandorafms:technical_reference:06_anexo_agent_plugins#validate_the_resulting_xml|XML Validation]]", the [[:en:documentation:pandorafms:technical_annexes:15_security_architecture#tentacle|Security Architecture for the Tentacle protocol]] (mechanism responsible for delivering data in XML format to the PFMS Data server) and the [[:en:documentation:pandorafms:technical_annexes:15_security_architecture#server|Security Architecture for the PFMS Data server]] (limit the auto-creation of EndPoint and set a password for the EndPoint group each EndPoint belongs to). | See "[[:en:documentation:pandorafms:technical_reference:06_anexo_agent_plugins#validate_the_resulting_xml|XML Validation]]", the [[:en:documentation:pandorafms:cybersecurity:15_security_architecture#tentacle|Security Architecture for the Tentacle protocol]] (mechanism responsible for delivering data in XML format to the PFMS Data server) and the [[:en:documentation:pandorafms:cybersecurity:15_security_architecture#server|Security Architecture for the PFMS Data server]] (limit the auto-creation of EndPoint and set a password for the EndPoint group each EndPoint belongs to). |
| |
[[:ja:documentation:pandorafms:technical_reference:06_anexo_agent_plugins#xmlの確認|XML の確認]]、[[:ja:documentation:pandorafms:technical_annexes:15_security_architecture#tentacle|Tentacle プロトコルのセキュリティアーキテクチャ]](XML フォーマットでの Pandora FMS データサーバへのデータ送信の仕組)、[[:ja:documentation:pandorafms:technical_annexes:15_security_architecture#サーバ|Pandora FMS データサーバのセキュリティアーキテクチャ]](エンドポイントの自動作成の制限、各エンドポイントが属するエンドポイントグループのパスワード設定) を参照してください。 | [[:ja:documentation:pandorafms:technical_reference:06_anexo_agent_plugins#xmlの確認|XML の確認]]、[[:ja:documentation:pandorafms:cybersecurity:15_security_architecture#tentacle|Tentacle プロトコルのセキュリティアーキテクチャ]](XML フォーマットでの Pandora FMS データサーバへのデータ送信の仕組)、[[:ja:documentation:pandorafms:cybersecurity:15_security_architecture#サーバ|Pandora FMS データサーバのセキュリティアーキテクチャ]](エンドポイントの自動作成の制限、各エンドポイントが属するエンドポイントグループのパスワード設定) を参照してください。 |
| |
Custom fields can also be passed from the EndPoint configuration file, using the tokens [[:en:documentation:pandorafms:installation:05_configuration_agents#custom_fieldx_name|custom_fieldx_name]] and [[:en:documentation:pandorafms:installation:05_configuration_agents#custom_fieldx_value|custom_fieldx_value]], for example: | Custom fields can also be passed from the EndPoint configuration file, using the tokens [[:en:documentation:pandorafms:installation:05_configuration_agents#custom_fieldx_name|custom_fieldx_name]] and [[:en:documentation:pandorafms:installation:05_configuration_agents#custom_fieldx_value|custom_fieldx_value]], for example: |
エンドポイントの設定: | エンドポイントの設定: |
| |
* **interval**: Mandatory, EndPoint sampling time in seconds, it is the general interval for all local modules. | * **interval**: Required, EndPoint sampling time in seconds, it is the general interval for all local modules. |
* **intensive_interval**: Time in which it will notify if there is any problem, and it will always be executed in this period and if it matches the condition, it will be notified in this period of time (otherwise the data will be sent in the **interval**). | * **intensive_interval**: Time in which it will notify if there is any problem, and it will always be executed in this period and if it matches the condition, it will be notified in this period of time (otherwise the data will be sent in the **interval**). |
Module configuration: | Module configuration: |
このモニタリングを行うには次のような手段をとります。 | このモニタリングを行うには次のような手段をとります。 |
| |
* インストールしたソフトウエアエージェント: CPU、メモリ、ディスクをモニタします。 | * インストールしたエンドポイント: CPU、メモリ、ディスクをモニタします。 |
* データベース用のブローカー: データベース内の状態をモニタします。 | * データベース用のブローカー: データベース内の状態をモニタします。 |
| |
これを行うには、ソフトウエアエージェントを CPU、メモリ、ディスクをモニタするマシンにインストールします。ソフトウエアエージェントの設定で次の行を追加します。 | これを行うには、エンドポイントを CPU、メモリ、ディスクをモニタするマシンにインストールします。エンドポイントの設定で次の行を追加します。 |
| |
<code> | <code> |
=== ブローカーを使ったリモートデバイスのモニタリング === | === ブローカーを使ったリモートデバイスのモニタリング === |
| |
この例では、Windows マシンにソフトウエアエージェントをインストールし、(CPU、メモリ、ディスクを)モニタリングしています。また、エージェントのインストールなしに 192.168.100.54 の IP を持ったルータをモニタリングしたいとします。この問題を解決するためにブローカーを利用できます。 | この例では、Windows マシンにエンドポイントをインストールし、(CPU、メモリ、ディスクを)モニタリングしています。また、エンドポイントのインストールなしに 192.168.100.54 の IP を持ったルータをモニタリングしたいとします。この問題を解決するためにブローカーを利用できます。 |
| |
次の設定で、ブローカーを作成します。 | 次の設定で、ブローカーを作成します。 |
</code> | </code> |
| |
これにより、routerFloor5 という名のブローカーエージェントを作成します。ソフトウエアエージェントが Windows マシンにインストールされているので、Windows のソフトウエアエージェントの機能で ping および snmp でルータをモニタできます。それには、routerFloor5.conf ファイルに次の設定を行います。 | これにより、routerFloor5 という名のブローカーエージェントを作成します。エンドポイントが Windows マシンにインストールされているので、Windows のエンドポイントの機能で ping および snmp でルータをモニタできます。それには、routerFloor5.conf ファイルに次の設定を行います。 |
| |
<code> | <code> |
{{ :wiki:broker_example_no_access.png?790 }} | {{ :wiki:broker_example_no_access.png?790 }} |
| |
この例では、本社からある会社のサイトのデバイスをリモートからモニタする必要があるとします。Pandora FMS サーバは本社にあり、他の会社のサイトに VPN で接続しています。何らかの制限により Pandora のリモートサーバはリモートでアクセスできません。会社のサイトをモニタリングするには、ブローカーモードを使います。ソフトウエアエージェントは、異なるデバイスとして Pandora サーバに XML を送信できます。 | この例では、本社からある会社のサイトのデバイスをリモートからモニタする必要があるとします。Pandora FMS サーバは本社にあり、他の会社のサイトに VPN で接続しています。何らかの制限により Pandora のリモートサーバはリモートでアクセスできません。会社のサイトをモニタリングするには、ブローカーモードを使います。エンドポイントは、異なるデバイスとして Pandora サーバに XML を送信できます。 |
| |
ソフトウエアエージェントの設定ファイルでは、モニタするデバイスの数だけブローカーを追加します。設定例は次の通りです。 | エンドポイントの設定ファイルでは、モニタするデバイスの数だけブローカーを追加します。設定例は次の通りです。 |
| |
<code> | <code> |
{{ :wiki:broker_scalation_example.png?800 }} | {{ :wiki:broker_scalation_example.png?800 }} |
| |
この例では、A から Z の複数のネットワークがあり、それぞれ 1000のデバイスがあります。Pandora FMS のリモートサーバの許容量は、役 2000エージェントです。そのため、負荷分散のためにブローカーモードでソフトウエアエージェントを利用することにします。ブローカーモードを有効にしたソフトウエアエージェントは、リモートでネットワークから全てのデバイスをモニタし、データを XML で Pandora FMS の中央サーバへ送ります。 | この例では、A から Z の複数のネットワークがあり、それぞれ 1000のデバイスがあります。Pandora FMS のリモートサーバの許容量は、役 2000エージェントです。そのため、負荷分散のためにブローカーモードでエンドポイントを利用することにします。ブローカーモードを有効にしたエンドポイントは、リモートでネットワークから全てのデバイスをモニタし、データを XML で Pandora FMS の中央サーバへ送ります。 |
| |
それぞれのネットワークに、ブローカーモードを有効にしたエージェントがあります。モニタするデバイスの分だけブローカーを作成します。ソフトウエアエージェントの //Broker_Agent_Net_A// の設定は次のようになります。 | それぞれのネットワークに、ブローカーモードを有効にしたエンドポイントがあります。モニタするデバイスの分だけブローカーを作成します。エンドポイントの //Broker_Agent_Net_A// の設定は次のようになります。 |
| |
<code> | <code> |
<wrap #ks8_5 /> | <wrap #ks8_5 /> |
| |
==== 独自エージェントプラグインの作成方法 ==== | ==== 独自エンドポイントプラグインの作成方法 ==== |
| |
Plugins can be created in any programming language. Just bear in mind the [[:en:documentation:08_technical_reference:04_anexo_plugins_considerations|general rules]] and the [[:es:documentation:08_technical_reference:06_anexo_agent_plugins|specific rules]] for its development. | Plugins can be created in any programming language. Only the [[:en:documentation:pandorafms:technical_reference:04_anexo_plugins_considerations|general rules]] and [[:en:documentation:pandorafms:technical_reference:06_anexo_agent_plugins|specific rules]] should be taken into account for its development. |
| |
プラグインは、任意のプログラミング言語で作成することができます。[[:ja:documentation:08_technical_reference:04_anexo_plugins_considerations|一般的なルール]] と開発の[[:ja:documentation:08_technical_reference:06_anexo_agent_plugins|特別なルール]]に気を付けてください。 | プラグインは、任意のプログラミング言語で作成することができます。[[:ja:documentation:pandorafms:technical_reference:04_anexo_plugins_considerations|一般的なルール]] と開発の[[:ja:documentation:pandorafms:technical_reference:06_anexo_agent_plugins|特別なルール]]に気を付けてください。 |
| |
<WRAP center round important 60%> | <WRAP center round important 60%> |
</code> | </code> |
| |
==== エージェントでの nagios プラグインの利用 ==== | ==== エンドポイントでの 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 [[:en:documentation:08_technical_reference:05_anexo_server_plugins_development#registro_manual_de_un_plugin_en_la_consola|Nagios compatibility]]. | 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 [[:en:documentation:pandorafms:technical_reference:05_anexo_server_plugins_development#registro_manual_de_un_plugin_en_la_consola|Nagios compatibility]]. |
| |
| Nagios には、Pandora FMS で使用できる多数のプラグインがあります。その一つとして、[[:ja:documentation:pandorafms:technical_reference:05_anexo_server_plugins_development#プラグインの手動登録|Nagios互換性]]を利用して、プラグインサーバでリモートプラグインを使用する方法があります。 |
| |
Nagios には多くのプラグインがあり、Pandora FMS で利用することができます。プラグインサーバで [[:ja:documentation:08_technical_reference:05_anexo_server_plugins_development#プラグインの手動登録|nagios 互換モード]] を使ってリモートでプラグインを利用することができます。 | |
ただし、ステータスを取得するのみで、いくつかの nagios プラグインが持っている詳細情報を扱うことができません。 | ただし、ステータスを取得するのみで、いくつかの nagios プラグインが持っている詳細情報を扱うことができません。 |
| |
この問題は、ソフトウエアエージェントで nagios プラグインラッパーを使うことで解決できます。ラッパーは、Unix エージェントにデフォルトで付属しています。Pandora FMS Windows エージェント用の同様のプラグインは、 [[https://pandorafms.com/library/nagios-wrapper-for-agent-plugin/|Pandora FMS リソースライブラリ]]からダウンロードできます。 | この問題は、エンドポイントで nagios プラグインラッパーを使うことで解決できます。ラッパーは、Unix エージェントにデフォルトで付属しています。Pandora FMS Windows エンドポイント用の同様のプラグインは、 [[https://pandorafms.com/library/nagios-wrapper-for-agent-plugin/|Pandora FMS リソースライブラリ]]からダウンロードできます。 |
| |
nagios プラグイン用のプラグインラッパーは何をするのでしょうか。 | nagios プラグイン用のプラグインラッパーは何をするのでしょうか。 |
| |
</code> | </code> |
| |
| |
=== 例 === | === 例 === |
</code> | </code> |
| |
これで、エージェントプラグイン用に完全な XML を生成します。 | これで、エンドポイントプラグイン用に完全な XML を生成します。 |
| |
<code> | <code> |
<WRAP center round tip 60%> | <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 ''pandora_agent.conf'' file. | 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 ''pandora_agent.conf'' file. |
| |
</WRAP> | </WRAP> |
</WRAP> | </WRAP> |
| |
A unique module in Pandora FMS is the type called ''keep_alive'', used to alert if a Software Agent has stopped sending information. | A unique module in Pandora FMS is the type called ''keep_alive'', used to alert if a EndPoint has stopped sending information. |
| |
Pandora FMS の固有のモジュールで ''keep_alive'' と呼ばれるタイプで、ソフトウェアエージェントが情報の送信を停止した場合に警告するために使用されます。 | Pandora FMS の固有のモジュールで ''keep_alive'' と呼ばれるタイプで、エンドポイントが情報の送信を停止した場合に警告するために使用されます。 |
| |
You must go to the modules tab (**Management** → **Manage agents** → click on agent name → **Modules**). | You must go to the modules tab (**Management** → **Manage agents** → click on agent name → **Modules**). |
<WRAP center round important 90%> | <WRAP center round important 90%> |
| |
* For this to work like this, you have to properly configure both the Pandora console (setup) andthe agent that collects that information, making sure that it is raw text. | * For this to work like this, you have to properly configure both the Pandora console (setup) andthe EndPoint that collects that information, making sure that it is raw text. |
* In the [[:en:documentation:pandorafms:management_and_operation:12_console_setup#ks1_1|Web Console configuration]], the option <wrap :en>**Command line snapshot**</wrap> must be activated. | * In the [[:en:documentation:pandorafms:management_and_operation:12_console_setup#ks1_1|Web Console configuration]], the option <wrap :en>**Command line snapshot**</wrap> must be activated. |
| |
<WRAP center round important 90%> | <WRAP center round important 90%> |
| |
* 動作させるには、Pandora FMS コンソール (セットアップ) とこの情報を収集するエージェントの両方を適切に設定し、情報が //未処理// テキストであることを確認する必要があります。 | * 動作させるには、Pandora FMS コンソール (セットアップ) とこの情報を収集するエンドポイントの両方を適切に設定し、情報が //未処理// テキストであることを確認する必要があります。 |
* [[:ja:documentation:pandorafms:management_and_operation:12_console_setup#ks1_1|Web コンソールの設定]] で、オプション <wrap :ja>**コマンドラインスナップショット(Command line shapshot)**</wrap> を有効にする必要があります。 | * [[:ja:documentation:pandorafms:management_and_operation:12_console_setup#ks1_1|Web コンソールの設定]] で、オプション <wrap :ja>**コマンドラインスナップショット(Command line shapshot)**</wrap> を有効にする必要があります。 |
| |
</code> | </code> |
| |
Write that content to a file on the agent (or distribute by [[:en:documentation:05_big_environments:02_policy#file_collections|collections]]) and run it like this: | Write that content to a file on the EndPoint (or distribute by [[:en:documentation:pandorafms:complex_environments_and_optimization:02_policy#file_collections|collections]]) and run it like this: |
| |
上記のファイルをエージェント上で保存し(または[[:ja:documentation:05_big_environments:02_policy#ファイルコレクション|ファイルコレクション]]で配り)し、次のように実行します。 | 上記のファイルをエンドポイント上で保存し(または[[:ja:documentation:pandorafms:complex_environments_and_optimization:02_policy#ファイルコレクション|ファイルコレクション]]で配り)し、次のように実行します。 |
| |
<code> | <code> |
==== 基本リソースのモニタリング ==== | ==== 基本リソースのモニタリング ==== |
| |
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's ''.conf'' file). | When installing the PFMS EndPoint 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 EndPoint's ''.conf'' file). |
| |
MS Windows® 用 Pandora FMS ソフトウェアエージェントをインストールすると、必要な基本モジュールが含まれています。その一部は有効になっていますが、その他は **リモート設定** (またはエージェントの ''.conf'' ファイルをローカルで編集) によって有効化する必要があります。 | MS Windows® 用 Pandora FMS エンドポイントをインストールすると、必要な基本モジュールが含まれています。その一部は有効になっていますが、その他は **リモート設定** (またはエンドポイントの ''.conf'' ファイルをローカルで編集) によって有効化する必要があります。 |
| |
=== CPU のモニタリング === | === CPU のモニタリング === |
=== WMI クエリ === | === WMI クエリ === |
| |
Pandora FMS のソフトウエアエージェントは、システムに関連した情報や外部の情報を保持するのに使われる共通の技術である WMI クエリおよび ODBC 接続を使って情報を取得することができます。 | Pandora FMS のエンドポイントは、システムに関連した情報や外部の情報を保持するのに使われる共通の技術である WMI クエリおよび ODBC 接続を使って情報を取得することができます。 |
| |
**module_wmiquery** パラメータを使って、ソフトウエアエージェントはローカルで WMI クエリを実行することができます。クエリを実行するには、実行するクエリを **module_wmiquery** パラメータで設定し、取得したい情報を持つカラムを **module_wmicolumn** で指定します。 | **module_wmiquery** パラメータを使って、エンドポイントはローカルで WMI クエリを実行することができます。クエリを実行するには、実行するクエリを **module_wmiquery** パラメータで設定し、取得したい情報を持つカラムを **module_wmicolumn** で指定します。 |
| |
例えば、次の設定ではインストールされているサービス一覧を取得できます。 | 例えば、次の設定ではインストールされているサービス一覧を取得できます。 |