3 בדיקות פסיביות ואקטיביות של הסוכן (aagent)

סקירה כללית

סעיף זה מספק פרטים על בדיקות פסיביות ואקטיביות שבוצעו על ידי סוכן Zabbix.

Zabbix משתמשת בפרוטוקול תקשורת מבוסס JSON לתקשורת איתו סוכן Zabbix.

ראה גם: סוכן Zabbix 2 פרטי פרוטוקול.

צ'קים פסיביים

בדיקה פסיבית היא בקשת נתונים פשוטה. שרת Zabbix או פרוקסי שואל עבור נתונים מסוימים (לדוגמה, עומס מעבד) וסוכן Zabbix שולח בחזרה את תוצאה לשרת.

בקשת שרת

להגדרת הכותרת ואורך הנתונים נא עיין בפרוטוקול פרטים.

 <מפתח פריט>

תגובת הסוכן

 <DATA>[\0<שגיאה>]

למעלה, החלק בסוגריים מרובעים הוא אופציונלי ונשלח רק על לא פריטים נתמכים.

לדוגמה, עבור פריטים נתמכים:

1. השרת פותח חיבור TCP
2. השרת שולח <HEADER><DATALEN>agent.ping
3. הסוכן קורא את הבקשה ומשיב עם <HEADER><DATALEN>1
4. השרת מעבד נתונים כדי לקבל את הערך, '1' במקרה שלנו
5. חיבור TCP נסגר

עבור פריטים שאינם נתמכים:

1. השרת פותח חיבור TCP
2. השרת שולח <HEADER><DATALEN>vfs.fs.size[/nono]
3. הסוכן קורא את הבקשה ומשיב עם <HEADER><DATALEN>ZBX_NOTSUPPORTED\0לא ניתן להשיג מידע על מערכת הקבצים: [2] אין קובץ או ספרייה כאלה
4. שרת מעבד נתונים, משנה מצב פריט ללא תמיכה עם הודעת שגיאה שצוינה
5. חיבור TCP נסגר

בדיקות אקטיביות

בדיקות אקטיביות דורשות עיבוד מורכב יותר. הסוכן חייב קודם כל לאחזר מהשרת/ים רשימה של פריטים לעיבוד עצמאי.

השרתים שמהם ניתן לקבל את הצ'קים הפעילים מפורטים ב- פרמטר 'ServerActive' של הסוכן תצורה file. תדירות השאלות עבור בדיקות אלה מוגדר על ידי הפרמטר 'RefreshActiveChecks' ב- אותו קובץ תצורה. עם זאת, אם רענון בדיקות פעילות נכשל, זה נוסה שוב לאחר קוד קשיח של 60 שניות.

לאחר מכן, הסוכן שולח מעת לעת את הערכים החדשים לשרת/ים.

The agent then periodically sends the new values to the server(s).

קבלת רשימת הפריטים

בקשת סוכן

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

{
          "request": "בדיקות פעילות",
          "host": "שרת Zabbix",
          "host_metadata": "mysql,nginx",
          "hostinterface": "zabbix.server.lan",
          "ip": "159.168.1.1",
          "נמל": 12050
       }

תגובת השרת

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

{
          "response": "הצלחה",
          "נתונים": [
            {
              "key": "log[/home/zabbix/logs/zabbix_agentd.log]",
              "key_orig": "log[/home/zabbix/logs/zabbix_agentd.log]",
              "itemid": 1234,
              "delay": "30s",
              "lastlogsize": 0,
              "mtime": 0
            },
            {
              "key": "agent.version",
              "key_orig": "agent.version",
              "itemid": 5678,
              "delay": "10m",
              "lastlogsize": 0,
              "mtime": 0
            }
          ]
       }

השרת חייב להגיב בהצלחה.

לדוגמה:

1. הסוכן פותח חיבור TCP
2. הסוכן מבקש את רשימת הצ'קים
3. השרת מגיב עם רשימה של פריטים (מפתח פריט, עיכוב)
4. הסוכן מנתח את התגובה
5. חיבור TCP נסגר
6. הסוכן מתחיל באיסוף נתונים תקופתי

::: שימו לב חשוב שים לב שנתוני תצורה (רגישים) עשויים הופכים לזמינים לגורמים שיש להם גישה ל-Zabix Server Traper יציאה בעת שימוש בצ'ק פעיל. זה אפשרי כי כל אחד יכול להעמיד פנים שהוא סוכן פעיל ולבקש נתוני תצורה של פריט; האימות אינו מתרחש אלא אם כן אתה משתמש אפשרויות הצפנה. :::

שליחת נתונים שנאספו

הסוכן שולח

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

{
          "request": "נתוני סוכן",
          "נתונים": [
            {
              "host": "שרת Zabbix",
              "key": "agent.version",
              "value": "2.4.0",
              "שעון": 1400675595,
              "ns": 76808644
            },
            {
              "host": "שרת Zabbix",
              "key": "log[/home/zabbix/logs/zabbix_agentd.log]",
              "lastlogsize": 112,
              "value": " 19845:20140621:141708.521 מפעיל Zabbix Agent [<שם מארח>]. Zabbix 2.4.0 (גרסה 50000).",
              "שעון": 1400675595,
              "ns": 77053975
            }
          ],
          "session": "1234456akdsjhfoui"
       }

לכל ערך מוקצה מזהה וירטואלי. מזהה ערך הוא פשוט עולה מונה, ייחודי בתוך סשן נתונים אחד (זוהה על ידי הפגישה אֲסִימוֹן). המזהה הזה משמש לביטול ערכים כפולים שעלולים להישלח בסביבות קישוריות גרועות.

תגובת השרת

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

{
          "response": "הצלחה",
          "info": "עיבוד: 2; נכשל: 0; סה"כ: 2; שניות שהושקעו: 0.003534"
       }

::: שימו לב חשוב אם שליחת ערכים מסוימים נכשלת בשרת (עבור לדוגמה, מכיוון שהמארח או הפריט הושבתו או נמחקו), הסוכן יעשה זאת אל תנסה לשלוח שוב את הערכים האלה. :::

לדוגמה:

1. הסוכן פותח חיבור TCP
2. הסוכן שולח רשימת ערכים
3. השרת מעבד את הנתונים ושולח את הסטטוס בחזרה
4. חיבור TCP נסגר

שים לב כיצד בדוגמה למעלה המצב לא נתמך עבור vfs.fs.size[/nono] מסומן על ידי הערך "מצב" של 1 והערך הודעת שגיאה במאפיין "ערך".

::: שימו לב חשוב הודעת השגיאה תיחתך ל-2048 סמלים בצד השרת. :::

Heartbeat message

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

It is used to monitor the availability of active checks.

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

פרוטוקול XML ישן יותר