差分

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

--- ja:documentation:03_monitoring:02_operations [2022/09/28 05:08] – [画像の監視と表示] junichi
+++ ja:documentation:03_monitoring:02_operations [2024/01/15 02:27] – [プロキシモード] junichi
@@ 行 1: / 行 1: @@
-====== ソフトウエアエージェントを使ったモニタリング ======
+====== ソフトウエアエージェントを使った監視 ======
 {{indexmenu_n>2}}
@@ 行 5: / 行 5: @@
 [[:ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]
-===== ソフトウエアエージェントを使ったモニタリング =====
+===== ソフトウエアエージェントを使った監視 =====
-==== ソフトウエアエージェントを使った監視 ====
+The Software Agents are running on the operating systems from which they collect information, performing a **check** for each **module**.
-{{  :wiki:agent-monitoring.png?400  }}
+ソフトウェアエージェントは、情報を収集するオペレーティングシステム上で実行され、**モジュール**ごとに**チェック**を実行します。
-ソフトウェアエージェントは、情報を取得する OS で実行されています。 CPU 使用率、空きメモリ、ディスク容量など、システムで実行される **各チェック** は、 **モジュール** に対応します。 したがって、各モジュールには、実行ごとに 1つのデータが収集されます。
+The Software Agent'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.
-ソフトウェアエージェント独自の //ディレクティブ// は、オペレーティングシステムから特定のデータ(CPU 使用率、メモリ、イベントなど)を直接取得し、事前に定義された //スクリプト// からの指示に従って **オペレーティングシステム独自のコマンド** を実行するのに便利です。データが標準的な方法で返されるコマンドであれば、他のソフトウェアと同様に直接実行することもできます。
+ソフトウェアエージェント独自のディレクティブは、オペレーティングシステムから特定のデータ (CPU 使用率、メモリ、イベントなど) を直接収集するために使用され、事前定義されたスクリプトの指示に従って **オペレーティングシステム独自のコマンド** を実行します。
-Pandora FMS データサーバは、ソフトウェアエージェントによって生成され、送信される XML ファイルを介してすべての情報を処理してデータベースに保存します。
+The Pandora FMS Dataserver processes and stores in the database all the information generated and sent in XML files by the software agents.
-{{  :wiki:esquema-3.png?650  }}エージェント/物理エージェントの論理的概要
+Pandora FMS データサーバは、ソフトウェア エージェントによって生成され XML ファイルで送信されたすべての情報を処理し、データベースに保存します。
-<WRAP center round tip 60%> 7 NG より前のバージョンが実行されている場合は、この記事の最後のソフトウェアエージェントの名前を確認してください。 </WRAP>
+==== エージェント設定 ====
-=== エージェント設定 ===
+All the configuration and parameters are stored in the pandora_agent.conf file, which is also installed locally together with your Software Agent. The basic configuration is dealt with in [[:en:documentation:02_installation:05_configuration_agents|"Configuration of Pandora FMS Agents"]], the advanced configuration is explained below.
-ソフトウェアエージェントのすべての設定と監視パラメータは、設定ファイル //pandora_agent.conf// にあります。 これは、ソフトウェアエージェントがインストールされているマシンのローカルに保存されるため、エージェントの設定変更は、すべてこのファイルに反映させる必要があります。全エージェント設定トークンの詳細については、"PandoraFMS ソフトウエアエージェント" の章 [[:ja:documentation:02_installation:05_configuration_agents|]] を参照してください。ここでは高度な設定向けに、そのうちのいくつかのみに焦点をあてます。
+すべての設定とパラメータは pandora_agent.conf ファイルに保存され、このファイルはソフトウェアエージェントと一緒にローカルにインストールされます。 基本的な設定については [[:ja:documentation:02_installation:05_configuration_agents|"Pandora FMS エージェントの設定"]] で説明しています。高度な設定については以下で説明しています。
-== ローカル設定 ==
+=== ローカル設定 ===
 ソフトウエアエージェントの設定ファイルでは、以下のテキストの基本構造でモジュールが定義されています。
@@ 行 105: / 行 105: @@
 </code>
-== リモート設定 ==
+=== リモート設定 ===
-エンタープライズ版では、設定の中央管理およびコンソールからのファイル管理が行える、リモートエージェント設定機能があります。これにより、エージェントをインストールしたシステムへログインすることなく、設定ファイルの管理をサーバコンソールから統括して行うことができます。
+<WRAP center round info 60%>
-設定は、<md5>.conf および <md5>.md5 という名前の 2つのファイルで行います。ここで、<md5> は、エージェント名のハッシュです。
+To enable remote configuration, enable the parameter: ''remote_config 1'' and restart the software agent.
-Those files are stored in:
+</WRAP>
-これらのファイルは以下にあります。
+<WRAP center round info 60%>
+リモート設定を有効にするには、パラメータ ''remote_config 1'' を設定し、ソフトウエアエージェントを再起動します。
+</WRAP>
+In the Enterprise version it is possible to remotely manage the files of the Software Agents from the Pandora FMS Web Console. The configuration of each agent is stored in the Pandora FMS server in two files: <md5>.conf and <md5>.md5, where <md5> is the hash of the software Agent name. These files are stored respectively in:
+Enterprise 版では、Pandora FMS ウェブコンソールからソフトウェアエージェントのファイルをリモートで管理できます。 各エージェントの設定は、Pandora FMS サーバの <md5>.conf と <md5>.md5 という 2 つのファイルに保存されます。<md5> はソフトウェア エージェント名のハッシュです。 これらのファイルはそれぞれ次の場所に保存されます。
+<file>
-<code>
 /var/spool/pandora/data_in/conf
-</code>
+</file>
 and
@@ 行 124: / 行 133: @@
 および
-<code>
+<file>
 /var/spool/pandora/data_in/md5
-</code>
+</file>
-folders respectively.
-The console is in charge of keeping said files synchronized in Pandora FMS server and the local ones accordingly, where each software agent is installed.
+<WRAP center round tip 75%>
-コンソールは、各ソフトウェアエージェントがインストールされているローカルファイルと、Pandora FMS サーバのファイルの同期を維持する役割を果たします。
+Once remote agent configuration is enabled, any changes made locally to the configuration file will be overwritten by the configuration stored in the console. To return to local administration of the Software Agent, stop its service, reset ''remote_config'' to zero, and start the service again.
-{{  :wiki:sw-agent.png?550  }}
+</WRAP>
-リモート設定を有効にするためには、最初にエージェントのローカル設定ファイルで以下のパラメータを設定します。有効にしたのちは、すべての変更は Pandora FMS コンソールから実施する必要があります。
+<WRAP center round tip 75%>
-<code>
+エージェントのリモート設定を有効にしたあとは、ローカルの設定ファイルを変更してもコンソールに保存されている設定で上書きされます。これをソフトウェアエージェントのローカル管理に戻したい場合は、ソフトウエアエージェントのサービスを停止し、''remote_config'' をゼロにリセットして、サービスを再度開始します。
-remote_config 1
-</code>
+</WRAP>
-<WRAP center round tip 60%> エージェントのリモート設定を有効にしたあとは、ローカルの設定ファイルを変更してもコンソールに保存されている設定で上書きされます。これを停止したい場合は、エージェントを停止し設定ファイルを編集し、リモート設定を無効化したのち、エージェントを再起動します。 </WRAP>
+=== カスタムフィールド ===
-== カスタムフィールド ==
+Custom fields allow you to add additional information to the agent. Custom fields can be created with the PFMS 1.0 API and the command [[:en:documentation:08_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**.
-{{  :wiki:rk0b6zaqbm.png?550  |エージェント用のカスタムフィールド管理}}
+カスタムフィールドを使用すると、エージェントに追加情報を追加できます。 カスタムフィールドは、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)** を使用して作成できます。
-カスタムフィールドは、エージェントの情報を追加する簡単な仕組みです。カスタムフィールドは、'リソース(Resources)' → 'カスタムフィールド(Custom fields)' をクリックすると作成できます。
+   * 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 agent's overview. 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.
+  * **Password type**: The value of the field (password) will be shown using asterisks in the Web Console.
+  * **Link type**: It allows you to add a custom field that will host a web link to be filled in by the Web Console or in a [[:en:documentation:08_technical_reference:11_pfms_plugis#xml|XML received by an agent]]. It is possible to include links in the custom fields of an XML in JSON format embedded with CDATA instructions ''<![CDATA[…]]>''. For example, if the JSON format of the link is:
-<WRAP center round tip 60%>
+   * オプション **選択肢の有効化(Enabled combo)**、**パスワードタイプ(Password type)**、**リンクタイプ(Link type)** は相互に排他的です。つまり、いずれか 1 つだけを使用できます (または、デフォルト値のなし)。
+   * **前面に表示(Display up front)** フィールドを有効にすると、値が設定されている場合、カスタムフィールドの情報がエージェントの概要に表示されます。 さらに、カスタムフィールド情報を **コマンドセンター** (メタコンソール) に送信するには、このトークンを有効にする必要があります。
+   * **選択肢の有効化(Enabled combo)**: このパラメーターを使用すると、ドロップダウンリストからのパラメータ選択を有効化できます。 有効化した場合、対応するカスタムフィールドの構成ウィンドウに新しいフィールドが表示され、カンマで区切で値を入力します。
+   * **パスワードタイプ(Password type)**: ウェブコンソールでは、フィールド (パスワード) の値がアスタリスクを使用して表示されます。
+   * **リンクタイプ(Link type)**: ウェブコンソールまたは [[:ja:documentation:08_technical_reference:11_pfms_plugis#xml|エージェントから受信した XML]] によって入力されるウェブリンクをホストするカスタムフィールドを追加できます。JSON 形式の CDATA 命令''<![CDATA[…]]>'' が埋め込まれた XML にリンクを含めることができます。 たとえば、リンクの JSON 形式が次の場合、
-You can include links in custom fields using the following tags:
+<file>
-''[url]< link >[/url]'' or
+["Web name","https://example.com"]
-''[url=< link >]< web name >[/url]'' .
+</file>
-</WRAP>
+The XML would have this syntax:
-<WRAP center round tip 60%>
+XML は次のような書式になります。
-カスタムフィールドには、次のようなタグを使ってリンクを含めることができます。
-''[url]< link >[/url]'' または、
+<code xml>
+<custom_fields>
+   <name>![CDATA[web]]</name>
+   <value>![CDATA[["Web name","https://example.com"|]]]</value>
+</custom_fields>
-''[url=< link >]< web name >[/url]''
-</WRAP>
-**前面に表示(Display up front)** および **有効なコンボ(Enabled combo)** フィールドはデフォルトで無効になっています：
+</code>
-{{  :wiki:customfields2.jpg  }}
+See "[[:en:documentation:08_technical_reference:06_anexo_agent_plugins#validate_the_resulting_xml|XML Validation]]", the [[:en:documentation:07_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:07_technical_annexes:15_security_architecture#server|Security Architecture for the PFMS Data server]] (limit the auto-creation of agents and set a password for the agent group each agent belongs to).
-  * By activating the field **Display up front**, custom field information will be displayed in the agent's general view as shown below. In addition, enable this token to send //Custom Fields//  information to the Metaconsole and be able to see it in the [[:en:documentation:06_metaconsole:05_visualization#agents|agent]] view and work in [[:pandorafms.com:docs:index.php?title = en:documentation:06_metaconsole:05_visualization#Custom_Fields_View#custom_fields_view|Custom Field View]] with this data.
+[[:ja:documentation:08_technical_reference:06_anexo_agent_plugins#xmlの確認|XML の確認]]、[[:ja:documentation:07_technical_annexes:15_security_architecture#tentacle|Tentacle プロトコルのセキュリティアーキテクチャ]](XML フォーマットでの Pandora FMS データサーバへのデータ送信の仕組)、[[:ja:documentation:07_technical_annexes:15_security_architecture#サーバ|Pandora FMS データサーバのセキュリティアーキテクチャ]](エージェントの自動作成の制限、各エージェントが属するエージェントグループのパスワード設定) を参照してください。
-  * **前面に表示(Display up front)**  を有効化することにより、カスタムフィールドの情報が以下に示すようにエージェント画面に表示されます。さらに、このトークンを有効にして、//カスタムフィールド//  情報をメタコンソールに送信すると、[[:ja:documentation:06_metaconsole:05_visualization#エージェント|エージェント]] 表示 および [[:ja:documentation:06_metaconsole:05_visualization#カスタムフィールド表示|カスタムフィールド表示]] で参照できます。
+Custom fields can also be passed from the agent configuration file, using the tokens [[:en:documentation:02_installation:05_configuration_agents#custom_fieldx_name|custom_fieldx_name]] and [[:en:documentation:02_installation:05_configuration_agents#custom_fieldx_value|custom_fieldx_value]], for example:
-{{  :wiki:vw9d9s2l9u.png  }}
-{{  :wiki:eqyikxu4qj.png?800  }}
+カスタムフィールドは、[[:ja:documentation:02_installation:05_configuration_agents#custom_fieldx_name|custom_fieldx_name]] および [[:ja:documentation:02_installation:05_configuration_agents#custom_fieldx_value|custom_fieldx_value]] トークンを用いて、エージェント設定ファイルから渡すこともできます。
+例:
-{{  :wiki:x1fyvchczt.png?500  }}
-  * **選択肢の有効化(Enabled combo)**: このパラメーターを使用すると、ドロップダウンリストからのパラメータ選択を有効化できます。 有効化した場合、対応するカスタムフィールドの構成ウィンドウに新しいフィールドが表示され、カンマで区切で値を入力します。
-<WRAP center round important 60%> "選択肢の有効化" をすると、"パスワードタイプ" は無効化されます。 </WRAP>
-これらのカスタムフィールドは、次のような設定トークンを使ってエージェント設定ファイルから渡すことができます。
 <code>
- custom_field1_name Model
+custom_field1_name Serial Number
- custom_field1_value i386
+custom_field1_value 56446456KS7000
 </code>
-== 共通設定パラメータ ==
+The custom field called ''Serial Number''  is created by default when installing PFMS and you may create as many custom fields as needed and of each different type (simple value, web link, password type and option list type). The order of the numerical identifier of each custom field is irrelevant, you just have to ensure that the name is exactly the same:
-基本的なエージェント設定における、最も重要なパラメータ (より詳細は、[[:ja:documentation:02_installation:04_configuration#pandora_fms_software_agents|Pandora FMS ソフトウエアエージェント]] を参照してください):
+''シリアル番号(Serial Number)'' と呼ばれるカスタムフィールドは、Pandora FMS  のインストール時にデフォルトで作成されます。カスタムフィールドは必要に応じて必要なだけ作成でき、それぞれのタイプ (単一値、ウェブリンク、パスワードタイプ、およびオプションリストタイプ) を作成できます。 各カスタムフィールドの数値識別子の順序は関係ありません。名前がまったく同じであることを確認する必要があるだけです。
-  * **server_ip**: IP address of Pandora FMS Server.
+<code>
-  * **server_path**: Path of the 'incoming' folder for the Pandora FMS server, ''/var/spool/pandora/data_in''  by default.
+custom_field11_name Simple custom field name
-  * **temporal**: Software agent's temporal folder, ''/tmp''  by default.
+custom_field11_value Simple custom field value
-  * **logfilefile**: Software agent's log file, ''/var/log/pandora/pandora_agent.log''  by default.
-  * **interval**: Agent's execution interval, ''300''  by default.
-  * **agent_name**: Agent name, ''hostname''  by default.
-  * **remote_config**: Activation of remote configuration. It is disabled (''0'') by default. Only for Enterprise version.
-  * **debug**: When activated (value ''1'') it sets the ''debug''  mode, in this way, a copy of the XML is created and sent to the server and stored in the temporary directory for analysis. In addition, on MS Windows® systems, a ''.debug''  file is created in the Agent installation path with a detailed log of the execution of each Module. In Enterprise versions, the active ''debug''  mode disables remote configuration from the Console to the Software Agent.
-  * **server_ip**: Pandora FMS サーバの IP アドレスです。
+custom_field12_name Custom field Link type
-  * **server_path**: Pandora FMS サーバの 'incoming' フォルダのパスです。デフォルトは、''/var/spool/pandora/data_in'' です。
+custom_field12_value ["Pandora FMS web site","https://pandorafms.com"]
-  * **temporal**: ソフトウエアエージェントのテンポラリフォルダです。デフォルトは、''/var/spool/pandora/data_out'' です。
-  * **logfile**: ソフトウエアエージェントのログファイルです。デフォルトは、''/var/log/pandora/pandora_agent.log'' です。
-  * **interval**: エージェントの実行間隔です。デフォルトは、''300'' です。
-  * **agent_name**: エージェント名です。デフォルトはホスト名が使われます。
-  * **remote_config**: リモート設定を有効にします。デフォルトは無効(''0'')です。 Enterprise 版のみです。
-  * **debug**: ''1'' で、XML ファイルデータフェイルを保存し分析するためのデバッグモードを有効にします。この場合、XMLのコピーが作成されてサーバーに送信され、分析のために一時ディレクトリに保存されます。さらに、MS Windows® システムでは、''.debug''  ファイルがエージェントのインストールパスに作成され、各モジュールの実行の詳細なログが記録されます。Enterprise 版では、アクティブデバッグモードにより、コンソールからソフトウェアエージェントのリモート設定が無効になります。
-<WRAP center round important 60%>
+custom_field13_name Custom field Password type
+custom_field13_value My;Password;
-The active ''debug''  mode is not designed for prolonged use. It is a mode for debugging errors for short periods of time. **It is important to remember to disable it as soon as debugging is finished.**  </WRAP>
+custom_field14_name Custom field Combo type
+custom_field14_value Two
-<WRAP center round important 60%> アクティブデバッグモードは、長期間使用するようには設計されていません。短期間でエラーをデバッグするためのモードです。**デバッグが終了したらすぐに無効にすることを忘れないでください。**</WRAP>
+</code>
-  * **nix**  環境での例:
+In the custom fields ''Combo type'', the value sent by the software agent must correspond exactly to one of its items, otherwise the value will not be changed.
-<code>
-server_ip       192.168.1.1
+カスタムフィールド ''Combo type'' では、ソフトウェア エージェントによって送信される値がその項目の 1 つに正確に一致する必要があります。そうでない場合、値は変更されません。
-server_path     /var/spool/pandora/data_in
-temporal        /tmp
-logfile         /var/log/pandora/pandora_agent.log
-interval        300
-debug           0
-agent_name      box01
-server_port     41121
-transfer_mode   tentacle
-remote_config   1
-</code>
+=== 共通設定パラメータ ===
-**MS Windows®**  環境での例:
+Most important parameters for the basic configuration of [[:en:documentation:02_installation:05_configuration_agents#what_is_a_software_agent|Software Agents]]:
-<code>
+基本的なエージェント設定における、最も重要なパラメータ (より詳細は、[[:ja:documentation:02_installation:04_configuration#pandora_fms_software_agents|Pandora FMS ソフトウエアエージェント]] を参照してください):
-server_ip       192.168.1.1
-server_path     /var/spool/pandora/data_in
-temporal        "%ProgramFiles%\pandora_agent\temp"
-logfile         "%ProgramFiles%\pandora_agent\pandora_agent.log"
-interval        300
-debug           0
-agent_name      box02
-server_port     41121
-transfer_mode   tentacle
-remote_config   1
-</code>
+   * **server_ip**: IP address of the Pandora FMS server.
+   * **server_path**: Path of the incoming input folder of the Pandora FMS server, by default ''/var/spool/pandora/data_in''.
+   * **temporary**: Folder, default ''/tmp''.
+   * **logfile**: Software Agent log file, by default ''/var/log/pandora/pandora_agent.log''.
+   * **interval**: Agent execution interval, by default ''300'' seconds.
+   * **server_ip**: Pandora FMS サーバの IP アドレスです。
+   * **server_path**: Pandora FMS サーバの 'incoming' フォルダのパスです。デフォルトは、''/var/spool/pandora/data_in'' です。
+   * **temporal**: ソフトウエアエージェントのテンポラリフォルダです。デフォルトは、''/var/spool/pandora/data_out'' です。
+   * **logfile**: ソフトウエアエージェントのログファイルです。デフォルトは、''/var/log/pandora/pandora_agent.log'' です。
+   * **interval**: エージェントの実行間隔です。デフォルトは、''300'' です。
-== パスワード保護グループ ==
+=== パスワード保護グループ ===
-デフォルトでは、エージェントが初めて Pandora FMS サーバにデータを送信すると、そのデータはエージェント設定ファイルで定義されているグループに自動的に追加されます。 つまり、実際には、グループ名を知っていれば、誰でもグループにエージェントを追加できます。 これは、複数のクライアントが Pandora FMS インスタンスを共有している場合や各グループの内容を制御したい場合に問題になる可能性があります。
+By default, when an agent sends data for the first time to the Pandora FMS server, it is automatically added to the group that has been defined in the agent's configuration file.
-オプションで、Pandora FMS コンソールからグループのパスワードを設定できます。エージェント設定ファイルで正しいパスワードが指定されていない限り、エージェントはグループに追加されません。
+デフォルトでは、エージェントが初めて Pandora FMS サーバにデータを送信すると、そのデータはエージェント設定ファイルで定義されているグループに自動的に追加されます。
-**例**  グループのパスワードを設定するには、//グループエディタ//  に移動して //編集//  をクリックし、グループパスワードを入力して、変更を保存します。
+is possibleIt is possible to set a password for a group, so an agent will not be added to a group unless the correct password is specified in the agent's configuration file.
-{{  :wiki:passgr1.jpg  |passgr1.jpg}}
+オプションで、Pandora FMS コンソールからグループのパスワードを設定できます。この場合、エージェント設定ファイルで正しいパスワードが指定されていない限り、エージェントはグループに追加されません。
-このグループに新しいエージェントを追加するには、設定ファイルを編集して、次の設定オプションを追加します。
+To edit and add a group password go to **Management** menu → **Profiles** → **Manage agent groups** → click on group name.
-<code>
-group_password <password>
+グループパスワードを編集して追加するには、**管理(Management)** メニュー → **プロファイル(Profiles)** → **エージェントグループ管理(Manage agent groups)** に移動し、グループ名をクリックします。
-</code>
+To add a new agent to this group, edit its configuration file and add the following configuration option ''group_password '' and restart the agent software.
-<WRAP center round tip 60%> 変更を有効にするために、エージェントを再起動することを忘れないでください。 エージェントは、Pandora FMS コンソールで正しく作成する必要があります。 </WRAP>
+このグループに新しいエージェントを追加するには、その設定ファイルを編集し、設定オプション ''group_password '' を追加し、エージェントソフトウェアを再起動します。
-=== エージェントおよびソフトウエアエージェントのモジュール ===
+==== エージェントおよびソフトウエアエージェントのモジュール ====
-== モジュールの種類 ==
+=== モジュールの種類 ===
 データのタイプに応じた、ソフトウエアエージェントのモジュールのタイプは次の通りです。
@@ 行 289: / 行 278: @@
   * **async_proc**: 非同期のブーリアンデータです。generic_proc と同じですが非同期のデータで、変化したときのみ更新されます。
   * **Image module**: テキスト文字列型モジュール(generic_data_string または async_string)をもとにしたものです。モジュール内のデータが base64 イメージの場合、つまり文字列の一部に "data：image" が含まれている場合、それは画像データとして識別され、表示画面では画像を表示するウィンドウを開くリンクが有効になります。 また、ヒストリデータとしても文字列として保存され、画像を構築/生成し表示されます。
-== ローカルモジュールの実行間隔 ==
+=== ローカルモジュールの実行間隔 ===
 ローカルモジュール(ソフトウエアエージェントのモジュール)には、ベースとしてエージェントの実行間隔があります。ただし、module_interval パラメータにゼロより大きい整数を設定することによって、エージェントの実行間隔にそれを乗じた値をモジュールの実行間隔とすることができます。例:
@@ 行 300: / 行 290: @@
 この場合、エージェントの実行間隔が 300 のとき、モジュールの実行間隔は 300×2 (600) になります。
-== モジュール作成インタフェース ==
+=== モジュール作成インタフェース ===
-<WRAP center round tip 60%> この機能は **Enterprise 版のみ**  です。ソフトウエアエージェントのリモート設定を有効化する必要があります。 </WRAP>
+<WRAP center round tip 60%>
+{{:wiki:icono-modulo-enterprise.png }}Functionality only for **Enterprise version**; the remote configuration of the respective Software Agent must be enabled.
+</WRAP>
+<WRAP center round tip 60%>
+{{:wiki:icono-modulo-enterprise.png }}この機能は **Enterprise 版のみ**  です。ソフトウエアエージェントのリモート設定を有効化する必要があります。
+</WRAP>
+The creation of local modules in the console is done through a form where, in addition to the common configuration of all modules (thresholds, type, group, etc.), there is a text box where you can specify the configuration data to be established in the configuration file. Software Agent configuration.
 コンソールからのローカルモジュールの作成は、リモートモジュール(の閾値、タイプ、グループなど)と同様に、フォームを利用して行います。設定データを指定するテキストボックスがあり、ソフトウエアエージェントの設定ファイルが表示されています。
-{{  :wiki:local_module_editor.png?800  }}
+{{ :wiki:local_module_editor.png }}
+   * When clicking on the **Load basic (template)** button, the content of Data configuration will be deleted with a basic template that we must modify according to the need for monitoring.
+   * Once modified, clicking **Check (syntax)** will verify that the template syntax is still correct, however the rest of the commands will not be checked.
   * **基本(テンプレート)のロード(Load basic (template)**  をクリックすると、**データ設定(Data configuration)**  のコンテンツが監視のニーズに応じて変更する必要のある基本テンプレートに置き換えられます。
   * 変更後、**チェック(構文)(Check (syntax))**  をクリックすると、テンプレートの構文が正しいことを確認しますが、残りのコマンドはチェックされません。
-モジュールがローカルコンポーネントからロードされる場合、マクロが含まれる場合があります。 マクロがある場合、設定ボックスは非表示のままになり、マクロごとにフィールドが表示されます。詳細については、[[:ja:documentation:04_using:03_templates_and_components#e383ade383bce382abe383abe5ae9fe8a18ce3839ee382afe383ad|テンプレートとコンポーネント]] を参照してください。
+When a module is loaded from a local component, it can have macros. If you have macros, the configuration box will be hidden and a field will appear for each macro, see more information in [[:en:documentation:04_using:03_templates_and_components#macros|Templates and components]]
+モジュールがローカルコンポーネントからロードされる場合、マクロが含まれる場合があります。 マクロがある場合、設定ボックスは非表示のままになり、マクロごとにフィールドが表示されます。詳細については、[[:ja:documentation:04_using:03_templates_and_components#ローカル実行マクロ|テンプレートとコンポーネント]] を参照してください。
-=== 状態にもとづくモニタリング ===
+==== 状態にもとづくモニタリング ====
-== 事後処理 ==
+=== 事後処理 ===
 Pandora FMS ソフトウエアエージェントは、モジュールの実行結果の値に応じたスクリプトの実行をサポートしています。これは、モジュールの実行で得られた値に応じてアクションを行えることを意味します。
@@ 行 364: / 行 371: @@
 </code>
-== 事前処理 ==
+=== 事前処理 ===
 **module_precondition**  パラメータにて、モジュール実行前の事前処理を定義します。この事前処理により、ソフトウエアエージェントはモジュールを実行するかどうか決めます。
@@ 行 401: / 行 408: @@
 この場合、アクティブなプロセスが 10 を超えており、そのうちの少なくとも 1つが重要なプロセスである場合にのみモジュールが実行されます。
-=== 高頻度モニタリング ===
+==== 高頻度モニタリング ====
 重要な実行プロセスやサービスなど、特に重要なモジュールが存在する場合があります。 これらのケース向けに、より制御された監視を可能にする集中監視が利用できます。
@@ 行 414: / 行 421: @@
   * **module_intensive_condition = 0**: モジュールの値がこのパラメータで指定した値(この場合 0)の場合、エージェントで定義された高頻度の間隔で監視します。
-== 例 ==
+=== 例 ===
 **sshd**  サービスは、シェルでリモート接続するために使用されるため非常に重要です。その動作を監視する必要があります。 次の例は、sshd プロセスの監視を通常は 5分ごとに実施しますが、障害時は 10秒ごとに監視したい場合の例です。
@@ 行 436: / 行 444: @@
 サービスがダウンすると、次の 10秒で再度チェックされます。サービスが起動していれば、次のチェックは通常通り 5分後です。
-=== 指定時間モニタリング ===
+==== 指定時間モニタリング ====
 ソフトウエアエージェントは、モジュールを指定時間に実行する設定ができます。書式は crontab と同じです。モジュールの設定例は次の通りです。以下は、モジュールを毎月曜の 12 から 15時の間に実行する例です。
@@ 行 464: / 行 472: @@
 <WRAP center round tip 60%> モジュールがデータを出力しない期間を設定した場合、モジュールは "不明" 状態になります。このような場合は非同期モジュールを利用します。 </WRAP>
-==== ソフトウエアエージェントでのリモートチェック ====
+===== ソフトウエアエージェントでのリモートチェック =====
 Pandora FMS サーバが(セキュリティ上の理由などから)直接アクセスできないシステムに対してリモートチェックを行う場合に使用します。ソフトウェアエージェントをインストールし、そこからリモートチェックを実行し、ブローカエージェントで配布することができます。
-=== ICMP チェック ===
+==== ICMP チェック ====
 ICMP もしくは ping の監視は、マシンがネットワークにつながっているかどうかを確認するのに便利です。単一のソフトウェアエージェントがすべてのマシンのステータスを簡単に監視できます。
@@ 行 506: / 行 514: @@
 </code>
-Note: ''[[en:documentation:03_monitoring:02_operations#module_advanced_options|module_advanced_options]]'' allows advanced options for ''ping.exe''.
+Note: ''[[:en:documentation:02_installation:05_configuration_agents#module_advanced_options|module_advanced_options]]'' allows advanced options for ''ping.exe''.
-注意: ''[[ja:documentation:03_monitoring:02_operations#module_advanced_options|module_advanced_options]]'' で、''ping.exe'' の高度なオプションを指定できます。
+注意: ''[[ja:documentation:02_installation:05_configuration_agents#module_advanced_options|module_advanced_options]]'' で、''ping.exe'' の高度なオプションを指定できます。
-=== TCP チェック ===
+==== TCP チェック ====
 TCP チェックは、ホストのポートが開いているかを確認するのに便利です。アプリケーションがネットワーク上で応答するかどうかを確認することができます。
@@ 行 553: / 行 561: @@
 このモジュールも同様に、192.168.100.54 の 80番ポートに対してチェックを行います。
-=== SNMP チェック ===
+==== SNMP チェック ====
 SNMP チェックは、一般的にネットワークデバイスのインタフェースのステータス、送受信トラフィックなどをチェックするのに利用します。
@@ 行 575: / 行 583: @@
 Windows のソフトウエアエージェントでは、モジュールを設定するための次のパラメータがあります。
+  * module_snmpversion [1,2c,3]: SNMP version (Default value is '1').
+  * module_snmp_community <community>> SNMP community (Default value is 'public').
+  * module_snmp_agent <host>> The host to monitor.
+  * module_snmp_oid <oid>> OID.
+  * [[:en:documentation:02_installation:05_configuration_agents#module_advanced_options|module_advanced_options]]: Advanced options for 'snmpget.exe'.
   * module_snmpversion [1,2c,3]: SNMP バージョン (デフォルトは 1)
@@ 行 580: / 行 594: @@
   * module_snmp_agent <host>: モニタ対象のホスト
   * module_snmp_oid <oid>: OID.
-  * module_advanced_options: snmpget.exe の拡張オプション
+  * [[:ja:documentation:02_installation:05_configuration_agents#module_advanced_options|module_advanced_options]]: snmpget.exe の拡張オプション
 モジュールの設定例を以下に示します。
@@ 行 599: / 行 613: @@
 このモジュールは、Unix のソフトウエアエージェントと同じ動作をします。
-==== プロキシモード ====
+===== プロキシモード =====
 <WRAP center round important 60%> Linux/Unix システムで、エージェントのプロキシモードを利用するためには、**エージェントを root 以外のユーザで実行** する必要があります。そのため、Pandora FMS エージェントのカスタムインストールが必要です。カスタムインストールの詳細については、[[:ja:documentation:02_installation:01_installing#エージェントのカスタムインストール|エージェントのカスタムインストール]]を参照してください。 </WRAP>
@@ 行 614: / 行 628: @@
 プロキシモードを有効にするには、ソフトウエアエージェントにて次のパラメータを設定します。
+   * **server_ip**: Pandora FMS server IP address.
+   * **proxy_mode**: On (1) or Off (0).
+   * **proxy_max_connection**: number of concurrent proxy connections, by default 10.
+   * **proxy_timeout**: response timeout for the proxy, default 1 second.
+   * **proxy_address**: address on which the proxy listens.
+   * **proxy_port**: port on which the proxy listens.
   * server_ip: Pandora FMS サーバの IP アドレスです。
-  * proxy_mode: 有効(([[http://pandorafms.com/index.php?sec = Library&sec2 = repository&lng = jp&action = view_PUI&id_PUI = 178|http://pandorafms.com/index.php?sec = Library&sec2 = repository&lng = jp&action = view_PUI&id_PUI = 178]])) または 無効(0)。
+  * proxy_mode: 有効(1) または 無効(0)。
   * proxy_max_connection: プロキシへの最大接続数です。デフォルトは 10です。
   * proxy_timeout: プロキシのタイムアウトです。デフォルトは 1秒です。
@@ 行 645: / 行 666: @@
 この設定により、Pandora FMS サーバと直接通信ができないソフトウエアエージェントが、プロキシモードの他のソフトウエアエージェントを経由して通信できるようになります。リモート設定、ポリシー、ファイルコレクションといったすべての機能が利用できます。
-==== ブローカーモード ====
+===== ブローカーモード =====
 ソフトウエアエージェントには、複数のソフトウエアエージェントがインストールされているかのように一つのエージェントを設定し、モニターするブローカーモードがあります。
@@ 行 674: / 行 695: @@
 <WRAP center round important 60%> ブローカーエージェントが有効な場合、実行中にメモリ内にデータを保持しているモジュール (module_logevent と MS Windows® における module_regexp) は動作しません。 </WRAP>
-=== 利用例 ===
+==== 利用例 ====
-== 異なるエージェントとしてのローカルデータベースのモニタリング ==
+=== 異なるエージェントとしてのローカルデータベースのモニタリング ===
 マシンの基本的な情報(CPU、メモリ、ディスク)および、インストールされているデータベースの情報を分けてモニタリングしたいとします。
@@ 行 711: / 行 732: @@
 これにより、Pandora ウェブコンソールに 2つのエージェントが現れます。一つはマシン名で CPU、メモリ、ディスクのモジュールがあり、もう一つは、DBApp という名前で Num Users および Num slow queries というモジュールがあります。
-== ブローカーを使ったリモートデバイスのモニタリング ==
+=== ブローカーを使ったリモートデバイスのモニタリング ===
 この例では、Windows マシンにソフトウエアエージェントをインストールし、(CPU、メモリ、ディスクを)モニタリングしています。また、エージェントのインストールなしに 192.168.100.54 の IP を持ったルータをモニタリングしたいとします。この問題を解決するためにブローカーを利用できます。
@@ 行 757: / 行 778: @@
 この例では、Pandora FMS のウェブコンソールには 2つのエージェントが表示されます。一つは CPU、メモリ、ディスクのモジュールを持った Windows マシン、もう一つは、Ping、Eth 1 up、Eth 2 up というモジュールを持った //routerFloor5//  です。
-== 直接通信できないネットワークのリモートモニタリング ==
+=== 直接通信できないネットワークのリモートモニタリング ===
 デバイスをリモートからモニタする必要があるが、Pandora FMS のリモートサーバがそれらに直接通信できない場合があります。
@@ 行 812: / 行 833: @@
 この設定で、異なる会社のサイト間で通信に制限があったとしても、リモート設定機能を利用でき、また、モニタした情報を Pandora FMS サーバへ送信することができます。
-== ブローカーを使ったモニタリング負荷分散 ==
+=== ブローカーを使ったモニタリング負荷分散 ===
 ブローカーモードは、複数のネットワークでモニタリングの負荷を分散するのにとても便利です。
@@ 行 900: / 行 921: @@
 ソフトウエアエージェントをブローカーモードを有効にして使うことで、数千のデバイスからのデータを簡単に負荷分散して収集することができます。
-==== ソフトウエアエージェントを使ったインベントリ ====
+===== ソフトウエアエージェントを使ったインベントリ =====
 Pandora FMS ソフトウエアエージェントは、ハードウエアおよびソフトウエアのインベントリの機能をサポートします。インベントリシステムは、企業のサーバで使われている CPU、拡張カード、メモリ、パッチ、ソフトウエアなどの情報を取得することができます。また、インベントリに変化が発生したときにアラートを上げることもできます。例えば、ディスクを交換したり、アプリケーションが削除されたときです。
@@ 行 906: / 行 927: @@
 より詳細の情報は、[[:ja:documentation:04_using:04_inventory#ソフトウエアエージェントによるローカルインベントリ|ソフトウエアエージェントによるローカルインベントリ]]を参照してください。
-==== UDP リモートコマンド ====
+===== ソフトウエアエージェントを使ったログ収集 =====
+For more information visit the topic [[:en:documentation:03_monitoring:09_log_monitoring|Log collection and monitoring]].
+詳細に関しては、[[:ja:documentation:03_monitoring:09_log_monitoring|ログ収集と監視]] を参照してください。
+===== UDP リモートコマンド =====
 ソフトウェアエージェントは、リモートリクエストを受信して処理を実行することができます。
@@ 行 921: / 行 949: @@
 <WRAP center round important 75%> どこからでも要求を受け入れるために //0.0.0.0//  に設定できますが、この方法はお勧めしません。 複数の Pandora FMS サーバがある場合や IPv6 を利用している場合は、異なる IP をカンマで区切って設定できます。たとえば、IPv6 で ''2001:0db8:0000:130F:0000:0000:087C:140B''  がある場合、その省略形は ''2001:0db8:0:130F::87C:140B ''  です。両方をコンマで区切って使用します。 </WRAP>
-=== ソフトウエアエージェントへのサービス再起動要求の送信方法 ===
+==== ソフトウエアエージェントへのサービス再起動要求の送信方法 ====
-Pandora FMS サーバの /usr/share/pandora_server/util に含まれる //udp_client.pl//  を使います。コマンドラインから実行したり、コンソールの [[:ja:documentation:04_using:01_alerts#e5ae9ae7bea9e6b888e381aee382b3e3839ee383b3e38389|設定済のコマンド]] **"Remote agent control"**  を使ったアラートで使うことができます。
+You must use the script located at:
-また、//Restart agent//  という設定済のアラートアクションもあります。このスクリプトで、//REFRESH AGENT//  を行います。
+以下のスクリプトを利用する必要があります。
-{{  :wiki:agent_restart_action.png?700  }}
+<file>
-次に、アラートの強制実行をするか、アラートを起動するためにモジュールを強制的に障害状態にして、設定を確認します。
+/usr/share/pandora_server/util/udp_client.pl
-=== カスタムリモートコマンド ===
+</file>
-Apart from the Refresh agent command, you can specify new and custom actions. For that, add a line for each command to execute, like the following (replace ''< order_name >'' with appropiate value):
+It can be executed from the command line or used in an alert, through the command that comes [[:en:documentation:04_using:01_alerts#comandos_predefinidos|preconfigurada]] in the **Remote agent control** console.
-エージェントのリフレッシュコマンドとは別に、新しいアクションとカスタムアクションを指定できます。そのためには、次のように実行する各コマンドの行を追加します (''< order_name >'' を適切な値に置き換えます)。
+コマンドラインやから実行したり、コンソールの [[:ja:documentation:04_using:01_alerts#定義済のコマンド|設定済のコマンド]] **"Remote agent control"**  を使ったアラートで使うことができます。
-  process_< order_name >_start comando
+{{ :wiki:agent_restart_action.png }}
+==== カスタムリモートアクション ====
+In addition to the Software Agent service restart action, custom actions can be specified.
+ソフトウェアエージェントサービスの再起動アクションに加えて、カスタムアクションを指定できます。
+<code>
+process_<order_name>_start command
+</code>
 例えば、リモートから sshd サービスを起動したい場合は次のようにします。
-  process_sshd_start /etc/init.d/sshd start
+<code>
-作成したリモートコマンドごとに、Pandora FMS コンソールで新たなアラートアクションを作成する必要があります。すでに udp でコマンドを送信する設定がされている "Remote agent control" アクションをコピーすると良いでしょう。フィールド1 に、"START PROCESS sshdproc" を設定します。
+process_sshd_start /etc/init.d/sshd start
-{{ wiki:Udp process.JPG?700 }}
+</code>
-sshd サービスを起動させたいエージェントで、新たなアラートアクションで新たな手動アラートを設定する必要があるだけです。これにより、手動でアラートを実行することにより、起動コマンドを発行することができます。
+<WRAP center round tip 60%>
-<WRAP center round tip 60%> スクリプトの実行順序も作成することができます。これで、"アラートの強制" をクリックすることにより、さまざまなリモートアクションをリモートエージェントで実行することができます。 </WRAP>
+You can also create commands that call scripts to perform multiple remote actions with the click of a button.
-==== ソフトウエアエージェントでのプラグインの利用 ====
+</WRAP>
+<WRAP center round tip 60%>
+ボタンをクリックするだけで複数のリモートアクションを実行するスクリプトを呼び出すコマンドを作成することもできます。
+</WRAP>
+===== ソフトウエアエージェントでのプラグインの利用 =====
 プラグインは、ソフトウェアエージェントから複雑で高度なチェックを実行することができるものです。単一の値だけではなく、複数のモジュールを返すことができます。 Pandora FMS サーバによって実行されるサーバプラグインとは異なり、エージェントプラグインはXMLでデータを返し、同時に1つまたは複数のモジュールのデータを返します。
-=== Windows システムでの実行 ===
+==== Windows システムでの実行 ====
 Windows では、デフォルトの全プラグインは、VBScript でプログラムされています。これらを実行するには、フルパスで適切なインタプリタを使用する必要があります。
@@ 行 969: / 行 1015: @@
 Windows エージェントでは、さまざまなプラグインを使用できます。
-=== Unix システムでの実行 ===
+==== Unix システムでの実行 ====
 Unix プラグインは、デフォルトでエージェントのディレクトリの "/plugin" 以下、/etc/pandora/plugins にあります。そのため、このディレクトリにある限りは実行時にフルパスを指定する必要はありません。
@@ 行 983: / 行 1029: @@
 Unix ソフトウエアエージェントには、デフォルトでいくつかのプラグインが含まれています。
-=== コンソールからのエージェントプラグインの管理 ===
+==== コンソールからのエージェントプラグインの管理 ====
-**Enterprise** 版では、設定ファイルを直接編集せずに管理することができます。リモート設定を有効にすると、管理画面のソフトウェアエージェントにプラグインエディタータブが表示されます。
+<WRAP center round info 90%>
-{{  :wiki:plugin_editor_tab.png?33  }}
+{{:wiki:icono-modulo-enterprise.png?23x23 |Enterprise Version}}In the **Enterprise** version it is possible to manage without directly editing the configuration file. By having remote configuration enabled, a Software Agent in its administration view will have the plugin editor tab.
-この部分には、エージェント内で有効になっているプラグインのリストが表示され、プラグインの削除、追加、および無効化が可能です。ポリシープラグインに関しては、ポリシーを再度適用すると無効のままになるため、無効化すると便利な場合があります。
+</WRAP>
-{{  :wiki:plugin_editor_simple.png?700  }}
+<WRAP center round info 90%>
-このエディターで管理されるプラグインは、エージェントの設定ファイルから編集できます。
+{{:wiki:icono-modulo-enterprise.png?23x23 |Enterprise 版}}**Enterprise** 版では、設定ファイルを直接編集せずに管理することができます。リモート設定を有効にすると、管理画面のソフトウェアエージェントにプラグインエディタータブが表示されます。
+</WRAP>
-{{  :wiki:plugin_editor_conf.png?500  }}
+{{ :wiki:plugin_editor_simple.png?700 }}
-== 例 1 ==
+=== 例 1 ===
 ソフトウエアエージェントのプラグインは、一つのデータもしくはグループ化したデータを返すことができます。Windows で一つのデータを返す //ps.vbs//  の例を示します。次の設定でプラグインを実行します。
@@ 行 1017: / 行 1065: @@
 </code>
-== 例 2 ==
+=== 例 2 ===
 次に Windows で複数のデータを返す //df.vbs//  プラグインの例を示します。次の設定でプラグインを実行します。
@@ 行 1042: / 行 1090: @@
 </code>
-=== コンソールからの高度なエージェントプラグイン管理 ===
+==== コンソールからの高度なエージェントプラグイン管理 ====
-<WRAP center round tip 60%> バージョン NG 750 以上 </WRAP>
+<WRAP center round tip 60%>
-エージェントの設定にプラグイン設定トークンがあり、有効にすると、''module_begin''  および ''module_end''  タグ内のプラグイン定義をカプセル化するオプションを使うことができます。
+Version NG 750 or later.
-''module_interval''  や ''module_crontab''  などを、設定に入れることができるようになります。
+</WRAP>
-このトークンを有効にするには、エージェント管理でエージェントプラグインにアクセスし、設定の上部の //詳細(Advanced)//  にアクセスするだけです。
+<WRAP center round tip 60%>
-{{  :wiki:plugin_editor_advanced2.png?800  }}
+バージョン NG 750 以上
-=== 独自エージェントプラグインの作成方法 ===
+</WRAP>
+It is possible to add a token in the agent plugins configuration that when enabled allows the option to 'encapsulate' the plugin definitions inside the ''module_begin'' and ''module_end'' tags.
+''module_begin'' タグと ''module_end'' タグ内にプラグイン定義を 'カプセル化' すると、エージェントのプラグイン設定にトークンを追加することができます。
+This enabled token allows you to insert configuration blocks such as ''module_interval'' or ''module_crontab'', among others.
+''module_interval''  や ''module_crontab''  などを、設定に入れることができるようになります。
+==== 独自エージェントプラグインの作成方法 ====
 Plugins can be created in any programming language. Just bear in mind the [[:en:documentation:08_technical_reference:04_anexo_plugins_considerations|general rules]] and the [[:es:documentation:08_technical_reference:06_anexo_agent_plugins|specific rules]] for its development.
@@ 行 1072: / 行 1130: @@
 </WRAP>
-== シェルスクリプト(Linux/Unix)によるプラグインの例 ==
+=== シェルスクリプト(Linux/Unix)によるプラグインの例 ===
 <code>
@@ 行 1105: / 行 1164: @@
 </code>
-== VBScript (Windows) によるプラグインの例 ==
+=== VBScript (Windows) によるプラグインの例 ===
 <code>
@@ 行 1144: / 行 1204: @@
 </code>
-=== エージェントでの nagios プラグインの利用 ===
+==== エージェントでの nagios プラグインの利用 ====
-Nagios には多くのすばらしいプラグインがあり、Pandora FMS で利用することができます。プラグインサーバで nagios 互換モードを使ってリモートでプラグインを利用することができますが、ステータスを取得するのみで、いくつかの nagios プラグインが持っている詳細情報を扱うことができません。
+Nagios has a large number of plugins that you can use with Pandora FMS. One way to do this is to use the remote plugins with the Plugin Server, using the [[:en:documentation:08_technical_reference:05_anexo_server_plugins_development#registro_manual_de_un_plugin_en_la_consola|Nagios compatibility]].
-ソフトウエアエージェントで nagios プラグインラッパーを使うことで、この問題が解決します。ラッパーは、バージョン 3.2 の Unix エージェントにデフォルトで付属しています。Pandora FMS Windows エージェント用の同様のプラグインは、 [[https://pandorafms.com/library/nagios-wrapper-for-agent-plugin/|Pandora FMS リソースライブラリ]]からダウンロードできます。
+Nagios には多くのプラグインがあり、Pandora FMS で利用することができます。プラグインサーバで [[:ja:documentation:08_technical_reference:05_anexo_server_plugins_development#プラグインの手動登録|nagios 互換モード]] を使ってリモートでプラグインを利用することができます。
+ただし、ステータスを取得するのみで、いくつかの nagios プラグインが持っている詳細情報を扱うことができません。
+この問題は、ソフトウエアエージェントで nagios プラグインラッパーを使うことで解決できます。ラッパーは、Unix エージェントにデフォルトで付属しています。Pandora FMS Windows エージェント用の同様のプラグインは、 [[https://pandorafms.com/library/nagios-wrapper-for-agent-plugin/|Pandora FMS リソースライブラリ]]からダウンロードできます。
 nagios プラグイン用のプラグインラッパーは何をするのでしょうか。
@@ 行 1155: / 行 1218: @@
   * ステータス情報: 正常(1)、異常(0)、警告(2)、不明() および、その他(4)。デフォルトでは、proc モジュールを利用します。正常および異常状態は、デフォルトで認識します。もし、警告やその他の状態を利用したい場合は、手動でモジュールのしきい値を設定してください。
   * 詳細情報: 通常は文字列データで、モジュールの説明フィールドに入ります。例えば、次のような形になります。
 <code>
@@ 行 1164: / 行 1227: @@
-== 例 ==
+=== 例 ===
 実行権限がついた pop3 プラグイン (/tmp/check_pop3_login) があったとします。これは、pop3 アクセスが正常かどうかチェックします。リモートホストに接続し、ユーザ名とパスワードを送信し、問題ないかを確認します。コマンドラインからは、次のように実行できます。
@@ 行 1229: / 行 1292: @@
 {{  :wiki:sample_plugin_wrapper.png  }}
-==== KeepAlive によるモニタリング ====
+===== KeepAlive によるモニタリング =====
-There is a special module in Pandora FMS called ''keep_alive'' used to alert about a software agent not sending information anymore (see previous [[:en:documentation:03_monitoring:02_operations#udp_remote_commands|Remote actions through UDP]]). This alert takes place when it has not updated its last contact date for twice of its interval, firing and checking the monitor in critical status.
+<WRAP center round tip 60%>
-Pandora FMS には、ソフトウエアエージェントからの接続がないことを検知する "keep_alive" と呼ばれる独特なモジュールがあります。
+The KeepAlive module can only be created from the Console, **even if remote configuration is not enabled** and it does not leave any trace in the ''pandora_agent.conf'' file.
-エージェントに情報を取得するリモートもしくはローカルのモジュールがある場合、エージェントの最新の "接続" が更新されます。全モジュールの中の一つのモジュールでもデータが更新されれば、最新の接続日時が更新されます。これは、エージェントが "応答しているかどうか" を知るのに便利です。正確には、その間隔の 2倍の時間データが更新されないと、エージェントは "停止" と認識します。エージェントの間隔が 5分であれば、10分以上更新されなければ、"停止" と認識します。
+</WRAP>
-<WRAP center round tip 60%> The KeepAlive module can be created by itself from the console (although you may not have remote configuration enabled) and it does not leave any trace in the ''pandora_agent.conf'' file. </WRAP>
+<WRAP center round tip 60%>
-<WRAP center round tip 60%>KeepAlive モジュールは(リモート設定が有効になっていない場合でも)コンソールから作成することができます。また、''pandora_agent.conf'' ファイルの変更は発生しません。</WRAP>
+KeepAlive モジュールは、**リモート設定が有効になっていない場合でも** コンソールから作成することができます。また、''pandora_agent.conf'' ファイルの変更は発生しません。
-Creation of a new KeepAlive module:
+</WRAP>
-新たな KeepAlive モジュールの作成:
+A unique module in Pandora FMS is the type called ''keep_alive'', used to alert if a Software Agent has stopped sending information.
-{{  :wiki:keep_alive_module.png  }}
+Pandora FMS の固有のモジュールで ''keep_alive'' と呼ばれるタイプで、ソフトウェアエージェントが情報の送信を停止した場合に警告するために使用されます。
-Performance in "NORMAL" status (green), "NOT INITIALIZED" (blue):
+You must go to the modules tab (**Management** → **Manage agents** → click on agent name → **Modules**).
-"正常" 状態(緑)、"未初期化" (青):
+設定には、モジュールタブに移動する必要があります (**管理(Management)** → **エージェント管理(Manage agents)** → エージェント名をクリック → **モジュール(Modules)**)。
-{{  :wiki:pfms-list_of_modules_including_keepalive.png  }}
+Click **Create module** and select **Create a new data server module** → **Create** → enter the name of the new module → **Create**.
-If the agent stops sending data (for this example there is a 1-minute interval), then it will automatically be triggered and change to CRITICAL status (red). To display this type of modules you may go to the left side menu and select **Monitoring** → **Views** → **Monitor detail** and in the filter dialog, field **Data type,** select **KeepAlive** and then click **Show**:
+**モジュールの作成(Create module)** をクリックし、**データサーバモジュールの新規作成(Create a new data server module)** → **作成(Create)** → 新しいモジュールの名前を入力 → **作成(Create)** を選択します。
-エージェントがデータの送信を停止すると(この例では 1分間隔)、それが自動的に検知され、障害状態(赤)に変わります。このタイプのモジュールを表示するには、左側のメニューに移動して、**モニタリング** → **表示** → **モニタリング概要** を選択し、フィルターダイアログのフィールド **データタイプ** で **KeepAlive** を選択し、**表示(Show)** をクリックします。
+===== コマンドスナップショット =====
-{{  :wiki:keepalive2.png  }}
+{{  :wiki:command_snapshot_2023.png  }}
-KeepAlive module works like any other module: they can have an alert associated and it may be used for other elements such as reports, maps, etc.
+Commands that have extensive outputs, such as ''top'' or ''netstat -n'' can be captured completely by a module and fully reproduced. The module must be configured as a text type, example:
-KeepAlive モジュールは、他のモジュールと同じように機能します。アラートを関連付けることができ、レポート、マップなどの他の要素に使用できます。
+''top'' や ''netstat -n'' などの複数行の出力を持つコマンドは、モジュールによって完全にキャプチャでき、完全に再現できます。 モジュールはテキストタイプとして設定する必要があります。例:
-==== コマンドスナップショットモニタリング ====
-このモニタリングは、バージョン 4.0.3 から対応しており、単一の値や文字列ではなくコマンドの出力結果をキャプチャするためのものです。このモジュールは、情報をテキストとして保存しますが、単一データではなくコマンドの出力結果全体を保存します。コマンドの出力結果をそのまま表示します。
-言葉で説明するより画面がわかりやすいです。
-{{  :wiki:snapshot_1.png?650  }}
-これは、Pandora FMS で "netstat -an" コマンドの出力をキャプチャしたものです。コマンドスナップショットのアイコンをクリックすると、複数行にわたる出力が表示されます。
-{{  :wiki:snapshot_2.png?650  }}
-これらは、時間ごとに異なるスナップショットになります。Pandora は、エージェントが異なる情報を取得した場合にのみ情報を表示します(データタイプは、generic_data_string であることに注意してください)。毎回データを保存したい場合(お勧めはしません)は、async_string を利用します。変化があった場合の情報のみを表示することは、データに問題がある部分を確認したり、ある時間間隔におけるコマンドスナップショット内の変化を比較するのに便利です。
-コマンド出力をスナップショットとして取得するためには、XMLタグ付きで全データを送信する簡単なプラグインを書く必要があります。また、//module_plugin//  の書式で通常のプラグインと同様にプラグインを実行します。以下に、前述の netstat コマンドの出力を生成するスクリプト例を見てみましょう。
 <code>
+module_begin
-#!/bin/bash
+module_name process_table
-echo "<module>"
+module_type generic_data_string
-echo "<name>netstat</name>"
+module_exec ps aux
-echo "<type>generic_data_string</type>"
+module_description Command snapshot of running processes
-echo "<data><![CDATA["
+module_group System
-netstat -an | grep LIST
+module_end
-echo "]]></data>"
-echo "</module>"
 </code>
-このスクリプトをファイルに保存(ファイルコレクションでリモートから配布できます)し、エージェントから次のように実行します。
+<WRAP center round important 60%>
-<code>
-module_plugin <full path for file>
+  * In order for it to work like this, it is necessary to configure properly both Pandora FMS console (setup) and the agent that collects this information, making sure that it is //untreated//  text.
+  * In Console, option **Command line snapshot**  must be activated.
-</code>
+</WRAP>
-これにより、ほぼどんなコマンド("netstat…." の部分を任意のコマンドに置き換えてください)であっても、エージェントがコマンドのスナップショットを生成します。Unix システムでは、次のようなコマンドも便利です。
+<WRAP center round important 60%>
-<code>
+  * 動作させるには、Pandora FMS コンソール (セットアップ) とこの情報を収集するエージェントの両方を適切に設定し、情報が //未処理// テキストであることを確認する必要があります。
-* top -b -n 1
+  * コンソールでは、**コマンドラインスナップショット** オプションを有効化する必要があります。
-* ps aux
-* vmstat 1 5
-* who
-* last -10
-</code>
+</WRAP>
-Windows システムでは、つぎのようなものがあります。
+===== 画像の監視と表示 =====
-<code>
+This method allows defining modules of the string type (''generic_data_string'' or ''async_string'') that contain images in text format with a base64 encoding, being able to display said image instead of a specific result.
-* tasklist
-* netstat -an
-* net start
-</code>
+この監視では、base64 エンコードを使用したテキスト形式の画像を含む文字列型 (''generic_data_string'' または ''async_string'') のモジュールを定義でき、特定の文字列の代わりにその画像を表示できます。
-<WRAP center round tip 60%> スクリプト内で XML を生成する必要があることに注意してください。module_exec で実行してしまうと、コマンドの実行結果の一行一行が異なるデータとなってしまい、コマンドスナップショットとして見ることができません。 </WRAP>
+For example:
-<WRAP center round important 60%> 動作させるためには、Pandora FMS コンソール(セットアップ)と情報を取集するエージェントの両方の設定が必要です。 </WRAP>
+例:
-コンソールではオプションを有効化します。
-{{  :wiki:command_line_snapshot_setup.png  }}
-==== 画像の監視と表示 ====
-This method allows you to define string type modules (''generic_data_string'' or ''async_string'') that contains images in text format with [[https://docs.python.org/3/library/base64.html|base64 encoding]], being able to display that image instead of a specific result. This is stored as text information, and displayed in a different way, not as simple data, but by means of reconstructing an image when clicking in the special icon for screenshots:
-この監視では、[[https://docs.python.org/3/library/base64.html|base64 でエンコード]]されたテキストフォーマットで、画像を含む文字列タイプ(''generic_data_string'' または ''async_string'')のモジュールを定義することができ、結果に画像を表示することができます。データはテキストで保存されますが、画像として表示されます。
-'画像キャプチャ' アイコンをクリックしたときに、"data:image" (画像は base64) を含む文字列を Pandora FMS が検出します。
-{{  :wiki:snapshot_text_1.png?650  }}
-このように画像を表示するには、全データと必要な XML タグを送るプラグインを書き、モジュールプラグインとして実行する必要があります。以下のプラグインの例は、上記の画像を出力する例です。
 <code>
 #!/bin/bash
 echo "<module>"
@@ 行 1349: / 行 1371: @@
 </code>
-上記のファイルをエージェント上で保存し(またはファイルコレクションで配り)し、次のように実行します。
+Write that content to a file on the agent (or distribute by [[:en:documentation:05_big_environments:02_policy#file_collections|collections]]) and run it like this:
+上記のファイルをエージェント上で保存し(または[[:ja:documentation:05_big_environments:02_policy#ファイルコレクション|ファイルコレクション]]で配り)し、次のように実行します。
 <code>
-module_plugin < complete path to the file >
+module_plugin <complete path to the file>
 </code>
 <code>
 module_plugin <ファイルへのフルパス>
 </code>
-==== Windows における特定の監視 ====
+===== Windows における特定の監視 =====
-Windows プラットフォームのソフトウエアエージェントは、モニタリングを簡単にするための特有の機能があります。以下にいくつかの例とともに、機能の説明をします。
+<WRAP center round info 90%>
-<WRAP center round tip 60%> プロセスの名前に空白が含まれている場合は、 **''" "''  を使用しない** でください。 プロセスの名前は、拡張子 .exe を含め、Windows のタスク管理　(//taskmngr//) に表示されているものと同じである必要があります。 **大文字と小文字を尊重する**  ことが重要です。 </WRAP>
+   * If the process name contains white spaces **do not use ** **''“ ”'' **.
+   * The process name must be the same as the one displayed in the Windows Task Manager ( ''taskmngr'' ), including the extension ''.exe''.
+   * It is important to **respect upper and lower case letters**.
+</WRAP>
+<WRAP center round info 90%>
+   * プロセスの名前に空白が含まれている場合は、 **''" "''  を使用しない** でください。
+   * プロセスの名前は、拡張子 ''.exe'' を含め、Windows のタスク管理　( ''taskmngr'' ) に表示されているものと同じである必要があります。
+   * **大文字と小文字を尊重する**  ことが重要です。
+</WRAP>
-<WRAP center round tip 60%> ウォッチドックは、**モジュールが非同期の場合のみ動作します** 。 </WRAP>
+==== プロセスモニタリングと、プロセスウォッチドック ====
-=== プロセスモニタリングと、プロセスウォッチドック ===
+=== プロセスモニタリング ===
-== プロセスモニタリング ==
+The **module_proc** parameter checks if a certain process name is running on this machine. Example:
-**module_proc**  パラメータは、指定した名前のプロセスがそのマシンで動いているかどうかをチェックします。モジュール定義は次の通りです。
+**module_proc**  パラメータは、指定した名前のプロセスがそのマシンで動いているかどうかをチェックします。例:
 <code>
@@ 行 1384: / 行 1423: @@
 </code>
-プロセス名にスペースが含まれる場合は、**«" "»を使わないでください** 。プロセス名は、Windows のタスクマネージャー(taskmngr)で表示されるものと同じで、拡張子 .exe を含んでいます。**大文字、小文字を正しく設定する** ことが重要です。
+The parameter **[[:en:documentation:03_monitoring:02_operations#monitorizacion_de_servicios_y_watchdog_de_servicios|module_async yes]]** must be added:
-プロセスが動作していない時、すぐにソフトウエアエージェントから通知が欲しい場合は、**module_async yes**  のパラメータを設定します。モジュールの設定例は次の通りです。
+**module_async yes**  のパラメータを指定する必要があります。
 <code>
@@ 行 1399: / 行 1438: @@
 </code>
-== プロセスウォッチドック ==
+=== プロセスウォッチドック ===
 Windows のソフトウエアエージェントのウォッチドック機能は、プロセスがダウンしたときに再起動することができます。ウォッチドックは、モジュールが非同期の場合にのみ動作します。
@@ 行 1436: / 行 1475: @@
-=== サービスモニタリングと、サービスウォッチドック ===
+==== サービスモニタリングと、サービスウォッチドック ====
-== サービスモニタリング ==
+=== サービスモニタリング ===
 **module_service**  パラメータは、指定したサービスがマシンで動作しているかどうかをチェックします。モジュールの設定例を以下に示します。
@@ 行 1467: / 行 1506: @@
 </code>
-== サービスウォッチドック ==
+=== サービスウォッチドック ===
 プロセスと同様に、ダウンしたサービスを再起動できるウォッチドックモードがあります。ウォッチドックを使ったモジュール定義例は次の通りです。
@@ 行 1485: / 行 1524: @@
 ウォッチドックの定義には、特別なパラメータは必要ありません。サービスの定義内にあるためです。
-=== 基本リソースのモニタリング ===
+==== 基本リソースのモニタリング ====
-この項では、Windows マシンの基本的な値をモニタリングする方法について説明します。
+When installing the PFMS Software Agent for MS Windows® the necessary basic modules are included, some of them come active and others must be activated by **Remote Configuration** (or locally editing the agent's ''.conf'' file).
-== CPU のモニタリング ==
+MS Windows® 用 Pandora FMS ソフトウェアエージェントをインストールすると、必要な基本モジュールが含まれています。その一部は有効になっていますが、その他は **リモート設定** (またはエージェントの ''.conf'' ファイルをローカルで編集) によって有効化する必要があります。
+=== CPU のモニタリング ===
 CPU をモニタするには、CPU 使用率を返す **module_cpuusage**  パラメータを利用します。
@@ 行 1517: / 行 1558: @@
 </code>
-== メモリのモニタリング ==
+=== メモリのモニタリング ===
 メモリをモニタするには、システムの空きメモリ容量を返す **module_freememory** と、空き率をパーセンテージで返す **module_freepercentmemory**  の 2つのパラメータを利用できます。
@@ 行 1544: / 行 1585: @@
 </code>
-== ディスクのモニタリング ==
+=== ディスクのモニタリング ===
 ディスクスペースをモニタするには、空き容量を返す **module_freedisk**  と、空き率をパーセンテージで返す **module_freepercentdisk**  の 2つのパラメータを利用できます。両方のパラメータには、モニタするドライブ名の指定が必要で、**":" を忘れないように** してください。
@@ 行 1570: / 行 1611: @@
 </code>
-== WMI クエリ ==
+=== WMI クエリ ===
 Pandora FMS のソフトウエアエージェントは、システムに関連した情報や外部の情報を保持するのに使われる共通の技術である WMI クエリおよび ODBC 接続を使って情報を取得することができます。
@@ 行 1600: / 行 1641: @@
 </code>
-==== バージョン 7 NG 以前 ====
+[[:ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]
-=== エージェントの名前 ===
+===== (OBSOLETE) バージョン 7 NG 以前 =====
+==== エージェントの名前 ====
 Pandora FMS バージョン 7 以降では、エージェントには、別名と名前(またはユニークな識別子)があります。デフォルトでは、エージェントはランダムの 16進数から成る文字列の名前(または識別子)を生成します。また、マシンのホスト名から成る別名(または表示名)を生成します。
@@ 行 1618: / 行 1661: @@
 デフォルトでは、設定ファイルのいずれかを使用しないので、マシンのホスト名を別名として取得し、非常に大きなランダムな16進数を名前または識別子として取得します。エージェント名は表示されなくなり(エージェント詳細表示を除く)、変更することはできません。 エージェントの一意の識別子はエージェントの「名前」であるため、エージェントの別名はソフトウェアエージェントの設定を心配することなく、いつでも変更できます。
-[[:ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]