差分

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

--- ja:documentation:pandorafms:monitoring:03_remote_monitoring [2025/07/13 07:59] – [経路監視] junichi
+++ ja:documentation:pandorafms:monitoring:03_remote_monitoring [2026/01/17 01:10] (現在) – [リモート監視] junichi
@@ 行 3: / 行 3: @@
 {{indexmenu_n>3}}
-[[ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]
+[[ja:documentation:pandorafms:start|Pandora FMS ドキュメント一覧に戻る]]
 <wrap #ks1 />
 ===== リモート監視 =====
+Key points on this topic:
+このトピックの要点:
+  * [[#ks3_2|ICMP monitoring]].
+  * [[#ks3_3|TCP monitoring]].
+  * [[#ks4|Monitoring according to SNMP]].
+  * [[#ks7|Route monitoring]].
+  * [[#ks8|Monitoring via API]].
+  * [[#ks3_2|ICMP 監視]]
+  * [[#ks3_3|TCP 監視]]
+  * [[#ks4|SNMP による監視]]
+  * [[#ks7|経路監視]]
+  * [[#ks9|API 監視]]
+Classic web monitoring [[:en:documentation:pandorafms:monitoring:06_web_monitoring|is covered in a separate topic]].
+従来の Web モニタリングについては [[:ja:documentation:pandorafms:monitoring:06_web_monitoring|別のトピックで説明します]]。
 <wrap #ks2 />
@@ 行 17: / 行 37: @@
 ネットワークサーバは、割り当てられたタスクをマルチスレッドキューシステムを介して実行し、他の [[:ja:documentation:pandorafms:complex_environments_and_optimization:06_ha|ネットワークサーバ (HA モード)]] と連携できます。
-You must have full visibility (IP addresses and ports) over which tests are going to be performed. This chapter also covers the Plugin server and WMI server.
+You must have full visibility (IP addresses and ports) over which tests are going to be performed. This chapter also covers the [[:en:documentation:pandorafms:installation:04_configuration#heavyserver|Heavy Server]].
-実行されるテストについて、完全な可視性（IPアドレスとポート）が必要です。この章では、プラグインサーバと WMI サーバについても説明します。
+どのテストを実行するかを完全に把握できる必要があります（IPアドレスとポート番号）。この章では、[[:ja:documentation:pandorafms:installation:04_configuration#heavyserver|ヘビーサーバ]]についても説明します。
-リモートテストを実行する他のサーバには、それ専用のドキュメントの章があります。
 <wrap #ks3 />
@@ 行 172: / 行 191: @@
    * **Custom ID**: allows you 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**: Module execution interval, which [[:en:documentation:pandorafms:management_and_operation:12_console_setup#other_setup|can be customized]] by an Administrator user in a predefined way and then used by standard users.
+   * **Interval**: Module execution interval, which [[:en:documentation:pandorafms:management_and_operation:12_console_setup#ks1_8_9|can be customized]] by an Administrator user in a predefined way and then used by standard users.
    * **Post process**: for post-processing of the module (multiplying or dividing the returned value), for example when getting bytes and wanting to display the value in Megabytes.
    * **Min. Value** and **Max. Value**: Any value below the minimum or above the maximum will be taken as invalid and discarded.
@@ 行 181: / 行 200: @@
   * **カスタムID(Custom ID)**: Pandora FMS とサードパーティアプリケーションの統合を容易にするために、外部アプリケーションの ID を保存できます。 たとえば、 //構成管理データベース//(CMDB) などです。
-  * **間隔(Interval)**: 管理者ユーザによってあらかじめ[[:ja:documentation:pandorafms:management_and_operation:12_console_setup#other_configuration|カスタマイズ]]された、標準ユーザが利用できるモジュールの実行間隔。
+  * **間隔(Interval)**: 管理者ユーザによってあらかじめ[[:ja:documentation:pandorafms:management_and_operation:12_console_setup#ks1_8_9|カスタマイズ]]された、標準ユーザが利用できるモジュールの実行間隔。
   * **保存倍率(Post process)**: モジュールの事後処理です。モジュールの値に掛け算や割り算を行うのに便利です。例えば、バイト単位のデータをメガバイトで表示したい場合などです。
   * **最小値(Min. Value)**: モジュールの最小値です。これより小さな数値は、不正とみなして破棄されます。
@@ 行 534: / 行 553: @@
 </WRAP>
-It is necessary to enable the **wmiserver** component in the Pandora FMS server configuration file.
-Pandora FMS サーバ設定ファイルで **wmiserver** コンポーネントを有効にする必要があります。
-<code>
-   # wmiserver : 1 or 0. Set to 1 to activate WMI server with this setup
-   # DISABLED BY DEFAULT
-     wmiserver 1
-</code>
 Queries are made in WQL, a kind of Microsoft®-specific SQL language, for any object that appears in the WMI system database.
@@ 行 850: / 行 857: @@
 最後にプラグインの実行を有効にします。
-[[ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]
+<wrap #ks9 />
+===== API 監視 =====
+<WRAP left round box 50%>
+Menu <wrap :en>**Management → Resources → Manage agents**</wrap>, direct access to <wrap :en>**Modules**</wrap> of the respective agent, <wrap :en>**Create module**</wrap> button.
+</WRAP>
+\\ \\ \\ \\ \\ \\
+<WRAP left round box 50%>
+メニュー <wrap :ja>**管理(Management) → リソース(Resources) → エージェント管理(Manage agents)**</wrap>, 対象エージェントの <wrap :ja>**モジュール(Modules)**</wrap> へアクセス、<wrap :ja>**モジュール作成(Create module)**</wrap> ボタン
+</WRAP>
+\\ \\ \\ \\ \\ \\
+There are two types of modules that share common characteristics with the rest of the modules and are used to retrieve data with API calls:
+他のモジュールと共通の特性を持ち、API 呼び出しでデータを取得するために使用されるモジュールには 2 つの種類があります。
+  * ''API retrieve module'': It can receive three types of data from the API query: numeric, true or false (//bool//), and alphanumeric.
+  * ''API 取得モジュール(API retrieve module)'': API クエリから数値、true または false (//bool//)、英数字の 3 種類のデータを受け取ることができます。
+{{ :wiki:APIRetrieveModule.png }}
+  * ''API custom module'': It only has one type //bool//, which will be normal if all conditions are met or if the API response code **does not match any** of the specified ones (the expected response code is ''200''). By default, the comparison codes with the response are ''500, 404, 403'' and as many as needed can be added, always separated by commas. If any of these codes is received as a response, the module will go into critical state (''0'').
+  * ''APIカスタムモジュール(API custom module)'': //bool//型のみを持ちます。すべての条件が満たされた場合、またはAPIレスポンスコードが指定された値のいずれにも一致しない場合（期待されるレスポンスコードは ''200''）は正常状態となります。デフォルトでは、レスポンスと比較するコードは ''500, 404, 403'' で、必要に応じてカンマで区切って追加できます。これらのコードのいずれかがレスポンスとして受信された場合、モジュールは障害状態（''0''）になります。
+In both cases, the following fields must be configured:
+どちらの場合も、次のフィールドを設定する必要があります。
+  - <wrap :en>**Timeout**</wrap>: Maximum response wait time for the API call, default is ''10'' seconds.
+  - <wrap :en>**URL**</wrap>: The web address of the API //endpoint// responsible for receiving the query.
+  - <wrap :en>**Method**</wrap>: It can be ''GET'' (default value), ''POST'', ''PUT'', ''GET'', and ''DELETE''.
+  - <wrap :en>**Ignore certificate**</wrap>: If enabled (//not recommended//), it will ignore certificates.
+  - <wrap :en>**Headers**</wrap>: The HTTP headers of the request are specified, allowing to set agreed value pairs. By default, it is set to ''Content-Type application/json'' to receive responses in JSON format, and an additional header can be added.
+  - <wrap :en>**Body**</wrap>: To specify the content of the request, the query itself (especially useful with ''PUT'' and ''POST'').
+  - <wrap :ja>**タイムアウト(Timeout)**</wrap>: API 呼び出しの最大応答待機時間。デフォルトは ''10'' 秒です。
+  - <wrap :ja>**URL**</wrap>: クエリの受信を担当する API //エンドポイント// の Web アドレス。
+  - <wrap :ja>**メソッド(Method)**</wrap>: ''GET'' (デフォルト値)、''POST''、''PUT''、''GET''、''DELETE'' を指定できます。
+  - <wrap :ja>**証明書を無視(Ignore certificate)**</wrap>: 有効にした場合 (//非推奨//)、証明書は無視されます。
+  - <wrap :ja>**ヘッダー(Headers)**</wrap>: リクエストの HTTP ヘッダーを指定し、合意された値のペアを設定できます。デフォルトでは、JSON 形式で応答を受信するために ''Content-Type application/json'' に設定されていますが、追加のヘッダーを追加することもできます。
+  - <wrap :ja>**Body**</wrap>: リクエストの内容、クエリ自体を指定します (特に ''PUT'' および ''POST'' で役立ちます)。
+For <wrap :en>**API custom module**</wrap>, there is <wrap :en>**JSON path query**</wrap>, a button {{:wiki:icon_zoom.png?nolink&21x21}} on the first line, which opens a pop-up window performing a pre-query, showing the results to specify the JSON field to be compared. Once the target is selected, the expected data type, condition, and comparison value must be specified to insert the //bool// responses into the module. As many conditions as needed can be added {{:wiki:icon_add.png?nolink&21x21}}, **all** must be met for the module to be in normal state (''1'').
+<wrap :ja>**APIカスタムモジュール(API custom module)**</wrap>には、最初の行に<wrap :ja>**JSONパスクエリ(JSON path query)**</wrap>というボタンがあります。このボタンをクリックすると、事前クエリを実行するポップアップウィンドウが開き、比較する JSON フィールドを指定するための結果が表示されます。対象を選択したら、想定されるデータ型、条件、比較値を指定して、//bool//レスポンスをモジュールに挿入する必要があります。必要な数の条件を追加できます{{:wiki:icon_add.png?nolink&21x21}}。モジュールが通常状態（''1''）になるには、**すべての**条件を満たす必要があります。
+{{ :wiki:APICustomModule.png }}
+<WRAP center round info 90%>
+  * If the API does not respond or the result returned is **not** a JSON, the module will not process anything.
+  * Date-type data should be treated as //string//, conditions accept **Regex**.
+</WRAP>
+<WRAP center round info 90%>
+  * API が応答しない場合、または返された結果が JSON でない場合、モジュールは何も処理しません。
+  * 日付型のデータは //文字列// として扱う必要があります。条件では **正規表現** が使用できます。
+</WRAP>
+[[ja:documentation:pandorafms:start|Pandora FMS ドキュメント一覧に戻る]]
 ==== (OBSOLETE) 表示 ====