Documentation
Table of Contents
> אובייקט כלל LLD
האובייקטים הבאים קשורים ישירות ל-'discoveryrule' API.
> אובייקט כלל LLD
האובייקטים הבאים קשורים ישירות ל-'discoveryrule' API.
מסנן כלל LLD
אובייקט מסנן כלל LLD מגדיר קבוצה של תנאים שניתן להשתמש בהם לסנן אובייקטים שהתגלו. יש לו את המאפיינים הבאים:
| Property | Type | תיאור |
|---|---|---|
| תנאים (חובה) |
מערך | סט של תנאי סינון לשימוש לסינון תוצאות. |
| evaltype (חובה) |
מספר שלם | שיטת הערכת מצב מסנן. ערכים אפשריים: 0 - ו/או; 1 - ו; 2 - או; 3 - ביטוי מותאם אישית. |
| eval_formula | string | (לקריאה בלבד) ביטוי שנוצר שישמש להערכת תנאי סינון. הביטוי מכיל מזהים שמתייחסים לתנאי סינון ספציפיים לפי ה'נוסחה' שלו. הערך של eval_formula שווה לערך של נוסחה עבור מסננים עם ביטוי מותאם אישית. |
| formula | string | ביטוי מוגדר על ידי משתמש לשימוש להערכת תנאים של מסננים עם ביטוי מותאם אישית. הביטוי חייב להכיל מזהים שמתייחסים לתנאי סינון ספציפיים לפי ה'נוסחה' שלו. המזהים המשמשים בביטוי חייבים להתאים בדיוק לאלו שהוגדרו בתנאי הסינון: אין אפשרות להישאר ללא שימוש או להשמיט שום תנאי. נדרש עבור מסנני ביטויים מותאמים אישית. |
תנאי מסנן כלל LLD
אובייקט מסנן כלל LLD מגדיר בדיקה נפרדת לביצוע על הערך של מאקרו LLD. יש לו את המאפיינים הבאים:
| Property | Type | תיאור |
|---|---|---|
| מאקרו (נדרש) |
מחרוזת | מאקרו LLD לביצוע הבדיקה. |
| ערך (חובה) |
מחרוזת | ערך להשוואה. |
| formulaid | string | מזהה ייחודי שרירותי המשמש להפניה לתנאי מביטוי מותאם אישית. יכול להכיל רק אותיות רישיות. המזהה חייב להיות מוגדר על ידי המשתמש בעת שינוי תנאי הסינון, אך יופק מחדש בעת בקשתם לאחר מכן. |
| operator | integer | אופרטור תנאי. ערכים אפשריים: 8 - (ברירת מחדל) תואם לביטוי רגולרי; 9 - אינו תואם לביטוי רגולרי; 12 - קיים;< br>13 - לא קיים. |
כדי להבין טוב יותר כיצד להשתמש במסננים עם שונים סוגי ביטויים, ראה דוגמאות על discoveryrule.get ו שיטת discoveryrule.create דפים.
נתיב מאקרו LLD
לנתיב המאקרו LLD יש את המאפיינים הבאים:
| Property | Type | תיאור |
|---|---|---|
| lld_macro (נדרש) |
מחרוזת | מאקרו LD. |
| נתיב (נדרש) |
מחרוזת | בורר עבור ערך שיוקצה למאקרו המתאים. |
עיבוד מקדים של כלל LLD
לאובייקט העיבוד המקדים של כלל LLD יש את המאפיינים הבאים.
| Property | Type | תיאור |
|---|---|---|
| סוג (נדרש) |
מספר שלם | סוג אפשרות העיבוד המקדים. ערכים אפשריים: 5 - התאמת ביטוי רגולרי; 11 - XML XPath; 12 - JSONPath; 15 - לא תואם לביטוי רגולרי; 16 - בדוק אם יש שגיאה ב-JSON; 17 - בדוק אם יש שגיאה ב-XML; 20 - מחק ללא שינוי עם פעימות לב; 23 - פרומתאוס ל-JSON; 24 - CSV ל-JSON; 25 - החלף; 27 - XML ל-JSON. |
| פרמטרים (חובה) |
מחרוזת | פרמטרים נוספים המשמשים אפשרות עיבוד מקדים. פרמטרים מרובים מופרדים על ידי תו LF (\n). |
| error_handler (נדרש) |
מספר שלם | סוג הפעולה המשמש במקרה של כשל בשלב העיבוד המקדים. ערכים אפשריים: 0 - הודעת השגיאה מוגדרת על ידי שרת Zabbix;< br>1 - Discard value; 2 - הגדר ערך מותאם אישית; 3 - הגדר הודעת שגיאה מותאמת אישית. |
| error_handler_params (נדרש) |
string | פרמטרים של מטפל שגיאות. בשימוש עם error_handler.חייב להיות ריק, אם error_handler הוא 0 או 1.יכול להיות ריק אם, error_handler הוא 2.לא יכול להיות ריק, אם error_handler הוא 3. |
הפרמטרים הבאים ומטפלי השגיאות נתמכים עבור כל אחד מהם סוג עיבוד מקדים.
|סוג עיבוד מקדים|שם|פרמטר 1|פרמטר 2|פרמטר 3|מטפלי שגיאות נתמכים| |----------------|----|--------|-----|- ----------|------------------------| |5|ביטוי רגולרי|דפוס1|פלט2|<|0, 1, 2, 3| |11|XML XPath|נתיב3|<|<|0, 1, 2, 3| |12|JSONPath|נתיב3|<|<|0, 1, 2, 3| |15|לא תואם לביטוי רגולרי|דפוס1|<|<|0, 1, 2, 3| |16|בדוק אם יש שגיאה ב-JSON|path3|<|<|0, 1, 2, 3| |17|בדוק אם יש שגיאה ב-XML|נתיב3|<|<|0, 1, 2, 3| |20|הסר ללא שינוי עם פעימות לב|שניות4, 5, 6|<|<|<| |23|פרומתאוס ל-JSON|דפוס5, 7|<|<|0, 1, 2, 3| |24|CSV ל-JSON|תו2|תו2|0,1|0, 1, 2, 3| |25|החלף|מחרוזת חיפוש2|החלפה2|<|<| |27|XML ל-JSON|<|<|<|0, 1, 2, 3|
1 ביטוי רגולרי
2 מחרוזת
3 JSONPath או XML XPath
4 מספר שלם חיובי (עם תמיכה בסיומת זמן, למשל 30s, 1m, 2h, 1ד)
5 מאקרו משתמש
6 מאקרו LLD
7 דפוס פרומתאוס בעקבות התחביר: <שם המדד>{<שם התווית>="<ערך התווית>", ...} == <ערך>. כל אחד רכיב דפוס פרומתאוס (מדד, שם תווית, ערך תווית ומדד value) יכול להיות מאקרו משתמש.
8 פלט Prometheus בעקבות התחביר: <שם התווית>.
עקיפות של כלל LLD
כלל ה-LLD עוקף את האובייקט מגדיר קבוצה של כללים (מסננים, תנאים ופעולות) המשמשים לעקוף מאפיינים של אובייקטי אב טיפוס שונים. יש לו את המאפיינים הבאים:
| Property | Type | תיאור |
|---|---|---|
| שם (חובה) |
מחרוזת | שם עקיפה ייחודי. |
| שלב (נדרש) |
מספר שלם | מספר הזמנה ייחודי של העקיפה. |
| stop | integer | הפסק את עיבוד העקיפות הבאות אם תואמות. ערכים אפשריים: 0 - (ברירת מחדל) אל תפסיק לעבד דחיפות; 1 - הפסק לעבד דחיפות אם המסנן תואם. |
| filter | object | עקוף מסנן. |
| פעולות | מערך | עקוף פעולות. |
מסנן לעקוף כלל LLD
אובייקט הסינון לעקוף כלל LLD מגדיר קבוצה של תנאים שאם הם תואמים לאובייקט שהתגלה שהעקיפה מוחלת. יש לו את המאפיינים הבאים:
| Property | Type | תיאור |
|---|---|---|
| evaltype (נדרש) |
מספר שלם | עקוף שיטת הערכת מצב מסנן. ערכים אפשריים: 0 - ו/או; 1 - ו; 2 - או; 3 - ביטוי מותאם אישית. |
| תנאים (חובה) |
מערך | סט של תנאי מסנן לעקוף לשימוש לצורך התאמת האובייקטים שהתגלו. |
| eval_formula | string | (readonly) ביטוי שנוצר שישמש להערכת תנאי מסנן עקיפה. הביטוי מכיל מזהים שמתייחסים לתנאי מסנן עקיפה ספציפיים לפי ה'נוסחה' שלו. הערך של eval_formula שווה לערך של נוסחה עבור מסננים עם ביטוי מותאם אישית. |
| formula | string | ביטוי מוגדר על ידי משתמש לשימוש להערכת תנאים של ביטול מסננים עם ביטוי מותאם אישית. הביטוי חייב להכיל מזהים שמתייחסים לתנאי מסנן עקיפה ספציפיים לפי ה"נוסחה" שלו. המזהים המשמשים בביטוי חייבים להתאים במדויק לאלו שהוגדרו בתנאי מסנן העקיפה: אין תנאי שיכול להישאר ללא שימוש או להשמיט. נדרש עבור מסנני ביטול ביטוי מותאמים אישית. |
תנאי מסנן לעקוף כלל LLD
אובייקט תנאי הסינון לעקוף כלל LLD מגדיר בדיקה נפרדת לבצע על הערך של מאקרו LLD. יש לו את הדברים הבאים נכסים:
| Property | Type | תיאור |
|---|---|---|
| מאקרו (נדרש) |
מחרוזת | מאקרו LLD לביצוע הבדיקה. |
| ערך (חובה) |
מחרוזת | ערך להשוואה. |
| formulaid | string | מזהה ייחודי שרירותי המשמש להפניה לתנאי מביטוי מותאם אישית. יכול להכיל רק אותיות רישיות. המזהה חייב להיות מוגדר על ידי המשתמש בעת שינוי תנאי הסינון, אך יופק מחדש בעת בקשתם לאחר מכן. |
| operator | integer | אופרטור תנאי. ערכים אפשריים: 8 - (ברירת מחדל) תואם לביטוי רגולרי; 9 - אינו תואם לביטוי רגולרי; 12 - קיים;< br>13 - לא קיים. |
פעולת עקיפה של כלל LLD
פעולת עקיפת כלל LLD היא שילוב של תנאים ופעולות לבצע על אובייקט אב הטיפוס. יש לו את המאפיינים הבאים:
| Property | Type | תיאור |
|---|---|---|
| מבצע אובייקט (נדרש) |
מספר שלם | סוג האובייקט שהתגלה לביצוע הפעולה. ערכים אפשריים: 0 - אב טיפוס של פריט; 1 - אב טיפוס מפעיל;< br>2 - אב טיפוס גרף; 3 - אב טיפוס מארח. |
| operator | integer | עקוף תנאי אופרטור. ערכים אפשריים: 0 - (ברירת מחדל) שווה; 1 - אינו שווה; 2 - מכיל; 3 - אינו מכיל; 8 - מתאים; 9 - אינו תואם. |
| value | string | דפוס שיתאים לפריט, טריגר, גרף או שם אב טיפוס מארח בהתאם לאובייקט שנבחר. |
| opstatus | object | עקוף אובייקט סטטוס פעולה עבור אובייקטים של פריט, טריגר ואב-טיפוס מארח. |
| opdiscover | object | עקוף פעולת גילוי אובייקט סטטוס (כל סוגי האובייקטים). |
| opperiod | object | עקוף תקופת פעולה (מרווח עדכון) אובייקט עבור אובייקט אב טיפוס של פריט. |
| ophistory | object | עקוף אובייקט היסטוריית פעולות עבור אובייקט אב-טיפוס של פריט. |
| optrends | object | עקוף אובייקט מגמות של פעולה עבור אובייקט אב טיפוס של פריט. |
| opseverity | object | עקוף אובייקט חומרת הפעולה עבור אובייקט אב-טיפוס טריגר. |
| optag | array | עקוף אובייקט תג פעולה עבור אובייקטי טריגר ואב-טיפוס מארח. |
| optemplate | מערך | עקוף אובייקט תבנית פעולה עבור אובייקט אב טיפוס מארח. |
| opinventory | object | עקוף אובייקט מלאי של פעולה עבור אובייקט אב-טיפוס מארח. |
סטטוס הפעולה של כלל LLD
כלל LLD עוקף מצב פעולה שמוגדר לאובייקט שהתגלה. זה בעל המאפיינים הבאים:
| Property | Type | תיאור |
|---|---|---|
| סטטוס (נדרש) |
מספר שלם | עקוף את הסטטוס של האובייקט שנבחר. ערכים אפשריים: 0 - יצירה מופעלת; 1 - יצירה מושבתת. |
גילוי פעולת עקיפה של כלל LLD
מצב LLD לעקוף את פעולת גילוי שהוגדר לגילוי לְהִתְנַגֵד. יש לו את המאפיינים הבאים:
| Property | Type | תיאור |
|---|---|---|
| גלה (נדרש) |
מספר שלם | עקוף את סטטוס הגילוי של האובייקט שנבחר. ערכים אפשריים: 0 - כן, המשך לגלות את האובייקטים; 1 - לא , אובייקטים חדשים לא יתגלו והקיימים יסומנו כאבודים. |
תקופת פעולה לעקוף כלל LLD
תקופת הפעולה לעקוף כלל LLD היא ערך מרווח עדכון (תומך מרווחים מותאמים אישית) שמוגדר לפריט שהתגלה. יש לו את הדברים הבאים נכסים:
| Property | Type | תיאור |
|---|---|---|
| עיכוב (נדרש) |
string | עקוף את מרווח העדכון של אב הטיפוס של הפריט. מקבל שניות או יחידת זמן עם סיומת (30s,1m,2h,1d) וכן מרווחי זמן גמישים ותזמון ופקודות מאקרו משתמש או פקודות מאקרו LLD. מרווחים מרובים מופרדים על ידי נקודה-פסיק. |
כלל LLD עוקף היסטוריית פעולות
כלל LLD עוקף את ערך היסטוריית הפעולות שהוגדר לגילוי פריט. יש לו את המאפיינים הבאים:
| Property | Type | תיאור |
|---|---|---|
| היסטוריה (חובה) |
string | עקוף את ההיסטוריה של אב טיפוס של פריט שהיא יחידת זמן של משך הזמן שיש לאחסן את נתוני ההיסטוריה. מקבל גם מאקרו משתמש ומקרו LLD. |
כלל LLD עוקף מגמות פעולה
כלל LLD עוקף את ערך מגמות הפעולה שמוגדר לפריט שהתגלה. יש לו את המאפיינים הבאים:
| Property | Type | תיאור |
|---|---|---|
| מגמות (חובה) |
string | עקוף את המגמות של אב טיפוס של פריט שהוא יחידת זמן של משך הזמן שיש לאחסן את נתוני המגמות. מקבל גם מאקרו משתמש ומקרו LLD. |
כלל LLD עוקף את חומרת הפעולה
כלל LLD עוקף את ערך חומרת הפעולה שהוגדר לגילוי הדק. יש לו את המאפיינים הבאים:
| Property | Type | תיאור |
|---|---|---|
| חומרה (חובה) |
מספר שלם | עקוף את חומרת אב הטיפוס של טריגר. ערכים אפשריים הם: 0 - (ברירת מחדל) לא מסווג; 1 - מידע;< br>2 - אזהרה; 3 - ממוצע; 4 - גבוה; 5 - אסון. |
תג פעולת דריסת כלל LLD
אובייקט תג פעולת דריסת כלל LLD מכיל שם תג וערך זה מוגדרים לאובייקט שהתגלה. יש לו את המאפיינים הבאים:
| Property | Type | תיאור |
|---|---|---|
| תג (נדרש) |
מחרוזת | שם תג חדש. |
| value | string | ערך תג חדש. |
תבנית הפעלה של כלל LLD
אובייקט תבנית הפעלה של כלל LLD המקושר לגילוי מנחה. יש לו את המאפיינים הבאים:
| Property | Type | תיאור |
|---|---|---|
| templateid (נדרש) |
string | עקוף את התבנית של תבניות מקושרות אב טיפוס מארח. |
כלל LLD עוקף מלאי של פעולות
ערך מצב מלאי לעקוף כלל LLD שמוגדר ל מארח גילה. יש לו את המאפיינים הבאים:
| Property | Type | תיאור |
|---|---|---|
| מלאי_mode (נדרש) |
מספר שלם | עקוף את מצב מלאי האב-טיפוס המארח. ערכים אפשריים הם: -1 - disabled; 0 - (ברירת מחדל ) ידני; 1 - אוטומטי. |