פרוטוקול Zabbix agent 2 מבוסס על קוד, גודל ומודל נתונים.
| סוג | גודל | הערות |
|---|---|---|
| בייט | 4 | סוג מטען, כרגע רק JSON נתמך. |
| סוג | גודל | הערות |
|---|---|---|
| בייט | 4 | גודל המטען הנוכחי בבתים. |
| סוג | גודל | הערות |
|---|---|---|
| בייט | מוגדר על ידי שדה גודל | נתונים בפורמט JSON. |
פרמטרים אלה קיימים בכל הבקשות/תגובות:
| שם | סוג | הערות |
|---|---|---|
| id | uint32 | עבור בקשות - המזהה ההגדלה המשמש לקישור בקשות לתגובות. ייחודי בתוך כיוון בקשה (כלומר מסוכן לפלאגין או מפלאגין לסוכן). לתגובות - מזהה הבקשה המתאימה. |
| type | uint32 | סוג הבקשה. |
בקשה שנשלחה על ידי תוסף לכתוב הודעת יומן לקובץ היומן של הסוכן.
| כיוון | תוסף → סוכן |
| תגובה | לא |
פרמטרים ספציפיים לבקשות יומן:
| שם | סוג | הערות |
|---|---|---|
| severity | uint32 | חומרת ההודעה (רמת יומן). |
| message | string | ההודעה לרישום. |
דוגמא:
בקשה שנשלחה על ידי הסוכן במהלך שלב ההפעלה של הסוכן כדי לקבל מדדים שסופקו לרישום תוסף.
| כיוון | סוכן → תוסף |
| תגובה | כן |
פרמטרים ספציפיים לרישום בקשות:
| שם | סוג | הערות |
|---|---|---|
| version | string | גרסת הפרוטוקול <major>.<minor> |
דוגמא:
תגובת הפלאגין לבקשת הרישום.
| כיוון | תוסף → סוכן |
| תגובה | לא קיימת |
פרמטרים ספציפיים לרישום תגובות:
| שם | סוג | הערות |
|---|---|---|
| name | string | שם הפלאגין. |
| metrics | מערך מחרוזות (אופציונלי) | המדדים עם תיאורים כפי שמשמשים בתוסף. מחזירה RegisterMetrics(). נעדר אם הוחזרה שגיאה. |
| interfaces | uint32 (אופציונלי) | מסכת הסיביות של הממשקים הנתמכים של הפלאגין. נעדר אם הוחזרה שגיאה. |
| error | string (אופציונלי) | הודעת שגיאה הוחזרה אם לא ניתן להפעיל תוסף. נעדר, אם מוחזרים מדדים. |
דוגמאות:
אוֹ
בקשה לביצוע פונקציית ההתחלה של ממשק ה-Runner.
| כיוון | סוכן → תוסף |
| תגובה | לא |
לבקשה אין פרמטרים ספציפיים, היא מכילה רק פרמטרים של common data.
דוגמא:
בקשה שנשלחה על ידי הסוכן לכיבוי תוסף.
| כיוון | סוכן → תוסף |
| תגובה | לא |
לבקשה אין פרמטרים ספציפיים, היא מכילה רק פרמטרים של common data.
דוגמא:
בקשה לביצוע פונקציית הייצוא של ממשק היצואן.
| כיוון | סוכן → תוסף |
| תגובה | לא |
פרמטרים ספציפיים לבקשות ייצוא:
| שם | סוג | הערות |
|---|---|---|
| key | string | מפתח הפלאגין. |
| פרמטרים | מערך מחרוזות (אופציונלי) | הפרמטרים לפונקציית ייצוא. |
דוגמא:
תגובה מפונקציית הייצוא של ממשק היצואן.
| כיוון | תוסף → סוכן |
| תגובה | לא קיימת |
פרמטרים ספציפיים לייצוא תגובות:
| שם | סוג | הערות |
|---|---|---|
| value | string (אופציונלי) | ערך תגובה מהפונקציה Export. נעדר, אם הוחזרה שגיאה. |
| error | string (אופציונלי) | הודעת שגיאה אם פונקציית הייצוא לא בוצעה בהצלחה. נעדר, אם הערך מוחזר. |
דוגמאות:
אוֹ
בקשה להפעיל את הפונקציה Configure של ממשק Configurator.
| כיוון | סוכן → תוסף |
| תגובה | לא קיימת |
פרמטרים ספציפיים לבקשות הגדר:
| שם | סוג | הערות |
|---|---|---|
| global_options | אובייקט JSON | אובייקט JSON המכיל אפשרויות תצורת סוכן גלובליות. |
| private_options | אובייקט JSON (אופציונלי) | אובייקט JSON המכיל אפשרויות תצורה פרטיות של תוסף, אם מסופק. |
דוגמא:
בקשה לביצוע פונקציית validate של ממשק Configurator.
| כיוון | סוכן → תוסף |
| תגובה | כן |
פרמטרים ספציפיים לבקשות אמת:
| שם | סוג | הערות |
|---|---|---|
| private_options | אובייקט JSON (אופציונלי) | אובייקט JSON המכיל אפשרויות תצורה פרטיות של תוסף, אם מסופק. |
דוגמא:
תגובה מפונקציית * Validate* של ממשק Configurator.
| כיוון | תוסף → סוכן |
| תגובה | לא קיימת |
פרמטרים ספציפיים לתגובות אמת:
| שם | סוג | הערות |
|---|---|---|
| error | string (אופציונלי) | הודעת שגיאה מוחזרת אם הפונקציה Validate לא מבוצעת בהצלחה. נעדר אם בוצע בהצלחה. |
דוגמא:
אוֹ