差分

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

--- ja:documentation:03_monitoring:03_remote_monitoring [2022/12/19 05:19] – [サーバプラグインを使ったモニタリング] junichi
+++ ja:documentation:03_monitoring:03_remote_monitoring [2024/01/24 05:48] – [//exec server// 機能の利用] junichi
@@ 行 1: / 行 1: @@
-====== リモートモニタリング ======
+====== リモート監視 ======
 {{indexmenu_n>3}}
 [[ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]
-===== リモートモニタリング =====
+===== リモート監視 =====
+===== 概要 =====
-==== 概要 ====
 Pandora FMS ネットワークサーバは、集中的にリモートからテストを実行することができる重要な要素です。データサーバとは逆に、ネットワークサーバは複数のプロセスキューを通してタスクを実行します。ネットワークサーバはまた、他のネットワークサーバと共にバランシング動作をしたり、他のネットワークサーバがダウンした時に、そのサーバと同等の処理を実行する代替えとして動作することができます。Pandora における HA の詳細については、それに関する章を参照してください。
@@ 行 15: / 行 16: @@
 ネットワークサーバのほかにも、様々なリモートテストを実行する Pandora FMS サーバサブタイプがあります。 この章では、ネットワークサーバ、リモートプラグインサーバー、および Windows マシンに対してリモートテストを実行するサーバ(WMIサーバ)について説明します。 WEB テストサーバ(WEBサーバまたは Goliat サーバ)としてリモートテストを実行する他のサーバには、それ専用のドキュメントの章があります。
-==== 基本的なネットワーク監視 ====
+===== 基本的なネットワーク監視 =====
 Pandora FMS のネットワークモジュールは、[[https://pandorafms.com/ja/server-monitoring/|リモートモニタリングタスク]] を実行します。リモートで実行するタスクは、次の 3つに分類されます。
@@ 行 39: / 行 41: @@
 </WRAP>
-=== ネットワークモニタリングのための一般的なモジュールの設定 ===
+==== ネットワークモニタリングのための一般的なモジュールの設定 ====
+To remotely monitor any kind of equipment or an equipment service (FTP, SSH, etc.), create the corresponding agent to monitor the service first.
 リモートからサービス (FTP、SSH など) をモニタするためには、最初にサービスをモニタするための通信を行うエージェントを作成します。
 <WRAP center round tip 60%>
-エージェントの作成は、対象のマシンのソフトウエアエージェントをインストールする必要はなく、Pandora FMS コンソールで行えばよいです。
+When talking about creating an agent, it does not mean installing a [[:en:documentation:03_monitoring:02_operations|software agent in the target machine.]], but creating an agent in the Pandora FMS interface.
 </WRAP>
+<WRAP center round tip 60%>
+エージェントの作成とは、[[:ja:documentation:03_monitoring:02_operations|対象マシンにソフトウェアエージェントをインストールする]] という意味ではなく、Pandora FMS インターフェースでエージェントを作成するという意味です。
+</WRAP>
+Go to the Pandora FMS section for console administration and click on **Resources** -> **Manage agents**:
 Pandora FMS コンソールにて、管理メニューの **リソース(Resources)** > **エージェント管理(Manage agents)** を使います。
-{{ wiki:CapturaMR1.JPG?500 }}
+{{  :wiki:pfms-resources-manage_agents.png  }}
 次の画面で、**エージェントの作成** ボタンをクリックします。
-{{ wiki:bibi.jpg?700 }}
+{{  :wiki:pfms-resources-manage_agents-create_button.png  }}
 新しいエージェントの情報を入力して、**エージェントの作成** をクリックします。
-{{ wiki:Raro.jpg?700 }}
+{{  :wiki:pfms-resources-manage_agents-create_agent.png  }}
 エージェントを作成したあと、上のプルダウンメニューからモジュールを選択します。ここで、「ネットワークサーバモジュールの新規作成」を選択し、**作成** ボタンを押します。
-{{ wiki:Sasa.jpg?500 }}
+{{  :wiki:pfms-resources-manage_agents-modules-create_a_new_network_server_module.png  }}
 以下のフォームで、ネットワークコンポーネントモジュールを選択し、右側のドロップダウンメニューで必要なチェックを見つけます。
-== Host Alive モジュール作成の例 ==
+=== Host Alive モジュール作成の例 ===
 //Host Alive// は、ping を実行することにより、デバイスがオンラインかどうかを確認する簡単なチェックです。
-{{ wiki:Alive.jpg?700 }}
+{{  :wiki:pfms-resources-manage_agents-modules-create_a_new_network_server_module-host_alive.png  }}
 //対象IP(Target IP)// に対象の IP アドレスを設定します。モジュールの定義ができたら **作成(Create)** をクリックします。
@@ 行 74: / 行 88: @@
 以下の画面では、エージェントのモジュールが表示されています。既存の Keepalive モジュール(エージェントと共に作成)と、追加した 'Host Alive' モジュールがあります。
-{{ wiki:Kiji.jpg?500 }}
+{{  :wiki:pfms-resources-manage_agents-modules-network_server_module_host_alive_created.png  }}
 見ての通り、モジュールでワーニングが出ています。ワーニングは、モジュールが追加されたばかりで、まだデータを受信していないということを意味しています。一度データを受信すると、ワーニングは消えます。
@@ 行 80: / 行 94: @@
 作成したモジュールのデータを見るには、上の方にある参照メニューをクリックします。収集した情報が表示されます。
-{{ wiki:keso.jpg?500 }}
+{{  :wiki:pfms-resources-manage_agents-modules-network_server_module_host_alive_view.png  }}
 他の種類のネットワークチェックを追加するには、上記と同じ要領で他の種類のモジュールを選択してください。
-=== ICMP モニタリング ===
+==== ICMP モニタリング ====
 前述の例は、ICMP モニタリングの例でしたが、重要で正確な情報を提供する、より基本的かつ簡単なチェック手法があります。ICMP チェックには次の 2つの種類があります。
@@ 行 91: / 行 106: @@
 **icmp_data** は、応答遅延のチェックを行います。IP アドレスに対して ICMP 応答にミリ秒単位でどれだけかかったかを確認します。
-=== TCP モニタリング ===
+==== TCP モニタリング ====
 TCP チェックは、ポートの状態や TCP サービスの状態を確認することができます。
@@ 行 151: / 行 167: @@
 最初の 3つのステップが OK (コード 250) であれば、SMTP は正常です。メールを実際に送信する必要はありません (必要であればそのような設定も可能です)。これにより、プレーンテキストを用いたプロトコルに対する TCP チェックが実現できます。
-=== リモート実行モジュール ===
+==== リモート実行モジュール ====
 <WRAP center round tip 60%>
 {{wiki:icono-modulo-enterprise.png |Enterprise 版}}バージョン 741 以降で利用できます。
@@ 行 217: / 行 234: @@
 </WRAP>
-=== ネットワークモジュールの共通拡張機能 ===
+==== ネットワークモジュールの共通拡張機能 ====
-{{ wiki:Cap5_snmp_8.png?700 }}
-**説明(Description)**
+{{  :wiki:cap5_snmp_8.png?700  }}
-モジュールの説明です。デフォルトの説明は変更できます。
-**カスタムID(Custom ID)**
+  * **Custom ID**: It allows to store an ID of an external application to facilitate the integration of Pandora FMS with third party applications. For example, a //Configuration management database//  (CMDB).
+  * **Interval**: The module's execution interval, which can be [[:en:documentation:04_using:12_console_setup#other_configuration|customized]] by an Admin user in a predefined way and then be used by standard users.
+  * **Post process**: The module's post processing. It is useful to multiply or divide the returned value, e.g. when you obtain bytes and you want to show the value in Megabytes.
+  * **Min. Value**  y **Max. Value**: Any value under the minimum or over the maximum will be taken as no valid and will be discarded.
+  * **Export target**: It is only available in Pandora FMS Enterprise Version, if you have configured [[:en:documentation:05_big_environments:03_export_server|an Export server]]
-Pandora FMS とサードパーティアプリケーションの統合を容易にするために、外部アプリケーションの ID を保存できます。 たとえば、 //構成管理データベース//(CMDB) などです。
+  * **カスタムID(Custom ID)**: Pandora FMS とサードパーティアプリケーションの統合を容易にするために、外部アプリケーションの ID を保存できます。 たとえば、 //構成管理データベース//(CMDB) などです。
+  * **間隔(Interval)**: 管理者ユーザによってあらかじめ[[:ja:documentation:04_using:12_console_setup#other_configuration|カスタマイズ]]された、標準ユーザが利用できるモジュールの実行間隔。
+  * **保存倍率(Post process)**: モジュールの事後処理です。モジュールの値に掛け算や割り算を行うのに便利です。例えば、バイト単位のデータをメガバイトで表示したい場合などです。
+  * **最小値(Min. Value)**: モジュールの最小値です。これより小さな数値は、不正とみなして破棄されます。
+  * **エクスポートターゲット(Export target)**: モジュールから返される値を[[:ja:documentation:05_big_environments:03_export_server|エクスポートサーバ]]へ渡すのに便利です。Pandora FMS Enterprise 版にのみにあり、エクスポートサーバを事前に設定する必要があります。詳細はエクスポートサーバの説明を参照してください。
-**間隔(Interval)**
+**Cron**
-モジュールの実行間隔です。エージェントとは異なります。
+If //Cron from//  is enabled, the module will be run once the current date and time match the date and time configured in //Cron from//, ignoring the module's own interval.
-表示される値は、"設定 > 画面設定(Visual Styles)" の "間隔値" の設定に依存します。
+//Cron 開始(Cron from)// が設定されているとモジュールの実行間隔は無視され、モジュールは //Cron 開始(Cron from)// で指定した日時に実行されます。
-管理者ユーザは、モジュール作成または編集時にカスタム間隔を設定することができます。通常のユーザは、あらかじめ定義された間隔のみです。画面設定(Visual Styles)で定義されていない場合は、デフォルトが表示されます。
+You may specify time periods in when the module will be executed; following the nomenclature: Minute, Hour, Month day, Month, Week day and there are three different possibilities:
-**保存倍率(Post process)**
+モジュールが実行される期間を指定できます。 分、時、日、月、曜日の命名法に従い、次の 3 つのパターンがあります。
-モジュールの事後処理です。モジュールの値に掛け算や割り算を行うのに便利です。例えば、バイト単位のデータをメガバイトで表示したい場合などです。
+  * **Cron from**  It has **Any**  set in all its fields, with no time restriction for monitoring.
+  * If **Cron from**  → some specific value and **Cron to**  all in **Any**: It will be executed just when it matches the set number. E.g.: ''15 20 * * *''  will only be executed everyday at 20:15.
+  * **Cron from**  → some specific value and **Cron to**  → → some specific value: It will be executed during the set interval. E.g.: ''5 * * * *''  and ''10 * * * *'', it will be executed every hour between minutes 5 and 10 (this is equivalent ''5-10 * * * *'').
-**最小値(Min. Value)**
+  * **Cron 開始(Cron from)** すべてのフィールドに **Any** が設定されている場合は、監視の時間制限はありません。
+  * **Cron 開始(Cron from)** が特定の値で、**Cron 終了(Cron to)** に **Any** が設定されている場合は、設定された値にマッチした際に実行されます。例: ''15 20 * * *'' は、毎日 20:15 に実行されます。
+  * **Cron 開始(Cron from)** が特定の値で、**Cron 終了(Cron to)** も特定の値が設定されている場合は、設定された期間で実行されます。例: ''5 * * * *'' および ''10 * * * *'' は、毎時 5分と 10分の間に実行されます。(''5-10 * * * *'' と同等です)
-モジュールの最小値です。これより小さな数値は、不正とみなして破棄されます。
+Example, execute every Monday at 6:30:
-**最大値(Max. Value)**
+例えば、次の設定ではモジュールは毎週月曜 6:30 に実行されます。
-モジュールの最大値です。これより大きな数値は、不正とみなして破棄されます。
+{{  :wiki:cron_from_ex1.png?600  }}
-**エクスポートターゲット(Export target)**
+Example, execute everyday between 6h and 7h:
-モジュールから返される値をエクスポートサーバへ渡すのに便利です。Pandora FMS Enterprise版にのみにあり、エクスポートサーバを事前に設定する必要があります。詳細はエクスポートサーバの説明を参照してください。
+毎日 6時と 7時の間に実行する例:
-**Cron**
+{{  :wiki:cron_from_ex2.png?600  }}
-//Cron 開始(Cron from)// が設定されているとモジュールの実行間隔は無視され、モジュールは //Cron 開始(Cron from)// で指定した日時に実行されます。例えば、次の設定ではモジュールは毎週月曜 6:30 に実行されます。
-{{ wiki:cron_from_ex1.png?600 }}
-//Cron 開始(Cron from)// と //Cron 終了(Cron to)// の両方が設定されていると、モジュールは、//Cron 開始(Cron from)// と //Cron 終了(Cron to)// の間の時間に 一度実行されます。例えば、次の設定では、毎日 6時と 7時の間に実行されます。
+For local modules, add the line //module_crontab//  corresponding to the file [[:en:documentation:03_monitoring:02_operations#programmed_monitoring|agent configuration]].
-{{ wiki:cron_from_ex2.png?600 }}
-ローカルモジュールでは、エージェント設定ファイルに //module_crontab// を設定することで対応します。
+ローカルモジュールでは、[[:ja:documentation:03_monitoring:02_operations#指定時間モニタリング|エージェント設定ファイル]]に //module_crontab// を設定することで対応します。
-詳細は、[[https://wiki.pandorafms.com/index.php?title = ja:documentation:03_monitoring:02_operations#.E6.8C.87.E5.AE.9A.E6.99.82.E9.96.93.E3.83.A2.E3.83.8B.E3.82.BF.E3.83.AA.E3.83.B3.E3.82.B0|指定時間モニタリング]] を参照してください。
+**Timeout**
+**タイムアウト(Timeout)**
+Time the agent will wait for the execution of the module in seconds.
+エージェントがモジュールの実行を待機する時間 (秒単位)。
+**Category**
 **カテゴリ(Category)**
-この分類は、通常のユーザーインターフェイスには影響を与えません。[[Pandora:Metaconsole:Documentation_ja:Introduction|メタコンソール]]と共に使用することを意図したものです。
+This categorization has no effect on the normal user interface, it is intended to be used together with the [[:en:documentation:06_metaconsole:01_introduction|Metaconsole]].
+このカテゴリは、通常のユーザインターフェイスには影響しません。[[:ja:documentation:06_metaconsole:01_introduction|メタコンソール]] と一緒に使用するためのものです。
+===== SNMP モニタリング =====
+==== SNMP モニタリングの概要 ====
-==== SNMP モニタリング ====
-=== SNMP モニタリングの概要 ===
 Simple Network Management Protocol (SNMP) は、[[https://tools.ietf.org/html/rfc3411|RFC 3411]] および [[https://tools.ietf.org/html/rfc3418|RFC 3418]] に定義されており、IETF により公開されています。同期および非同期の動作をします。
@@ 行 286: / 行 319: @@
   * デバイスが返す値をどのように扱えばよいかを確認します。SNMP デバイスは、それぞれ異なるファーマットでデータを返します。Pandora FMS は、ほとんどすべてのデータを扱うことができます。カウンタデータは、Pandora が ''remote_snmp_inc'' として管理する特別重要なものです。それは、数値データとしてではなく、カウンタとして認識されます。多くの SNMP データはカウンタ値になっています。それを正しく監視するためには、''remote_snmp_inc'' として設定する必要があります。
-=== SNMP のネットワークモジュールでのモニタリング ===
+==== SNMP のネットワークモジュールでのモニタリング ====
 Pandora FMS のデータベースには、直接使用できる OID がいくつか含まれています。 たとえば、モジュールを作成するときに Cisco MIB コンポーネントを選択すると、Cisco で使用可能な変換済みの OID チェックのリストを表示します。
@@ 行 326: / 行 360: @@
 .3.6.1.4.868.2.4.1.2.1.1.1.3.3562.3
-=== ソフトウエアエージェントからの SNMP モニタリング ===
+==== ソフトウエアエージェントからの SNMP モニタリング ====
 ローカルデータの取得に一般的に使用される [[ja:documentation:03_monitoring:02_operations|ソフトウエアエージェント]]からリモートで監視することもできます。Pandora FMS はこのような点で柔軟性を備えています。
@@ 行 391: / 行 426: @@
 </code>
-=== MIB 管理 ===
+==== MIB 管理 ====
 Pandora FMS は、事前に決定された方法で、''/usr/share/snmp/mibs'' にある OS によって管理されている MIB ディレクトリの MIB を利用します。また、新しい MIB は、**MIBアップローダー** を使用して追加(および管理)できます。これらの MIB は、Pandora でのみ利用され、保存先は、''{PANDORA_CONSOLE}/attachment/mibs'' です。
@@ 行 400: / 行 436: @@
 </WRAP>
-=== Pandora FMS SNMP ブラウザ ===
+==== Pandora FMS SNMP ブラウザ ====
 <WRAP center round tip 60%>
 {{wiki:icono-modulo-enterprise.png |Enterprise 版}}Enterprise 版バージョン 744 以降で利用できます
@@ 行 451: / 行 488: @@
 {{ wiki:Snmp browser from module creation.jpg?800 }}
-=== Pandora FMS SNMP ウィザード ===
+==== Pandora FMS SNMP ウィザード ====
 エージェント管理画面に、リモートからモジュールを作成するツール、エージェントウィザードがあります。
-{{ wiki:agent_wizard.png?500 }}
+{{  :wiki:agent_wizard.png  }}
 **SNMP ウィザード**
-[[:wiki:agent_wizard_snmp_wizard.png?id=ja%3Adocumentation%3A03_monitoring%3A03_remote_monitoring&media=wiki:agent_wizard_snmp_wizard.png|{{  :wiki:agent_wizard_snmp_wizard.png?300  }}]]
+{{  :wiki:agent_wizard.png  }}
 ホストに snmpwalk するために、対象の IP アドレス、コミュニティ、その他オプションパラメータ (SNMP v3 をサポートしています) を設定する必要があります。
-[[:wiki:snmp_wizard_form.png?id=ja%3Adocumentation%3A03_monitoring%3A03_remote_monitoring&media=wiki:snmp_wizard_form.png|{{  :wiki:snmp_wizard_form.png?600  }}]]
+{{  :wiki:snmp_wizard_form.png  }}
 データを受信すると、モジュール作成のフォームが表示されます。
 SNMP ウィザードでは、さまざまな種類の SNMP データからモジュールの作成が可能です。
+  * **Devices**
+  * **Processes**
+  * **Free Space on disk**
+  * **Temperature Sensors**
+  * **Other SNMP Data**
   * **デバイス(Devices)**
@@ 行 473: / 行 517: @@
   * **温度センサ(Temperature sensors)**
   * **その他 SNMP データ(Other SNMP Data)**
-[[:wiki:snmp_wizard_module_creator.png?id=ja%3Adocumentation%3A03_monitoring%3A03_remote_monitoring&media=wiki:snmp_wizard_module_creator.png|{{  :wiki:snmp_wizard_module_creator.png?800  }}]]
+{{  :wiki:snmp_wizard_module_creator.png  }}
 モジュールの種類を選択し、左のウインドウから右へ必要なものをもっていきます。終わったら、モジュール作成(Create modules)ボタンをクリックします。
@@ 行 494: / 行 539: @@
 すべてのブロックは、参照を容易にするために、最初は圧縮されて表示されます。そうすることで、選択範囲やデータを変更するように拡張できます。さらに、モジュールが作成対象としてマークされている各ブロックでは、これを示す情報アイコンが表示されます。
-[[:wiki:img8_wizard_components.png?id=ja%3Adocumentation%3A03_monitoring%3A03_remote_monitoring&media=wiki:img8_wizard_components.png|{{  :wiki:img8_wizard_components.png?400  }}]]
+{{  :wiki:img8_wizard_components.png  }}
 ブロックをデプロイする場合、追加するモジュールと追加しないモジュールを選択できます。また、各モジュールの名前、説明、またはしきい値を個別に変更するオプションも選択できます。
-[[:wiki:img9_wizard_components.png?id=ja%3Adocumentation%3A03_monitoring%3A03_remote_monitoring&media=wiki:img9_wizard_components.png|{{  :wiki:img9_wizard_components.png?800  }}]]
+{{  :wiki:img9_wizard_components.png  }}
 //モジュールの作成(Create modules)//  をクリックすると、選択したモジュールとその設定の概要一覧が表示されます。この一覧には、エージェントにすでに存在するか、同じ名前で 2つ以上のモジュールがウィザード自体で設定されていることで作成できなかったモジュールが表示されます。
@@ 行 506: / 行 551: @@
 それらをエージェントに追加する前に、前述のモジュールの作成を確認するか、モジュールをキャンセルしてウィザードの結果を変更するかの選択ができます。
-[[:wiki:img10_wizard_components.png?id=ja%3Adocumentation%3A03_monitoring%3A03_remote_monitoring&media=wiki:img10_wizard_components.png|{{  :wiki:img10_wizard_components.png?800  }}]]
+{{  :wiki:img10_wizard_components.png  }}
 モジュールの作成が確認されると、確認している間に同じモジュールが別の方法で作成された場合にモジュールが重複しないように、作成できるかどうか 1つずつ再評価されます。
@@ 行 514: / 行 559: @@
 **SNMP インタフェースウィザード**
-{{ wiki:agent_wizard_snmp_interfaces_wizard.png?500 }}
+{{  :wiki:agent_wizard_snmp_interfaces_wizard.png  }}
 エージェントウィザードには、インターフェイスを参照するために特別に作成された SNMP ウィザードがあります。 このウィザードは、SNMP ブランチ **IF-MIB::interfaces** を参照し、複数の選択肢を持つ異なるインターフェイスの複数のモジュールを作成する機能を提供します。対象 IP、コミュニティなどを選択した後、システムは SNMP クエリをホストに送信します。その後、モジュール作成フォームに入力します。
-{{ wiki:agent_wizard_snmp_interfaces_creation.png?800 }}
+{{  :wiki:agent_wizard_snmp_interfaces_creation.png  }}
 左側の窓から 1つ以上のインターフェースを選択します。 その後、それに関して利用可能な要素(説明、速度、インバウンド/アウトバウンドトラフィックなど)が右側に表示されます。 この窓から 1つ以上の要素を選択し、**モジュールの作成(Create module)** をクリックして、左側の窓で選択したインターフェイスごとにこれらのモジュールを作成できます。
@@ 行 528: / 行 574: @@
 追加可能なモジュールを備えた、デバイスで選択したすべてのインターフェースの概要を示す設定ブロックが表示されます。このブロックで選択されたモジュールとそのしきい値は、ネットワークインターフェイスに行われるデフォルト設定になります。 インターフェイスに一般的な監視を追加しないように、このブロックを無効にすることができます。
-{{ wiki:IMG11_wizard_components.png?800 }}
+{{  :wiki:img11_wizard_components.png  }}
 また、ネットワークインターフェースごとに特定のブロックがあり、監視するインターフェースを選択できます。さらに、前のブロックで一般的な監視が設定されている場合、チェックされたすべてのインターフェイスがそれらの設定を使用します。
-{{ wiki:IMG12_wizard_components.png?600 }}
+{{  :wiki:img12_wizard_components.png  }}
 各インターフェイスブロックでは、インターフェイスの特定の設定を指定することもできます。つまり、一般的な監視ブロックに含まれていない特定のモジュールを追加したり、特定のケースでそれらの設定を別の設定で上書きしたりできます。
 特定のケースごとにモジュールの名前と説明を変更することもできます。特定の設定が有効になるように、インターフェイスブロックを監視対象としてマークする必要があります。
-{{ wiki:IMG13_wizard_components.png?800 }}
+{{  :wiki:img13_wizard_components.png  }}
 すべてのブロックは、参照を容易にするために、最初は圧縮されて表示されます。選択やデータを変更するために展開できます。 さらに、モジュールが作成対象としてマークされている各ブロックには、それを示す情報アイコンが表示されます。
@@ 行 545: / 行 591: @@
 すべての変更を行ったのち、それらがエージェントに追加される前に、それらのモジュールの作成を確認するか、それをキャンセルしてウィザードの結果を変更し続けるかを最後に選択します。
-{{ wiki:IMG14_wizard_components.png?800 }}
+{{  :wiki:img14_wizard_components.png  }}
 モジュールの作成が確認されると、モジュールが 1つずつ再評価され、作成できるかどうかが確認されます。確認時間内に同じモジュールが別の方法で作成された場合にモジュールが重複しないようにします。
@@ 行 551: / 行 597: @@
 プロセスが正常に完了したか、作成できなかったモジュールがあるかどうかが通知されます。
-==== WMI でのリモート Windows モニタリング ====
+===== WMI でのリモート Windows モニタリング =====
 WMI は、Windows OS を実行するコンピュータのリモート情報取得用のマイクロシステムであり、Windows XP 以降のバージョンで利用できます。 WMI を使用すると、OS、アプリケーション、さらにはハードウェアのすべての種類の情報を取得できます。 WMI クエリは、ローカルでの実行（実際には、Pandora のエージェントは内部的にオペレーティングシステムの API を呼び出し WMI サブシステムに問い合わせます）または、リモートで実行することができます。 一部のシステムでは、WMI へのリモートアクセスは有効になっておらず、外部からの利用のためには有効にする必要があります。
@@ 行 618: / 行 665: @@
   * Microsoft Exchange
-=== WMI ウィザード ===
+==== WMI ウィザード ====
 エージェントウィザード(エージェントの管理画面のタブ)に、WMI ウィザードがあります。指定のエージェントにおいて WMI クエリでモジュールを参照したり作成したりするのに利用します。
@@ 行 660: / 行 708: @@
 ウィザードは、モジュールが正常に作成されたかどうか、または逆に作成できなかったモジュールがあったかどうかを通知します。
-==== サーバプラグインを使ったモニタリング ====
+===== サーバプラグインを使ったモニタリング =====
 A remote plugin is a script or executable file that supports parameters and returns a **single** value. The result could be a number, a boolean value (0 = error, OK <> 0 ), or a text string. A remote plugin usually allows input parameters. There are several server plugins installed by default and they are ready to use, bu the user may always adds more if they need so.
@@ 行 668: / 行 716: @@
 リモートプラグインには、標準タイプと Nagios タイプの 2種類があります。 違いは、Nagios リモートプラグインはエラーレベルに加えて説明文字列で応答することです。
-=== リモートプラグイン管理 ===
+==== リモートプラグイン管理 ====
-{{ wiki:verdecito1.jpg?230 }}
-**サーバ管理(manage servers)** をクリックし、**プラグイン管理(manage plugins)** をクリックすると新たなウインドウが開きます。
+{{  :wiki:pfms-servers-plugins-menu-ng-767.png  }}
-{{ wiki:verdecito2.jpg?700 }}
+Click on **Servers** and then **Plugins**, and a new window will open:
-プラグインの 1つをクリックするか、新規作成すると、次のダイアログが開きます。
+**サーバ(Servers)**、そして **プラグイン(Plugins)** をクリックするとウインドウが開きます。
-{{ wiki:plugin_create_1.jpg?700 }}
+{{  :wiki:pfms-servers-plugins-menu-ng-767-registered_plugins.png  }}
+By clicking on one of them, the following dialogue will open:
-プラグインタイプ (Plugin type)** は標準か Nagios かを設定できます。 **最大タイムアウト(Max. Timeout)** は、実行タイムアウト時間を設定します。**実行には十分な時間を確保する必要があるため、この値には特に注意してください。** そうしないと、値を取得できません。**(不明状態となります)
+いずれかをクリックすると次のダイアログが開きます。
+{{  :wiki:pfms-servers-plugins-menu-ng-767-edit_plugin_for_udp_check.png  }}
+  * **Plug-in type**: It allows setting whether it is standard or Nagios.
+  * **Max. timeout**: To fix the waiting time for its execution, pay special attention to this value since it has to provide enough time for execution, otherwise you will not get any values.
+  * **プラグインタイプ(Plug-in type)**: 標準か Nagios かを設定できます。
+  * **最大タイムアウト(Max. timeout)**: 実行タイムアウト時間を設定します。実行には十分な時間を確保する必要があるため、この値には特に注意してください。そうしないと、値を取得できません。(不明状態となります)
+<WRAP center round tip 60%>
+In a plugin execution, there are three timeouts: those of servere, those of plugins and those of modules. Please note that the server prevails over the others, and secondly that of the plugin. That is, if you have a server with a 10-second timeout and a plugin with a 20-second timeout and a module that uses that plugin with a 30-second timeout, **the maximum time to wait for the execution of that module will be 10 seconds.**</WRAP>
 <WRAP center round tip 60%>
 プラグインの実行には、サーバ、プラグイン、モジュールの 3つのタイムアウトがあります。 サーバのタイムアウトが他よりも優先され、次にプラグインのタイムアウトが優先されることに注意してください。 つまり、タイムアウトが 10秒のサーバとタイムアウトが 20秒のプラグインがあり、そのプラグインをタイムアウトが 30秒で使用するモジュールがある場合、そのモジュールのタイムアウトは 10秒になります。
 </WRAP>
+The description field is important since it will be seen in a plugin use interface by the user, make sure you choose a descriptive but short one. The following image shows a practical example:
 説明フィールドは、ユーザがプラグインを使用するインターフェースに表示されるため重要です。説明的で短いものを選択してください。 次の画像は実際の例を示しています。
-{{ wiki:macro_editor2.jpg?700 }}
+{{  :wiki:pfms-servers-plugins-menu-ng-767-edit_plugin_description.png  }}
+Essential configuration values:
 重要な設定値:
-{{ wiki:plugin_create_2.jpg?700 }}
+{{  :wiki:pfms-servers-plugins-menu-ng-767-edit_plugin_command.png  }}
   * **プラグインコマンド(Plug-in command)**: プラグインコマンドのパスです。標準のインストールでのデフォルトでは、''/usr/share/pandora_server/util/plugin/'' です。任意のパスを設定できます。独自のプラグインを利用する場合は、どこにプラグインを置いたかを確認し、実行権限(''chmod 755'')がついていることを確認してください。
@@ 行 700: / 行 764: @@
 それぞれのマクロは 3つのフィールドがあります:
-{{ wiki:macro_configuration.png?700 }}
+{{  :wiki:pfms-servers-plugins-menu-ng-767-edit_plugin_macro_parameters.png  }}
+  * **Description**: A short label next to the field in the form.
+  * **Default value**: The default value assigned to the field.
+  * **Help**: A text with an explanation of the macro, to show some examples of use or better explain what that field is for.
+  * The **Add macro**  and **Delete macro**  buttons are used to add and delete macros accordingly.
   * **説明(Description)**: マクロの簡単な説明です。フィールドのラベルになります。
   * **デフォルト値(Default value)**: デフォルトでフィールドに割り当てられる値です。
   * **ヘルプ(Help)**: マクロの説明です。フィールドの設定例などを記載するとよいでしょう。
+  * **マクロの追加(Add macro)** および **マクロの削除(Delete macro)** ボタンは、マクロの追加および削除に利用します。
+<WRAP center round info 60%>
+When you **edit**  a plugin and it is used by at least one agent, **you won't be able to **//add or delete//** the macros**.
+</WRAP>
+<WRAP center round info 60%>
+プラグインを**編集**し、それが少なくとも 1 つのエージェントによって使用されている場合、**マクロを**//追加または削除//**することはできません**。
+</WRAP>
+=== 内部マクロ ===
-== 内部マクロ ==
 アラートのように、プラグインの設定にも内部マクロを使うことができます。
@@ 行 747: / 行 831: @@
   * ''_email_tag_''> モジュールタグに関連付けられたメールアドレス。
-=== リモートプラグインの内部 ===
+==== リモートプラグインの内部 ====
 <code>
@@ 行 774: / 行 858: @@
 {{ wiki:udp_port_check_demo.jpg?600 }}
-=== 例 1: MySQL のプラグインモジュール ===
+==== 例 1: MySQL のプラグインモジュール ====
-MySQL はデータベースエンジンで、Pandora FMS ではそれぞれのユーザがカスタマイズできるデフォルトプラグインを用意しています。**Administration(管理)** -> **サーバ管理(Manage servers)** -> **プラグイン(plugins)** へ行き、MySQL 用の新たなプラグインモジュールを追加します。
+MySQL is a database engine for which Pandora FMS has created a default plugin to be customized by each client for their users. To the end go to **Servers** → **Plugins** and add a new plugin module for MySQL:
+MySQL はデータベースエンジンで、Pandora FMS ではそれぞれのユーザがカスタマイズできるデフォルトプラグインを用意しています。**サーバ(Servers)** -> **プラグイン(plugins)** へ行き、MySQL 用の新たなプラグインモジュールを追加します。
+{{  :wiki:plugin_mysql1.png  }}
 このプラグインは、起動した瞬間からユーザに対して完全に透過的な4つのチェックを提供します。
@@ 行 786: / 行 875: @@
 次の手順では、プラグインのデフォルトの場所と、前に示したチェックを実行するための 4つのパラメータに注意してください。
-{{ wiki:plugin_mysql2.png?800 }}
+{{  :wiki:plugin_mysql2.png  }}
 最初と2番目のパラメータ(IP アドレスとユーザ名)の設定:
 {{ wiki:plugin_mysql3.png?800 |最初と2番目のパラメータ(IP アドレスとユーザ名)の設定}}
-番目と4番目のパラメータ(ユーザパスワードと SQL クエリ設定:
-{{ wiki:plugin_mysql4.png?800 |3番目と4番目のパラメータ(ユーザパスワードと SQL クエリ設定}}
-プラグインは次のようになります。
+Configuration of the third and fourth parameters (user password and [[:en:documentation:01_understanding:03_glossary#database|SQL query]]):
-{{ wiki:plugin_mysql_module.png?800 }}
+番目と4番目のパラメータ(ユーザパスワードと [[:ja:documentation:01_understanding:03_glossary#データベース|SQL クエリ]]設定)
+{{  :wiki:plugin_mysql4.png  }}
+Create a module in the agent of the computer where Pandora FMS is installed and assign it; its name will be ''Mysql Connections'', using as plugin "MySQL", as IP ''localhost'', as user pandora, as password the password of Pandora FMS database, and as check the word **Connections**.
 Pandora FMS がインストールされているコンピュータのエージェントにモジュールを作成し、割り当てます。 その名前は ''Mysql Connections'' で、プラグイン "MySQL"、IP ''localhost''、ユーザ pandora、パスワードとして Pandora FMS データベースのパスワードを使用し、**Connections** という文字を確認します。
+After its creation, it should look like this:
 作成すると次のようになります。
-{{ wiki:mysql_module2.png?400 }}
+{{  :wiki:mysql_module2.png  }}
+Once created, it will appear in the list of modules, as a plugin type module (in this case, yet to be initialized)
 作成すると、プラグインタイプのモジュールとしてモジュールの一覧に表示されます(この場合、まだ初期化されていません)。
-{{ wiki:fosforo3.jpg?600 }}
+{{  :wiki:mysql_module2_created.png  }}
+==== 例2: SMTP サーバリモートプラグイン ====
-=== 例2: SMTP サーバリモートプラグイン ===
 {{ wiki:Pandora_plugin_SMTP5.png?800 }}
@@ 行 817: / 行 912: @@
 {{ wiki: smtp_module2.png?600 }}
-=== 例3: DNS サーバリモートプラグイン ===
+==== 例3: DNS サーバリモートプラグイン ====
 {{ wiki:Pandora_plugin_DNS5.png?800 }}
@@ 行 828: / 行 924: @@
 </WRAP>
-=== リモート監視のためのカスタムフィールドマクロ ===
+==== リモート監視のためのカスタムフィールドマクロ ====
 リモートモジュールを設定するとき、エージェント特有の設定オプションを何度も入力しなければならないことは面倒です(例えば、SNMP コミュニティ文字列)。カスタムフィールドマクロを使うと、特定のモジュール設定オプションのマクロとして[[ja:documentation:03_monitoring:02_operations#カスタムフィールド | エージェントカスタムフィールド]] を使うことができます。
@@ 行 850: / 行 947: @@
-==== リモートウィザードとネットワーク監視実行 (Exec Server) ====
+===== リモートウィザードとネットワーク監視実行 (Exec Server) =====
 <WRAP center round tip 60%>
-GNU/Linux へインストールした Pandora FMS サーバのみ。
-</WRAP>
-この機能は、Pandora コンソールから Pandora リモートサーバでのアクションの実行をするものです。そのため、SNMP エージェントのウィザード、MIBブラウザ、およびリモートサーバからの「イベント応答」の使用を許可し、コンソールがあるサーバからのアクセスも許可する必要があります。
+Only for PFMS servers installed on GNU/Linux.
-内部的には、"Exec Server" と呼ばれるもので、有効化されたサーバに対して Pandora コンソールから SSH でのリモートコマンド実行を通して動作します。リモートサーバは、Pandora またはサテライトサーバで、Linux である必要があります。
-=== 設定 ===
-リモート設定が有効で論理的なエージェントが既に作成されている必要があります。ユーザ("apache" など)が(公開および秘密)鍵を用いて、リモートデバイスにアクセスします。最後に自動監視処理のために SSH 接続を設定します。
-<WRAP center round important 60%>
-リモート設定が有効になってない場合、サテライトモジュールはウィザードで作成されません。
 </WRAP>
-. Pandora FMS のサーバ一覧で、exec server として利用したいサーバへアクセスする必要があります。
+<WRAP center round tip 60%>
-{{ wiki:Exec-server-111.jpg }}
+GNU/Linux へインストールした Pandora FMS サーバのみ。
+</WRAP>
-. 指定したコマンドを実行するサーバの IP を編集し、"Exec Server" の検証を有効化します。"ポート(Port)" オプションを使うことによって、サーバへ SSH 接続する際に利用するポートを指定できます。このオプションは、ネットワークサーバまたはサテライトサーバで設定できます。
+This feature allows to execute some actions in remote Pandora FMS servers from Pandora FMS console.
-{{ wiki:server_222_2.png?800 }}
+この機能は、Pandora FMS コンソールから、リモートの Pandora FMS サーバでのアクションの実行をするものです。
-<WRAP center round tip 60%>
+{{  :wiki:pfms-exec_server_enabled.png  }}
-設定が完了していないため、接続テストは失敗します。
-</WRAP>
-. Pandoraコンソールが動作するサーバーを有効にして、"apache" または同等のユーザーがシェルを実行できるようにします。 /etc/passwd ファイルを修正し、ユーザーが有効なシェルを持つように行を変更します。たとえば、次のようになります。
+Once you have configured at least one Exec server you may choose from:
-  apache:x:48:48:Apache:/var/www:/bin/bash
+少なくとも 1 つの Excec サーバを設定したら、次の選択ができます。
-. ''/var/www'' に ''.ssh'' ディレクトリを作成し、"apache" ユーザがアクセス可能なパーミッションにします。
+  * [[#pandora_fms_snmp_browser|The SNMP browser in the SNMP section]].
+  * [[:en:documentation:04_using:02_events#event_responses|The Event responses]] in the events section.
+  * [[#pandora_fms_snmp_wizard|The agent SNMP wizards]].
+  * [[#wmi_wizard|The agent WMI wizards]].
+  * [[#pandora_fms_snmp_wizard|The agent SNMP interface wizards]] (except for Satellite Server).
-<code>
+  * [[#pandora_fms_snmp_ブラウザ|SNMP セクションの SNMP ブラウザ]]
- mkdir /var/www/.ssh
+  * イベントセクションの [[:ja:documentation:04_using:02_events#イベント応答|イベント応答]]
- chown apache /var/www/.ssh
+  * [[#pandora_fms_snmp_ウィザード|エージェント SNMP ウィザード]]
-</code>
+  * [[#wmi_ウィザード|エージェント WMI ウィザード]]
+  * [[#pandora_fms_snmp_ウィザード|エージェント SNMP インタフェースウィザード]] (サテライトサーバを除く)
-. 鍵のペアを作成するために root で作業します。
+Depending on the server selected when launching each //wizard//, the modules adapted for server or Satellite Server will be created. In the latter case, the modules will be written in the remote configuration file so that they can be executed by the server.
-<code>
+各 //ウィザード// の起動時に選択したサーバに応じて、サーバまたはサテライトサーバに適合したモジュールが作成されます。 後者の場合、モジュールはサーバで実行できるようにリモート設定ファイルに書き込まれます。
- su apache
- ssh-keygen
-</code>
-"enter" を押すことによりデフォルト値を受け入れます。次のような内容が表示されます。
+The Exec servers work internally through the execution of remote SSH commands from Pandora FMS console to the enabled servers, called **Exec Server**. These can be [[:en:documentation:01_understanding:02_architecture|Network servers or Pandora FMS Satellite servers]].
-{{ wiki:Exec-server-3.jpg?500 }}
+Exec サーバは、Pandora FMS コンソールから **Exec Server** と呼ばれる有効なサーバへのリモート SSH コマンドの実行を通じて内部的に機能します。 これらは [[:ja:documentation:01_ Understanding:02_architecture|ネットワークサーバまたは Pandora FMS サテライトサーバ]] です。
-<WRAP center round tip 60%>
+The configuration process will require the assistance of the person in charge of network administration to configure both PFMS servers and the target computers and the connection and data traffic, among other aspects such as firewalls and VLAN to increase security.
-作成された鍵ファイルの場所と名前を覚えておいてください。これは、次のステップの 1つに必要なだけでなく、セキュリティにとっても重要です。
-</WRAP>
-. SSH で "Exec server" (Pandora サーバまたはサテライトサーバ)へアクセスする前に、そのマシン上に
+設定段階では、Pandora FMS サーバとターゲットコンピュータの両方、接続とデータトラフィック、特にセキュリティを強化するためのファイアウォールや VLAN などを設定するネットワーク管理担当者の支援が必要です。
-''pandora_exec_proxy'' という特定のユーザを作成し、''/home/pandora_exec_proxy/.ssh/'' ディレクトリを作成します。
-  sudo useradd pandora_exec_proxy -m
+  * You must have a logical agent configured with remote configuration enabled.
-  mkdir /home/pandora_exec_proxy/.ssh/
+  * リモート設定を有効にして論理エージェントを設定する必要があります。
 <WRAP center round important 60%>
-鍵認証のみのためユーザにはパスワードは設定しません。これによりセキュリティを高めることができます。
-</WRAP>
-. 前のステップで作成した公開鍵の内容を、Pandora コンソールから "//exec server//" にコピーします。これには、Pandora コンソールの <strong>“///var/www/.ssh/id_rsa.pub//”</strong> の内容をコピーし、exec server の <strong>///home/pandora_exec_proxy/.ssh/authorized_keys//</strong> にペーストします。その後、ファイルのパーミッションを調整します。
+Without remote configuration enabled **you will lack**  the ability to create Satellite modules from the wizards (//wizards//).
-  chown -R pandora_exec_proxy /home/pandora_exec/.ssh/
+</WRAP>
-. ユーザを作成したら、コンソールを実行しているマシンから "apache" ユーザで、パスワードなしでリモートにログインできるか確認するために次のコマンドを手動で実行します。(前の手順で設定した Exec server のホスト名/ IPを利用）
+<WRAP center round important 60%>
-  ssh pandora_exec_proxy@ip_address
+リモート設定が有効になっていないと、**ウィザード (//wizards//) からサテライトモジュールを作成する機能が動作しません**。
-. すべてのステップを正しく実行したら、apache ユーザを元の状態(ログインシェル無し)に戻すために ''/etc/passwd'' ファイルを編集します。(root でのみ実行できます。ステップ 5 を参照してください。)
+</WRAP>
-  apache:x:48:48:Apache:/var/www:/sbin/nologin
+  * You must have created digital keys (public key and private key) for the SSH connection.
+  * The public key must be copied to the target servers and must be configured to only connect that way, by digital key.
+  * On the server running the PFMS Web Console, you must have a user created at **operating system level**  and with proper access to its own directory and which allows to execute a valid //shell//  for the tasks to be entrusted.
+  * In PFMS Web Console you must log in as user //superadmin//  or //Pandora Administrator//.
-. 最後に、Pandora コンソール内のプロキシサーバの編集セクションで設定をテストをすれば、テストインジケータが緑色に変わり、完全に動作し機能します。
+  * SSH 接続用の鍵 (公開鍵と秘密鍵) を作成しておく必要があります。
+  * 公開鍵はターゲットサーバにコピーする必要があり、鍵によってのみ接続するように設定する必要があります。
+  * Pandora FMS ウェブコンソールを実行しているサーバ上では、**オペレーティングシステムレベル**でユーザを作成し、独自のディレクトリへの適切なアクセス権を持ち、タスクを実行するための有効な //shell// を実行できるようにする必要があります。
+  * Pandora FMS ウェブコンソールでは、ユーザ //superadmin// または //Pandora Administrator// としてログインする必要があります。
-{{ wiki:Exec-server-4.png?300 }}
+[[:en:documentation:07_technical_annexes:39_exec_server_configuration|See the technical annex]] for more information.
-=== //exec server// 機能の利用 ===
+より詳細は、[[:ja:documentation:07_technical_annexes:39_exec_server_configuration|技術補足資料]] を参照してください。
-MIB ブラウザー、エージェントの SNMP ウィザード、およびイベント応答で、ローカルコンソールまたは設定済みの Exec server のどちらから要求を開始するかを選択できます。
-{{ wiki:Exec-server-555.jpg }}
-また、WMI ウィザード、SNMP インターフェイス、SNMP エージェントのウィザード(サテライトサーバーでは使用できません)からも同様です。
+===== 経路監視 =====
-{{ wiki:Exec-server-666.jpg }}
+<WRAP center round tip 60%>
+Version NG 715 or higher.
-ウィザードを起動したときに選択したサーバに依存して、サテライトサーバまたはサーバに関連付けられたモジュールが作成されます。サテライトサーバーの場合は、サーバーで実行できるようにリモート構成ファイルにモジュールを書き込みます。
+</WRAP>
-"イベント応答" の実行には、最初に新たな exec server を利用する新たなイベント応答の設定を行う必要があります。
+<WRAP center round tip 60%>
-{{ wiki:Exec-server-777.jpg }}
+バージョン NG 715 以降
+</WRAP>
-そしてイベントからそれを起動します。
+Pandora FMS offers by default the monitoring of complete routes between two points in the network, visually indicating the path that is being followed at all times to communicate between these two points. Pandora FMS route analyzer uses an agent plugin to map the route.
-{{ wiki:Exec-server-8.jpg }}
+Pandora FMS は、デフォルトでネットワーク内の 2 つのポイント間の完全な経路の監視を提供し、これら 2 つのポイント間の通信のために常にたどっているパスを視覚的に示します。 Pandora FMS 経路アナライザは、エージェントプラグインを使用して経路をマッピングします。
-==== パス監視 ====
+To use this system you need:
-Pandora FMS は、ネットワークの 2つのポイント間の完全なパス監視をデフォルトで提供し、これらの 2つのポイント間の通信パスを視覚的に示します。
 このシステムを利用するには以下が必要です。
-  * 分析したいルートの発信元となるポイント上にソフトウエアエージェント
+   * A software Agent at the point of origin of the route to be analyzed.
-  * 発信元ポイントからの ICMP による宛先までの到達性
+   * Reach via ICMP from the point of origin.
-Pandora FMS パス解析は、ルートのマップ生成にエージェントプラグインを利用します。このエージェントプラグインは、情報収集し構造化した情報を Pandora サーバへレポートするためいくつかの手法を利用します。
+   * 分析したいルートの発信元となるポイント上にソフトウエアエージェント
+   * 発信元ポイントからの ICMP による宛先までの到達性
-オプションで、インターネット越しにパスをスキャンしたい場合は、発信元となるコンピュータに [[https://en.wikipedia.org/wiki/MTR_%28software%29|MTR アプリケーション]]を入れることをお勧めします。
+Optionally, if you want to do route scans over the Internet, it is recommended that you deploy the MTR application on the route source computer.
-=== 設定 ===
+オプションで、インターネット越しに経路をスキャンしたい場合は、発信元となるコンピュータに MTR アプリケーションを入れることをお勧めします。
-<WRAP center round tip 60%>
-バージョン NG 715 以上
-</WRAP>
-エージェントのプラグイン設定タブへ行き、次の行を追加します。
+Access the agent plugins configuration tab and add the following line:
-  route_parser -t <direccion_objetivo>
+エージェントプラグイン設定タブにアクセスし、次の行を追加します。
-{{ wiki:route_conf2.png?800 }}
+<code>
-ここで、''<target address>'' は、IPv4 アドレスまたは FQDN ドメイン名です。
+route_parser -t <target_address>
-  * プラグイン実行の有効化
+</code>
-**注意**
+Finally activate the execution of the plugin.
-エージェントバージョン NG 715 以前を利用している場合:
+最後にプラグインの実行を有効にします。
-  * モジュールライブラリのパス解析 [[https://pandorafms.com/library/route-parser-monitoring/|プラグインをダウンロード]] します。
-  * コレクションを介してプラグインをソフトウェアエージェントに転送します(またはファイルを手動でコピーします。次の図を参照してください)。
-{{ wiki:route_conf1.png?800 }}
+==== 表示 ====
-=== 表示 ===
 システムを設定しレポートが始まると、エージェント表示画面に新たなタブが表示され、対象との通信が確立されます。