差分

このページの2つのバージョン間の差分を表示します。

--- ja:documentation:pandorafms:monitoring:01_intro_monitoring [2025/09/12 22:26] – [Pandora FMS における論理エージェント] junichi
+++ ja:documentation:pandorafms:monitoring:01_intro_monitoring [2026/04/18 22:52] (現在) – [モジュールライブラリ] junichi
@@ 行 3: / 行 3: @@
 {{indexmenu_n>1}}
-[[ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]
+[[ja:documentation:pandorafms:start|Pandora FMS ドキュメント一覧に戻る]]
 <wrap #ks1 />
@@ 行 17: / 行 17: @@
 ===== Pandora FMS における論理エージェント =====
+The monitoring carried out by Pandora FMS is classified into Logical Agents, which always belong to a [[:en:documentation:pandorafms:management_and_operation:11_managing_and_administration#ks1_2_3|Group]]. These are equivalent to each of the different computers, devices, websites or applications that are subject to monitoring.
-{{ wiki:AgentHierarchy.png?550 }}
+Pandora FMS による監視は論理エージェントに分類され、論理エージェントは常に [[:ja:documentation:pandorafms:management_and_operation:11_managing_and_administration#ks1_2_3|グループ]] に属します。これらの論理エージェントは、監視対象となる様々なコンピュータ、デバイス、ウェブサイト、またはアプリケーションに相当します。
-The monitoring carried out by Pandora FMS is classified into Logical Agents, which always belong to a Group. These are equivalent to each of the different computers, devices, websites or applications that are subject to monitoring.
-Pandora FMS によるすべての監視は、論理エージェントで管理され、全ての論理エージェントは、グループに属します。これらエージェントは、監視対象のさまざまなコンピュータ、デバイス、Webサイト、またはアプリケーションを表します。
 <WRAP center round tip 90%>
@@ 行 42: / 行 39: @@
 Pandora FMS には、主にソフトウエアエージェントを使った方法とリモートで行う方法の 2つの監視手法があります。
-  * **Agent-based monitoring**  consists of installing a small program (EndPoint) that remains running on the system, obtaining data **locally**, by executing commands and/or scripts ( scripts).
+  * **EndPoint-based monitoring**  consists of installing a small program that remains running on the system, obtaining data **locally**, by executing commands and/or scripts ( scripts). \\ {{  :wiki:pfms-local_monitoring.png?500  }} \\
-  * **Remote monitoring**  consists of using the network to perform remote checks on the systems, without the need to install any additional component on the equipment to be monitored.
+  * **Remote monitoring**  consists of using the network to perform remote checks on the systems, without the need to install any additional component on the equipment to be monitored. \\ {{  :wiki:pfms-remote_monitoring.png?500  }} \\
-  * **エージェントベースの監視** は、監視対象にインストールした小さなプログラム(エンドポイント)を用い、ローカルでコマンドやスクリプトを実行して情報を取得します。
+  * **エンドポイントベースの監視** は、監視対象にインストールした小さなプログラムを用い、**ローカルで**コマンドやスクリプトを実行して情報を取得します。\\ {{  :wiki:pfms-local_monitoring.png?500  }} \\
-  * **リモート監視** は、監視対象の確認をリモートからネットワークを介して行います。監視対象には、追加のソフトウエアをインストールする必要はありません。
+  * **リモート監視** は、監視対象の確認をリモートからネットワークを介して行います。監視対象には、追加のソフトウエアをインストールする必要はありません。\\ {{  :wiki:pfms-remote_monitoring.png?500  }} \\
 <wrap #ks2_2 />
@@ 行 60: / 行 57: @@
 **通常の主な編集インターフェイスフィールド**
-   * <wrap :en>**Alias**</wrap>: For proper operation of all functions that Pandora FMS performs with agents and modules, avoid the use of the following characters ''/'', ''\'', ''|'', ''%'', ''#'', ''&''  and ''$ ''within the agent or module name. If these agents contain such characters, they may be misunderstood for system paths or command execution, generating server errors.
+  * <wrap :en>**Name**</wrap>: Although the agent name can be changed, it is not recommended to do so, especially in the case of [[:en:documentation:pandorafms:installation:04_configuration#self_monitoring_agent_name|the self-monitoring agent for each PFMS Server]].
+  * <wrap :en>**Alias**</wrap>: For proper operation of all functions that Pandora FMS performs with agents and modules, avoid the use of the following characters ''/'', ''\'', ''|'', ''%'', ''#'', ''&''  and ''$ ''within the agent or module name. If these agents contain such characters, they may be misunderstood for system paths or command execution, generating server errors.
   * The <wrap :en>**Server**</wrap> field allows you to indicate one of these options:
@@ 行 71: / 行 69: @@
   * <wrap :en>**IP address**</wrap>: It allows you to assign an IP address to the agent. By means of the <wrap :en>**Check unique IP**</wrap> button, you may check whether the IP address entered is free, if it is already in the list of addresses saved for that agent (it has a deletion option) **or whether it is in use by another agent**. In case it is in use by another agent, a warning will be displayed when saving the editing and a confirmation will be requested before recording the data. In the [[:en:documentation:pandorafms:management_and_operation:12_console_setup#general_setup|General Configuration]], it may be configured so that the <wrap :en>**Check unique IP**</wrap> button is automatically used for editing all agents.
-  * **別名(Alias):** Pandora FMS がエージェント/モジュールを使って実行するすべての機能を正しく処理するために、エージェント名には ''/'', ''\'', ''|'', ''%'', ''#'', ''&'' および ''$'' などの文字を使用しないことをお勧めします。 これらのエージェントを使うと、システムパスを使用しているときや他のコマンドを実行しているときに誤解を招き、サーバー上でエラーを引き起こす可能性があります。
+  * **名前(Name)**: エージェント名は変更できますが、特に [[:ja:documentation:pandorafms:installation:04_configuration#self_monitoring_agent_name|各 PFMS サーバの自己監視エージェント]] の場合には、変更することは推奨されません。
-  * **サーバ(Server):** このフィールドでは、次のいずれかのオプションを指定できます。
+  * **別名(Alias)**: Pandora FMS がエージェント/モジュールを使って実行するすべての機能を正しく処理するために、エージェント名には ''/'', ''\'', ''|'', ''%'', ''#'', ''&'' および ''$'' などの文字を使用しないことをお勧めします。 これらのエージェントを使うと、システムパスを使用しているときや他のコマンドを実行しているときに誤解を招き、サーバー上でエラーを引き起こす可能性があります。
+  * **サーバ(Server)**: このフィールドでは、次のいずれかのオプションを指定できます。
   - <wrap :en>**None**</wrap>: どのサーバもエージェントモジュールを実行しません。
@@ 行 108: / 行 107: @@
 <wrap #ks2_3 />
-==== コンソールでのエージェント参照 ====
+==== エージェント表示 ====
-**Management**  menu → **Resources**  → **Manage agents**, click on the agent name.
-**管理(Management)** メニュー → **リソース(Resources)** → **エージェント管理(Manage agents)** で、エージェント名をクリックします。
-This screen offers a large amount of information regarding the agent, with the possibility of forcing the execution of remote checks and refreshing data. At the top it shows a summary with various agent data.
-この画面では、エージェントに関する豊富な情報が提供され、リモートチェックの強制実行やデータの更新も可能です。画面上部には、エージェントの様々なデータの概要が表示されます。
-  * Total number of modules and their status.
-  * Events in the last 24 hours.
-  * Agent information.
-      * Name.
-      * Version.
-      * Agent accessibility.
-      * Cluster.
-  * **List of modules**: belonging to the agent and their respective states (only initialized modules).
-  * Full list of [[:en:documentation:pandorafms:management_and_operation:01_alerts|alerts]] from the agent, with the option to select one or more alerts and validate them.
-  * Status of log sources as configured in [[:en:documentation:pandorafms:monitoring:09_log_monitoring|Log Collection]].
-  * List with the last [[:en:documentation:pandorafms:management_and_operation:02_events|events]] of the agent, with the option to show only the events of the last 24 hours.
-  * 全モジュールとその状態
-  * 直近 24時間のイベント
-  * エージェント情報
-    * 名前
-    * バージョン
-    * エージェント接続
-    * クラスタ
-  * **モジュール一覧**: エージェントに属しているものとそれぞれの状態 (初期化されたモジュールのみ)。
-  * エージェントからの [[:ja:documentation:pandorafms:management_and_operation:01_alerts|アラート]] の完全な一覧。1 つ以上のアラートを選択して承諾するオプションがあります。
-  * [[:ja:documentation:pandorafms:monitoring:09_log_monitoring|ログ収集]]で設定されたログソースの状態。
-  * エージェントの最新の [[:ja:documentation:pandorafms:management_and_operation:02_events|イベント]] の一覧です。過去 24 時間のイベントのみを表示するオプションがあります。
-<WRAP center round info 60%>
-NG 770 version or later.
+<WRAP group>
+<WRAP half column><WRAP left round box 90%>Menu <wrap :en>**Management → {{:wiki:pfms-menu-resources_icon.svg?nolink&21x21}} Resources → Manage agents**</wrap>, click on the agent's <wrap :en>**View**</wrap> shortcut.</WRAP></WRAP>
+<WRAP half column>This screen provides a large amount of information about the agent, with the possibility to force the execution of remote checks and refresh data. The first box shows a summary with various agent data:</WRAP>
 </WRAP>
-<WRAP center round info 60%>
+<WRAP group>
+<WRAP half column><WRAP left round box 90%>メニュー <wrap :ja>**管理(Management) → {{:wiki:pfms-menu-resources_icon.svg?nolink&21x21}} リソース(Resources) → エージェント管理(Manage agents)**</wrap> で、エージェントの <wrap :ja>**表示(View)**</wrap> ショートカットをクリックします。</WRAP></WRAP>
-バージョン NG 770 以降
+<WRAP half column>この画面では、エージェントに関する多くの情報が提供され、リモートチェックの強制実行やデータの更新も可能です。最初のボックスには、エージェントの様々なデータの概要が表示されます。</WRAP>
 </WRAP>
-Using the [[:en:documentation:pandorafms:installation:03_interface#favorite|favorite system]] you can add any agent to a custom list for each user. Click the star button right next to the agent's name in your main view.
+  * Agent information, including: Name, group, IP address, operating system version, and agent version.
+  * Total number of modules and their status.
+  * Summary of the latest [[:en:documentation:pandorafms:management_and_operation:02_events|events]] from the agent, with active events and those that occurred in the last 8 and 24 hours.
+  * Summary of the [[:en:documentation:pandorafms:management_and_operation:01_alerts|alerts]] for the agent, with the option to view all of them.
+  * If applicable, the status of log sources as configured in [[:en:documentation:pandorafms:monitoring:09_log_monitoring|Log collection]].
+  * A box with tabs and filters for the lists of modules, alerts, and events.
-[[:ja:documentation:pandorafms:installation:03_interface#お気に入り|お気に入りシステム]] を使用すると、エージェントを各ユーザのカスタムリストに追加できます。 メイン画面のエージェント名のすぐ横にある星ボタンをクリックします。
+  * エージェント情報（名前、グループ、IP アドレス、OS バージョン、エージェントバージョンなど）。
+  * モジュールの総数とその状態。
+  * エージェントからの最新の [[:ja:documentation:pandorafms:management_and_operation:02_events|イベント]] の概要（アクティブなイベント、過去 8 時間と 24 時間に発生したイベントを含む）。
+  * エージェントの [[:ja:documentation:pandorafms:management_and_operation:01_alerts|アラート]] の概要（すべてのアラートを表示するオプション付き）。
+  * 該当する場合、[[:ja:documentation:pandorafms:monitoring:09_log_monitoring|ログ収集]] で設定されたログソースの状態。
+  * モジュール、アラート、イベントの一覧を表示するタブとフィルタ付きのボックス。
-{{  :wiki:pfms-menu-operation-favorite-agents.png  }}
+{{  :wiki:pfms-menu-operation-favorite-agents_2.png  }}
-You can add (or remove) as many agents as you need, all of them will always be visible in the **Agents**  section of the **Favorite**  menu (**Operation**  section).
+An agent can be pinned to the main menu by clicking the pin icon {{:wiki:pfms-icons-pin_enable.svg?nolink&21x21}} next to its name. It will then appear in the <wrap :en>**Operation → {{:wiki:pfms-operation-icon_pinned.svg?nolink&21x21}} Pinned → Agents**</wrap> menu. To unpin it, simply click on {{:wiki:pfms-icons-pin_disable.svg?nolink&21x21}}.
-必要な数のエージェントを追加 (または削除) できます。エージェントはすべて、**お気に入り(Favorite)** メニュー (**操作(Operation)** セクション) の **エージェント(Agents)** セクションに常に表示されます。
+エージェント名の横にあるピンアイコン {{:wiki:pfms-icons-pin_enable.svg?nolink&21x21}} をクリックすると、エージェントをメインメニューにピン留めできます。ピン留めすると、<wrap :ja>**操作(Operation) → {{:wiki:pfms-operation-icon_pinned.svg?nolink&21x21}} ピン留め(Pinned) → エージェント(Agents)**</wrap> メニューに表示されます。ピン留めを解除するには、{{:wiki:pfms-icons-pin_disable.svg?nolink&21x21}} をクリックします。
 <wrap #ks3 />
@@ 行 191: / 行 166: @@
 モジュールには、二値型、数値型、文字列型、[[:ja:documentation:pandorafms:installation:05_configuration_agents#module_type|その他]] いくつかのデータ型があります。
+<wrap #ks3_1 />
 ==== モジュールのタイプ ====
@@ 行 232: / 行 209: @@
 コマンドセンターを使用すると、モジュールグループの管理は [[:ja:documentation:pandorafms:command_center:06_operation#ks1_4|集中化されます]]。
+<wrap #ks3_3 />
 ==== 状態監視 ====
@@ 行 260: / 行 239: @@
 "警告" と "障害" のしきい値が重なっている場合は、"障害" しきい値が常に優先されます。
 </WRAP>
+<wrap #ks3_4 />
 === 数値しきい値 - ケーススタディ 1 ===
@@ 行 401: / 行 382: @@
 </WRAP>
-  * **Using module component**: When using a module component, it will be automatically populated with parameter values needed to perform monitoring, this token appears in all module types except for prediction modules.
+  * **Using module component**: When using a module component they will be automatically filled with parameter values necessary to perform the monitoring, this token appears in all types of modules, except in those of prediction.
-  * **Name**: Module name.
+  * **Module group**: Allows you to assign the module to a defined module group.
-  * **Disable**: It allows you to disable the module.
-  * **Module group**: It allows you to assign the module to a defined module group.
   * **Type**: [[:en:documentation:pandorafms:monitoring:02_operations#ks1_2|Type of module]] depending on the type of data returned. By selecting **Using module component**  the data type will be chosen automatically.
-  * **Warning threshold**  and **Critical threshold**: Thresholds that when reached by the returned value change the status of the module to **warning**  status or **critical**  status. You may use the **Inverse interval**  option to define that the warning/critical status //is any value outside this range//.
+  * **Change to critical status after **X** intervals in warning status**: (version 766 or later) This token allows you to promote a module's status change to critical __if it has been X times in a row__  (continuous monitoring intervals ) __in warning state__.
-  * **Change to critical status after **X** intervals in warning status**: From PFMS version 766 onwards there is the possibility to //promote//  the change to critical status of a module __if it has been in warning status N times in a row__  (continuous monitoring intervals) __in warning status__. The main difference with **FF threshold**  is that such functionality delays the status change while **Change to critical status after**  favors it. Always keep in mind that both options work in conjunction with each other.
+      * For example, if a value of ''2''  is placed: <wrap em>warning → warning → warning → CRITICAL</wrap>.
-  * **Historical data**: Check this option if you need to save the values in the [[:en:documentation:01_understanding:02_architecture#pandora_fms_database|history database]] for the long term.
+      * **Important**: This token works in conjunction with **FF threshold**, for example **Change to critical…**  to ''1''  and **FF threshold**  to ''1''  :
-  * **Target IP**  y **Port**: IP address and port number to query for monitoring values. In some cases, as for example with WMI monitoring, additional text fields will appear to establish connection credentials and even query strings.
+        * <wrap em>normal → normal → warning → warning → CRITICAL</wrap>.
+  * **Historical data**: Check this option if you need to save long-term values in the [[:en:documentation:pandorafms:introduction:02_architecture|databasehistorical cough]].
+  * **Target IP**  and **Port**: IP address and port number to which to query to obtain monitoring values. In some cases, such as with WMI monitoring, additional text fields will appear to set connection credentials and even query strings.
   * **モジュールコンポーネントの利用(Using module component):** Pandora FMS には、使用可能なデフォルトモジュールのレパートリーがあります。 選択したモジュールに応じて、監視を実行するために必要なパラメータが自動的に入力されます。 この設定は予測モジュールを除くすべてのタイプのモジュールにあります。
-  * **名前(Name)**: モジュール名。
-  * **無効化(Disable)**: モジュールを無効化できます。
   * **モジュールグループ(Module group)**: 定義済のモジュールグループにモジュールを割り当てることができます。
   * **タイプ(Type)**: 返されるデータのタイプに応じた[[:ja:documentation:pandorafms:monitoring:02_operations#ks1_2|モジュールのタイプ]]です。**モジュールコンポーネントの利用Using module component)** を選択すると、データタイプは自動的に選択されます。
-  * **警告閾値(Warning threshold)** および **障害閾値(Critical threshold)**: モジュールの状態が**警告**状態または**障害**状態に変更される値のしきい値。**条件の反転(Inverse interval)** を使うと、//範囲外//の場合に警告/障害状態になるように定義できます。
+  * **警告状態が **X** 間隔経過後に障害状態に変更(Change to critical status after **X** intervals in warning status)**: (バージョン 766 以降) このトークンを使用すると、モジュールが __連続して X 回__ (継続的な監視間隔) __警告状態__ になった場合に、モジュールの状態を障害に変更することができます。
-  * **警告状態 X 回後に障害状態に変更(Change to critical status after **X** intervals in warning status)**: Pandora FMS バージョン 766 以降では、__モジュールが連続して N 回警告状態が続いた場合(継続的な監視間隔)__に、モジュールを障害状態へ変更することができます。**連続抑制回数** との主な違いは、それがステータスの変更を遅らせるのに対し、**障害状態への変更** を優先することです。 両方のオプションが相互に連携して機能することを常に念頭に置いてください。
+      * たとえば、値 ''2'' が指定された場合は、<wrap ja>警告 → 警告 → 警告 → 障害</wrap> となります。
-  * **データの保存(Historical data)**: データを保存する場合にチェックします。
+      * **重要**: このトークンは **連続抑制回数** と連動します。**連続抑制回数** との主な違いは、それがステータスの変更を遅らせるのに対し、**障害状態への変更** を優先することです。たとえば、**障害状態に変更** を ''1'' に、**連続抑制回数** を ''1'' にすると次のようになります:
+        * <wrap ja>正常 → 正常 → 警告 → 警告 → 障害</wrap>。
+  * **データの保存(Historical data)**: [[:ja:documentation:pandorafms:introduction:02_architecture|ヒストリデータベース]]に長期的な値を保存する必要がある場合は、このオプションをオンにします。
   * **対象IP(Target IP)** および **ポート(Port)**: 監視対象の IP アドレスとポート番号。場合によっては、たとえば WMI 監視の場合のように、接続認証情報やクエリ文字列を設定するために追加のテキストフィールドが表示されます。
+<wrap #ks3_4_1 />
 === 高度なオプション ===
@@ 行 707: / 行 690: @@
 また、モジュールに特定のアクセス許可を付与するために使用することもできます。これにより、ユーザはエージェントの一つのモジュールのみに[[:ja:documentation:pandorafms:management_and_operation:11_managing_and_administration#タグで拡張された権限システム|エージェントの一つのモジュールのみにアクセスでき]]、残りのモジュールにはアクセスできないようにすることができます。
+<wrap #ks3_4_3 />
 === モジュール管理 ===
@@ 行 782: / 行 767: @@
   * Pandora FMS ユーザが **AW 権限**を持っている。
-[[ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]
+[[ja:documentation:pandorafms:start|Pandora FMS ドキュメント一覧に戻る]]