אנו פותרים בעיות מעשיות ב-Zabix באמצעות JavaScript

טיכון אוסקוב, מהנדס צוות האינטגרציה של Zabbix

Zabbix היא פלטפורמה הניתנת להתאמה אישית המשמשת לניטור כל סוג של נתונים. מאז הגרסאות המוקדמות ביותר של Zabbix, למנהלי ניטור הייתה את היכולת להריץ סקריפטים שונים באמצעות פעולות לבדיקות על צמתי רשת יעד. במקביל, השקת סקריפטים הובילה למספר קשיים, לרבות כמו הצורך לתמוך בסקריפטים, מסירתם לצמתי תקשורת ופרוקסי וכן תמיכה בגרסאות שונות.

JavaScript עבור Zabbix

באפריל 2019, Zabbix 4.2 הוצג עם עיבוד מקדים של JavaScript. אנשים רבים התלהבו מהרעיון לנטוש את כתיבת סקריפטים שלוקחים נתונים לאנשהו, לעכל אותם ולספק אותם בפורמט ש-Zabix מבין, ולבצע בדיקות פשוטות שיקבלו נתונים שאינם מוכנים לאחסון ועיבוד על-ידי Zabbix, וכן לאחר מכן עבדו את זרם הנתונים הזה באמצעות כלי Zabbix ו-JavaScript. בשילוב עם גילוי ברמה נמוכה ופריטים תלויים שהופיעו ב- Zabbix 3.4, קיבלנו קונספט גמיש למדי למיון וניהול הנתונים שהתקבלו.

ב-Zabbix 4.4, כהמשך הגיוני לעיבוד מקדים ב-JavaScript, הופיעה שיטת הודעות חדשה - Webhook, שבאמצעותה ניתן לשלב הודעות Zabbix בקלות עם אפליקציות צד שלישי.

JavaScript ו-Duktapes

מדוע נבחרו JavaScript ו-Duktape? אפשרויות שונות לשפות ומנועים נשקלו:

• לואה - לואה 5.1
• Lua - LuaJIT
• Javascript - Duktape
• Javascript - JerryScript
• פייתון מוטבע
• פרל מוטבע

קריטריוני הבחירה העיקריים היו שכיחות, קלות שילוב המנוע במוצר, צריכת משאבים נמוכה וביצועים כלליים של המנוע, ובטיחות הכנסת קוד בשפה זו לניטור. בהתבסס על שילוב האינדיקטורים, JavaScript זכה במנוע Duktape.

קריטריוני בחירה ובדיקת ביצועים

תכונות של Duktape:

- סטנדרטי ECMAScript E5/E5.1
- מודולי Zabbix עבור Duktape:

• Zabbix.log() - מאפשר לכתוב הודעות עם רמות פירוט שונות ישירות לתוך יומן השרת של Zabbix, מה שמאפשר לתאם שגיאות, למשל, ב-Webhook, עם מצב השרת.
• CurlHttpRequest() - מאפשר לבצע בקשות HTTP לרשת, עליהן מבוסס השימוש ב-Webhook.
• atob() ו-btoa() - מאפשר לך לקודד ולפענח מחרוזות בפורמט Base64.

הערה. Duktape עומד בתקני ACME. Zabbix משתמש בגרסת 2015 של התסריט. השינויים הבאים הם מינוריים, כך שניתן להתעלם מהם..

קסם של JavaScript

כל הקסם של JavaScript טמון בהקלדה דינמית ובליהוק סוג: מחרוזת, מספרית ובוליאנית.

המשמעות היא שאין צורך להצהיר מראש איזה סוג המשתנה צריך להחזיר ערך.

בפעולות מתמטיות, הערכים המוחזרים על ידי אופרטורים של פונקציות מומרים למספרים. החריג לפעולות כאלה הוא תוספת, מכיוון שאם לפחות אחד מהמונחים הוא מחרוזת, המרת מחרוזת מוחלת על כל המונחים.

