This is a translation of the original English documentation page. Help us make it better.

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