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

概要

このセクションでは、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接続が閉じられます

旧プロトコルへのフェイルオーバー

Zabbixサーバーまたはプロキシが、プレーンテキストプロトコルを使用する7.0より前のバージョンのエージェントと確実に連携できるように、旧プロトコルへのフェイルオーバーが実装されています。

再起動後、またはインターフェース設定の変更時に、JSONプロトコル（7.0以降）を使用したパッシブチェックが実行されます。 有効なJSONが応答として受信されない場合（エージェントが"ZBX_NOTSUPPORTED"を送信した場合）、Zabbixはインターフェースを旧プロトコルとしてキャッシュし、アイテムキーのみを送信してチェックを再試行します。

Zabbixサーバー/プロキシは1時間ごとにすべてのインターフェースで新プロトコルの使用を再度試み、必要に応じて旧プロトコルにフォールバックします。

アクティブチェック

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

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

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

エージェントは定期的に新しい値をサーバーに送信します。 エージェントが実行すべきリモートコマンドを受信した場合は、実行結果も送信されます。 アクティブエージェントでのリモートコマンド実行は、Zabbixエージェント 7.0以降でサポートされています。

アイテムのリスト取得

エージェントリクエスト

アクティブ チェック要求は、エージェントによって処理されるアクティブ チェックを取得するために使用されます。 この要求は、開始時にエージェントによって送信され、その後 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"プロパティのエラーメッセージによって指摘されています。

ハートビートメッセージ

エージェントが送信

ハートビートメッセージは、アクティブエージェントからZabbixサーバー/プロキシに、HeartbeatFrequency秒ごとに送信されます（Zabbixエージェント/ エージェント2設定ファイルで設定）

これは、アクティブチェックの可用性を監視するために使用されます。

{
         "request": "active check heartbeat",
         "host": "Zabbix server",
         "heartbeat_freq": 60,
         "version": "7.0.0",
         "variant": 2
       }

リダイレクト応答

ホストが再割り当てされた場合、サーバーはエージェントに対し、ハートビート（および後続のアクティブチェック）を別のプロキシまたはサーバーインスタンスにリダイレクトするよう指示する場合があります。

  {
           "response": "failed",
           "redirect": {
             "revision": 2,
             "address": "192.0.2.0:10055"
           }
         }

古い XML プロトコル