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

概要

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

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

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

パッシブチェック

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

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

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

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

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

サーバー要求

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

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

エージェント応答

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

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

1. サーバーがTCP接続を開く
2. サーバーが <HEADER><DATALEN>{"request":"passive checks","data":[{"key":"agent.ping","timeout":3}]} を送信する
3. エージェントが要求を読み取り、<HEADER><DATALEN>{"version":"7.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":"7.0.0","variant":2,"data":[{"error":"Unsupported item key."}]} を返す
4. サーバーがデータを処理し、指定されたエラーメッセージとともにアイテムの状態を未サポートに変更する
5. TCP接続が閉じられる

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

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

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

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

アクティブチェック

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

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

::: ヒント Zabbix 6.4 以降、エージェント（アクティブモード）は、サーバー/プロキシから2分ごと（デフォルト）に設定の完全なコピーを受信しなくなりました。 代わりに、ネットワークトラフィックとリソース使用量を削減するために、5秒ごと（デフォルト）に設定の増分同期が実行され、エージェントがまだ設定を受け取っていない場合、またはホスト設定、グローバルマクロ、またはグローバル正規表現に変更があった場合にのみ、サーバー/プロキシから設定の完全なコピーが提供されます。 :::

エージェントは定期的に新しい値をサーバーに送信します。 エージェントが実行すべきリモートコマンドを受信した場合は、実行結果も送信されます。 アクティブエージェントでのリモートコマンド実行は、Zabbixエージェント 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": "7.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": "7.0.0",
  "variant": 2
}

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

サーバーのレスポンス

エージェントデータレスポンスは、エージェントデータリクエストの処理後にサーバーからエージェントへ送信されます。

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

例:

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

ハートビートメッセージ

エージェントが送信

ハートビートメッセージは、アクティブエージェントから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 プロトコル