Documentation
Table of Contents
- discoveryrule.create
- Opis
- Parametry
- Zwracane wartości
- Przykłady
- Tworzenie reguły wykrywania niskopoziomowego
- Użycie filtra
- Tworzenie reguły LLD wraz z ścieżkami makr
- Korzystanie z niestandardowego filtra wyrażeń
- Korzystanie z niestandardowych pól zapytań i nagłówków
- Tworzenie reguły LLD z preprocesingiem
- Tworzenie reguły LLD wraz z regułami nadpisania
- Tworzenie reguły LLD typu skrypt
- Zobacz także
- Źródło
discoveryrule.create
Opis
object discoveryrule.create(object/array lldRules)
Ta metoda pozwala na tworzenie nowych reguł LLD.
Ta metoda jest dostępna tylko dla użytkowników typu Admin i Super admin. Uprawnienia do wywoływania metody można odebrać w ustawieniach roli użytkownika. Zobacz Role użytkownika po więcej informacji.
Parametry
(object/array) reguły LLD do wykreowania.
Oprócz standardowych właściwości reguł LLD, metoda akceptuje następujące parametry.
| Parametr | Typ | Opis |
|---|---|---|
| filter | object | Obiekt filtra reguły LLD dla reguły LLD. |
| preprocessing | array | Opcje preprocessingu reguły LLD. |
| lld_macro_paths | array | Opcje lld_macro_path reguły LLD. |
| overrides | array | Opcje nadpisania reguły LLD. |
Zwracane wartości
(object) Zwraca obiekt zawierający identyfikatory utworzonych reguł LLD we właściwości itemids. Kolejność zwróconych identyfikatorów ID jest zgodna z kolejnością przekazanych reguł LLD.
Przykłady
Tworzenie reguły wykrywania niskopoziomowego
Utwórz regułę LLD agenta Zabbix, aby wykrywać zamontowane systemy plików. Odkryte elementy będą aktualizowane co 30 sekund.
Zapytanie:
{
"jsonrpc": "2.0",
"method": "discoveryrule.create",
"params": {
"name": "Mounted filesystem discovery",
"key_": "vfs.fs.discovery",
"hostid": "10197",
"type": 0,
"interfaceid": "112",
"delay": "30s"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Odpowiedź:
Użycie filtra
Utwórz regułę LLD z zestawem warunków do filtrowania wyników. Warunki zostaną pogrupowane za pomocą logicznego operatora "i".
Zapytanie:
{
"jsonrpc": "2.0",
"method": "discoveryrule.create",
"params": {
"name": "Filtered LLD rule",
"key_": "lld",
"hostid": "10116",
"type": 0,
"interfaceid": "13",
"delay": "30s",
"filter": {
"evaltype": 1,
"conditions": [
{
"macro": "{#MACRO1}",
"value": "@regex1"
},
{
"macro": "{#MACRO2}",
"value": "@regex2",
"operator": "9"
},
{
"macro": "{#MACRO3}",
"value": "",
"operator": "12"
},
{
"macro": "{#MACRO4}",
"value": "",
"operator": "13"
}
]
}
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Odpowiedź:
Tworzenie reguły LLD wraz z ścieżkami makr
Zapytanie:
{
"jsonrpc": "2.0",
"method": "discoveryrule.create",
"params": {
"name": "LLD rule with LLD macro paths",
"key_": "lld",
"hostid": "10116",
"type": 0,
"interfaceid": "13",
"delay": "30s",
"lld_macro_paths": [
{
"lld_macro": "{#MACRO1}",
"path": "$.path.1"
},
{
"lld_macro": "{#MACRO2}",
"path": "$.path.2"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Odpowiedź:
Korzystanie z niestandardowego filtra wyrażeń
Utwórz regułę LLD z filtrem, który będzie używał niestandardowego wyrażenia do oceny warunków. Reguła LLD musi wykrywać tylko obiekty, których wartość makra „{#MACRO1}” pasuje zarówno do wyrażenia regularnego „regex1”, jak i „regex2”, a wartość „{#MACRO2}” pasuje do „regex3” lub „regex4 ". Identyfikatory formuł „A”, „B”, „C” i „D” zostały wybrane arbitralnie.
Zapytanie:
{
"jsonrpc": "2.0",
"method": "discoveryrule.create",
"params": {
"name": "Filtered LLD rule",
"key_": "lld",
"hostid": "10116",
"type": 0,
"interfaceid": "13",
"delay": "30s",
"filter": {
"evaltype": 3,
"formula": "(A and B) and (C or D)",
"conditions": [
{
"macro": "{#MACRO1}",
"value": "@regex1",
"formulaid": "A"
},
{
"macro": "{#MACRO1}",
"value": "@regex2",
"formulaid": "B"
},
{
"macro": "{#MACRO2}",
"value": "@regex3",
"formulaid": "C"
},
{
"macro": "{#MACRO2}",
"value": "@regex4",
"formulaid": "D"
}
]
}
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Odpowiedź:
Korzystanie z niestandardowych pól zapytań i nagłówków
Utwórz regułę LLD z niestandardowymi polami zapytań i nagłówkami.
Zapytanie:
{
"jsonrpc": "2.0",
"method": "discoveryrule.create",
"params": {
"hostid": "10257",
"interfaceid": "5",
"type": 19,
"name": "API HTTP agent",
"key_": "api_discovery_rule",
"value_type": 3,
"delay": "5s",
"url": "http://127.0.0.1?discoverer.php",
"query_fields": [
{
"mode": "json"
},
{
"elements": "2"
}
],
"headers": {
"X-Type": "api",
"Authorization": "Bearer mF_A.B5f-2.1JcM"
},
"allow_traps": 1,
"trapper_hosts": "127.0.0.1"
},
"auth": "d678e0b85688ce578ff061bd29a20d3b",
"id": 1
}Odpowiedź:
Tworzenie reguły LLD z preprocesingiem
Zapytanie:
{
"jsonrpc": "2.0",
"method": "discoveryrule.create",
"params": {
"name": "Discovery rule with preprocessing",
"key_": "lld.with.preprocessing",
"hostid": "10001",
"ruleid": "27665",
"type": 0,
"value_type": 3,
"delay": "60s",
"interfaceid": "1155",
"preprocessing": [
{
"type": 20,
"params": "20",
"error_handler": 0,
"error_handler_params": ""
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Odpowiedź:
Tworzenie reguły LLD wraz z regułami nadpisania
Zapytanie:
{
"jsonrpc": "2.0",
"method": "discoveryrule.create",
"params": {
"name": "Discover database host",
"key_": "lld.with.overrides",
"hostid": "10001",
"type": 0,
"value_type": 3,
"delay": "60s",
"interfaceid": "1155",
"overrides": [
{
"name": "Discover MySQL host",
"step": "1",
"stop": "1",
"filter": {
"evaltype": "2",
"conditions": [
{
"macro": "{#UNIT.NAME}",
"operator": "8",
"value": "^mysqld\\.service$"
},
{
"macro": "{#UNIT.NAME}",
"operator": "8",
"value": "^mariadb\\.service$"
}
]
},
"operations": [
{
"operationobject": "3",
"operator": "2",
"value": "Database host",
"opstatus": {
"status": "0"
},
"optemplate": [
{
"templateid": "10170"
}
],
"optag": [
{
"tag": "Database",
"value": "MySQL"
}
]
}
]
},
{
"name": "Discover PostgreSQL host",
"step": "2",
"stop": "1",
"filter": {
"evaltype": "0",
"conditions": [
{
"macro": "{#UNIT.NAME}",
"operator": "8",
"value": "^postgresql\\.service$"
}
]
},
"operations": [
{
"operationobject": "3",
"operator": "2",
"value": "Database host",
"opstatus": {
"status": "0"
},
"optemplate": [
{
"templateid": "10263"
}
],
"optag": [
{
"tag": "Database",
"value": "PostgreSQL"
}
]
}
]
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Odpowiedź:
Tworzenie reguły LLD typu skrypt
Utwórz proste zbieranie danych za ponocą skryptu w regule LLD.
Zapytanie:
{
"jsonrpc": "2.0",
"method": "discoveryrule.create",
"params": {
"name": "Script example",
"key_": "custom.script.lldrule",
"hostid": "12345",
"type": 21,
"value_type": 4,
"params": "var request = new CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));",
"parameters": [
{
"name": "host",
"value": "{HOST.CONN}"
}
],
"timeout": "6s",
"delay": "30s"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 2
}Odpowiedź:
Zobacz także
Źródło
CDiscoveryRule::create() w ui/include/classes/api/services/CDiscoveryRule.php.