הערה. השיטות האחראיות להמרות כאלה מיושמות בדרך כלל באבות טיפוס האב של האובייקט, ערך של и toString. ערך של נקרא במהלך המרה מספרית ותמיד לפני השיטה toString. שיטה ערך של חייב להחזיר ערכים פרימיטיביים, אחרת מתעלמים מהתוצאה שלו.

שיטה נקראת על אובייקט ערך של. אם הוא לא נמצא או לא מחזיר ערך פרימיטיבי, השיטה נקראת toString. אם השיטה toString לא נמצא, מחפש ערך של באב הטיפוס של האובייקט, והכל חוזר על עצמו עד לסיום עיבוד הערך וכל הערכים בביטוי נוצקים לאותו סוג. אם האובייקט מיישם שיטה toString, שמחזירה ערך פרימיטיבי, אז הוא משמש להמרת מחרוזת. עם זאת, התוצאה של יישום שיטה זו אינה בהכרח מחרוזת.

לדוגמה, אם עבור עבור אובייקט 'objמוגדרת השיטה toString,

`var obj = { toString() { return "200" }}` 

метод toString מחזירה בדיוק מחרוזת, וכאשר מוסיפים מחרוזת עם מספר, נקבל מחרוזת מודבקת:

`obj + 1 // '2001'` 

`obj + 'a' // ‘200a'`

אבל אם תכתוב מחדש toString, כדי שהשיטה מחזירה מספר, בהוספת האובייקט תתבצע פעולה מתמטית עם המרה מספרית ותתקבל תוצאת החיבור המתמטי.

`var obj = { toString() { return 200 }}` 

`obj + 1 // '2001'`

במקרה זה, אם נבצע הוספה עם מחרוזת, מתבצעת המרת מחרוזת, ונקבל מחרוזת מודבקת.

`obj + 'a' // ‘200a'`

זו הסיבה למספר רב של טעויות של משתמשי JavaScript מתחילים.

השיטה toString אתה יכול לכתוב פונקציה שתגדיל את הערך הנוכחי של האובייקט ב-1.

ביצוע הסקריפט, בתנאי שהמשתנה שווה ל-3, והוא גם שווה ל-4.

בהשוואה לקאסט (==), השיטה מבוצעת בכל פעם toString עם פונקציית העלאת ערך. בהתאם לכך, עם כל השוואה שלאחר מכן, הערך עולה. ניתן להימנע מכך על ידי שימוש בהשוואה ללא יצוק (===).

השוואה ללא יציקת סוג

הערה. אל תשתמש בהשוואת שחקנים שלא לצורך.

עבור סקריפטים מורכבים, כמו Webhooks עם לוגיקה מורכבת, הדורשים השוואה עם יציקת טיפוסים, מומלץ לכתוב מראש בדיקות עבור הערכים המחזירים משתנים ומטפלים בחוסר עקביות ושגיאות.

Webhook Media

בסוף 2019 ותחילת 2020, צוות האינטגרציה של Zabbix פיתח באופן פעיל את Webhooks ואינטגרציות מחוץ לקופסה שמגיעות עם הפצת Zabbix.

• מחלוקת
• Jira
• דלפק שירות Jira
• מאלצת
• Microsoft Teams
• אופסגני
• OTR
• חובת דפדוף
• יָרִיב חַלָשׁ
• Redmine
• ServiceNow
• SINGL4
• רפוי
• מברק
• זמד
• Zendesk

קישור אל תיעוד

עיבוד מוקדם

• הופעת העיבוד המקדים ב-JavaScript אפשרה לנטוש את רוב הסקריפטים החיצוניים, וכיום ב-Zabix ניתן לקבל כל ערך ולהמיר אותו לערך אחר לגמרי.
• עיבוד מקדים ב-Zabbix מיושם על ידי קוד JavaScript, אשר, כאשר הוא קומפילד לתוך bytecode, מומר לפונקציה שלוקחת ערך בודד כפרמטר ערך כמחרוזת (מחרוזת יכולה להכיל גם ספרה וגם מספר).
• מכיוון שהפלט הוא פונקציה, בסופו של הסקריפט נדרש לַחֲזוֹר.
• אפשר להשתמש בפקודות מאקרו מותאמות אישית בקוד.
• ניתן להגביל משאבים לא רק ברמת מערכת ההפעלה, אלא גם באופן תוכניתי. שלב העיבוד המקדים מוקצה לכל היותר 10 מגה-בייט של זיכרון RAM ומגבלת זמן ריצה של 10 שניות.

