Documentation
Table of Contents
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"
}תגובת נתוני סוכן
תגובת נתוני הסוכן נשלחת על ידי השרת בחזרה לסוכן לאחר עיבוד בקשת נתוני הסוכן.
| שדה | הקלד | חובה | ערך |
|---|---|---|---|
| תגובה | מחרוזת | כן | הצלחה | נכשל |
| מידע | מחרוזת | כן | תוצאות עיבוד פריטים. |
דוגמא: