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

概要

このセクションでは、Zabbix agentによって実行されるパッシブおよびアクティブ チェックの詳細について説明します。

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

参照: Zabbix agent 2 プロトコルの詳細。

パッシブチェック

パッシブチェックは単純なデータリクエストです。 Zabbixサーバーまたはプロキシがデータ（CPU負荷など）を要求し、Zabbixエージェントがデータをサーバーに送り返します。

サーバーリクエスト

ヘッダーとデータ長の定義については、プロトコルの詳細を参照してください。

<item key>

エージェントの応答

<DATA>[\0<ERROR>]

上記の角括弧内の部分はオプションであり、サポートされていないアイテムに対してのみ送信されます。

サポートされているアイテムの場合：

1. サーバーがTCP接続を開きます
2. サーバーが<HEADER><DATALEN>agent.pingを送信します
3. エージェントはリクエストを読み取り、<HEADER><DATALEN>1で応答します
4. サーバーはデータを処理して値を取得します。今回の場合は"1"です。
5. TCP接続が閉じられます

サポートされていないアイテムの場合：

1. サーバーがTCP接続を開きます
2. サーバーは<HEADER><DATALEN>vfs.fs.size[/nono]を送信します
3. エージェントはリクエストを読み取り、次のレスポンスを返します。<HEADER><DATALEN>ZBX_NOTSUPPORTED\0Cannot obtain filesystem information: [2] No such file or directory
4. サーバーはデータを処理し、アイテムの状態をサポートされていない状態に変更し、指定されたエラーメッセージを表示します
5. TCP接続が閉じられます

アクティブチェック

アクティブチェックには、より複雑な処理が必要です。 エージェントは、最初にサーバーから独立した処理でアイテムのリストを取得します。

アクティブチェックを取得するサーバーは、エージェント構成ファイルの"ServerActive"パラメーターにリストされています。 これらのチェックを要求する頻度は、同じ構成ファイルの"RefreshActiveChecks"パラメーターによって設定されます。 ただしアクティブチェックの更新に失敗した場合は、ハードコードされた60秒後に再試行されます。

その後、エージェントは定期的に新しい値をサーバーに送信します。

The agent then periodically sends the new values to the server(s).

アイテムのリスト取得

エージェントリクエスト

アクティブ チェック要求は、エージェントによって処理されるアクティブ チェックを取得するために使用されます。 この要求は、開始時にエージェントによって送信され、その後 RefreshActiveChecks 間隔で送信されます。

{
         "request": "active checks",
         "host": "Zabbix server",
         "host_metadata": "mysql,nginx",
         "hostinterface": "zabbix.server.lan",
         "ip": "159.168.1.1",
         "port": 12050
       }

サーバーレスポンス

アクティブ チェック応答は、アクティブ チェック要求を処理した後、サーバーによってエージェントに返されます。

{
         "response": "success",
         "data": [
           {
             "key": "log[/home/zabbix/logs/zabbix_agentd.log]",
             "key_orig": "log[/home/zabbix/logs/zabbix_agentd.log]",
             "itemid": 1234,
             "delay": "30s",
             "lastlogsize": 0,
             "mtime": 0
           },
           {
             "key": "agent.version",
             "key_orig": "agent.version",
             "itemid": 5678,
             "delay": "10m",
             "lastlogsize": 0,
             "mtime": 0
           }
         ]
       }

サーバーは成功で応答する必要があります。

例: 1. エージェントがTCP接続を開きます 2. エージェントがチェックのリストを要求します 3. サーバーはアイテムのリスト（アイテムキー、遅延）で応答します 4. エージェントが応答を解析します 5. TCP接続が閉じられます 6. エージェントが定期的なデータ収集を開始します

収集データの送信

エージェント送信

エージェント データ リクエストには、収集されたアイテムの値が含まれます。

{
         "request": "agent data",
         "data": [
           {
             "host": "Zabbix server",
             "key": "agent.version",
             "value": "2.4.0",
             "clock": 1400675595,
             "ns": 76808644
           },
           {
             "host": "Zabbix server",
             "key": "log[/home/zabbix/logs/zabbix_agentd.log]",
             "lastlogsize": 112,
             "value": " 19845:20140621:141708.521 Starting Zabbix Agent [<hostname>]. Zabbix 2.4.0 (revision 50000).",
             "clock": 1400675595,
             "ns": 77053975
           }
         ],
         "session": "1234456akdsjhfoui"
       }

各値には仮想IDが割り当てられます。 値IDは、1つのデータセッション（セッショントークンで識別される）内で一意の単純な昇順カウンターです。 このIDは、接続性の低い環境で送信される可能性のある重複値を破棄するために使用されます。

サーバー応答

エージェントデータ応答は、エージェントデータ要求を処理した後、サーバーによってエージェントに送り返されます。

{
         "response": "success",
         "info": "processed: 2; failed: 0; total: 2; seconds spent: 0.003534"
       }

例:

1. エージェントがTCP接続を開きます。
2. エージェントが値のリストを送信します。
3. サーバがそのデータを処理し、ステータスを返します。
4. TCP接続を閉じます。

上記の例では、vfs.fs.size[/nono]がサポートされていないステータスであることを、"state"の値が1および"value"プロパティのエラーメッセージによって指摘されています。

Heartbeat message

The heartbeat message is sent by an active agent to Zabbix server/proxy every HeartbeatFrequency seconds (configured in the Zabbix agent configuration file).

It is used to monitor the availability of active checks.

{
         "request": "active check heartbeat",
         "host": "Zabbix server",
         "heartbeat_freq": 60
       }

古い XML プロトコル