פרוטוקול 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 לא מבוצעת בהצלחה. נעדר אם בוצע בהצלחה. |
דוגמא:
אוֹ