הערה. ערך הזמן הקצוב של 10 שניות הוא די הרבה, מכיוון שאיסוף מותנה של אלפי פריטי נתונים בשנייה אחת לפי תרחיש עיבוד מוקדם למדי "כבד" יכול להאט את Zabbix. לכן, לא מומלץ להשתמש בעיבוד מקדים כדי לבצע סקריפטים מלאים של JavaScript דרך מה שנקרא רכיבי נתונים צללים (פריטי דמה), המופעלים רק כדי לבצע עיבוד מקדים.

אתה יכול לבדוק את הקוד שלך באמצעות מבחן העיבוד המקדים או באמצעות כלי השירות zabbix_js:

`zabbix_js -s *script-file -p *input-param* [-l log-level] [-t timeout]`

`zabbix_js -s script-file -i input-file [-l log-level] [-t timeout]`

`zabbix_js -h`

`zabbix_js -V`

משימות מעשיות

משימה 1

החלף פריט מחושב בעיבוד מקדים.

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

בעבר היינו יוצרים פריט שאוסף את הטמפרטורה במעלות פרנהייט. לאחר מכן, פריט נתונים נוסף (מחושב) שימיר פרנהייט לצלזיוס באמצעות נוסחה.

בעיות:

• יש צורך לשכפל רכיבי נתונים ולאחסן את כל הערכים במסד הנתונים.
• עליך להסכים על המרווחים עבור פריט הנתונים "האב" המחושב והמשמש בנוסחה, ועבור פריט הנתונים המחושבים. אחרת, הפריט המחושב עלול להיכנס למצב לא נתמך או לחשב ערך קודם, מה שישפיע על מהימנות תוצאות הניטור.

אחד הפתרונות היה להתרחק ממרווחי בדיקה גמישים לטובת מרווחים קבועים כדי להבטיח שהפריט המחושב יוערך אחרי הפריט שמקבל את הנתונים (במקרה שלנו, הטמפרטורה במעלות פרנהייט).

אבל אם למשל נשתמש בתבנית כדי לבדוק מספר רב של מכשירים, והבדיקה מתבצעת אחת ל-30 שניות, Zabbix "פורץ" למשך 29 שניות, ובשנייה האחרונה היא מתחילה לבדוק ולחשב. זה יוצר תור ומשפיע על הביצועים. לכן, מומלץ להשתמש במרווחים קבועים רק אם זה באמת נחוץ.

בבעיה זו, הפתרון האופטימלי הוא עיבוד מקדים של JavaScript בשורה אחת הממיר מעלות פרנהייט למעלות צלזיוס:

`return (value - 32) * 5 / 9;`

זה מהיר וקל, אתה לא צריך ליצור פריטי נתונים מיותרים ולשמור עליהם היסטוריה, ותוכל גם להשתמש במרווחים גמישים לבדיקות.

`return (parseInt(value) + parseInt("{$EXAMPLE.MACRO}"));`

אבל, אם במצב היפותטי יש צורך להוסיף את רכיב הנתונים שהתקבל, למשל, עם כל קבוע מוגדר במאקרו, יש לקחת בחשבון שהפרמטר ערך מתרחב למחרוזת. בפעולת הוספת מחרוזת, שני מחרוזות פשוט משולבות לאחת.

`return (value + "{$EXAMPLE.MACRO}");`

כדי לקבל את התוצאה של פעולה מתמטית, יש צורך להמיר את סוגי הערכים שהושגו לפורמט מספרי. בשביל זה אתה יכול להשתמש בפונקציה parseInt (), שמייצר מספר שלם, פונקציה parseFloat (), שמייצר נקודה עשרונית, או פונקציה מספר, המחזיר מספר שלם או עשרוני.

