- Obiekt reguły LLD (Low Level Discovery)
- Reguła LLD
- Filtr reguły LLD
- Ścieżka makra LLD
- Preprocessing reguły LLD
- Nadpisy reguł LLD
- Filtr nadpisywania reguły LLD
- Operacja nadpisania reguły LLD
- Status operacji nadpisania reguły LLD
- Operacja nadpisania reguły LLD: discover
- Okres operacji nadpisania reguły LLD
- Historia operacji nadpisania reguły LLD
- Trendy operacji nadpisania reguły LLD
- Nadpisanie poziomu ważności operacji reguły LLD
- Znacznik operacji nadpisania reguły LLD
- Szablon operacji nadpisania reguły LLD
- Inwentarz operacji nadpisania reguły LLD
Obiekt reguły LLD (Low Level Discovery)
Następujące obiekty są bezpośrednio powiązane z API discoveryrule.
Reguła LLD
Obiekt reguły wykrywania niskiego poziomu ma następujące właściwości.
| Property | Type | Description |
|---|---|---|
| itemid | ID | ID reguły LLD. Property behavior: - tylko do odczytu - wymagane dla operacji aktualizacji |
| delay | string | Interwał aktualizacji reguły LLD. Akceptuje sekundy lub jednostkę czasu z sufiksem (np. 30s, 1m, 2h, 1d) oraz opcjonalnie jedną lub więcej niestandardowych interwałów, wszystkie oddzielone średnikami. Niestandardowe interwały mogą być mieszanką interwałów elastycznych i harmonogramowanych. Akceptuje makra użytkownika. Jeśli są używane, wartość musi być pojedynczym makrem. Wiele makr lub makra połączone z tekstem nie są obsługiwane. Interwały elastyczne mogą być zapisane jako dwa makra oddzielone ukośnikiem (np. {$FLEX_INTERVAL}/{$FLEX_PERIOD}).Przykład: 1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}Property behavior: - wymagane jeśli type ma wartość "Zabbix agent" (0), "Simple check" (3), "Zabbix internal" (5), "External check" (10), "Database monitor" (11), "IPMI agent" (12), "SSH agent" (13), "TELNET agent" (14), "JMX agent" (16), "HTTP agent" (19), "SNMP agent" (20), "Script" (21), "Browser" (22) lub jeśli type ma wartość "Zabbix agent (active)" (7) i key_ nie zawiera "mqtt.get" |
| hostid | ID | ID hosta, do którego należy reguła LLD. Property behavior: - stałe - wymagane dla operacji tworzenia |
| interfaceid | ID | ID interfejsu hosta reguły LLD. Property behavior: - wymagane jeśli reguła LLD należy do hosta i type ma wartość "Zabbix agent", "IPMI agent", "JMX agent" lub "SNMP agent"- obsługiwane jeśli reguła LLD należy do hosta i type ma wartość "Simple check", "External check", "SSH agent", "TELNET agent" lub "HTTP agent" |
| key_ | string | Klucz reguły LLD. Property behavior: - wymagane dla operacji tworzenia - tylko do odczytu dla obiektów dziedziczonych |
| name | string | Nazwa reguły LLD. Property behavior: - wymagane dla operacji tworzenia - tylko do odczytu dla obiektów dziedziczonych |
| type | integer | Typ reguły LLD. Możliwe wartości: 0 - Zabbix agent; 2 - Zabbix trapper; 3 - Simple check; 5 - Zabbix internal; 7 - Zabbix agent (active); 10 - External check; 11 - Database monitor; 12 - IPMI agent; 13 - SSH agent; 14 - TELNET agent; 16 - JMX agent; 18 - Dependent item; 19 - HTTP agent; 20 - SNMP agent; 21 - Script; 22 - Browser. Property behavior: - wymagane dla operacji tworzenia - tylko do odczytu dla obiektów dziedziczonych |
| url | string | Łańcuch URL. Obsługuje makra użytkownika, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}. Property behavior: - wymagane jeśli type ma wartość "HTTP agent"- tylko do odczytu dla obiektów dziedziczonych |
| allow_traps | integer | Pozwala na wypełnianie wartości podobnie jak w przypadku pozycji trapper. Możliwe wartości: 0 - (domyślnie) Nie zezwalaj na przyjmowanie danych przychodzących; 1 - Zezwalaj na przyjmowanie danych przychodzących. Property behavior: - obsługiwane jeśli type ma wartość "HTTP agent" |
| authtype | integer | Metoda uwierzytelniania. Możliwe wartości, jeśli type ma wartość "SSH agent":0 - (domyślnie) hasło; 1 - klucz publiczny. Możliwe wartości, jeśli type ma wartość "HTTP agent":0 - (domyślnie) brak; 1 - basic; 2 - NTLM; 3 - Kerberos; 4 - Digest. Property behavior: - obsługiwane jeśli type ma wartość "SSH agent" lub "HTTP agent"- tylko do odczytu dla obiektów dziedziczonych (jeśli type ma wartość "HTTP agent") |
| description | string | Opis reguły LLD. |
| error | string | Tekst błędu, jeśli występują problemy z aktualizacją wartości reguły LLD. Property behavior: - tylko do odczytu |
| follow_redirects | integer | Podążaj za przekierowaniami odpowiedzi podczas pobierania danych. Możliwe wartości: 0 - Nie podążaj za przekierowaniami; 1 - (domyślnie) Podążaj za przekierowaniami. Property behavior: - obsługiwane jeśli type ma wartość "HTTP agent"- tylko do odczytu dla obiektów dziedziczonych |
| headers | array | Tablica nagłówków, które zostaną wysłane podczas wykonywania żądania HTTP. Property behavior: - obsługiwane jeśli type ma wartość "HTTP agent"- tylko do odczytu dla obiektów dziedziczonych |
| http_proxy | string | Łańcuch połączenia proxy HTTP(S). Property behavior: - obsługiwane jeśli type ma wartość "HTTP agent"- tylko do odczytu dla obiektów dziedziczonych |
| ipmi_sensor | string | Czujnik IPMI. Property behavior: - wymagane jeśli type ma wartość "IPMI agent" i key_ nie ma wartości "ipmi.get"- obsługiwane jeśli type ma wartość "IPMI agent"- tylko do odczytu dla obiektów dziedziczonych |
| jmx_endpoint | string | Niestandardowy łańcuch połączenia agenta JMX. Domyślnie: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi Property behavior: - obsługiwane jeśli type ma wartość "JMX agent" |
| lifetime | string | Okres czasu, po którym pozycje, które nie są już wykrywane, zostaną usunięte. Akceptuje sekundy, jednostkę czasu z sufiksem lub makro użytkownika. Domyślnie: 7d. |
| lifetime_type | integer | Scenariusz usuwania utraconych zasobów LLD. Możliwe wartości: 0 - (domyślnie) Usuń po osiągnięciu progu czasu życia; 1 - Nie usuwaj; 2 - Usuń natychmiast. |
| enabled_lifetime | string | Okres czasu, po którym pozycje, które nie są już wykrywane, zostaną wyłączone. Akceptuje sekundy, jednostkę czasu z sufiksem lub makro użytkownika. Domyślnie: 0. |
| enabled_lifetime_type | integer | Scenariusz wyłączania utraconych zasobów LLD. Możliwe wartości: 0 - Wyłącz po osiągnięciu progu czasu życia; 1 - Nie wyłączaj; 2 - (domyślnie) Wyłącz natychmiast. |
| master_itemid | ID | ID pozycji nadrzędnej. Dozwolona jest rekurencja do 3 pozycji zależnych oraz maksymalna liczba pozycji zależnych równa 999. Reguła wykrywania nie może być pozycją nadrzędną dla innej reguły wykrywania. Property behavior: - wymagane jeśli type ma wartość "Dependent item"- tylko do odczytu dla obiektów dziedziczonych |
| output_format | integer | Czy odpowiedź ma zostać przekonwertowana do JSON. Możliwe wartości: 0 - (domyślnie) Zapisz surowe dane; 1 - Konwertuj do JSON. Property behavior: - obsługiwane jeśli type ma wartość "HTTP agent"- tylko do odczytu dla obiektów dziedziczonych |
| params | string | Dodatkowe parametry zależnie od typu reguły LLD: - wykonywany skrypt dla reguł LLD SSH i Telnet; - zapytanie SQL dla reguł LLD monitorowania bazy danych; - formuła dla obliczanych reguł LLD; - skrypt dla reguł LLD typu script i browser. Property behavior: - wymagane jeśli type ma wartość "Database monitor", "SSH agent", "TELNET agent", "Script" lub "Browser"- tylko do odczytu dla obiektów dziedziczonych (jeśli type ma wartość "Script" lub "Browser") |
| parameters | object/array | Dodatkowe parametry, jeśli type ma wartość "Script" lub "Browser".Tablica obiektów z właściwościami name i value, gdzie name musi być unikalne.Property behavior: - obsługiwane jeśli type ma wartość "Script" lub "Browser"- tylko do odczytu dla obiektów dziedziczonych |
| password | string | Hasło do uwierzytelniania. Property behavior: - wymagane jeśli type ma wartość "JMX agent" i username jest ustawione- obsługiwane jeśli type ma wartość "Simple check", "Database monitor", "SSH agent", "TELNET agent" lub "HTTP agent"- tylko do odczytu dla obiektów dziedziczonych (jeśli type ma wartość "HTTP agent") |
| post_type | integer | Typ treści danych POST przechowywanych we właściwości posts.Możliwe wartości: 0 - (domyślnie) Dane surowe; 2 - Dane JSON; 3 - Dane XML. Property behavior: - obsługiwane jeśli type ma wartość "HTTP agent"- tylko do odczytu dla obiektów dziedziczonych |
| posts | string | Dane treści żądania HTTP(S). Property behavior: - wymagane jeśli type ma wartość "HTTP agent" i post_type ma wartość "JSON data" lub "XML data"- obsługiwane jeśli type ma wartość "HTTP agent" i post_type ma wartość "Raw data"- tylko do odczytu dla obiektów dziedziczonych |
| privatekey | string | Nazwa pliku klucza prywatnego. Property behavior: - wymagane jeśli type ma wartość "SSH agent" i authtype ma wartość "public key" |
| publickey | string | Nazwa pliku klucza publicznego. Property behavior: - wymagane jeśli type ma wartość "SSH agent" i authtype ma wartość "public key" |
| query_fields | array | Tablica pól zapytania, które zostaną wysłane podczas wykonywania żądania HTTP. Property behavior: - obsługiwane jeśli type ma wartość "HTTP agent"- tylko do odczytu dla obiektów dziedziczonych |
| request_method | integer | Typ metody żądania. Możliwe wartości: 0 - (domyślnie) GET; 1 - POST; 2 - PUT; 3 - HEAD. Property behavior: - obsługiwane jeśli type ma wartość "HTTP agent"- tylko do odczytu dla obiektów dziedziczonych |
| retrieve_mode | integer | Która część odpowiedzi ma zostać zapisana. Możliwe wartości, jeśli request_method ma wartość "GET", "POST" lub "PUT":0 - (domyślnie) Treść; 1 - Nagłówki; 2 - Zostaną zapisane zarówno treść, jak i nagłówki. Możliwe wartości, jeśli request_method ma wartość "HEAD":1 - Nagłówki. Property behavior: - obsługiwane jeśli type ma wartość "HTTP agent"- tylko do odczytu dla obiektów dziedziczonych |
| snmp_oid | string | OID SNMP. Property behavior: - wymagane jeśli type ma wartość "SNMP agent"- tylko do odczytu dla obiektów dziedziczonych |
| ssl_cert_file | string | Ścieżka do publicznego pliku klucza SSL. Property behavior: - obsługiwane jeśli type ma wartość "HTTP agent"- tylko do odczytu dla obiektów dziedziczonych |
| ssl_key_file | string | Ścieżka do prywatnego pliku klucza SSL. Property behavior: - obsługiwane jeśli type ma wartość "HTTP agent"- tylko do odczytu dla obiektów dziedziczonych |
| ssl_key_password | string | Hasło do pliku klucza SSL. Property behavior: - obsługiwane jeśli type ma wartość "HTTP agent"- tylko do odczytu dla obiektów dziedziczonych |
| state | integer | Stan reguły LLD. Możliwe wartości: 0 - (domyślnie) normalny; 1 - nieobsługiwany. Property behavior: - tylko do odczytu |
| status | integer | Status reguły LLD. Możliwe wartości: 0 - (domyślnie) włączona reguła LLD; 1 - wyłączona reguła LLD. |
| status_codes | string | Zakresy wymaganych kodów statusu HTTP, oddzielone przecinkami. Obsługuje również makra użytkownika jako część listy rozdzielanej przecinkami. Przykład: 200,200-{$M},{$M},200-400 Property behavior: - obsługiwane jeśli type ma wartość "HTTP agent"- tylko do odczytu dla obiektów dziedziczonych |
| templateid | ID | ID nadrzędnego szablonu reguły LLD. Property behavior: - tylko do odczytu |
| timeout | string | Limit czasu żądania pobierania danych pozycji. Akceptuje sekundy lub jednostkę czasu z sufiksem (np. 30s, 1m). Akceptuje również makra użytkownika. Zakres możliwych wartości: 1-600s. Domyślnie: "" - użyj ustawień proxy/globalnych. Property behavior: - obsługiwane jeśli type ma wartość "Zabbix agent" (0), "Simple check" (3) i key_ nie zaczyna się od "vmware." ani "icmpping", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "HTTP agent" (19), "SNMP agent" (20) i snmp_oid zaczyna się od "walk[" lub "get[", "Script" (21), "Browser" (22)- tylko do odczytu dla obiektów dziedziczonych |
| trapper_hosts | string | Dozwolone hosty. Property behavior: - obsługiwane jeśli type ma wartość "Zabbix trapper", lub jeśli type ma wartość "HTTP agent" i allow_traps ma wartość "Allow to accept incoming data" |
| username | string | Nazwa użytkownika do uwierzytelniania. Property behavior: - wymagane jeśli type ma wartość "SSH agent", "TELNET agent", lub jeśli type ma wartość "JMX agent" i password jest ustawione- obsługiwane jeśli type ma wartość "Simple check", "Database monitor" lub "HTTP agent"- tylko do odczytu dla obiektów dziedziczonych (jeśli type ma wartość "HTTP agent") |
| uuid | string | Uniwersalny unikalny identyfikator, używany do powiązania importowanych reguł LLD z już istniejącymi. Generowany automatycznie, jeśli nie zostanie podany. Property behavior: - obsługiwane jeśli reguła LLD należy do szablonu |
| verify_host | integer | Czy sprawdzać, czy nazwa hosta dla połączenia zgadza się z nazwą w certyfikacie hosta. Możliwe wartości: 0 - (domyślnie) Nie sprawdzaj; 1 - Sprawdzaj. Property behavior: - obsługiwane jeśli type ma wartość "HTTP agent"- tylko do odczytu dla obiektów dziedziczonych |
| verify_peer | integer | Czy sprawdzać, czy certyfikat hosta jest autentyczny. Możliwe wartości: 0 - (domyślnie) Nie sprawdzaj; 1 - Sprawdzaj. Property behavior: - obsługiwane jeśli type ma wartość "HTTP agent"- tylko do odczytu dla obiektów dziedziczonych |
Nagłówek HTTP
Obiekt nagłówka ma następujące właściwości:
| Właściwość | Typ | Opis |
|---|---|---|
| name | string | Nazwa nagłówka HTTP. Zachowanie właściwości: - wymagane |
| value | string | Wartość nagłówka. Zachowanie właściwości: - wymagane |
Pole zapytania HTTP
Obiekt pola zapytania definiuje nazwę i wartość używane do określenia parametru URL. Ma następujące właściwości:
| Właściwość | Typ | Opis |
|---|---|---|
| name | string | Nazwa parametru. Zachowanie właściwości: - wymagane |
| value | string | Wartość parametru. Zachowanie właściwości: - wymagane |
Filtr reguły LLD
Obiekt filtra reguły LLD definiuje zestaw warunków, które można wykorzystać do filtrowania wykrytych obiektów. Ma następujące właściwości:
| Property | Type | Description |
|---|---|---|
| conditions | object/array | Zestaw warunków filtra używanych do filtrowania wyników. Warunki zostaną posortowane zgodnie z kolejnością ich umieszczenia we wzorze. Zachowanie właściwości: - required |
| evaltype | integer | Metoda oceny warunków filtra. Możliwe wartości: 0 - And/Or; 1 - And; 2 - Or; 3 - Wyrażenie niestandardowe. Zachowanie właściwości: - required |
| eval_formula | string | Wygenerowane wyrażenie, które będzie używane do oceny warunków filtra. Wyrażenie zawiera identyfikatory odwołujące się do konkretnych warunków filtra za pomocą ich formulaid. Wartość eval_formula jest równa wartości formula dla filtrów z wyrażeniem niestandardowym.Zachowanie właściwości: - read-only |
| formula | string | Wyrażenie zdefiniowane przez użytkownika, używane do oceny warunków filtrów z wyrażeniem niestandardowym. Wyrażenie musi zawierać identyfikatory odwołujące się do konkretnych warunków filtra za pomocą ich formulaid. Identyfikatory użyte w wyrażeniu muszą dokładnie odpowiadać tym zdefiniowanym w warunkach filtra: żaden warunek nie może pozostać nieużyty ani pominięty.Zachowanie właściwości: - required jeśli evaltype jest ustawione na "custom expression" |
Warunek filtra reguły LLD
Obiekt warunku filtra reguły LLD definiuje osobne sprawdzenie wykonywane na wartości makra LLD. Ma on następujące właściwości:
| Właściwość | Typ | Opis |
|---|---|---|
| macro | string | Makro LLD, na którym ma zostać wykonane sprawdzenie. Zachowanie właściwości: - wymagane |
| value | string | Wartość do porównania. Zachowanie właściwości: - wymagane jeśli operator jest ustawiony na "matches regular expression" lub "does not match regular expression" |
| formulaid | string | Dowolny unikalny identyfikator używany do odwoływania się do warunku z wyrażenia niestandardowego. Może zawierać wyłącznie wielkie litery. Identyfikator musi zostać zdefiniowany przez użytkownika podczas modyfikowania warunków filtra, ale przy późniejszym pobieraniu zostanie wygenerowany ponownie. Zachowanie właściwości: - wymagane jeśli evaltype obiektu LLD rule filter object jest ustawiony na "custom expression" |
| operator | integer | Operator warunku. Możliwe wartości: 8 - (domyślnie) matches regular expression; 9 - does not match regular expression; 12 - exists; 13 - does not exist. |
Aby lepiej zrozumieć, jak używać filtrów z różnymi typami wyrażeń, zobacz przykłady na stronach metod discoveryrule.get i discoveryrule.create.
Ścieżka makra LLD
Ścieżka makra LLD ma następujące właściwości:
| Właściwość | Type | Opis |
|---|---|---|
| lld_macro | string | Makro LLD. Zachowanie właściwości: - wymagane |
| path | string | Selektor wartości, która zostanie przypisana do odpowiadającego jej makra. Zachowanie właściwości: - wymagane |
Preprocessing reguły LLD
Obiekt preprocessing reguły LLD ma następujące właściwości.
| Property | Type | Description |
|---|---|---|
| type | integer | Typ opcji preprocessing. Possible values: 5 - Wyrażenie regularne; 11 - XML XPath; 12 - JSONPath; 14 - Dopasowuje wyrażenie regularne; 15 - Nie dopasowuje wyrażenia regularnego; 16 - Sprawdź błąd w JSON; 17 - Sprawdź błąd w XML; 20 - Odrzuć niezmienione z heartbeat; 21 - JavaScript; 23 - Prometheus do JSON; 24 - CSV do JSON; 25 - Zamień; 27 - XML do JSON; 28 - Wartość SNMP walk; 29 - SNMP walk do JSON; 30 - Wartość SNMP get. Property behavior: - required |
| params | string | Dodatkowe parametry używane przez opcję preprocessing. Wiele parametrów jest oddzielonych znakiem nowej linii (\n). Property behavior: - required jeśli type jest ustawione na "Wyrażenie regularne" (5), "XML XPath" (11), "JSONPath" (12), "Dopasowuje wyrażenie regularne" (14), "Nie dopasowuje wyrażenia regularnego" (15), "Sprawdź błąd w JSON" (16), "Sprawdź błąd w XML" (17), "Odrzuć niezmienione z heartbeat" (20), "JavaScript" (21), "Prometheus do JSON" (23), "CSV do JSON" (24), "Zamień" (25), "Wartość SNMP walk" (28), "SNMP walk do JSON" (29) lub "Wartość SNMP get" (30) |
| error_handler | integer | Typ akcji używany w przypadku niepowodzenia kroku preprocessing. Possible values: 0 - Komunikat błędu jest ustawiany przez serwer Zabbix; 1 - Odrzuć wartość; 2 - Ustaw wartość niestandardową; 3 - Ustaw niestandardowy komunikat błędu. Property behavior: - required jeśli type jest ustawione na "Wyrażenie regularne" (5), "XML XPath" (11), "JSONPath" (12), "Dopasowuje wyrażenie regularne" (14), "Nie dopasowuje wyrażenia regularnego" (15), "Sprawdź błąd w JSON" (16), "Sprawdź błąd w XML" (17), "Prometheus do JSON" (23), "CSV do JSON" (24), "XML do JSON" (27), "Wartość SNMP walk" (28), "SNMP walk do JSON" (29) lub "Wartość SNMP get" (30) |
| error_handler_params | string | Parametry obsługi błędów. Property behavior: - required jeśli error_handler jest ustawione na "Ustaw wartość niestandardową" lub "Ustaw niestandardowy komunikat błędu" |
Następujące parametry i obsługi błędów są obsługiwane dla każdego typu preprocessing.
| Preprocessing type | Name | Parameter 1 | Parameter 2 | Parameter 3 | Supported error handlers |
|---|---|---|---|---|---|
| 5 | Wyrażenie regularne | pattern1 | output2 | 0, 1, 2, 3 | |
| 11 | XML XPath | path3 | 0, 1, 2, 3 | ||
| 12 | JSONPath | path3 | 0, 1, 2, 3 | ||
| 14 | Dopasowuje wyrażenie regularne | pattern1 | 0, 1, 2, 3 | ||
| 15 | Nie dopasowuje wyrażenia regularnego | pattern1 | 0, 1, 2, 3 | ||
| 16 | Sprawdź błąd w JSON | path3 | 0, 1, 2, 3 | ||
| 17 | Sprawdź błąd w XML | path3 | 0, 1, 2, 3 | ||
| 20 | Odrzuć niezmienione z heartbeat | seconds4, 5 | |||
| 21 | JavaScript | script2 | |||
| 23 | Prometheus do JSON | pattern5, 6 | 0, 1, 2, 3 | ||
| 24 | CSV do JSON | character2 | character2 | 0,1 | 0, 1, 2, 3 |
| 25 | Zamień | search string2 | replacement2 | ||
| 27 | XML do JSON | 0, 1, 2, 3 | |||
| 28 | Wartość SNMP walk | OID2 | Format: 0 - Bez zmian 1 - UTF-8 z Hex-STRING 2 - MAC z Hex-STRING 3 - Integer z BITS |
0, 1, 2, 3 | |
| 29 | SNMP walk do JSON7 | Field name2 | OID prefix2 | Format: 0 - Bez zmian 1 - UTF-8 z Hex-STRING 2 - MAC z Hex-STRING 3 - Integer z BITS |
0, 1, 2, 3 |
| 30 | Wartość SNMP get | Format: 1 - UTF-8 z Hex-STRING 2 - MAC z Hex-STRING 3 - Integer z BITS |
0, 1, 2, 3 | ||
1 wyrażenie regularne
2 ciąg znaków
3 JSONPath lub XML XPath
4 dodatnia liczba całkowita (z obsługą sufiksów czasu, np. 30s, 1m, 2h,
1d)
5 makro użytkownika
6 wzorzec Prometheus zgodny ze składnią:
<metric name>{<label name>="<label value>", ...} == <value>. Każdy
element wzorca Prometheus (nazwa metryki, nazwa etykiety, wartość etykiety i wartość metryki)
może być makrem użytkownika.
7 Obsługuje wiele rekordów "Field name,OID prefix,Format" oddzielonych znakiem nowej linii.
Nadpisy reguł LLD
Obiekt nadpisywania reguł LLD definiuje zestaw reguł (filtry, warunki i operacje), które są używane do nadpisywania właściwości różnych obiektów prototypów. Ma on następujące właściwości:
| Property | Type | Description |
|---|---|---|
| name | string | Unikalna nazwa nadpisania. Property behavior: - required |
| step | integer | Unikalny numer kolejności nadpisania. Property behavior: - required |
| stop | integer | Zatrzymaj przetwarzanie kolejnych nadpisań, jeśli pasuje. Possible values: 0 - (default) nie zatrzymuj przetwarzania nadpisań; 1 - zatrzymaj przetwarzanie nadpisań, jeśli filtr pasuje. |
| filter | object | Filtr nadpisania. |
| operations | object/array | Operacje nadpisania. |
Filtr nadpisywania reguły LLD
Obiekt filtra nadpisywania reguły LLD definiuje zestaw warunków, które po dopasowaniu do wykrytego obiektu powodują zastosowanie nadpisania. Ma on następujące właściwości:
| Property | Type | Description |
|---|---|---|
| conditions | object/array | Zestaw warunków filtra nadpisywania używanych do dopasowywania wykrytych obiektów. Warunki zostaną posortowane zgodnie z kolejnością ich umieszczenia we wzorze. Zachowanie właściwości: - required |
| evaltype | integer | Metoda oceny warunków filtra nadpisywania. Możliwe wartości: 0 - And/Or; 1 - And; 2 - Or; 3 - Wyrażenie niestandardowe. Zachowanie właściwości: - required |
| eval_formula | string | Wygenerowane wyrażenie, które będzie używane do oceny warunków filtra nadpisywania. Wyrażenie zawiera identyfikatory odwołujące się do konkretnych warunków filtra nadpisywania za pomocą ich formulaid. Wartość eval_formula jest równa wartości formula dla filtrów z wyrażeniem niestandardowym.Zachowanie właściwości: - read-only |
| formula | string | Wyrażenie zdefiniowane przez użytkownika, używane do oceny warunków filtrów nadpisywania z wyrażeniem niestandardowym. Wyrażenie musi zawierać identyfikatory odwołujące się do konkretnych warunków filtra nadpisywania za pomocą ich formulaid. Identyfikatory użyte w wyrażeniu muszą dokładnie odpowiadać tym zdefiniowanym w warunkach filtra nadpisywania: żaden warunek nie może pozostać nieużyty ani pominięty.Zachowanie właściwości: - required jeśli evaltype jest ustawione na "custom expression" |
Warunek filtra nadpisania reguły LLD
Obiekt warunku filtra nadpisania reguły LLD definiuje osobny test wykonywany na wartości makra LLD. Ma on następujące właściwości:
| Property | Type | Description |
|---|---|---|
| macro | string | Makro LLD, na którym ma zostać wykonany test. Property behavior: - required |
| value | string | Wartość do porównania. Property behavior: - required if operator is set to "matches regular expression" or "does not match regular expression" |
| formulaid | string | Dowolny unikalny identyfikator używany do odwoływania się do warunku z wyrażenia niestandardowego. Może zawierać wyłącznie wielkie litery. Identyfikator musi zostać zdefiniowany przez użytkownika podczas modyfikowania warunków filtra, ale przy późniejszym pobieraniu zostanie wygenerowany ponownie. Property behavior: - required if evaltype of LLD rule override filter object is set to "custom expression" |
| operator | integer | Operator warunku. Possible values: 8 - (default) matches regular expression; 9 - does not match regular expression; 12 - exists; 13 - does not exist. |
Operacja nadpisania reguły LLD
Operacja nadpisania reguły LLD jest kombinacją warunków i działań wykonywanych na obiekcie prototypu. Ma następujące właściwości:
| Property | Type | Description |
|---|---|---|
| operationobject | integer | Typ wykrytego obiektu, na którym ma zostać wykonana akcja. Possible values: 0 - Item prototype; 1 - Trigger prototype; 2 - Graph prototype; 3 - Host prototype. Property behavior: - required |
| operator | integer | Operator warunku nadpisania operator. Possible values: 0 - (default) equals; 1 - does not equal; 2 - contains; 3 - does not contain; 8 - matches; 9 - does not match. |
| value | string | Wzorzec dopasowania nazwy prototypu pozycji, wyzwalacza, wykresu lub hosta, zależnie od wybranego obiektu. |
| opstatus | object | Obiekt statusu operacji nadpisania dla obiektów typu item, trigger i host prototype. |
| opdiscover | object | Obiekt statusu wykrywania operacji nadpisania (wszystkie typy obiektów). |
| opperiod | object | Obiekt okresu operacji nadpisania (interwału aktualizacji) dla obiektu typu item prototype. |
| ophistory | object | Obiekt historii operacji nadpisania dla obiektu typu item prototype. |
| optrends | object | Obiekt trendów operacji nadpisania dla obiektu typu item prototype. |
| opseverity | object | Obiekt ważności operacji nadpisania dla obiektu typu trigger prototype. |
| optag | object/array | Obiekt tagu operacji nadpisania dla obiektów typu trigger i host prototype. |
| optemplate | object/array | Obiekt szablonu operacji nadpisania dla obiektu typu host prototype. |
| opinventory | object | Obiekt inwentarza operacji nadpisania dla obiektu typu host prototype. |
Status operacji nadpisania reguły LLD
Status operacji nadpisania reguły LLD ustawiony dla wykrytego obiektu. Ma następujące właściwości:
| Property | Type | Description |
|---|---|---|
| status | integer | Zastąp status dla wybranego obiektu. Możliwe wartości: 0 - Utwórz włączone; 1 - Utwórz wyłączone. Zachowanie właściwości: - required |
Operacja nadpisania reguły LLD: discover
Status operacji nadpisania reguły LLD discover, który jest ustawiony dla wykrytego obiektu. Ma następujące właściwości:
| Property | Type | Description |
|---|---|---|
| discover | integer | Nadpisz status discover dla wybranego obiektu. Możliwe wartości: 0 - Tak, kontynuuj wykrywanie obiektów; 1 - Nie, nowe obiekty nie będą wykrywane, a istniejące zostaną oznaczone jako utracone. Zachowanie właściwości: - required |
Okres operacji nadpisania reguły LLD
Okres operacji nadpisania reguły LLD to wartość interwału aktualizacji ustawiana dla wykrytej pozycji. Ma następujące właściwości:
| Property | Type | Description |
|---|---|---|
| delay | string | Nadpisuje interwał aktualizacji prototypu pozycji. Akceptuje sekundy lub jednostkę czasu z sufiksem (np. 30s, 1m, 2h, 1d) oraz opcjonalnie jeden lub więcej interwałów niestandardowych, wszystkie oddzielone średnikami. Interwały niestandardowe mogą być kombinacją interwałów elastycznych i harmonogramowych. Akceptuje makra użytkownika lub makra LLD (obsługa makr LLD przywrócona w Zabbix 7.0.27). Jeśli są używane, wartość musi być pojedynczym makrem. Nie są obsługiwane wiele makr ani makra połączone z tekstem. Interwały elastyczne można zapisać jako dwa makra oddzielone ukośnikiem (np. {$FLEX_INTERVAL}/{$FLEX_PERIOD}).Przykład: 1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}Zachowanie właściwości: - wymagane |
Historia operacji nadpisania reguły LLD
Wartość historii operacji nadpisania reguły LLD ustawiana dla wykrytej pozycji. Ma następujące właściwości:
| Property | Type | Description |
|---|---|---|
| history | string | Nadpisuje historię prototypu pozycji, czyli jednostkę czasu określającą, jak długo dane historyczne mają być przechowywane. Akceptuje również makro użytkownika i makro LLD (obsługa makr LLD została przywrócona w Zabbix 7.0.27). Property behavior: - required |
Trendy operacji nadpisania reguły LLD
Wartość trendów operacji nadpisania reguły LLD ustawiana dla wykrytej pozycji. Ma następujące właściwości:
| Właściwość | Typ | Opis |
|---|---|---|
| trends | string | Nadpisuje trendy prototypu pozycji, czyli jednostkę czasu określającą, jak długo dane trendów powinny być przechowywane. Akceptuje również makro użytkownika i makro LLD (obsługa makr LLD została przywrócona w Zabbix 7.0.27). Zachowanie właściwości: - wymagane |
Nadpisanie poziomu ważności operacji reguły LLD
Wartość poziomu ważności operacji nadpisania reguły LLD, która jest ustawiana dla wykrytego wyzwalacza. Ma ona następujące właściwości:
| Property | Type | Description |
|---|---|---|
| severity | integer | Nadpisuje poziom ważności prototypu wyzwalacza. Możliwe wartości: 0 - (domyślnie) nie sklasyfikowano; 1 - informacja; 2 - ostrzeżenie; 3 - średni; 4 - wysoki; 5 - katastrofa. Property behavior: - required |
Znacznik operacji nadpisania reguły LLD
Obiekt znacznika operacji nadpisania reguły LLD zawiera nazwę znacznika i wartość, które są ustawiane dla wykrytego obiektu. Ma następujące właściwości:
| Property | Type | Description |
|---|---|---|
| tag | string | Nowa nazwa znacznika. Akceptuje również makro użytkownika i makro LLD. Zachowanie właściwości: - required |
| value | string | Nowa wartość znacznika. Akceptuje również makro użytkownika i makro LLD. |
Szablon operacji nadpisania reguły LLD
Obiekt szablonu operacji nadpisania reguły LLD, który jest powiązany z wykrytym hostem. Ma następujące właściwości:
| Property | Type | Description |
|---|---|---|
| templateid | ID | Nadpisuje szablon prototypu hosta powiązanych szablonów. Zachowanie właściwości: - required |
Inwentarz operacji nadpisania reguły LLD
Wartość trybu inwentarza operacji nadpisania reguły LLD, która jest ustawiana dla wykrytego hosta. Ma ona następujące właściwości:
| Właściwość | Typ | Opis |
|---|---|---|
| inventory_mode | integer | Nadpisuje tryb inwentarza prototypu hosta. Możliwe wartości: -1 - wyłączone; 0 - (domyślnie) ręczny; 1 - automatyczny. Zachowanie właściwości: - wymagane |