Documentation
Table of Contents
1 סוכן Zabbix
סקירה כללית
בדיקות אלו משתמשות בתקשורת עם סוכן Zabbix לאיסוף נתונים.
יש פאסיבי ופעיל בדיקות סוכן. בעת הגדרת פריט, אתה יכול לבחור את הרצוי סוּג:
- סוכן Zabbix - לבדיקות פסיביות
- סוכן Zabbix (פעיל) - לצ'קים אקטיביים
מפתחות פריטים נתמכים
הטבלה מספקת פרטים על מפתחות הפריטים שבהם אתה יכול להשתמש עם Zabbix פריטי סוכן מקובצים לפי משפחת הפריטים.
ראה גם:
- פריטים נתמכים על ידי platform
- מפתחות פריט נתמכים על ידי סוכן Zabbix 2
- מפתחות פריט ספציפיים עבור Windows agent
- רמת הרשאה מינימלית לסוכן Windows items
פרמטרים חובה ואופציונליים
פרמטרים ללא סוגריים זווית הם חובה. פרמטרים המסומנים ב- סוגריים זווית < > הם אופציונליים.
שימוש עם כלי שירות בשורת הפקודה
שימו לב כי בעת בדיקה או שימוש במפתחות פריט עם zabbix_agentd או zabbix_get משורת הפקודה אתה צריך לשקול גם תחביר מעטפת.
לדוגמה, אם פרמטר מסוים של המפתח צריך להיות מוקף במירכאות כפולות עליך לחמוק ממרכאות כפולות במפורש, אחרת הם יחתכו על ידי הקליפה כדמויות מיוחדות ולא יועברו לתוכנית השירות Zabbix.
דוגמאות:
$ zabbix_agentd -t 'vfs.dir.count[/var/log,,,"file,dir",,0]'
$ zabbix_agentd -t vfs.dir.count[/var/log,,,\"file,dir\",,0]נתוני ליבה
| מפתח פריט | |||
|---|---|---|---|
| תיאור | ערך החזרה | פרמטרים | הערות |
| kernel.maxfiles | |||
| מספר מקסימלי של קבצים שנפתחו נתמכים על ידי מערכת ההפעלה. | מספר שלם | ||
| kernel.maxproc | |||
| מספר מקסימלי של תהליכים הנתמכים על ידי מערכת ההפעלה. | מספר שלם | ||
| kernel.openfiles | |||
| החזר את מספר מתארי הקבצים הפתוחים כעת. | מספר שלם | פריט זה נתמך מאז Zabbix 6.0. | |
נתוני ליבה
| מפתח פריט | |||
|---|---|---|---|
| תיאור | ערך החזרה | פרמטרים | הערות |
| kernel.maxfiles | |||
| מספר מקסימלי של קבצים שנפתחו נתמכים על ידי מערכת ההפעלה. | מספר שלם | ||
| kernel.maxproc | |||
| מספר מקסימלי של תהליכים הנתמכים על ידי מערכת ההפעלה. | מספר שלם | ||
| kernel.openfiles | |||
| החזר את מספר מתארי הקבצים הפתוחים כעת. | מספר שלם | פריט זה נתמך מאז Zabbix 6.0. | |
נתוני Modbus
| מפתח פריט | |||
|---|---|---|---|
| תיאור | ערך החזרה | פרמטרים | הערות |
| modbus.get[endpoint,<slave id>,<function>,<address>,<count>,<type>,<endianness>,<offset>] | |||
| קורא נתוני Modbus. | אובייקט JSON | נקודת קצה - נקודת קצה מוגדרת בתור protocol://connection_stringמזהה עבד - מזהה עבד פונקציה - פונקציית Modbus<br >כתובת - כתובת הרישום הראשון, סליל או קלט ספירה - מספר רשומות לקריאה סוג - סוג הנתונים endianness - תצורת endianness offset - מספר אוגרים, החל מ-'address', שתוצאותיהם יימחקו. ראה תיאור מפורט של פרמטרים. |
נתמך מאז Zabbix 5.2.0. |
נתוני Modbus
| מפתח פריט | |||
|---|---|---|---|
| תיאור | ערך החזרה | פרמטרים | הערות |
| modbus.get[endpoint,<slave id>,<function>,<address>,<count>,<type>,<endianness>,<offset>] | |||
| קורא נתוני Modbus. | אובייקט JSON | נקודת קצה - נקודת קצה מוגדרת בתור protocol://connection_stringמזהה עבד - מזהה עבד פונקציה - פונקציית Modbus<br >כתובת - כתובת הרישום הראשון, סליל או קלט ספירה - מספר רשומות לקריאה סוג - סוג הנתונים endianness - תצורת endianness offset - מספר אוגרים, החל מ-'address', שתוצאותיהם יימחקו. ראה תיאור מפורט של פרמטרים. |
נתמך מאז Zabbix 5.2.0. |
נתוני Modbus
| מפתח פריט | |||
|---|---|---|---|
| תיאור | ערך החזרה | פרמטרים | הערות |
| modbus.get[endpoint,<slave id>,<function>,<address>,<count>,<type>,<endianness>,<offset>] | |||
| קורא נתוני Modbus. | אובייקט JSON | נקודת קצה - נקודת קצה מוגדרת בתור protocol://connection_stringמזהה עבד - מזהה עבד פונקציה - פונקציית Modbus<br >כתובת - כתובת הרישום הראשון, סליל או קלט ספירה - מספר רשומות לקריאה סוג - סוג הנתונים endianness - תצורת endianness offset - מספר אוגרים, החל מ-'address', שתוצאותיהם יימחקו. ראה תיאור מפורט של פרמטרים. |
נתמך מאז Zabbix 5.2.0. |
נתוני חיישן
| מפתח פריט | |||
|---|---|---|---|
| תיאור | ערך החזרה | פרמטרים | הערות |
| חיישן[מכשיר,חיישן,<מצב>] | |||
| קריאת חיישן חומרה. | צף | מכשיר - שם מכשיר חיישן - שם חיישן מצב - ערכים אפשריים: avg, max, דקה (אם הפרמטר הזה מושמט, ההתקן והחיישן מטופלים מילה במילה). |
קורא /proc/sys/dev/sensors ב-Linux 2.4. דוגמה: => sensor[w83781d- i2c-0-2d,temp1] לפני Zabbix 1.8.4, נעשה שימוש בפורמט sensor[temp1]. |
| קורא /sys/class/hwmon ב-Linux 2.6+. ראה תיאור מפורט יותר של פריט sensor ב-Linux. |
|||
| קורא את hw.sensors MIB ב-OpenBSD. דוגמאות: => חיישן[cpu0,temp0] → טמפרטורה של חיישן מעבד אחד => ["cpu[0-2]$",temp,avg] → טמפרטורה ממוצעת של שלושת המעבדים הראשונים נתמכת ב-OpenBSD מאז Zabbix 1.8.4. |
|||
נתוני חיישן
| מפתח פריט | |||
|---|---|---|---|
| תיאור | ערך החזרה | פרמטרים | הערות |
| חיישן[מכשיר,חיישן,<מצב>] | |||
| קריאת חיישן חומרה. | צף | מכשיר - שם מכשיר חיישן - שם חיישן מצב - ערכים אפשריים: avg, max, דקה (אם הפרמטר הזה מושמט, ההתקן והחיישן מטופלים מילה במילה). |
קורא /proc/sys/dev/sensors ב-Linux 2.4. דוגמה: => sensor[w83781d- i2c-0-2d,temp1] לפני Zabbix 1.8.4, נעשה שימוש בפורמט sensor[temp1]. |
| קורא /sys/class/hwmon ב-Linux 2.6+. ראה תיאור מפורט יותר של פריט sensor ב-Linux. |
|||
| קורא את hw.sensors MIB ב-OpenBSD. דוגמאות: => חיישן[cpu0,temp0] → טמפרטורה של חיישן מעבד אחד => ["cpu[0-2]$",temp,avg] → טמפרטורה ממוצעת של שלושת המעבדים הראשונים נתמכת ב-OpenBSD מאז Zabbix 1.8.4. |
|||
נתוני חיישן
| מפתח פריט | |||
|---|---|---|---|
| תיאור | ערך החזרה | פרמטרים | הערות |
| חיישן[מכשיר,חיישן,<מצב>] | |||
| קריאת חיישן חומרה. | צף | מכשיר - שם מכשיר חיישן - שם חיישן מצב - ערכים אפשריים: avg, max, דקה (אם הפרמטר הזה מושמט, ההתקן והחיישן מטופלים מילה במילה). |
קורא /proc/sys/dev/sensors ב-Linux 2.4. דוגמה: => sensor[w83781d- i2c-0-2d,temp1] לפני Zabbix 1.8.4, נעשה שימוש בפורמט sensor[temp1]. |
| קורא /sys/class/hwmon ב-Linux 2.6+. ראה תיאור מפורט יותר של פריט sensor ב-Linux. |
|||
| קורא את hw.sensors MIB ב-OpenBSD. דוגמאות: => חיישן[cpu0,temp0] → טמפרטורה של חיישן מעבד אחד => ["cpu[0-2]$",temp,avg] → טמפרטורה ממוצעת של שלושת המעבדים הראשונים נתמכת ב-OpenBSD מאז Zabbix 1.8.4. |
|||
נתוני זיכרון וירטואלי
| מפתח פריט | |||
|---|---|---|---|
| תיאור | ערך החזרה | פרמטרים | הערות |
| vm.memory.size[<mode>] | |||
| גודל זיכרון בבייטים או באחוזים מהסך הכל. | מספר שלם - עבור בתים צף - עבור אחוז |
מצב - ערכים אפשריים: סה"כ (ברירת מחדל), פעיל, אנון, מאגרים, מטמון, exec, קובץ, חינם, לא פעיל, מוצמד, משותף, לוח, חוטי, משומש, מוצמד (משומש, אחוז), זמין, זמין (זמין, אחוז) ראה גם תמיכה בפלטפורמה ספציפית ו-פרטים נוספים עבור פרמטר זה. |
פריט זה מקבל שלוש קטגוריות של פרמטרים: 1) סה"כ - כמות זיכרון כוללת; 2) סוגי זיכרון ספציפיים לפלטפורמה: פעיל, אנון, מאגרים, מטמון, exec, קובץ, חינם, לא פעיל, מוצמד, משותף, לוח, חוטי;<br >3) הערכות ברמת המשתמש לגבי כמות הזיכרון בשימוש וזמין: משומש, מושך, זמין, זמין. |
נתוני ניטור אינטרנט
| מפתח פריט | |||
|---|---|---|---|
| תיאור | ערך החזרה | פרמטרים | הערות |
| web.page.get[מארח,<path>,<port>] | |||
| קבל תוכן של דף אינטרנט. | מקור דף אינטרנט כטקסט (כולל כותרות) | מארח - שם מארח או כתובת אתר (כמו scheme://host:port/path, כאשר רק מארח הוא חובה). סכימות כתובות אתרים מותרות: http, https4. סכימה חסרה תטופל כאל http. אם צוין כתובת אתר 'נתיב' ו'יציאה' חייבים להיות ריקים. ציון שם משתמש/סיסמה בעת חיבור לשרתים הדורשים אימות, לדוגמה: http://user:[email protected] אפשרי רק עם תמיכת cURL 4 .Punycode נתמך בשמות מארחים. נתיב - נתיב למסמך HTML (ברירת המחדל היא /) ** port** - מספר יציאה (ברירת המחדל היא 80 עבור HTTP) |
פריט זה הופך ללא נתמך אם המשאב שצוין ב-'host' אינו קיים או אינו זמין. 'host' יכול להיות שם מארח, שם דומיין, IPv4 או כתובת IPv6. אבל עבור כתובת IPv6 סוכן Zabbix חייב להיות הידור עם תמיכת IPv6 מופעלת. דוגמה: => web.page.get[www.example.com,index.php,80] => web.page.get[https://www.example.com] => web.page.get[https://blog.example.com/?s=zabbix]<br >=> web.page.get[localhost:80] => web.page.get["[::1]/server-status"] |
| web.page.perf[מארח,<path>,<port>] | |||
| זמן טעינה של דף אינטרנט מלא (בשניות). | Float | מארח - שם מארח או כתובת אתר (כמו scheme://host:port/path, כאשר רק מארח הוא חובה).סכימות כתובות אתרים מותרות: http, https4. סכימה חסרה תטופל כאל http. אם צוין כתובת אתר 'נתיב' ו'יציאה' חייבים להיות ריקים. ציון שם משתמש/סיסמה בעת חיבור לשרתים הדורשים אימות, לדוגמה: http://user:[email protected] אפשרי רק עם תמיכת cURL 4 .Punycode נתמך בשמות מארחים. נתיב - נתיב למסמך HTML (ברירת המחדל היא /) ** port** - מספר יציאה (ברירת המחדל היא 80 עבור HTTP) |
פריט זה הופך ללא נתמך אם המשאב שצוין ב-'host' אינו קיים או אינו זמין. 'host' יכול להיות שם מארח, שם דומיין, IPv4 או כתובת IPv6. אבל עבור כתובת IPv6 יש להרכיב את סוכן Zabbix עם תמיכת IPv6 מופעלת. דוגמה: => web.page.perf[www.example.com,index.php,80] => web.page.perf[https://www.example.com] |
| web.page.regexp[מארח,<path>,<port>,regexp,<length>,<output>] | |||
| מצא מחרוזת בדף אינטרנט. | המחרוזת התואמת, או כפי שצוין על ידי פרמטר פלט האופציונלי |
מארח - שם מארח או כתובת אתר (כמו scheme://host:port/path, כאשר רק * מארח* הוא חובה).סכימות כתובות אתרים מותרות: http, https4. סכימה חסרה תטופל כאל http. אם צוין כתובת אתר 'נתיב' ו'יציאה' חייבים להיות ריקים. ציון שם משתמש/סיסמה בעת חיבור לשרתים הדורשים אימות, לדוגמה: http://user:[email protected] אפשרי רק עם תמיכת cURL 4 .Punycode נתמך בשמות מארחים. נתיב - נתיב למסמך HTML (ברירת המחדל היא /) ** port** - מספר יציאה (ברירת המחדל היא 80 עבור HTTP) regexp - רגיל ביטוי המתאר את הדפוס הנדרש אורך - המספר המרבי של תווים להחזר פלט - תבנית עיצוב פלט אופציונלית. רצף הבריחה \0 מוחלף בחלק המותאם של הטקסט (מהתו הראשון שבו מתחילה ההתאמה ועד התו שבו מסתיימת ההתאמה) בעוד \N (כאשר N=1... 9) רצף ה-escape מוחלף בקבוצה מותאמת Nth (או מחרוזת ריקה אם ה-N חורג ממספר הקבוצות שנלכדו). |
פריט זה הופך ללא נתמך אם המשאב שצוין ב-'host' אינו קיים או אינו זמין. br> מארח יכול להיות שם מארח, שם דומיין, כתובת IPv4 או IPv6. אבל עבור כתובת IPv6 סוכן Zabbix חייב להיות קומפילד עם תמיכת IPv6 מופעלת.חילוץ תוכן באמצעות פרמטר פלט מתבצע בסוכן.פרמטר פלט נתמך מגרסה 2.2 .דוגמה: => web.page.regexp[www.example.com,index.php,80,OK,2] => web.page.regexp[ https://www.example.com,,,OK,2] |
מדדי Zabbix
| מפתח פריט | |||
|---|---|---|---|
| תיאור | ערך החזרה | פרמטרים | הערות |
| agent.hostmetadata | |||
| Agent host metadata. | String | מחזיר את הערך של פרמטרים HostMetadata או HostMetadataItem, או מחרוזת ריקה אם אף אחד מהם אינו מוגדר. נתמך מאז Zabbix 6.0. |
|
| agent.hostname | |||
| שם מארח הסוכן. | מחרוזת | מחזירות: כבדיקה פסיבית - שם המארח הראשון הרשום בפרמטר Hostname של קובץ התצורה של הסוכן; בדיקה כפעילה - שם שם המארח הנוכחי. |
|
| agent.ping | |||
| בדיקת זמינות סוכן. | שום דבר - לא זמין 1 - זמין |
השתמש בפונקציית ההדק nodata() כדי לבדוק אם מארח אינו זמינות. | |
| agent.variant | |||
| וריאנט של סוכן Zabbix (סוכן Zabbix או Zabbix agent 2). | מספר שלם | דוגמה לערך שהוחזר: 1 - סוכן Zabbix 2 - סוכן Zabbix 2 |
|
| agent.version | |||
| גרסת סוכן Zabbix. | מחרוזת | דוגמה לערך שהוחזר: 6.0.3 |
|
| zabbix.stats[<ip>,<port>] | |||
| החזר קבוצה של מדדים פנימיים של שרת Zabbix או פרוקסי מרחוק. | אובייקט JSON | ip - רשימת מסיכות IP/DNS/רשת של שרתים/פרוקסי שיש לבצע שאילתה מרחוק (ברירת המחדל היא 127.0.0.1) ** port** - יציאה של שרת/פרוקסי לשאילתה מרחוק (ברירת המחדל היא 10051) |
שים לב שבקשת הסטטיסטיקה תתקבל רק מהכתובות הרשומות ב-'StatsAllowedIP' שרת פרמטר /proxy במופע היעד. קבוצה נבחרת של מדדים פנימיים מוחזרת על ידי פריט זה. לפרטים, ראה ניטור מרחוק של Zabbix סטטיסטיקות. |
| zabbix.stats[<ip>,<port>,queue,<from>,<to>] | |||
| החזר מספר הפריטים המנוטרים בתור שמתעכבים בשרת Zabbix או ב-proxy מרחוק. | אובייקט JSON | ip - רשימת מסיכות IP/DNS/רשת של שרתים/פרוקסי שיש לבצע שאילתה מרחוק (ברירת המחדל היא 127.0.0.1 ) יציאה - יציאה של שרת/פרוקסי שיש לבצע שאילתה מרחוק (ברירת המחדל היא 10051) תור - קבוע (לשימוש כפי שהוא) מאת - עיכוב לפחות (ברירת המחדל היא 6 שניות) ל - עיכוב לכל היותר (ברירת המחדל היא אינסוף) |
שים לב שבקשת הסטטיסטיקה תתקבל רק מהכתובות הרשומות ב-'StatsAllowedIP' [שרת] (/manual/appendix/config/zabbix_server)/proxy במופע היעד. |
הערות שוליים
1הערה ספציפית ללינוקס. לסוכן Zabbix חייבת להיות גישת קריאה בלבד מערכת הקבצים /proc. תיקוני ליבה מ-www.grsecurity.org מגבילים את הגישה זכויות של משתמשים שאינם מורשים.
2 vfs.dev.read[], vfs.dev.write[]: סוכן Zabbix יסתיים חיבורי התקן "מיושנים" אם אין גישה לערכי הפריט עבור יותר יותר מ-3 שעות. זה עלול לקרות אם למערכת יש התקנים עם באופן דינמי שינוי נתיבים או אם התקן יוסר באופן ידני. שימו לב גם לזה פריטים אלה, אם משתמשים במרווח עדכון של 3 שעות או יותר, תמיד יהיו להחזיר '0'.
3 vfs.dev.read[], vfs.dev.write[]: אם נעשה שימוש ברירת המחדל של הכל עבור הפרמטר הראשון אז המפתח יחזיר סטטיסטיקות סיכום, כולל כל מכשירי החסימה כמו sda, sdb והמחיצות שלהם (sda1, sda2, sdb3...) והתקנים מרובים (MD raid) המבוססים על הבלוק הזה התקנים/מחיצות ונפחים לוגיים (LVM) המבוססים על אותם בלוק מכשירים/מחיצות. במקרים כאלה יש לשקול ערכים שהוחזרו רק כערך יחסי (דינמי בזמן) אך לא כערכים מוחלטים.
4 SSL (HTTPS) נתמך רק אם הסוכן מורכב עם cURL תמיכה. אחרת הפריט יהפוך ללא תמיכה.
הגדרות קידוד
כדי לוודא שהנתונים שנרכשו אינם פגומים, תוכל לציין הקידוד הנכון לעיבוד ההמחאה (למשל 'vfs.file.contents') בפרמטר 'קידוד'. רשימת הקידודים הנתמכים (דף קוד מזהים) ניתן למצוא בתיעוד עבור libiconv (פרויקט GNU) או ב תיעוד Microsoft Windows SDK עבור "מזהי דף קוד".
אם לא צוין קידוד בפרמטר קידוד, הבא מיושמות אסטרטגיות רזולוציה:
- אם הקידוד לא צוין (או שהוא מחרוזת ריקה) ההנחה היא שהוא UTF-8, הנתונים מעובדים "כמו שהם";
- ניתוח BOM - ישים לפריטים 'vfs.file.contents', 'vfs.file.regexp', 'vfs.file.regmatch'. נעשה ניסיון קבע את הקידוד הנכון באמצעות סימן סדר בתים (BOM) ב תחילת הקובץ. אם BOM אינו קיים - סטנדרטי רזולוציה (ראה לעיל) מוחלת במקום זאת.
פתרון בעיות בפריטי סוכן
- אם נעשה שימוש עם הסוכן הפסיבי, ערך פסק זמן בשרת ייתכן שהקונפיגורציה צריכה להיות גבוהה מ-זמן קצוב בסוכן קובץ תצורה. אחרת הפריט עלול לא לקבל שום ערך בגלל תחילה תם הזמן הקצוב לבקשת השרת לסוכן.