Documentation
Table of Contents
3 Agent (סוכן) 2
סקירה כללית
Zabbix agent 2 הוא דור חדש של סוכן Zabbix וניתן להשתמש בו המקום של סוכן Zabbix. Zabbix agent 2 פותח כדי:
- צמצם את מספר חיבורי ה-TCP
- לספק התאמה משופרת של המחאות
- ניתן להרחבה בקלות עם תוספים. תוסף אמור להיות מסוגל:
- לספק צ'קים טריוויאליים המורכבים מכמה שורות פשוטות בלבד של קוד
- לספק צ'קים מורכבים המורכבים מסקריפטים ארוכי טווח ו איסוף נתונים עצמאי עם שליחה תקופתית חזרה של הנתונים
- להיות תחליף לסוכן Zabbix (בכך שהוא תומך בכל הפונקציונליות הקודמת)
סוכן 2 כתוב בשפת התכנות Go (עם קוד C של סוכן Zabbix בשימוש חוזר). א סביבת Go שהוגדרה עם Go גרסה נדרשת עבור בניין Zabbix agent 2.
לסוכן 2 אין תמיכת דמוניזציה מובנית בלינוקס; זה יכול להיות הפעל כשירות Windows.
בדיקות פסיביות פועלות בדומה לסוכן Zabbix. תמיכת צ'קים פעילה מרווחי זמן מתוזמנים/גמישים ובדוק התאמה בתוך פעיל אחד שרת.
כברירת מחדל, Zabbix agent 2 יתזמן את איסוף הנתונים הראשון לבדיקות אקטיביות בזמן אקראי מותנה בתוך מרווח העדכון של הפריט כדי למנוע עליות בשימוש במשאבים. כדי לבצע בדיקות אקטיביות שאין להן תזמון מרווחי עדכון מיד לאחר ההפעלה מחדש של הסוכן, הגדר פרמטר ForceActiveChecksOnStart (ברמה גלובלית) או Plugins.<שם פלאגין>.System.ForceActiveChecksOnStart (משפיע רק על בדיקות פלאגין ספציפיות) בקובץ התצורה. פרמטר ברמת הפלאגין, אם מוגדר, יעקוף את הפרמטר הגלובלי. כפיית בדיקות אקטיביות בהתחלה נתמכת מאז Zabbix 6.0.2.
בדוק התאמה
ניתן לבצע בדיקות מתוספים שונים במקביל. המספר של בדיקות במקביל בתוך תוסף אחד מוגבלת על ידי קיבולת הפלאגין הגדרה. לכל תוסף עשויה להיות הגדרת קיבולת מקודדת (100 היות ברירת המחדל) שניתן להנמיך באמצעות ההגדרה Plugins.<PluginName>.System.Capacity=N ב-Plugins תצורה פרמטר. השם הקודם של פרמטר זה Plugins.<PluginName>.Capacity עדיין נתמך, אך הוצא משימוש ב-Zabix 6.0.
ראה גם: פיתוח תוסף הנחיות.
Passive and active checks
Passive checks work similarly to Zabbix agent. Active checks support scheduled/flexible intervals and check concurrency within one active server.
By default, after a restart, Zabbix agent 2 will schedule the first data collection for active checks at a conditionally random time within the item's update interval to prevent spikes in resource usage. To perform active checks that do not have Scheduling update interval immediately after the agent restart, set ForceActiveChecksOnStart parameter (global-level) or Plugins.<Plugin name>.System.ForceActiveChecksOnStart (affects only specific plugin checks) in the configuration file. Plugin-level parameter, if set, will override the global parameter. Forcing active checks on start is supported since Zabbix 6.0.2.
Check concurrency
Checks from different plugins can be executed concurrently. The number of concurrent checks within one plugin is limited by the plugin capacity setting. Each plugin may have a hardcoded capacity setting (100 being default) that can be lowered using the Plugins.<PluginName>.System.Capacity=N setting in the Plugins configuration parameter. Former name of this parameter Plugins.<PluginName>.Capacity is still supported, but has been deprecated in Zabbix 6.0.
פלטפורמות נתמכות
Zabbix agent 2 נתמך בפלטפורמות הבאות:
- Windows (כל גרסאות שולחן העבודה והשרת מאז XP; זמין גם כקובץ בינארי מהודר מראש)
- לינוקס (זמין גם בחבילות הפצה)
התקנה
Zabbix agent 2 זמין בחבילות Zabbix שהורכבו מראש. כדי להרכיב את Zabbix agent 2 מ-sources עליך לציין את אפשרות התצורה --enable-agent2.
אפשרויות
ניתן להשתמש בפרמטרים הבאים של שורת הפקודה עם Zabbix agent 2:
| פרמטר | תיאור |
|---|---|
| -c --config <config-file> | נתיב לקובץ התצורה. תוכל להשתמש באפשרות זו כדי לציין קובץ תצורה שאינו ברירת המחדל. ב-UNIX, ברירת המחדל היא /usr/local /etc/zabbix_agent2.conf או כפי שנקבע על ידי זמן הידור משתני --sysconfdir או --prefix |
| -f --foreground | הפעל את סוכן Zabbix בחזית (ברירת מחדל: true). |
| -p --print | הדפס פריטים ידועים וצא. הערה: כדי להחזיר גם תוצאות של פרמטר משתמש, עליך לציין את קובץ התצורה (אם הוא לא במיקום ברירת המחדל). |
| -t --test <item key> | בדוק את הפריט שצוין וצא. הערה: כדי להחזיר גם תוצאות של פרמטר משתמש, עליך לציין את קובץ התצורה (אם זה לא במיקום ברירת המחדל). |
| -h --help | הדפס מידע עזרה וצא. |
| -v --verbose | הדפס מידע על ניפוי באגים. השתמש באפשרות זו עם אפשרויות -p ו-t. |
| -V --version | גרסת סוכן הדפסה ופרטי רישיון. |
| -R --runtime-control <option> | בצע פונקציות ניהול. ראה בקרת זמן ריצה. |
דוגמאות ספציפיות לשימוש בפרמטרים של שורת הפקודה:
- להדפיס את כל פריטי הסוכן המובנים עם ערכים
- בדוק פרמטר משתמש עם מפתח "mysql.ping" המוגדר במפורט קובץ תצורה
בקרת זמן ריצה
בקרת זמן ריצה מספקת כמה אפשרויות לשליטה מרחוק.
| אפשרות | תיאור |
|---|---|
| log_level_increase | הגדל את רמת היומן. |
| log_level_decrease | הקטנת רמת היומן. |
| metrics | רשום מדדים זמינים. |
| version | הצג את גרסת הסוכן. |
| userparameter_reload | טען מחדש פרמטרים של משתמש מקובץ התצורה הנוכחי. שים לב ש-UserParameter היא אפשרות תצורת הסוכן היחידה שתיטען מחדש. |
| help | הצג מידע עזרה על בקרת זמן ריצה. |
דוגמאות:
- הגדלת רמת היומן עבור סוכן 2
- הדפס אפשרויות בקרת זמן ריצה
קובץ תצורה
פרמטרי התצורה של סוכן 2 תואמים לרוב סוכן Zabbix למעט כמה חריגים.
| פרמטרים חדשים | תיאור |
|---|---|
| ControlSocket | נתיב שקע בקרת זמן הריצה. סוכן 2 משתמש בשקע בקרה עבור פקודות זמן ריצה. |
| EnablePersistentBuffer, PersistentBufferFile, PersistentBufferPeriod |
פרמטרים אלה משמשים להגדרת אחסון מתמשך בסוכן 2 עבור פריטים פעילים. |
| ForceActiveChecksOnStart | קובע אם על הסוכן לבצע בדיקות אקטיביות מיד לאחר הפעלה מחדש או לפזר באופן שווה לאורך זמן. נתמך מאז Zabbix 6.0.2. |
| תוספים | לתוספים עשויים להיות פרמטרים משלהם, בפורמט תוספים.<שם פלאגין>.<Parameter>=<ערך>. פרמטר נפוץ של תוסף הוא System.Capacity, הגדרת מגבלת הבדיקות שניתן לבצע בו זמנית. |
| StatusPort | סוכן היציאה 2 יקשיב לבקשת מצב HTTP והצגת רשימה של תוספים מוגדרים וכמה פרמטרים פנימיים |
| פרמטרים שנפלטו | תיאור |
| AllowRoot, User | לא נתמך מכיוון שהדמוניזציה אינה נתמכת. |
| LoadModule, LoadModulePath | מודולים הניתנים לטעינה אינם נתמכים. |
| StartAgents | פרמטר זה שימש בסוכן Zabbix כדי להגביר את במקביליות הבדיקות הפסיביות או להשבית אותן. בסוכן 2, המקבילות מוגדרת ברמת הפלאגין וניתן להגביל אותה על ידי הגדרת קיבולת. ואילו השבתת בדיקות פסיביות אינה נתמכת כעת. |
| HostInterface, HostInterfaceItem | עדיין לא נתמך. |
לפרטים נוספים עיין באפשרויות קובץ התצורה עבור zabbix_agent2.
קודי יציאה
החל מגרסה 4.4.8 ניתן להרכיב גם את Zabbix agent 2 גרסאות OpenSSL ישנות יותר (1.0.1, 1.0.2).
במקרה זה Zabbix מספקת מוטקסים לנעילה ב-OpenSSL. אם מוטקס נעילה או ביטול נעילה נכשלת ואז הודעת שגיאה מודפסת לפי התקן זרם השגיאות (STDERR) וסוכן 2 יוצאים עם קוד החזרה 2 או 3, בהתאמה.