| 両方とも前のリビジョン 前のリビジョン 次のリビジョン | 前のリビジョン |
| ja:documentation:pandorafms:monitoring:02_operations [2025/07/10 08:11] – [基本リソースのモニタリング] junichi | ja:documentation:pandorafms:monitoring:02_operations [2026/02/13 12:10] (現在) – [カスタムフィールド] 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|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|Pandora FMS データサーバ]]は、エンドポイントによって生成され XML ファイルで送信されたすべての情報を処理し、データベースに保存します。 |
| |
| <wrap #ks1_1 /> | <wrap #ks1_1 /> |
| Custom fields allow you to add additional information to the EndPoint. Custom fields can be created with the PFMS 1.0 API and the command [[:en:documentation:pandorafms:technical_reference:02_annex_externalapi#set_create_custom_field|set create_custom_field]] or through the Web Console in the menu **Management → Resources → Custom fields → Create field**. | Custom fields allow you to add additional information to the EndPoint. Custom fields can be created with the PFMS 1.0 API and the command [[:en:documentation:pandorafms:technical_reference:02_annex_externalapi#set_create_custom_field|set create_custom_field]] or through the Web Console in the menu **Management → Resources → Custom fields → Create field**. |
| |
| カスタムフィールドを使用すると、エンドポイントに追加情報を追加できます。 カスタムフィールドは、PFMS 1.0 API とコマンド [[:ja:documentation:08_technical_reference:02_annex_externalapi#set_create_custom_field|set create_custom_field]] を使用して作成するか、ウェブコンソールのメニュー **管理(Management) → リソース(Resources) → カスタムフィールド(Custom fields) → フィールドの作成(Create field)** を使用して作成できます。 | カスタムフィールドを使用すると、エンドポイントに追加情報を追加できます。 カスタムフィールドは、PFMS 1.0 API とコマンド [[:ja:documentation:pandorafms:technical_reference:02_annex_externalapi#set_create_custom_field|set create_custom_field]] を使用して作成するか、ウェブコンソールのメニュー **管理(Management) → リソース(Resources) → カスタムフィールド(Custom fields) → フィールドの作成(Create field)** を使用して作成できます。 |
| |
| * The options **Enabled combo**, **Password type** and **Link type** are mutually exclusive, that is, only one of them can be used (or none, default value). | * The options **Enabled combo**, **Password type** and **Link type** are mutually exclusive, that is, only one of them can be used (or none, default value). |
| * By activating the **Display up front** field, the information of the custom field will be displayed, if it has any value set, in the EndPoint's overview. Additionally, it will be necessary to activate this token to send the Custom Fields information to the **Command Center** (Metaconsole). | * By activating the **Display up front** field, the information of the custom field will be displayed, if it has any value set, in the EndPoint's overview. **If no checked custom field has a value, the custom field box will remain hidden**. Additionally, it will be necessary to activate this token to send the Custom Fields information to the **Command Center** (Metaconsole). |
| * **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** to enter the combo values separated by commas. | * **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** to enter the combo values separated by commas. |
| * **Password type**: The value of the field (password) will be shown using asterisks in the Web Console. | * **Password type**: The value of the field (password) will be shown using asterisks in the Web Console. |
| |
| * オプション **選択肢の有効化(Enabled combo)**、**パスワードタイプ(Password type)**、**リンクタイプ(Link type)** は相互に排他的です。つまり、いずれか 1 つだけを使用できます (または、デフォルト値のなし)。 | * オプション **選択肢の有効化(Enabled combo)**、**パスワードタイプ(Password type)**、**リンクタイプ(Link type)** は相互に排他的です。つまり、いずれか 1 つだけを使用できます (または、デフォルト値のなし)。 |
| * **前面に表示(Display up front)** フィールドを有効にすると、値が設定されている場合、カスタムフィールドの情報がエンドポイントの概要に表示されます。 さらに、カスタムフィールド情報を **コマンドセンター** (メタコンソール) に送信するには、このトークンを有効にする必要があります。 | * **前面に表示(Display up front)** フィールドを有効にすると、カスタムフィールドに値が設定されている場合、その情報はエンドポイントの概要に表示されます。**チェックされたカスタムフィールドに値が設定されていない場合、カスタムフィールドボックスは非表示のままになります**。また、カスタムフィールドの情報を**コマンドセンター**（メタコンソール）に送信するには、このトークンを有効化する必要があります。 |
| * **選択肢の有効化(Enabled combo)**: このパラメーターを使用すると、ドロップダウンリストからのパラメータ選択を有効化できます。 有効化した場合、対応するカスタムフィールドの構成ウィンドウに新しいフィールドが表示され、カンマで区切で値を入力します。 | * **選択肢の有効化(Enabled combo)**: このパラメーターを使用すると、ドロップダウンリストからのパラメータ選択を有効化できます。 有効化した場合、対応するカスタムフィールドの構成ウィンドウに新しいフィールドが表示され、カンマで区切で値を入力します。 |
| * **パスワードタイプ(Password type)**: ウェブコンソールでは、フィールド (パスワード) の値がアスタリスクを使用して表示されます。 | * **パスワードタイプ(Password type)**: ウェブコンソールでは、フィールド (パスワード) の値がアスタリスクを使用して表示されます。 |
| * **リンクタイプ(Link type)**: ウェブコンソールまたは [[:ja:documentation:08_technical_reference:11_pfms_plugis#xml|エンドポイントから受信した XML]] によって入力されるウェブリンクをホストするカスタムフィールドを追加できます。JSON 形式の CDATA 命令''<![CDATA[…]]>'' が埋め込まれた XML にリンクを含めることができます。 たとえば、リンクの JSON 形式が次の場合、 | * **リンクタイプ(Link type)**: ウェブコンソールまたは [[:ja:documentation:pandorafms:technical_reference:11_pfms_plugis#xml|エンドポイントから受信した XML]] によって入力されるウェブリンクをホストするカスタムフィールドを追加できます。JSON 形式の CDATA 命令''<![CDATA[…]]>'' が埋め込まれた XML にリンクを含めることができます。 たとえば、リンクの JSON 形式が次の場合、 |
| |
| <file> | <file> |
| </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> |
| === WMI クエリ === | === WMI クエリ === |
| |
| Pandora FMS のソフトウエアエージェントは、システムに関連した情報や外部の情報を保持するのに使われる共通の技術である WMI クエリおよび ODBC 接続を使って情報を取得することができます。 | Pandora FMS のエンドポイントは、システムに関連した情報や外部の情報を保持するのに使われる共通の技術である WMI クエリおよび ODBC 接続を使って情報を取得することができます。 |
| |
| **module_wmiquery** パラメータを使って、ソフトウエアエージェントはローカルで WMI クエリを実行することができます。クエリを実行するには、実行するクエリを **module_wmiquery** パラメータで設定し、取得したい情報を持つカラムを **module_wmicolumn** で指定します。 | **module_wmiquery** パラメータを使って、エンドポイントはローカルで WMI クエリを実行することができます。クエリを実行するには、実行するクエリを **module_wmiquery** パラメータで設定し、取得したい情報を持つカラムを **module_wmicolumn** で指定します。 |
| |
| 例えば、次の設定ではインストールされているサービス一覧を取得できます。 | 例えば、次の設定ではインストールされているサービス一覧を取得できます。 |