ja:documentation:pandorafms:installation:05_configuration_agents

差分

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

この比較画面へのリンク

両方とも前のリビジョン 前のリビジョン
次のリビジョン
前のリビジョン
ja:documentation:pandorafms:installation:05_configuration_agents [2026/05/22 23:17] – [ルール] junichija:documentation:pandorafms:installation:05_configuration_agents [2026/10/02 22:55] (現在) – [module_absoluteinterval] junichi
行 106: 行 106:
 ==== temporal_min_size ==== ==== temporal_min_size ====
  
-If the free space (in megabytes) of the partition where the temporary directory is located is less than this value (by default one megabyte), **the generation of data packets is stopped**. This prevents the disk from filling up if for some reason the connection to the primary and/or [[:en:documentation:02_installation:05_configuration_agents#secondary_server|secondary]] PFMS server is lost for an extended interval of time.+If the free space (in megabytes) of the partition where the temporary directory is located is less than this value (default five megabytes), **data packet generation stops**.
  
-テンポラリディレクトリのパーティション空き容量がここで指定したサイズ (MB 単位) より小さくなったら、**データパケットの生成を停止します。** (デフォルトは 1MB) 何らかの理由でプライマリおよび[[:ja:documentation:02_installation:05_configuration_agents#セカンダリサーバ|セカンダリ]]の Pandora FMS サーバへの接続が長時間切れた場合に、ディスクがいっぱいになるのを避けます。+一時ディレクトリが配置されているパーティションの空き容量(メガバイト単位)がこの値(デフォルトは 5メガバイト)を下回ると、**データパケットの生成が停止します**。
  
-<WRAP center round tip 90%>In the [[:en:documentation:04_using:02_events#general_information|Pandora FMS event view]] you will be able to know in a timely manner if a Software Agent, whatever the cause, has stopped delivering data to its main and/or secondary PFMS server, since in these cases its status becomes ''UNKNOWN''. See also, if desired, [[:en:documentation:04_using:01_alerts#step_2:conditions|the creation of alert conditions]]. +<code> 
- +# This limits operation if temporal dir has not enough free disk (in megabytes). 
-{{  :wiki:pfms-gitlab_ticket_7146.png  }} +#temporal_min_size 5 
- +</code>
-In this particular example with four days offline, monitoring data will be saved until only 1 megabyte (or the value you set) of free disk space is left.</WRAP> +
- +
-<WRAP center round tip 90%>[[:ja:documentation:04_using:02_events#一般情報|Pandora FMS イベント表示]]で、原因が何であれ、ソフトウェアエージェントがメインおよびセカンダリ Pandora FMS サーバへのデータ配信を停止したかどうかをタイムリーに知ることができます。この場合、その状態は ''不明'' になります。必要に応じて、[[:ja:documentation:04_using:01_alerts#ステップ_2状態|アラート条件の作成]]も参照してください。 +
- +
-{{  :wiki:pfms-gitlab_ticket_7146.png  }} +
- +
-4日間オフラインのこの例では、1メガバイト(または設定した値)の空きディスク容量が残るまで、監視データが保存されます。</WRAP> +
- +
-<WRAP center round important 60%>Because of the above, you should always keep in mind that when the Software Agent finally connects to its primary and/or secondary PFMS server, the amount of accumulated data may overload the [[:en:documentation:01_understanding:02_architecture#the_data_server|PFMS data server]].</WRAP>+
  
-<WRAP center round important 60%>上記の理由により、ソフトウェアエージェントが改めてプライマリおよびセカンダリ Pandora FMS サーバに接続するときに、蓄積された量のデータで[[:ja:documentation:01_understanding:02_architecture#データ_data_サーバ|Pandora FMS データサーバ]]の高負荷が発生する可能性があることに注意が必要です。</WRAP>+<wrap #ks3_7 />
  
 ==== temporal_max_size ==== ==== temporal_max_size ====
行 581: 行 572:
  
 </WRAP> </WRAP>
 +
 +==== default_native_encoding ====
 +
 +<code>
 +# Default value for module_native_encoding. Empty by default.
 +#default_native_encoding OEM
 +</code>
 +
 +**Unless a value has been explicitly set using** ''module_native_encoding'', this sets the value to be used for all instances of ''module_native_encoding'' appearing in a PFMS EndPoint’s configuration file. \\ Its default value is empty, so when //uncommenting// the token line, one of the supported options must be set (see [[#module_native_encoding|module_native_encoding]]).
 +
 +''module_native_encoding'' で値が明示的に設定されていない場合、この設定が PFMS エンドポイント設定ファイルに現れるすべての ''module_native_encoding'' の値として設定されます。\\ デフォルト値は空であるため、トークンの行のコメントを解除する際には、サポートされているオプションのいずれかを設定する必要があります([[#module_native_encoding|module_native_encoding]] を参照)。
 +
 +<wrap #ks4 />
  
 ===== セカンダリサーバ ===== ===== セカンダリサーバ =====
行 2502: 行 2506:
 <wrap #ks7_2_2 /> <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>
  
-<WRAP center round info 60%>+<WRAP center round info 90%>
  
-集中管理が有効なコマンドセンター(メタコンソール)に属するノードから自動設定管理を行おうとすると、リードオンリー表示になります。+中央管理が有効になっているコマンドセンターに属するノードでは、画面は読み取り専用になります。
  
 </WRAP> </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 custom event**)
   - アラートアクションを実行する (**Launch alert action**)   - アラートアクションを実行する (**Launch alert action**)
-  - スクリプトを実行する (**Launch script**)+  - 場所とパラメータを指定してスクリプトを実行する (**Launch script**)
  
 The system supports the following macros: The system supports the following macros:
行 2544: 行 2554:
 システムは、次のマクロをサポートします。 システムは、次のマクロをサポートします。
  
-   * ''_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 エンドポイント ===== ===== Unix/Linux エンドポイント =====
行 2567: 行 2579:
 把握しておくべき基本的なファイルとディレクトリは次のとおりです。 把握しておくべき基本的なファイルとディレクトリは次のとおりです。
  
-  * ''/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''   * ''/usr/share/pandora_agent'' : Pandora FMS エンドポイントがインストールされる場所です。厳密なシステムポリシーがあり、ここにインストールできないシステムでは、実際のインストールパスからこのパスへのリンクを作成することを推奨します。例: ''/opt/pandora'' → ''/usr/share/pandora_agent''
行 2586: 行 2598:
   * ''/etc/pandora/plugins'' : エージェントプラグインを置くディレクトリです。これは ''/usr/share/pandora_agent/plugins''  にリンクされています。   * ''/etc/pandora/plugins'' : エージェントプラグインを置くディレクトリです。これは ''/usr/share/pandora_agent/plugins''  にリンクされています。
   * ''/etc/pandora/collections'' : エージェントのコレクションを置くディレクトリです。これは ''/usr/share/pandora_agent/collections''  にリンクされています。   * ''/etc/pandora/collections'' : エージェントのコレクションを置くディレクトリです。これは ''/usr/share/pandora_agent/collections''  にリンクされています。
 +
 +<wrap #ks8_2 />
  
 ==== Unix エンドポイントの初期実行 ==== ==== 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 systemctl start pandora_agent_daemon
- 
 </code> </code>
  
-To stop the EndPoint, run:+To stop the EndPoint:
  
 エンドポイントの停止は以下のようにします。 エンドポイントの停止は以下のようにします。
  
-<code>+<code bash>
 systemctl stop pandora_agent_daemon 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> </code>
 + \\ 
 +</WRAP>
  
-起動スクリプトで Pandora FMS エージェントの起動・停止ができます。デフォルトでは起動後はデーモーンとして動作します。+<WRAP center round tip 90%> 
 + 
 +エンドポイントがオペレーティングシステムの起動時に毎回実行されるようにするには、一度だけ実行してください。 
 + 
 +<code bash> 
 +systemctl enable pandora_agent_daemon 
 +</code> 
 + \\  
 +</WRAP>
  
 <wrap #ks8_3 /> <wrap #ks8_3 />
行 2805: 行 2838:
  
 </code> </code>
 +
 +<wrap #ks9_3 />
  
 ==== MS Windows でのエンドポイントセキュリティオプション ==== ==== MS Windows でのエンドポイントセキュリティオプション ====
  • ja/documentation/pandorafms/installation/05_configuration_agents.1779491868.txt.gz
  • 最終更新: 2026/05/22 23:17
  • by junichi