3 Zabbix エージェント 2 プロトコル

概要

このセクションでは、次の情報を提供します

Agent2 -> Server : アクティブチェックリクエスト
Server -> Agent2 : アクティブチェックレスポンス
Agent2 -> Server : エージェントデータリクエスト
Server -> Agent2 : エージェントデータレスポンス

アクティブチェックリクエスト

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

フィールド	タイプ	必須	値
request	string	はい	`active checks`
host	string	はい	ホスト名
version	string	はい	エージェントのバージョン: <メジャー>.<マイナー>.
host_metadata	string	いいえ	設定パラメータ HostMetadata または HostMetadataItem メトリック値
interface	string	いいえ	設定パラメータ HostInterface または HostInterfaceItem メトリック値
ip	string	いいえ	設定パラメータ ListenIPが設定されている場合は先頭のIP
port	number	いいえ	設定パラメータ ListenPort 値 (設定されている場合) であり、デフォルトのエージェント・リスニング・ポートではありません。

例:

{
         "request": "active checks",
         "host": "Zabbix server",
         "version": "6.0",
         "host_metadata": "mysql,nginx",
         "hostinterface": "zabbix.server.lan",
         "ip": "159.168.1.1",
         "port": 12050
       }

アクティブチェックレスポンス

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

フィールド		タイプ	必須	値
response		string	yes	`success` \| `failed`
info		string	no	失敗した場合のエラー情報
data		array of objects	no	アクティブチェックアイテム
	key	string	no	マクロが展開されたアイテムキー
	itemid	number	no	アイテムID
	delay	string	no	アイテムの更新間隔
	lastlogsize	number	no	アイテムの最終ログサイズ
	mtime	number	no	アイテム修正時間
regexp		array of objects	no	グローバル正規表現
	name	string	no	Global 正規表現名
	expression	string	no	グローバル正規表現
	expression_type	number	no	グローバル正規表現タイプ
	exp_delimiter	string	no	グローバル正規表現の区切り文字
	case_sensitive	number	no	グローバル正規表現の大文字小文字の区別設定

例:

{
         "response": "success",
         "data": [
           {
             "key": "log[/home/zabbix/logs/zabbix_agentd.log]",
             "itemid": 1234,
             "delay": "30s",
             "lastlogsize": 0,
             "mtime": 0
           },
           {
             "key": "agent.version",
             "itemid": 5678,
             "delay": "10m",
             "lastlogsize": 0,
             "mtime": 0
           }
         ]
       }

エージェントデータリクエスト

エージェントデータリクエストには、収集されたアイテムの値が含まれます。

フィールド		タイプ	必須	値
request		string	はい	`agent data`
host		string	はい	ホスト名
version		string	はい	エージェントバージョン: <メジャー>.<マイナー>.
session		string	はい	エージェントが開始されるたびに生成される固有のセッション ID
data		array of objects	はい	アイテムデータオブジェクト
	id	number	はい	値の識別子 (ネットワークの問題が発生した場合に、重複した値をチェックするために使用されるインクリメントカウンター)
	itemid	number	はい	アイテムID
	value	string	いいえ	アイテム値
	lastlogsize	number	いいえ	アイテムの最終ログサイズ
	mtime	number	いいえ	アイテム修正日時
	state	number	いいえ	アイテムステータス
	source	string	いいえ	イベントログソース
	eventid	number	いいえ	イベントログイベント ID
	severity	number	いいえ	イベントログの深刻度
	timestamp	number	いいえ	イベントログのタイムスタンプ
	clock	number	はい	タイムスタンプ (エポックからの秒数)
	ns	number	はい	タイムスタンプナノ秒

例:

{
         "request": "agent data",
         "data": [
           {
             "id": 1,
             "itemid": 5678,
             "value": "2.4.0",
             "clock": 1400675595,
             "ns": 76808644
           },
           {
             "id": 2,
             "itemid": 1234,
             "lastlogsize": 112,
             "value": " 19845:20140621:141708.521 Starting Zabbix Agent [<hostname>]. Zabbix 2.4.0 (revision 50000).",
             "clock": 1400675595,
             "ns": 77053975
           }
         ],
         "host": "Zabbix server",
         "version": "6.0",
         "session": "1234456akdsjhfoui"
       }

エージェントデータレスポンス

エージェントデータレスポンス、エージェントデータリクエストを処理した後、サーバーによってエージェントに送り返されます。 | フィールド | タイプ | 必須 | 値 | |-|-|-|--------| | response | string | はい | success または failed | | info | string | はい | アイテム処理結果 |

例:

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

Heartbeat message

The heartbeat message is sent by an active agent to Zabbix server/proxy every HeartbeatFrequency seconds (configured in the Zabbix agent 2 configuration file).

It is used to monitor the availability of active checks.

{
         "request": "active check heartbeat",
         "host": "Zabbix server",
         "heartbeat_freq": 60
       }

Field	Type	Mandatory	Value
request	string	yes	`active check heartbeat`
host	string	yes	The host name.
heartbeat_freq	number	yes	The agent heartbeat frequency (HeartbeatFrequency configuration parameter).

Documentation