3 פרוטוקול Zabbix agent 2

סקירה כללית

סעיף זה מספק מידע על:

Agent2 -> שרת: בקשת בדיקות פעילה
שרת -> סוכן2: תגובת בדיקות פעילה
סוכן2 -> שרת: בקשת נתוני סוכן
שרת -> סוכן2: תגובת נתוני סוכן

Active checks request

The active checks request is used to obtain the active checks to be processed by agent. This request is sent by the agent upon start and then with RefreshActiveChecks inervals.

Field	Type	Mandatory	Value
request	string	yes	`active checks`
host	string	yes	Host name.
version	string	yes	The agent version: <major>.<minor>.
host_metadata	string	no	The configuration parameter HostMetadata or HostMetadataItem metric value.
interface	string	no	The configuration parameter HostInterface or HostInterfaceItem metric value.
ip	string	no	The configuration parameter ListenIP first IP if set.
port	number	no	The configuration parameter ListenPort value if set and not default agent listening port.

Example:

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

תגובת בדיקות פעילה

תגובת הצ'קים הפעילים נשלחת על ידי השרת בחזרה לסוכן לאחר עיבוד בקשת הצ'קים הפעילים.

שדה		הקלד	חובה	ערך
תגובה		מחרוזת	כן	`הצלחה` \| `נכשל`
מידע		מחרוזת	לא	מידע על שגיאה במקרה של כשל.
נתונים		מערך אובייקטים	לא	פריטי סימון פעילים.
	מפתח	מחרוזת	לא	מפתח פריט עם פקודות מאקרו מורחבות.
	itemid	מספר	לא	מזהה פריט.
	עיכוב	מחרוזת	לא	מרווח עדכון פריט.
	lastlogsize	מספר	לא	פריט lastlogsize.
	mtime	מספר	לא	פריט mtime.
ביטוי רגולרי		מערך אובייקטים	לא	ביטויים רגולריים גלובליים.
	שם	מחרוזת	לא	שם ביטוי רגולרי גלובלי.
	ביטוי	מחרוזת	לא	ביטוי רגולרי גלובלי.
	סוג_ביטוי	מספר	לא	סוג ביטוי רגולרי גלובלי.
	exp_delimiter	מחרוזת	לא	מפריד ביטוי רגולרי גלובלי.
	רגישות_רישיות	מספר	לא	הגדרה גלובלית של רגישות רישיות לביטוי רגולרי.

דוגמא:

{
          "response": "הצלחה",
          "נתונים": [
            {
              "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
            }
          ]
       }

בקשת נתוני סוכן

בקשת נתוני הסוכן מכילה את ערכי הפריט שנאספו.

שדה		הקלד	חובה	ערך
בקשה		מחרוזת	כן	`נתוני סוכן`
מארח		מחרוזת	כן	שם מארח.
גרסה		מחרוזת	כן	גרסת הסוכן: <major>.<minor>.
הפעלה		מחרוזת	כן	מזהה הפעלה ייחודי שנוצר בכל פעם כאשר הסוכן מופעל.
נתונים		מערך אובייקטים	כן	ערכי פריט.
	id	מספר	כן	מזהה הערך (מונה אינקרמנטלי המשמש לבדיקת ערכים משוכפלים במקרה של בעיות רשת).
	itemid	מספר	כן	מזהה פריט.
	ערך	מחרוזת	לא	ערך הפריט.
	lastlogsize	מספר	לא	הפריט lastlogsize.
	mtime	מספר	לא	הפריט mtime.
	מדינה	מספר	לא	מצב הפריט.
	מקור	מחרוזת	לא	מקור יומן האירועים של הערך.
	eventtid	מספר	לא	יומן האירועים של הערך eventtid.
	חומרה	מספר	לא	חומרת יומן האירועים של הערך.
	חותמת זמן	מספר	לא	חותמת הזמן של יומן האירועים של הערך.
	שעון	מספר	כן	חותמת הזמן של הערך (שניות מאז עידן).
	ns	מספר	כן	חותמת הזמן של הערך ננו-שניות.

דוגמא:

{
          "request": "נתוני סוכן",
          "נתונים": [
            {
              "מזהה": 1,
              "itemid": 5678,
              "value": "2.4.0",
              "שעון": 1400675595,
              "ns": 76808644
            },
            {
              "מזהה": 2,
              "itemid": 1234,
              "lastlogsize": 112,
              "value": " 19845:20140621:141708.521 מפעיל Zabbix Agent [<שם מארח>]. Zabbix 2.4.0 (גרסה 50000).",
              "שעון": 1400675595,
              "ns": 77053975
            }
          ],
          "host": "שרת Zabbix",
          "version": "6.0",
          "session": "1234456akdsjhfoui"
       }

תגובת נתוני סוכן

תגובת נתוני הסוכן נשלחת על ידי השרת בחזרה לסוכן לאחר עיבוד בקשת נתוני הסוכן.

שדה	הקלד	חובה	ערך
תגובה	מחרוזת	כן	`הצלחה` \| `נכשל`
מידע	מחרוזת	כן	תוצאות עיבוד פריטים.

דוגמא:

{
          "response": "הצלחה",
          "info": "עיבוד: 2; נכשל: 0; סה"כ: 2; שניות שהושקעו: 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

3 פרוטוקול Zabbix agent 2

סקירה כללית

Active checks request

תגובת בדיקות פעילה

בקשת נתוני סוכן

תגובת נתוני סוכן

Heartbeat message