差分

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

この比較画面へのリンク

両方とも前のリビジョン 前のリビジョン
次のリビジョン
前のリビジョン
ja:documentation:pandorafms:technical_reference:06_anexo_agent_plugins [2024/10/11 22:18] – [エージェントプラグインの基本機能] junichija:documentation:pandorafms:technical_reference:06_anexo_agent_plugins [2025/07/19 07:37] (現在) – [デバッグモード] junichi
行 8: 行 8:
 ===== エージェントプラグインの基本機能 ===== ===== エージェントプラグインの基本機能 =====
  
-The //agent //plugin **is run by Pandora FMS Software Agent** so it has to have some special features:+The //agent //plugin **is run by Pandora FMS EndPoint** so it has to have some special features:
  
-//エージェント//プラグインは、**Pandora FMS ソフトウアエージェントで実行され**、いくつかの特別な機能があります。+//エージェント//プラグインは、**Pandora FMS エンドポイントで実行され**、いくつかの特別な機能があります。
  
    * Each plugin execution may return one or more modules with their corresponding values. The output must be in [[#ks3_5|XML format]].    * Each plugin execution may return one or more modules with their corresponding values. The output must be in [[#ks3_5|XML format]].
   * It will be possible to access local machine resources local or remote machine resources.   * It will be possible to access local machine resources local or remote machine resources.
-  * It is possible to use any type of programming language supported by the operating system where the Pandora FMS software agent is installed.+  * It is possible to use any type of programming language supported by the operating system where the Pandora FMS EndPoint is installed.
   * All dependencies or software needed to run the plugin must be available or installed in the same machine that runs Pandora FMS agent.   * All dependencies or software needed to run the plugin must be available or installed in the same machine that runs Pandora FMS agent.
  
   * それぞれのプラグインの実行では、一つまたは複数のモジュールの値を返します。出力は後述する XML フォーマットである必要があります。   * それぞれのプラグインの実行では、一つまたは複数のモジュールの値を返します。出力は後述する XML フォーマットである必要があります。
   * ローカルマシンのリソースおよび、リモートで他のマシンのリソースの両方にアクセスすることができます。   * ローカルマシンのリソースおよび、リモートで他のマシンのリソースの両方にアクセスすることができます。
-  * Pandora ソフトウアエージェントがインストールされている OS でサポートしている、任意のプログラミング言語を利用することができます。 +  * Pandora FMS ンドポイントがインストールされている OS でサポートしている、任意のプログラミング言語を利用することができます。 
-  * プラグインを実行するために必要な依存プログラムは、Pandora ソフトウアエージェントを実行するのと同じマシンにインストールされている必要があります。+  * プラグインを実行するために必要な依存プログラムは、Pandora FMS ンドポイントを実行するのと同じマシンにインストールされている必要があります。
  
 Agent plugins may perform a kind of recon task since the plugin may return several modules in one run and the number may change between different runs. Agent plugins may perform a kind of recon task since the plugin may return several modules in one run and the number may change between different runs.
行 187: 行 187:
 このプラグインから返されるモジュール数は、設定したファイルシステムの数に依存し、実行ごとに変更することができます。 このプラグインから返されるモジュール数は、設定したファイルシステムの数に依存し、実行ごとに変更することができます。
  
-The XML fragment is added to the general XML generated by the software agent and is sent to the Pandora FMS server to be processed by the **Data Server**.+The XML fragment is added to the general XML generated by the EndPoint and is sent to Pandora FMS server to be processed by the **Data Server**.
  
-この XML がソフトウアエージェントが生成する全体の XML に追加され、Pandora サーバへ送信され、**データサーバ** にて処理されます。+この XML がエンドポイントが生成する全体の XML に追加され、Pandora FMS サーバへ送信され、**データサーバ** にて処理されます。
  
 <wrap #ks4 /> <wrap #ks4 />
行 203: 行 203:
 ==== pandora_agent.conf の修正 ==== ==== pandora_agent.conf の修正 ====
  
-The Software Agent requires a line in this file with the **correct path** of the plugin.+The EndPoint requires a line in this file with the **correct path**  of the plugin.
  
-ソフトウアエージェントでは、プラグインの **正しいパス** がこのファイル内に書かれている必要があります。+ンドポイントでは、プラグインの **正しいパス** がこのファイル内に書かれている必要があります。
  
 Example: Example:
行 224: 行 224:
 ==== pandora_agent_daemon の再起動 ==== ==== pandora_agent_daemon の再起動 ====
  
-The Software Agent will run the plugins every 5 minutes and it is possible to restart the Software Agent with user **root** or equivalent from the command line:+The EndPoint will run the plugins every 5 minutes and it is possible to restart the EndPoint with the **root** user or equivalent from the command line:
  
-ソフトウアエージェントは 5分ごとにプラグインを実行します。次回の実行まで待てない場合は、コマンドラインからソフトウアエージェントを再起動します。+ンドポイントは 5分ごとにプラグインを実行します。次回の実行まで待てない場合は、コマンドラインからエンドポイントを再起動します。
  
 <code bash> <code bash>
-/etc/init.d/pandora_agent_daemon restart+systemctl restart pandora_agent_daemon 
  
 </code> </code>
行 274: 行 275:
 ==== デバッグモード ==== ==== デバッグモード ====
  
-You can activate the development mode by changing the value of the debug tag in the ''pandora_agent.conf'' file from ''0'' to ''1''. Once you have done this, when the Software Agent executes the plugin, the results will be saved in an XML document with all the agent information.+You may activate the development mode by changing the value of the debug tag in the ''pandora_agent.conf''  file from ''0''  to ''1''. Once done, when the EndPoint runs the plugin, the results will be saved in an XML document with all the agent information.
  
-''pandora_agent.conf'' ファイル内で、debug の値を ''0'' から ''1'' に変更することで、デバッグモードを有効にすることができます。これを行うと、ソフトウアエージェントがプラグインを実行した結果が、エージェントのその他の情報とあわせて xml ファイルに保存されます。+''pandora_agent.conf'' ファイル内で、debug の値を ''0'' から ''1'' に変更することで、デバッグモードを有効にすることができます。これを行うと、エンドポイントがプラグインを実行した結果が、エージェントのその他の情報とあわせて xml ファイルに保存されます。
  
-The name of the document will be the name of the agent with the extension ''.data''and it will be located in the '''tmp''' directory (you should check the log of the PFMS agent in ''/var/log/pandora/pandora_agent.log''). By reviewing the document, you will be able to see if the plugin data is being collected and if it is as expected.+The name of the document will be the name of the agent with the ''.data'' extension and it will be located in the '''tmp''' directory (you should check PFMS agent log in ''/var/log/pandora/pandora_agent.log''). By double checking the document, you will be able to see whether the plugin data is being collected and if it is as expected.
  
 ファイル名は、エージェント名と ''.data'' を含むもので、''tmp'' ディレクトリに保存されます(Pandora FMS エージェントのログは、''/var/log/pandora/pandora_agent.log'' を確認してください)。内容を確認し、期待したプラグインの実行結果が含まれているかどうかを見ます。 ファイル名は、エージェント名と ''.data'' を含むもので、''tmp'' ディレクトリに保存されます(Pandora FMS エージェントのログは、''/var/log/pandora/pandora_agent.log'' を確認してください)。内容を確認し、期待したプラグインの実行結果が含まれているかどうかを見ます。
  • ja/documentation/pandorafms/technical_reference/06_anexo_agent_plugins.1728685099.txt.gz
  • 最終更新: 2024/10/11 22:18
  • by junichi