差分

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

--- ja:documentation:pandorafms:installation:05_configuration_agents [2026/05/22 23:04] – [概要] junichi
+++ ja:documentation:pandorafms:installation:05_configuration_agents [2026/05/22 23:30] (現在) – [MS Windows での基本エンドポイントオプション] junichi
@@ 行 2380: / 行 2380: @@
 ==== 自動エージェント設定の作成/編集 ====
-**Console**
+<WRAP group>
+<WRAP half column><WRAP left round box 90%>Nodes:  \\ Menu <wrap :en>**Management → {{:wiki:pfms-configuration_icon.svg?nolink&21x21}} Configuration → Manage agent autoconfiguration**</wrap>.</WRAP>
+</WRAP>
+<WRAP half column><WRAP left round box 90%>Command Center:  \\ Menu <wrap :en>**Centralised management → Agent management → {{:wiki:pfms-command_center-agent_autoconfiguration-icon.png?nolink&21x21}} Agent autoconfiguration**</wrap>.</WRAP>
+</WRAP>
+</WRAP>
-**コンソール**
+<WRAP group>
+<WRAP half column><WRAP left round box 90%>ノード: \\ メニュー <wrap :ja>**管理(Management) → {{:wiki:pfms-configuration_icon.svg?nolink&21x21}} 設定(Configuration) → エージェント自動設定管理(Manage agent autoconfiguration)**</wrap>.</WRAP>
+</WRAP>
+<WRAP half column><WRAP left round box 90%>コマンドセンター: \\ メニュー <wrap :ja>**中央管理(Centralised management) → エージェント管理(Agent management) → {{:wiki:pfms-command_center-agent_autoconfiguration-icon.png?nolink&21x21}} エージェント自動設定(Agent autoconfiguration)**</wrap>.</WRAP>
+</WRAP>
+</WRAP>
-Access the management of automatic configurations through **Configuration** → **Manage agent autoconfiguration**.
+By accessing the administration page, you can create new automatic configurations by pressing the <wrap :en>**Add new configuration definition**</wrap> button to establish the //autoconfiguration general data//.
-自動設定画面へは **設定(Configuration)** → **自動エージェント設定管理(Manage agent autoconfiguration)** からアクセスします。
+管理ページにアクセスして、<wrap :ja>**新しい設定定義を追加(Add new configuration definition)**</wrap>ボタンを押して、//自動設定の一般データ//を設定することで、新しい自動設定を作成できます。
-**Metaconsole**
+You must choose a name and an execution mode: immediate (<wrap :en>**Start**</wrap> option by default) or periodically (<wrap :en>**Scheduled**</wrap>, daily, weekly, or monthly calendar options will appear). Click the <wrap :en>**Create**</wrap> button to save and enter editing mode. If you wish to change any of the three previous fields, you must click the <wrap :en>**Update**</wrap> button (only to save general data).
-**メタコンソール**
+名前と実行モードを選択する必要があります。即時実行（デフォルトでは **開始(Start)** オプション）または定期実行（**スケジュール済み**、日次、週次、月次のカレンダーオプションが表示されます）から選択してください。**作成(Create)** ボタンをクリックして保存し、編集モードに入ります。上記の 3つのフィールドのいずれかを変更する場合は、**更新(Update)** ボタンをクリックしてください（一般的なデータのみ保存されます）。
-Go to **Centralized management** → **Agent management** → automatic agent configuration icon.
+Once an automatic configuration is created (or during its subsequent edition), the configuration forms can be displayed by clicking on the required section:
-**中央管理(Centralized management)** → **エージェント管理(Agent management)** → エージェント自動設定アイコン:
+自動設定が作成されると（またはその後の編集時に）、必要なセクションをクリックすることで設定フォームを表示できます。
-By accessing the administration page you can create new automatic configurations by pressing the **Add new configuration definition** button. You will need to choose a name and description for your automatic configuration.
+  * <wrap :en>[[#ks7_2_1|Rules]]</wrap>.
+  * <wrap :en>[[#ks7_2_2|Agent autoconfiguration]]</wrap>.
+  * <wrap :en>[[#ks7_2_3|Extra actions]]</wrap>.
+  * **These three sections have their own independent creation, editing, and deletion buttons for their elements**.
-管理ページにアクセスしたら、**新たな設定定義の追加(Add new configuration definition)** ボタンをクリックすることにより新たな自動設定を作成することができます。自動設定の名前と説明を設定します。
+  * <wrap :en>[[#ks7_2_1|ルール(Rules)]]</wrap>
+  * <wrap :en>[[#ks7_2_2|エージェントの自動設定(Agent autoconfiguration)]]</wrap>
+  * <wrap :en>[[#ks7_2_3|追加アクション(Extra actions)]]</wrap>
+  * **これら 3つのセクションには、それぞれの要素に対して独立した作成、編集、削除ボタンがあります。**
-Once the new auto configuration is created, you can display the configuration forms by clicking on the section you need: **Rules**, **Agent autoconfiguration** or **Extra actions**.
+<WRAP center round info 90%>
-新たな自動設定を作成したら、必要な項目 (**ルール(Rules)**、**エージェント自動設定(Agent autoconfiguration)**、**追加アクション(Extra actions)**) をクリックすることにより設定フォームを表示できます。
+In nodes that belong to a Command Center with centralized management active, the view will be read-only. In a Command Center where the [[:en:documentation:pandorafms:command_center:04_command|Merging Tool]] is pending to be applied for the first time, it will be unable to create agent autoconfigurations for its future nodes.
+</WRAP>
+<WRAP center round info 90%>
+中央管理が有効になっているコマンドセンターに属するノードでは、画面は読み取り専用になります。[[:ja:documentation:pandorafms:command_center:04_command|マージツール]]が初めて適用される予定のコマンドセンターでは、将来のノード用のエージェント自動設定を作成できません。
+</WRAP>
+<wrap #ks7_2_1 />
 === ルール ===
-To define the EndPoints to which the automatic configuration will be applied, you can first add rules to identify them.
+To define the EndPoints on which the automatic configuration will be applied, rules must be added to identify them.
 自動設定が適用されるエンドポイントを定義するには、まずエンドポイントを識別するルールを追加します。
-Expand the rules section within your automatic configuration, and select **Add new rule**. You can choose a series of options in the rules selector to identify the EndPoints that are going to be configured.
+<WRAP center round tip 90%>
-自動設定内のルールセクションを展開し、**新しいルールの追加(Add new rule)** を選択します。 ルールセレクターで一連のオプションを選択して、設定するエンドポイントを識別できます。
+If no rule is added, **the automatic configuration will not be applied**. If a single configuration is needed for all agents, the regular expression ''.*'' can be used to match any //alias//.
-  * **Server name**: Match on server name.
+</WRAP>
-  * **Group name**: Match on group name.
-  * **OS**: Match operating system name using regular expressions.
+<WRAP center round tip 90%>
-  * **Custom field**: Match by key/value based on a custom field reported by the EndPoint. Indicate the name of the custom field and the value it should have.
-  * **IP range**: Match by range of IP (network) addresses, use IP/mask notation.
+ルールが追加されない場合、**自動設定は適用されません**。すべてのエージェントに単一の設定が必要な場合は、正規表現 ''.*'' を使用して任意の別名に一致させることができます。
-  * **Script output (> 0)**: Intended to execute a script whose execution result is evaluated as valid when the standard output is greater than 0.
-  * **Rules script call**: Supports the following macros in the 'arguments' field (you can choose between ''AND'' and ''OR'' operators to modify the logic of the rules):
+</WRAP>
-      * ''_agent_'' **:**  Will be replaced by the name of the Agent.
-      * ''_agentalias_'' **:** Will be replaced by the Agent's alias.
+Expand the rules section and click <wrap :en>**Add rule**</wrap>. A series of options can be chosen in the rule selector to identify the EndPoints to be configured.
-      * ''_address_'' **:** Will be replaced by the primary IP address reported by the Agent.
-      * ''_agentgroup_'' **:** Will be replaced by the name of the group reported by the Agent.
+自動設定内のルールセクションを展開し、**ルールの追加(Add rule)** を選択します。 ルールセレクターで一連のオプションを選択して、設定するエンドポイントを識別できます。
-      * ''_agents_'' **:** Will be replaced by the Agent operating system.
+  * <wrap :en>**Server name**</wrap>: Match by server name.
+  * <wrap :en>**Group name**</wrap>: Match by group name.
+  * <wrap :en>**Secondary group name**</wrap>: Match by a secondary group name.
+  * <wrap :en>**OS**</wrap>: Match by operating system name using regular expressions.
+  * <wrap :en>**Alias**</wrap>: Match by alias. //The regular expression ''.*'' can be used to match any alias//.
+  * <wrap :en>**Custom field**</wrap>: Match by key/value based on a custom field reported by the EndPoint. Indicate the custom field name and the value it must have.
+  * <wrap :en>**IP range**</wrap>: Match by IP address range (network), use IP/mask notation.
+  * <wrap :en>**Script output (> 0)**</wrap>: Designed to execute a //script// whose execution result is evaluated as valid when the standard output is greater than ''0''.
+  * **Rule //script// call**: It supports the following macros in the 'arguments' field (you can choose between ''AND'' and ''OR'' operators to modify the logic of the rules relative to each other):
+  - ''_agent_'': It will be replaced by the Agent name.
+  - ''_agentalias_'': It will be replaced by the Agent alias.
+  - ''_address_'': It will be replaced by the main IP address reported by the Agent.
+  - ''_agentgroup_'': It will be replaced by the group name reported by the Agent.
+  - ''_agentos_'': It will be replaced by the Agent operating system.
    * **Server name**: マッチするサーバ名
    * **Group name**: マッチするグループ名
+   * **Secondary group name**: マッチするセカンダリグループ名
    * **OS**: マッチする OS 名 (正規表現)
+   * **Alias**: 別名で一致します。//正規表現 ''.*'' は任意の別名に一致させる目的で使用できます//。
    * **Custom field**: エンドポイントが報告してくる、キー/値 のカスタムフィールドマッチ。カスタムフィールド名と値を指定する必要があります。
    * **IP range**: IP の範囲(ネットワーク)にマッチ。IP/ネットマスク の書式を追加います。
    * **Script output (> 0)**: スクリプトの実行結果で、標準出力の結果が 0より大きい場合にルールにマッチしたと評価されます。
    * **Rules script call**: 'arguments' フィールドに次のマクロが使えます。(演算子 ''AND'' と ''OR'' のどちらかを選択して、ルールロジックを変更できます)
-       * ''_agent_'' **:**  エージェント名に置き換えられます。
-       * ''_agentalias_'' **:**  エージェントの別名に置き換えられます。
-       * ''_address_'' **:**  エージェントから報告された IP アドレスに置き換えられます。
-       * ''_agentgroup_'' **:**  エージェントから報告されたグループ名に置き換えられます。
-       * ''_agentos_'' **:**  エージェントの OS で置き換えられます。
-<WRAP center round tip 60%>
+   - ''_agent_'':   エージェント名に置き換えられます。
+   - ''_agentalias_'':  エージェントの別名に置き換えられます。
+   - ''_address_'':  エージェントから報告された IP アドレスに置き換えられます。
+   - ''_agentgroup_'':  エージェントから報告されたグループ名に置き換えられます。
+   - ''_agentos_'':  エージェントの OS で置き換えられます。
-If you don't add any rules, the automatic settings will not be applied. If you need a single configuration for all agents, you can use the following regular expression to match any alias: ''.*''</WRAP>
+Finally, you must click <wrap :en>**Create rule**</wrap> to save the changes, without the need to click the <wrap :en>**Update**</wrap> button.
-<WRAP center round tip 60%>ルールが無い場合は、自動設定は適用されません。全てのエージェントに対して一つの設定でよい場合は、すべての別名にマッチする正規表現 ''.*''  を使うことができます。</WRAP>
+最後に、<wrap :ja>**ルールの作成(Create rule)**</wrap>をクリックして変更を保存する必要があります。<wrap :ja>**更新(Update)**</wrap>ボタンをクリックする必要はありません。
+<WRAP center round info 90%>
+In nodes that belong to a Command Center with centralized management active, the view will be read-only.
+</WRAP>
+<WRAP center round tip 90%>
+中央管理が有効になっているコマンドセンターに属するノードでは、画面は読み取り専用になります。
+</WRAP>
 <wrap #ks7_2_2 />
-=== 設定 ===
+=== エージェント自動設定 ===
-  * **Agent Group**: You may keep it unchanged or force it to be a specific one.
+  * <wrap :en>**New group**</wrap>: You can keep it without changes (<wrap :en>**No change**</wrap>, default option) or force it to belong to a specific group.
-  * **Secondary Groups**: The groups selected here will be added as secondary groups to the Agent.
+  * <wrap :en>**Secondary groups**</wrap>: The groups selected here will be added as secondary groups to the Agent. //Avoid repeating secondary groups in the selection//.
-  * **Configuration Block**: It adds the extra raw configuration to the Agent configuration file.
+  * <wrap :en>**Policy configuration**</wrap>: One or several [[:en:documentation:pandorafms:complex_environments_and_optimization:02_policy|monitoring policies]] can be selected to be applied automatically when the Agent //reaches// the PFMS Server. If there are several monitoring policies, a priority (zero by default) can be specified and those with a higher numerical value will be applied first (using unique values is recommended).
-  * **Policies**: You may select policies to be applied automatically when the Agent reaches the server. If there are several monitoring policies, you may specify a priority (zero by default) and the ones with the highest numerical value will be applied first (it is recommended to use singular values).
+  * <wrap :en>**Edit configuration block**</wrap>: Adds the extra configuration //in raw format// to the Agent configuration file (the EndPoint must have remote configuration enabled).
-   * **エージェントグループ(Agent Group)**: 変更せずにそのままとするか、強制的に変更します。
+  * <wrap :ja>**新規グループ(New group)**</wrap>: 変更せずにそのまま保持するか（<wrap :ja>**変更なし(No change)**</wrap>、デフォルトオプション）、特定のグループに強制的に所属させることができます。
-   * **セカンダリグループ(Secondary Group)**: エージェントにセカンダリグループとして追加するグループを選択します。
+  * <wrap :ja>**セカンダリグループ(Secondary Group)**</wrap>: ここで選択したグループは、エージェントのセカンダリグループとして追加されます。//選択時にセカンダリグループを重複させないようにしてください//。
-   * **設定ブロック(Configuration Block)**: エージェントの設定ファイルに追加する設定内容です。
+  * <wrap :ja>**ポリシー設定(Policy configuration)**</wrap>: エージェントが PFMS サーバに到達した際に自動的に適用される [[:ja:documentation:pandorafms:complex_environments_and_optimization:02_policy|監視ポリシー]]を 1つまたは複数選択できます。監視ポリシーが複数ある場合は、優先度（デフォルトは 0）を指定できます。数値が大きいポリシーが優先的に適用されます（一意の値を使用することをお勧めします）。
-   * **ポリシー(Policies)**: エージェントがサーバに接続してきたときに適用するポリシーを選択できます。監視ポリシーが複数ある場合は、優先順位（デフォルトではゼロ）を指定すると、数値が最も高いポリシーが最初に適用されます（単数値を使用することをお勧めします）。
+  * <wrap :ja>**設定ブロックの編集(Edit configuration block)**</wrap>: 追加の設定を //生の形式//でエージェント設定ファイルに追加します (エンドポイントでリモート設定が有効になっている必要があります)。
-<WRAP center round info 60%>
+The first time you add an agent autoconfiguration, you must use the <wrap :en>**Create**</wrap> button. Afterward, an <wrap :en>**Update**</wrap> button will appear, //which is different from the// <wrap :en>**Update**</wrap> //button used for the general autoconfiguration data//.
-If you try to access the automatic configuration administration from a node that belongs to a Command Center (Metaconsole), with centralized administration active, the view will be read-only.
+エージェントの自動設定を初めて追加するときは、<wrap :ja>**作成(Create)**</wrap> ボタンを使用する必要があります。その後、<wrap :ja>**更新(Update)**</wrap> ボタンが表示されます。//これは、//一般的な自動設定データに使用される<wrap :ja>**更新(Update)**</wrap> //ボタンとは異なります//。
+<WRAP center round info 90%>
+In nodes that belong to a Command Center with centralized management active, the view will be read-only.
 </WRAP>
-<WRAP center round info 60%>
+<WRAP center round info 90%>
-集中管理が有効なコマンドセンター(メタコンソール)に属するノードから自動設定管理を行おうとすると、リードオンリー表示になります。
+中央管理が有効になっているコマンドセンターに属するノードでは、画面は読み取り専用になります。
 </WRAP>
+<wrap #ks7_2_3 />
 === 追加アクション ===
-From this section you can associate other actions to the autoconfiguration, such as:
+From this section, you can associate other additional actions to the autoconfiguration:
 ここでは、自動設定に追加のアクションを行うことができます。例えば以下のような処理です。
-   - Launch a custom event (**Launch custom event**).
+  - Launch a custom event (<wrap :en>**Launch custom event**</wrap>).
-   - Execute an alert action (**Launch alert action**).
+  - Execute an alert action (<wrap :en>**Launch alert action**</wrap>).
-   - Execute a script (**Launch script**).
+  - Run a //script// (<wrap :en>**Launch script**</wrap>) specifying the location and parameters.
   - 独自イベントを出す (**Launch custom event**)
   - アラートアクションを実行する (**Launch alert action**)
-  - スクリプトを実行する (**Launch script**)
+  - 場所とパラメータを指定してスクリプトを実行する (**Launch script**)
 The system supports the following macros:
@@ 行 2490: / 行 2550: @@
 システムは、次のマクロをサポートします。
-   * ''_agent_'' Will be replaced by the name of the Agent.
+  * ''_agent_'': It will be replaced by the Agent name.
-   * ''_agentalias_'' Will be replaced by the Agent's alias.
+  * ''_agentalias_'': It will be replaced by the Agent alias.
-   * ''_address_'' Will be replaced by the primary IP address reported by the agent.
+  * ''_address_'': It will be replaced by the main IP address reported by the agent.
-   * ''_agentgroup_'' Will be replaced by the name of the group reported by the Agent.
+  * ''_agentgroup_'': It will be replaced by the group name reported by the Agent.
-   * ''_togentos_'' Will be replaced by the Agent operating system.
+  * ''_agentos_'': It will be replaced by the Agent operating system.
-   * ''_agentid_'' Replaced by the Agent ID.
+  * ''_agentid_'': It is replaced by the Agent ID.
+  * ''_agent_'': エージェント名に置き換えられます。
+  * ''_agentalias_'': エージェントの別名に置き換えられます。
+  * ''_address_'': エージェントが報告した IP アドレスに置き換えられます。
+  * ''_agentgroup_'': エージェントが報告したグループ名に置き換えられます。
+  * ''_agentos_'': エージェントの OS に置き換えられます。
+  * ''_agentid_'':  エージェント ID に置き換えられます。
-   * ''_agent_'' エージェント名に置き換えられます。
+<wrap #ks8 />
-   * ''_agentalias_'' エージェントの別名に置き換えられます。
-   * ''_address_'' エージェントが報告した IP アドレスに置き換えられます。
-   * ''_agentgroup_'' エージェントが報告したグループ名に置き換えられます。
-   * ''_togentos_'' エージェントの OS に置き換えられます。
-   * ''_agentid_'' エージェント ID に置き換えられます。
 ===== Unix/Linux エンドポイント =====
@@ 行 2513: / 行 2575: @@
 把握しておくべき基本的なファイルとディレクトリは次のとおりです。
-  * ''/usr/share/pandora_agent'': Where the Pandora FMS EndPoint is installed. On systems where this is not allowed by policy, it is recommended to create a link to this path from the actual installation path, for example ''/opt/pandora''  → ''/usr/share/pandora_agent''.
+  * ''/usr/share/pandora_agent'': Path where the Pandora FMS EndPoint is installed. In systems where this is not allowed due to policies, it is recommended to create a link to this path from the actual installation path, \\ for example ''/opt/pandora'' → ''/usr/share/pandora_agent''. \\ \\
-  * ''/etc/pandora/pandora_agent.conf'': Main configuration file of the EndPoint. Local Runtime Modules and EndPoint plugins are configured here.
+  * ''/etc/pandora/pandora_agent.conf'': Main EndPoint configuration file. Local execution Modules and EndPoint plugins are configured here. \\ \\
-  * ''/usr/local/bin/pandora_agent'': EndPoint executable binary. It usually has a link to ''/usr/bin/pandora_agent''.
+  * ''/usr/local/bin/pandora_agent'': Path to the EndPoint executable binary. It generally has a link to ''/usr/bin/pandora_agent''. \\ \\
-  * ''/usr/local/bin/tentacle_client'': Tentacle executable binary, for file transfer to the server. It usually has a link to ''/usr/bin/tentacle_client''.
+  * ''/usr/local/bin/tentacle_client'': Path to the Tentacle executable binary, for file transfer to the server. \\ It generally has a link to ''/usr/bin/tentacle_client''. \\ \\
-  * ''systemctl pandora_agent_daemon'': Script start/stop/restart.
+  * ''systemctl pandora_agent_daemon'': Start/stop/restart //script//.
-      * **On AIX systems the daemon is** ''/etc/rc.pandora_agent_daemon''.
+      * **In AIX systems the //daemon// is** ''/etc/rc.pandora_agent_daemon''. \\ \\
-  * ''/var/log/pandora/pandora_agent.log'': Text file where the activity of the Pandora FMS EndPoint is saved, when the EndPoint runs in debugging mode.
+  * ''/var/log/pandora/pandora_agent.log'': Text file where Pandora FMS EndPoint activity is saved when the EndPoint runs in debug mode. \\ \\
-  * ''/etc/pandora/plugins'': Directory that contains the agent plugins. It is linked to the ''/usr/share/pandora_agent/plugins'' directory.
+  * ''/etc/pandora/plugins'': Directory containing the EndPoint plugins. It is linked to the ''/usr/share/pandora_agent/plugins'' directory. \\ \\
-  * ''/etc/pandora/collections'': Directory containing the collections deployed to the Agent. It is linked to the ''/usr/share/pandora_agent/collections'' directory.
+  * ''/etc/pandora/collections'': Directory containing the collections deployed to the EndPoint. It is linked to the ''/usr/share/pandora_agent/collections''. \\ \\
   * ''/usr/share/pandora_agent'' : Pandora FMS エンドポイントがインストールされる場所です。厳密なシステムポリシーがあり、ここにインストールできないシステムでは、実際のインストールパスからこのパスへのリンクを作成することを推奨します。例: ''/opt/pandora'' → ''/usr/share/pandora_agent''
@@ 行 2532: / 行 2594: @@
   * ''/etc/pandora/plugins'' : エージェントプラグインを置くディレクトリです。これは ''/usr/share/pandora_agent/plugins''  にリンクされています。
   * ''/etc/pandora/collections'' : エージェントのコレクションを置くディレクトリです。これは ''/usr/share/pandora_agent/collections''  にリンクされています。
+<wrap #ks8_2 />
 ==== Unix エンドポイントの初期実行 ====
-To start the EndPoint it is only necessary to execute:
+To start the EndPoint, it is necessary to run:
 エンドポイントの起動は以下のようにします。
-<code>
+<code bash>
 systemctl start pandora_agent_daemon
 </code>
-To stop the EndPoint, run:
+To stop the EndPoint:
 エンドポイントの停止は以下のようにします。
-<code>
+<code bash>
 systemctl stop pandora_agent_daemon
+</code>
+This startup script can start or stop the Pandora FMS EndPoint, which when started will run by default in the system as a daemon.
+この起動スクリプトは、Pandora FMS エンドポイントを起動または停止できます。起動すると、デフォルトではシステム内でデーモンとして実行されます。
+<WRAP center round tip 90%>
+To ensure that the EndPoint runs every time the operating system starts, simply run it once:
+<code bash>
+systemctl enable pandora_agent_daemon
 </code>
+ \\
+</WRAP>
-起動スクリプトで Pandora FMS エージェントの起動・停止ができます。デフォルトでは起動後はデーモーンとして動作します。
+<WRAP center round tip 90%>
+エンドポイントがオペレーティングシステムの起動時に毎回実行されるようにするには、一度だけ実行してください。
+<code bash>
+systemctl enable pandora_agent_daemon
+</code>
+ \\
+</WRAP>
 <wrap #ks8_3 />
@@ 行 2751: / 行 2834: @@
 </code>
+<wrap #ks9_3 />
 ==== MS Windows でのエンドポイントセキュリティオプション ====