Documentation
Table of Contents
discoveryrule.create
תיאור
object discoveryrule.create(object/array lldRules)
שיטה זו מאפשרת ליצור כללי LLD חדשים.
שיטה זו זמינה רק ל-Admin ו-Super Admin סוגי משתמשים. ניתן לבטל הרשאות לקרוא לשיטה בתפקיד משתמש הגדרות. ראה משתמש תפקידים למידע נוסף.
פרמטרים
(object/array) כללי LLD ליצירת.
בנוסף למאפייני כלל LLD הסטנדרטיים, ה השיטה מקבלת את הפרמטרים הבאים.
| פרמטר | סוג | תיאור |
|---|---|---|
| filter | object | כלל LLD filter עבור כלל LLD. |
| preprocessing | מערך | כלל LD preprocessing אפשרויות. |
| lld_macro_paths | מערך | כלל LLD lld_macro_path אפשרויות. |
| overrides | מערך | כלל LD עוקף אפשרויות. |
החזר ערכים
(object) מחזיר אובייקט המכיל את המזהים של כללי ה-LLD שנוצרו תחת הנכס itemids. סדר המזהים המוחזרים תואם את סדר כללי LLD שעברו.
דוגמאות
יצירת כלל LLD
צור כלל LLD של סוכן Zabbix כדי לגלות מערכות קבצים רכובות. פריטים שהתגלו יעודכנו כל 30 שניות.
בַּקָשָׁה:
{
"jsonrpc": "2.0",
"method": "discoveryrule.create",
"params": {
"name": "גילוי מערכת קבצים מותקן",
"key_": "vfs.fs.discovery",
"hostid": "10197",
"סוג": 0,
"interfaceid": "112",
"delay": "30s"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"מזהה": 1
}תְגוּבָה:
שימוש במסנן
צור כלל LLD עם קבוצת תנאים לפיהם ניתן לסנן את התוצאות. התנאים יקובצו יחד באמצעות "ו" ההגיוני מַפעִיל.
בַּקָשָׁה:
{
"jsonrpc": "2.0",
"method": "discoveryrule.create",
"params": {
"name": "כלל LLD מסונן",
"key_": "lld",
"hostid": "10116",
"סוג": 0,
"interfaceid": "13",
"delay": "30s",
"מסנן": {
"evaltype": 1,
"תנאים": [
{
"macro": "{#MACRO1}",
"value": "@regex1"
},
{
"macro": "{#MACRO2}",
"value": "@regex2",
"מפעיל": "9"
},
{
"macro": "{#MACRO3}",
"ערך": "",
"מפעיל": "12"
},
{
"macro": "{#MACRO4}",
"ערך": "",
"מפעיל": "13"
}
]
}
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"מזהה": 1
}תְגוּבָה:
יצירת כלל LLD עם נתיבי מאקרו
בַּקָשָׁה:
{
"jsonrpc": "2.0",
"method": "discoveryrule.create",
"params": {
"name": "כלל LLD עם נתיבי מאקרו LLD",
"key_": "lld",
"hostid": "10116",
"סוג": 0,
"interfaceid": "13",
"delay": "30s",
"lld_macro_paths": [
{
"lld_macro": "{#MACRO1}",
"path": "$.path.1"
},
{
"lld_macro": "{#MACRO2}",
"path": "$.path.2"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"מזהה": 1
}תְגוּבָה:
שימוש במסנן ביטויים מותאם אישית
צור כלל LLD עם מסנן שישתמש בביטוי מותאם אישית כדי להעריך את התנאים. כלל LLD חייב לגלות רק אובייקטים את ערך המאקרו "{#MACRO1}" שמתאים לשני הביטויים הרגולריים "regex1" ו-"regex2", והערך של "{#MACRO2}" מתאים לאחד "regex3" או "regex4". מזהי הנוסחה "A", "B", "C" ו-"D" היו נבחר באופן שרירותי.
בַּקָשָׁה:
{
"jsonrpc": "2.0",
"method": "discoveryrule.create",
"params": {
"name": "כלל LLD מסונן",
"key_": "lld",
"hostid": "10116",
"סוג": 0,
"interfaceid": "13",
"delay": "30s",
"מסנן": {
"evaltype": 3,
"נוסחה": "(A ו-B) ו-(C או D)",
"תנאים": [
{
"macro": "{#MACRO1}",
"value": "@regex1",
"formulaid": "א"
},
{
"macro": "{#MACRO1}",
"value": "@regex2",
"formulaid": "B"
},
{
"macro": "{#MACRO2}",
"value": "@regex3",
"formulaid": "C"
},
{
"macro": "{#MACRO2}",
"value": "@regex4",
"formulaid": "D"
}
]
}
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"מזהה": 1
}תְגוּבָה:
שימוש בשדות ובכותרות של שאילתה מותאמים אישית
צור כלל LLD עם שדות וכותרות מותאמים אישית של שאילתה.
בַּקָשָׁה:
{
"jsonrpc": "2.0",
"method": "discoveryrule.create",
"params": {
"hostid": "10257",
"interfaceid": "5",
"סוג": 19,
"name": "סוכן API HTTP",
"key_": "api_discovery_rule",
"ערך_סוג": 3,
"delay": "5s",
"url": "http://127.0.0.1?discoverer.php",
"query_fields": [
{
"mode": "json"
},
{
"elements": "2"
}
],
"headers": {
"X-Type": "API",
"Authorization": "נושא mF_A.B5f-2.1JcM"
},
"allow_traps": 1,
"trapper_hosts": "127.0.0.1"
},
"auth": "d678e0b85688ce578ff061bd29a20d3b",
"מזהה": 1
}תְגוּבָה:
יצירת כלל LLD עם עיבוד מקדים
בַּקָשָׁה:
{
"jsonrpc": "2.0",
"method": "discoveryrule.create",
"params": {
"name": "כלל גילוי עם עיבוד מקדים",
"key_": "lld.with.preprocessing",
"hostid": "10001",
"ruleid": "27665",
"סוג": 0,
"ערך_סוג": 3,
"delay": "שנות ה-60",
"interfaceid": "1155",
"עיבוד מוקדם": [
{
"סוג": 20,
"params": "20",
"error_handler": 0,
"error_handler_params": ""
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"מזהה": 1
}תְגוּבָה:
יצירת כלל LLD עם עקיפות
בַּקָשָׁה:
{
"jsonrpc": "2.0",
"method": "discoveryrule.create",
"params": {
"name": "גלה מארח מסד הנתונים",
"key_": "lld.with.overrides",
"hostid": "10001",
"סוג": 0,
"ערך_סוג": 3,
"delay": "שנות ה-60",
"interfaceid": "1155",
"עוקף": [
{
"name": "גלה מארח MySQL",
"שלב 1",
"stop": "1",
"מסנן": {
"evaltype": "2",
"תנאים": [
{
"macro": "{#UNIT.NAME}",
"מפעיל": "8",
"value": "^mysqld\\.service$"
},
{
"macro": "{#UNIT.NAME}",
"מפעיל": "8",
"value": "^mariadb\\.service$"
}
]
},
"פעולות": [
{
"operationobject": "3",
"מפעיל": "2",
"value": "מארח מסד נתונים",
"opstatus": {
"סטטוס": "0"
},
"optemplate": [
{
"templateid": "10170"
}
],
"optag": [
{
"tag": "מסד נתונים",
"value": "MySQL"
}
]
}
]
},
{
"name": "גלה מארח PostgreSQL",
"שלב 2",
"stop": "1",
"מסנן": {
"evaltype": "0",
"תנאים": [
{
"macro": "{#UNIT.NAME}",
"מפעיל": "8",
"value": "^postgresql\\.service$"
}
]
},
"פעולות": [
{
"operationobject": "3",
"מפעיל": "2",
"value": "מארח מסד נתונים",
"opstatus": {
"סטטוס": "0"
},
"optemplate": [
{
"templateid": "10263"
}
],
"optag": [
{
"tag": "מסד נתונים",
"value": "PostgreSQL"
}
]
}
]
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"מזהה": 1
}תְגוּבָה:
צור כלל LLD של סקריפט
צור איסוף נתונים פשוט באמצעות כלל Script LLD.
בַּקָשָׁה:
{
"jsonrpc": "2.0",
"method": "discoveryrule.create",
"params": {
"name": "דוגמה לסקריפט",
"key_": "custom.script.lldrule",
"hostid": "12345",
"סוג": 21,
"ערך_סוג": 4,
"params": "var request = new CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));",
"פרמטרים": [
{
"name": "מארח",
"value": "{HOST.CONN}"
}
],
"פסק זמן": "6 שניות",
"delay": "30s"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"מזהה": 2
}תְגוּבָה:
ראה גם
מקור
CDiscoveryRule::create() בתוך ui/include/classes/api/services/CDiscoveryRule.php.