差分

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

--- ja:documentation:pandorafms:monitoring:03_remote_monitoring [2025/11/22 23:13] – [WMI でのリモート Windows モニタリング] 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 />
@@ 行 837: / 行 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) 表示 ====