龙虎赌博

Table of Contents

3 パッシブエージェントチェックとアクティブエージェントチェック

3 パッシブエージェントチェックとアクティブエージェントチェック

概要

このセクションでは、龙虎赌博エージェントによるパッシブチェックとアクティブチェックの詳細を説明します。

龙虎赌博は、龙虎赌博エージェントとの通信にJSON ベースの通信プロトコルを使用します。

龙虎赌博によって使用されるプロトコルの詳細には、次のようないくつかの定義が使用されます：

<HEADER> - "ZBXD\x01" (5 bytes)
       <DATALEN> - data length (8 bytes). 1 will be formatted as 01/00/00/00/00/00/00/00 (eight bytes in HEX, 64 bit number)

（潜在的に）メモリを使い果たさないように、バージョン2.2.0 ～ 2.2.2で龙虎赌博プロトコルを使用するとき、龙虎赌博サーバは1回の通信で64MBだけ受信するように制限されています（2.2.0以前は128MB、龙虎赌博 2.0.3以前は無制限でした）。

龙虎赌博の以前のバージョンとの互換性を維持するため、2.2.3以降では64MB が128MBへ戻されました。データ転送限界128MBのあるプロセスから限界64MBの別のプロセスへデータを送信する場合、受信側は、自身のサイズ限界を超えるデータは欠落します。

パッシブチェック

パッシブチェックは、単純なデータのリクエストです。龙虎赌博サーバまたはプロキシが、データ（例えば、CPU負荷）を問い合わせ、龙虎赌博エージェントがサーバに結果を返します。

サーバのリクエスト

<item key>\n

エージェントの応答

<HEADER><DATALEN><DATA>

例：

サーバが罢颁笔接続を开きます。
サーバがagent.ping\nを送信します。
エージェントがリクエストを読み、<HEADER><DATALEN>1 で応答します。
サーバがデータを処理して値（この场合は「1」）を取得します。
罢颁笔接続を闭じます。

アクティブチェック

アクティブチェックでは、もっと复雑な処理を必要とします。エージェントは最初に、独立した処理でサーバからアイテムのリストを検索します。

アクティブチェックを行うサーバは、エージェントの设定ファイル内の「ServerActive」パラメータに記載されます。これらのチェックの問い合わせ頻度は、同じ设定ファイル内の「RefreshActiveChecks」パラメータによって設定されます。しかし、アクティブチェックのリフレッシュが失敗した場合は、ハードコードされた60秒後に再試行されます。それから、エージェントは新しい値を定期的にサーバに送信します。

アイテムのリストの取得

エージェントのリクエスト

<HEADER><DATALEN>{
          "request":"active checks",
          "host":"<hostname>"
       }

サーバの応答

{
           "response":"success",
           "data":[
           {
               "key":"log[\/home\/zabbix\/logs\/zabbix_agentd.log]",
               "delay":"30",
               "lastlogsize":"0"
           },
           {
               "key":"agent.version",
               "delay":"600"
           }
           ]
       }

サーバは成功で応答しなければなりません。返されたアイテムごとに、keyとdelayが存在しなければなりません。「ログ」タイプを持つアイテムには、lastlogsize も存在しなければなりません。

例：

エージェントが罢颁笔接続を开きます。
エージェントがチェックのリストを问い合わせます。
サーバがアイテムのリスト（アイテムキー、遅延）で応答します。
エージェントがその応答を构文解析します。
罢颁笔接続を闭じます。
エージェントが定期的なデータ収集を开始します。

アクティブチェックを使用する际、窜补产产颈虫サーバのトラッパーポートへアクセスは、（慎重に扱うべき）设定データを利用できるようになりますので、注意してください。これができるのは、谁もがアクティブエージェントに成りすまし、アイテム设定データをリクエストできるためです；认証は発生しません。

収集データの送信

エージェントが以下を送信します。

<HEADER><DATALEN>{
          "request":"agent data",
          "data":[
              {
                  "host":"<hostname>",
                  "key":"log[\/home\/zabbix\/logs\/zabbix_agentd.log]",
                  "value":" 13039:20090907:184546.759 zabbix_agentd started. ZABBIX 1.6.6 (revision {7836}).",
                  "lastlogsize":80,
                  "clock":1252926015
              },
              {
                  "host":"<hostname>",
                  "key":"agent.version",
                  "value":"1.6.6",
                  "clock":1252926015
              }
          ],
          "clock":1252926016
       }

サーバの応答

<HEADER><DATALEN>{
           "response":"success",
           "info":"Processed 2 Failed 0 Total 2 Seconds spent 0.002070"
       }

サーバ上でいくつかの値の送信に失败した场合（例えば、ホストまたはアイテムが无効であるか削除されていた）、エージェントはこれらの値の送信を再试行しません。

例：

エージェントが罢颁笔接続を开きます。
エージェントが値のリストを送信します。
サーバがそのデータを処理し、ステータスを返します。
罢颁笔接続を闭じます。

古い XML プロトコル

龙虎赌博は、 Base64にエンコードされたXMLのデータを16MBまで取得しますが、デコードされる値は1つが64KB以下でなければなりません。そうでないと、デコード中にそれが64KBに切り捨てられます。

本ページは2014/08/05时点の原文を基にしておりますので、内容は必ずしも最新のものとは限りません。
最新の情报は、英语版の窜补产产颈虫2.2マニュアルを参照してください。