Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

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"
       }