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": "8.0.0",
  "variant": 2,
  "data": [
    {
      "value": "8.0.0"
    }
  ]
}

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

1. サーバーがTCP接続を開く
2. サーバーが<HEADER><DATALEN>{"request":"passive checks","data":[{"key":"agent.ping","timeout":3}]}を送信
3. エージェントがリクエストを読み取り、<HEADER><DATALEN>{"version":"8.0.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":"8.0.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からです。

アイテム一覧の取得

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

アクティブチェックのリクエストは、エージェントが処理するアクティブチェックを取得するために使用されます。
このリクエストは、エージェントの起動時に送信され、その後は RefreshActiveChecks 間隔で送信されます。

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

サーバーのレスポンス

アクティブチェックのレスポンスは、アクティブチェックのリクエストを処理した後にサーバーからエージェントへ返送されます。

{
  "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": "8.0.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サーバー/プロキシに対して、Zabbix agent/agent 2の設定ファイルで設定されたHeartbeatFrequency秒ごとに送信されます。

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

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

リダイレクト応答

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

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

古い XML プロトコル