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

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 נתמך בפלטפורמות הבאות:

התקנה

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" המוגדר במפורט קובץ תצורה
 shell> zabbix_agent2 --print
        shell> zabbix_agent2 -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf
בקרת זמן ריצה

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

אפשרות תיאור
log_level_increase הגדל את רמת היומן.
log_level_decrease הקטנת רמת היומן.
metrics רשום מדדים זמינים.
version הצג את גרסת הסוכן.
userparameter_reload טען מחדש פרמטרים של משתמש מקובץ התצורה הנוכחי.
שים לב ש-UserParameter היא אפשרות תצורת הסוכן היחידה שתיטען מחדש.
help הצג מידע עזרה על בקרת זמן ריצה.

דוגמאות:

  • הגדלת רמת היומן עבור סוכן 2
  • הדפס אפשרויות בקרת זמן ריצה
 shell> zabbix_agent2 -R log_level_increase
        shell> zabbix_agent2 -R עזרה

קובץ תצורה

פרמטרי התצורה של סוכן 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, בהתאמה.