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

概要

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

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

ZabbixエージェントとZabbixエージェント2のプロトコルは、Zabbix 7.0以降で統一されました。ZabbixエージェントとZabbixエージェント2のリクエスト/レスポンスの違いは、"variant"タグの値で表されます。

パッシブチェック

パッシブチェックは、単純なデータ要求です。Zabbix サーバーまたはプロキシが 何らかのデータ（たとえば CPU 使用率）を要求し、Zabbix エージェントが結果を サーバーに返します。

パッシブチェックは非同期で実行されます。1つの要求に対する応答を受信する前に、他のチェックを開始する必要はありません。DNS 解決も同様に非同期です。

エージェントポーラーは、DNS ルックアップで返されたすべてのアドレスへの接続を試みます。これにより、1つの IP アドレスに到達できない場合でも、ポーラーは次に利用可能なアドレスを試行し、接続成功の可能性が高まります。この拡張は Zabbix サーバーとプロキシの両方に適用されます。

非同期チェックの最大同時実行数は 1000 です（MaxConcurrentChecksPerPoller で定義）。

非同期エージェントポーラーの数は StartAgentPollers パラメーターで定義されます。

サーバー要求

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

{
  "request": "passive checks",
  "data": [
    {
      "key": "agent.version",
      "timeout": 3
    }
  ]
}

エージェント応答

{
  "version": "7.4.0",
  "variant": 2,
  "data": [
    {
      "value": "7.4.0"
    }
  ]
}

たとえば、サポートされているアイテムの場合:

1. サーバーが TCP 接続を開く
2. サーバーが <HEADER><DATALEN>{"request":"passive checks","data":[{"key":"agent.ping","timeout":3}]} を送信する
3. エージェントが要求を読み取り、次のように応答する <HEADER><DATALEN>{"version":"7.4.0","variant":2,"data":[{"value":1}]}
4. サーバーがデータを処理して、ここでは値 '1' を取得する
5. TCP 接続が閉じられる

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

1. サーバーが TCP 接続を開く
2. サーバーが <HEADER><DATALEN>{"request":"passive checks","data":[{"key":"vfs.fs.size[/nono]","timeout":3}]} を送信する
3. エージェントが要求を読み取り、次のように応答する <HEADER><DATALEN>{"version":"7.4.0","variant":2,"data":[{"error":"Unsupported item key."}]}
4. サーバーがデータを処理し、指定されたエラーメッセージとともにアイテムの状態をサポート対象外に変更する
5. TCP 接続が閉じられる

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

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

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

Zabbixサーバー/プロキシは、すべてのインターフェースで毎時新しいプロトコルでの動作を再試行し、必要に応じて古いプロトコルにフォールバックすることに注意してください。

アクティブチェック

アクティブチェックは、より複雑な処理を必要とします。 エージェントは、独立した処理のために、最初にサーバー/プロキシからアイテムやリモートコマンドのリストを取得する必要があります。

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

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

アイテム一覧の取得

エージェント要求

active checks 要求は、エージェントによって処理される active checks を取得するために使用されます。
この要求は、エージェント起動時に送信され、その後は RefreshActiveChecks の間隔で送信されます。

{
  "request": "active checks",
  "host": "Zabbix server",
  "host_metadata": "mysql,nginx",
  "interface": "zabbix.server.lan",
  "ip": "159.168.1.1",
  "port": 12050,
  "version": "7.4.0",
  "variant": 2,
  "config_revision": 1,
  "session": "e3dcbd9ace2c9694e1d7bbd030eeef6e"
}

サーバー応答

active checks 応答は、active checks 要求の処理後にサーバーからエージェントへ送信されます。

{
  "response": "success",
  "config_revision": 2,
  "data": [
    {
      "key": "system.uptime",
      "itemid": 1234,
      "delay": "10s",
      "lastlogsize": 0,
      "mtime": 0
    },
    {
      "key": "agent.version",
      "itemid": 5678,
      "delay": "10m",
      "lastlogsize": 0,
      "mtime": 0,
      "timeout": "30s"
    }
  ],
  "commands": [
    {
      "command": "df -h --output=source,size / | awk 'NR>1 {print $2}'",
      "id": 1324,
      "wait": 1
    }
  ]
}

サーバーは success を返さなければなりません。

例:

1. エージェントが TCP 接続を開く
2. エージェントがチェック一覧を要求する
3. サーバーがアイテム一覧と実行するリモートコマンドを返す
4. エージェントが応答を解析する
5. TCP 接続が閉じられる
6. エージェントが定期的なデータ収集を開始し、リモートコマンドを実行する（Zabbix agent 7.0 以降でサポート）

収集済みデータの送信

エージェント送信

エージェントのデータ要求には、収集されたアイテム値と、実行されたリモートコマンドの値（ある場合）が含まれます。

{
  "request": "agent data",
  "data": [
    {
      "id": 1,
      "itemid": 5678,
      "value": "7.0.0",
      "clock": 1712830783,
      "ns": 76808644
    },
    {
      "id": 2,
      "itemid": 1234,
      "value": "69672",
      "clock": 1712830783,
      "ns": 77053975
    }
  ],
  "commands": [
    {
      "id": 1324,
      "value": "16G"
    }
  ],
  "session": "8495cd52070e6ca52b371f29c8574165",
  "host": "Zabbix server",
  "version": "7.4.0",
  "variant": 2
}

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

サーバー応答

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

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

例:

1. エージェントが TCP 接続を開く
2. エージェントが値の一覧を送信する
3. サーバーがデータを処理し、ステータスを返す
4. TCP 接続が閉じられる

ハートビートメッセージ

エージェントが送信

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

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

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

リダイレクト応答

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

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

古い XML プロトコル