משימה 2

קבל את הזמן בשניות עד לסיום התעודה.

מצב: שירות מנפיק תאריך תפוגה של אישור בפורמט "12 בפברואר 12:33:56 2022 GMT".

ב-ECMAScript5 תאריך.parse () מקבל תאריך בפורמט ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ). יש צורך להטיל עליו מחרוזת בפורמט MMM DD YYYY HH:mm:ss ZZ

בעיה: ערך החודש מבוטא כטקסט, לא כמספר. נתונים בפורמט זה אינם מתקבלים על ידי Duktape.

דוגמה לפתרון:

• קודם כל, מכריזים על משתנה שלוקח ערך (הסקריפט כולו הוא הצהרת משתנים המופרדים בפסיקים).

• בשורה הראשונה נקבל את התאריך בפרמטר ערך ולהפריד אותו עם רווחים בשיטה לפצל. לפיכך, אנו מקבלים מערך, שבו כל אלמנט של המערך, החל באינדקס 0, מתאים לרכיב תאריך אחד לפני ואחרי רווח. פיצול (0) - חודש, פיצול (1) - מספר, פיצול (2) - מחרוזת עם זמן וכו'. לאחר מכן, ניתן לגשת לכל רכיב של התאריך על ידי אינדקס במערך.

`var split = value.split(' '),`

• כל חודש (בסדר כרונולוגי) מתאים לאינדקס מיקומו במערך (מ-0 עד 11). כדי להמיר ערך טקסט לערך מספרי, מתווסף אחד לאינדקס החודש (כי חודשים ממוספרים החל מ-1). במקרה זה, הביטוי בתוספת של אחד נלקח בסוגריים, כי אחרת תתקבל מחרוזת, לא מספר. בסוף אנחנו עושים פרוסה() - חותכים את המערך מהקצה כדי להשאיר רק שני תווים (מה שחשוב לחודשים עם מספר דו ספרתי).

`MONTHS_LIST = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'],`

`month_index = ('0' + (MONTHS_LIST.indexOf(split[0]) + 1)).slice(-2),`

• אנו יוצרים מחרוזת בפורמט ISO מהערכים המתקבלים על ידי הוספה רגילה של מחרוזות בסדר המתאים.

`ISOdate = split[3] + '-' + month_index + '-' + split[1] + 'T' + split[2],`

הנתונים בפורמט המתקבל הם מספר השניות משנת 1970 ועד לנקודה כלשהי בעתיד. זה כמעט בלתי אפשרי להשתמש בנתונים בפורמט שהתקבל בטריגרים, כי Zabbix מאפשר לך לפעול רק עם פקודות מאקרו {תַאֲרִיך} и {זְמַן}, המחזירים את התאריך והשעה בפורמט ידידותי למשתמש.

• לאחר מכן נוכל לקבל את התאריך הנוכחי ב-JavaScript בפורמט Unix Timestamp ולהחסיר אותו מתאריך התפוגה של האישור המתקבל כדי לקבל את מספר האלפיות השניות מעכשיו ועד שהאישור יפוג.

`now = Date.now();`

• אנו מחלקים את הערך המתקבל באלף כדי לקבל שניות ב- Zabbix.

`return parseInt((Date.parse(ISOdate) - now) / 1000);`

בטריגר, אתה יכול לציין את הביטוי 'אחרון' ואחריו קבוצת ספרות התואמת למספר השניות בתקופה שאליה תרצה להגיב, למשל בשבועות. לפיכך, הטריגר יודיע כי תוקף האישור יפוג בעוד שבוע.

הערה. שימו לב לשימוש parseInt () בתפקוד לַחֲזוֹרלהמיר את המספר השברי הנובע מחלוקת אלפיות השנייה למספר שלם. אתה יכול גם להשתמש parseFloat () ולאחסן נתונים חלקיים.

צפו בדוח

מקור: www.habr.com