[comment]: # translation:outdated

[comment]: # ({a6d31bd3-a6d31bd3})
# 2 パッシブおよびアクティブエージェントチェック

[comment]: # ({/a6d31bd3-a6d31bd3})

[comment]: # ({1b7bc303-7bd0dd61})
#### 概要

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

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

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

[comment]: # ({/1b7bc303-7bd0dd61})

[comment]: # ({db675be2-e6db8dd6})
#### パッシブチェック

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

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

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

非同期チェックの最大同時実行数は1000です（[MaxConcurrentChecksPerPoller](/manual/appendix/config/zabbix_server#maxconcurrentchecksperpoller)で定義）。

非同期エージェントpollerの数は、[StartAgentPollers](/manual/appendix/config/zabbix_server#startagentpollers)パラメータで定義されます。

**サーバー要求**

ヘッダーおよびデータ長の定義については、[プロトコルの詳細](/manual/appendix/protocols/header_datalen)を参照してください。

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

| Field |<| Type | Mandatory | Value |
|-|------|--|-|-----------------------|
| request |<| _string_ | yes | `"passive checks"` |
| data |<| _array of object_ | yes | パッシブチェックのアイテム。 |
| | key | _string_ | yes | マクロ展開後のアイテムキー。 |
|^| timeout | _number_ | yes | 通信タイムアウト。 |

**エージェント応答**

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

| Field |<| Type | Mandatory | Value |
|-|------|--|-|-----------------------|
| version |<| _string_ | yes | エージェントのバージョン番号。 |
| variant |<| _number_ | yes | エージェントのバリアント（*1* - Zabbix agent、*2* - Zabbix agent 2）。 |
| data |<| _array of object_ | yes | チェック結果を含みます。 |
| | value | _string_ | no | チェックが成功した場合のアイテム値。 |
| | error | _string_ | no | チェックが成功しなかった場合のエラーメッセージ。 |

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

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接続が閉じられる

[comment]: # ({/db675be2-e6db8dd6})

[comment]: # ({8a5c8e4e-d33dfdd3})
##### 旧プロトコルへのフェイルオーバー

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

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

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

[comment]: # ({/8a5c8e4e-d33dfdd3})

[comment]: # ({86593407-ecdd6e8e})
#### アクティブチェック

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

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

[comment]: # ({/86593407-ecdd6e8e})

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

[comment]: # ({/e520c471-4c14cd28})

[comment]: # ({63166bda-2f80420a})
エージェントは定期的に新しい値をサーバーに送信します。
エージェントが実行すべき[リモートコマンド](/manual/config/notifications/action/operation/remote_command)を受信した場合は、実行結果も送信されます。
アクティブエージェントでのリモートコマンド実行は、Zabbixエージェント 7.0以降でサポートされています。

::: ヒント
エージェントがファイアウォールの内側にある場合は、アクティブチェックのみを使用することを検討してください。この場合、最初の受信接続を許可するためにファイアウォールを変更する必要はありません。
:::

[comment]: # ({/63166bda-2f80420a})

[comment]: # ({fa921319-d898e135})
##### アイテムのリストの取得

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

アクティブチェックのリクエストは、エージェントによって処理されるアクティブチェックを取得するために使用されます。  
このリクエストは、エージェントの起動時に送信され、その後は [RefreshActiveChecks](/manual/appendix/config/zabbix_agent2) 間隔で送信されます。

```json
{
  "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"
}
```

| Field | Type | Mandatory | Value |
|-|-|-|--------|
| request | _string_ | yes | `active checks` |
| host | _string_ | yes | ホスト名。 |
| host_metadata | _string_ | no | 設定パラメータ HostMetadata または HostMetadataItem メトリクス値。 |
| interface | _string_ | no | 設定パラメータ HostInterface または HostInterfaceItem メトリクス値。 |
| ip | _string_ | no | 設定されている場合、設定パラメータ ListenIP の最初のIP。 |
| port | _number_ | no | 設定されている場合、かつデフォルトのエージェント待ち受けポートでない場合の設定パラメータ ListenPort の値。 |
| version | _string_ | yes | エージェントのバージョン番号。 |
| variant | _number_ | yes | エージェントのバリアント（*1* - Zabbix agent、*2* - Zabbix agent 2）。 |
| config_revision | _number_ | no | [増分設定同期](#active-checks) の設定識別子。 |
| session | _string_ | no | [増分設定同期](#active-checks) のセッション識別子。 |
  
**サーバーのレスポンス**

アクティブチェックのレスポンスは、アクティブチェックのリクエストを処理した後にサーバーからエージェントへ返送されます。
  
```json
{
  "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
    }
  ]
}

```

| Field |<| Type | Mandatory | Value |
|-|------|--|-|-----------------------|
| response |<| _string_ | yes | `success` \| `failed` |
| info |<| _string_ | no | 失敗時のエラー情報。 |
| data |<| _array of objects_ | no | アクティブチェックのアイテム。ホスト設定が変更されていない場合は省略されます。 |
| | key | _string_ | no | マクロ展開後のアイテムキー。 |
|^| itemid | _number_ | no | アイテム識別子。 |
|^| delay | _string_ | no | アイテムの更新間隔。<br>柔軟な間隔/スケジューリング間隔は、Zabbix 7.0 以降、Zabbix agent と Zabbix agent 2 の両方でサポートされています。 |
|^| lastlogsize | _number_ | no | アイテムの lastlogsize。 |
|^| mtime | _number_ | no | アイテムの mtime。 |
|^| timeout | _string_ | no | アイテムのタイムアウト。 |
| refresh_unsupported |<| _number_ | no | 未サポートのアイテムの更新間隔。 |
| regexp |<| _array of objects_ | no | グローバル正規表現。 |
| | name | _string_ | no | グローバル正規表現名。 |
|^| expression | _string_ | no | グローバル正規表現。 |
|^| expression_type | _number_ | no | グローバル正規表現のタイプ。 |
|^| exp_delimiter | _string_ | no | グローバル正規表現の区切り文字。 |
|^| case_sensitive | _number_ | no | グローバル正規表現の大文字・小文字の区別設定。 |
| commands |<| _array of objects_ | no | 実行するリモートコマンド。アクションの[実行内容](/manual/config/notifications/action/operation#operations)または手動の[スクリプト](/manual/web_interface/frontend_sections/alerts/scripts)実行によってリモートコマンドの実行がトリガーされた場合に含まれます。アクティブなエージェントでのリモートコマンド実行は Zabbix agent 7.0 以降でサポートされていることに注意してください。これより古いアクティブなエージェントは、アクティブチェックのサーバーレスポンスに含まれるリモートコマンドを無視します。 |
| | command | _string_ | no | リモートコマンド。 |
|^| id | _number_ | no | リモートコマンド識別子。 |
|^| wait | _number_ | no | リモートコマンドの実行モード（アクションの[実行内容](/manual/config/notifications/action/operation#operations)からのコマンドは "0"（nowait）、手動の[スクリプト](/manual/web_interface/frontend_sections/alerts/scripts)実行からのコマンドは "1"（wait））。 |
| config_revision | < | _number_ | no | [増分設定同期](#active-checks) の設定識別子。ホスト設定が変更されていない場合は省略されます。ホスト設定が変更された場合はインクリメントされます。 |
  
サーバーは success を返さなければなりません。

例:

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

::: noteimportant
アクティブチェックを使用する場合、機密性の高い設定データが、Zabbix server trapper
ポートにアクセスできる第三者に利用可能になる可能性があることに注意してください。これは、誰でもアクティブなエージェントを装ってアイテム設定データを要求できるためです。
[暗号化](/manual/encryption) オプションを使用しない限り、認証は行われません。
:::

[comment]: # ({/fa921319-d898e135})

[comment]: # ({1e8860e1-8c5ecfe1})
##### 収集したデータの送信

**エージェントからの送信**

エージェントのデータリクエストには、収集されたアイテムの値と、実行されたリモートコマンドの値（存在する場合）が含まれます。
  
```json
{
  "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
}
```

| Field |<| Type | Mandatory | Value |
|-|------|--|-|-----------------------|
| request |<| _string_ | yes | `agent data` |
| data |<| _array of objects_ | yes | アイテムの値。 |
| | id | _number_ | yes | 値の識別子（ネットワーク障害時に重複した値を確認するために使用される増分カウンター）。 |
|^| itemid | _number_ | yes | アイテム識別子。 |
|^| value | _string_ | no | アイテムの値。 |
|^| lastlogsize | _number_ | no | アイテムの lastlogsize。 |
|^| mtime | _number_ | no | アイテムの mtime。 |
|^| state | _number_ | no | アイテムの状態。 |
|^| source | _string_ | no | 値のイベントログソース。 |
|^| eventid | _number_ | no | 値のイベントログ eventid。 |
|^| severity | _number_ | no | 値のイベントログ severity。 |
|^| timestamp | _number_ | no | 値のイベントログ timestamp。 |
|^| clock | _number_ | yes | 値のタイムスタンプ（Epoch からの秒数）。 |
|^| ns | _number_ | yes | 値のタイムスタンプのナノ秒。 |
| commands |<| _array of objects_ | no | リモートコマンド実行結果。アクティブエージェントでのリモートコマンド実行は、Zabbix agent 7.0 以降でサポートされています。これより古いアクティブエージェントは、アクティブチェックのサーバーレスポンスに含まれるリモートコマンドを無視します。 |
| | id | _number_ | no | リモートコマンド識別子。 |
|^| value | _string_ | no | 実行が成功した場合のリモートコマンド実行結果。 |
|^| error | _string_ | no | 実行が失敗した場合のリモートコマンド実行エラーメッセージ。 |
| session |<| _string_ | yes | エージェントの起動時ごとに生成される一意のセッション識別子。 |
| host |<| _string_ | yes | ホスト名。 |
| version |<| _string_ | yes | エージェントのバージョン番号。 |
| variant |<| _number_ | yes | エージェントのバリアント（*1* - Zabbix agent、*2* - Zabbix agent 2）。 |

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

**サーバーのレスポンス**

エージェントデータレスポンスは、エージェントデータリクエストの処理後にサーバーからエージェントへ送信されます。
  
```json
{
  "response": "success",
  "info": "processed: 2; failed: 0; total: 2; seconds spent: 0.003534"
}
```

| Field | Type | Mandatory | Value |
|-|-|-|--------|
| response | _string_ | yes | `success` \| `failed` |
| info | _string_ | yes | アイテム処理結果。 |
  
::: noteimportant
サーバーで一部の値の送信に失敗した場合（たとえば、
ホストまたはアイテムが無効化または削除されている場合）、エージェントは
それらの値の再送を行いません。
:::

例:

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

::: noteimportant
エラーメッセージはサーバー側で 2048 文字に切り詰められます。
:::

[comment]: # ({/1e8860e1-8c5ecfe1})

[comment]: # ({65122d4f-ee2b7a2a})

##### ハートビートメッセージ

**エージェントが送信**

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

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

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

| フィールド | タイプ | 必須 | 値 |
|-|-|-|--------|
| request | _string_ | yes | `アクティブチェックハートビート` |
| host | _string_ | yes | ホスト名 |
| heartbeat_freq | _number_ | yes | エージェントのハートビート頻度（HeartbeatFrequency 設定パラメータ） |
| version | _string_ | yes | エージェントのバージョン番号 |
| variant | _number_ | yes | エージェントのバリアント（*1* - Zabbix エージェント、*2* - Zabbix エージェント 2） |

**リダイレクト応答**

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

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

| フィールド |<| タイプ | 必須 | 値 |
|-|------|--|-|-----------------------|
| response |<| _string_ | yes | `success` \| `failed` |
| redirect |<| _object_ | yes | リダイレクトの指示 |
| | revision | _number_ | yes | 設定リビジョン識別子 |
|^| address | _string_ | yes | ターゲット サーバ/プロキシ アドレス |

[comment]: # ({/65122d4f-ee2b7a2a})

[comment]: # ({e66043c4-e66043c4})
#### 古い XML プロトコル

::: noteclassic
Zabbixは、 Base64にエンコードされたXMLのデータを16MBまで取得しますが、デコードされる値は1つが64KB以下でなければなりません。そうでないと、デコード中にそれが64KBに切り捨てられます。
:::

[comment]: # ({/e66043c4-e66043c4})