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 niskopoziomowego ma następujące właściwości.

Property Type Description
itemid ID Identyfikator reguły LLD.

Zachowanie właściwości:
- tylko do odczytu
- wymagana w operacjach aktualizacji
delay string Interwał aktualizacji reguły LLD.

Akceptuje liczbę sekund (np. 1, 60, 300), wartość z przyrostkiem czasu (np. 30s, 1m, 2h, 1d) lub, opcjonalnie, jeden lub więcej niestandardowych interwałów, rozdzielonych średnikami. Niestandardowe interwały mogą być kombinacją interwałów elastycznych i harmonogramowych.

Akceptuje makra użytkownika. Jeśli jest używane, wartość musi być pojedynczym makrem. Wiele makr lub makra połączone z tekstem nie są obsługiwane. Interwały elastyczne można zapisać jako dwa makra rozdzielone 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:
- wymagana, 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), „Telemetry query” (24) lub jeśli type ma wartość „Zabbix agent (active)” (7), a key_ nie zawiera „mqtt.get”
hostid ID Identyfikator hosta, do którego należy reguła LLD.

Zachowanie właściwości:
- stała
- wymagana w operacjach tworzenia
flags integer Pochodzenie reguły wykrywania.

Możliwe wartości:
1 - reguła wykrywania niskopoziomowego;
5 - reguła wykrywania niskopoziomowego przekonwertowana z prototypu.

Zachowanie właściwości:
- tylko do odczytu
interfaceid ID Identyfikator interfejsu hosta reguły LLD.

Zachowanie właściwości:
- wymagana, jeśli reguła LLD należy do hosta, a type ma wartość „Zabbix agent”, „IPMI agent”, „JMX agent” lub „SNMP agent”
- obsługiwana, jeśli reguła LLD należy do hosta, a type ma wartość „Simple check”, „External check”, „SSH agent”, „TELNET agent” lub „HTTP agent”
key_ string Klucz reguły LLD.

Zachowanie właściwości:
- wymagana w operacjach tworzenia
- tylko do odczytu dla obiektów dziedziczonych
name string Nazwa reguły LLD.

Zachowanie właściwości:
- wymagana w operacjach 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;
23 - Nested. Ten typ jest dozwolony tylko wtedy, gdy element nadrzędny reguły jest szablonem (zakłada się, że podczas wykrywania jest połączony z prototypem hosta) lub wykrytym hostem (który ma regułę LLD w katalogu głównym);
24 - Telemetry query.

Zachowanie właściwości:
- wymagana w operacjach tworzenia
- tylko do odczytu dla obiektów dziedziczonych
url string Ciąg URL.
Obsługuje makra użytkownika, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {ITEM.ID}, {ITEM.KEY}.

Zachowanie właściwości:
- wymagana, jeśli type ma wartość „HTTP agent”
- tylko do odczytu dla obiektów dziedziczonych
allow_traps integer Zezwala na wypełnianie wartości w sposób podobny do pozycji trappera.

Możliwe wartości:
0 - (domyślnie) nie akceptuj danych przychodzących;
1 - akceptuj dane przychodzące.

Zachowanie właściwości:
- obsługiwana, 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.

Zachowanie właściwości:
- obsługiwana, 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.

Zachowanie właściwości:
- tylko do odczytu
follow_redirects integer Podążanie za przekierowaniami odpowiedzi podczas odpytywania danych.

Możliwe wartości:
0 - nie podążaj za przekierowaniami;
1 - (domyślnie) podążaj za przekierowaniami.

Zachowanie właściwości:
- obsługiwana, 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.

Zachowanie właściwości:
- obsługiwana, jeśli type ma wartość „HTTP agent”
- tylko do odczytu dla obiektów dziedziczonych
http_proxy string Ciąg połączenia z proxy HTTP(S).

Zachowanie właściwości:
- obsługiwana, jeśli type ma wartość „HTTP agent”
- tylko do odczytu dla obiektów dziedziczonych
ipmi_sensor string Czujnik IPMI.

Zachowanie właściwości:
- wymagana, jeśli type ma wartość „IPMI agent”, a key_ nie ma wartości „ipmi.get”
- obsługiwana, jeśli type ma wartość „IPMI agent”
- tylko do odczytu dla obiektów dziedziczonych
jmx_endpoint string Niestandardowy ciąg połączenia agenta JMX.

Wartość domyślna: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi

Zachowanie właściwości:
- obsługiwana, jeśli type ma wartość „JMX agent”
lifetime string Okres, po którym pozycje, które nie są już wykrywane, zostaną usunięte. Akceptuje liczbę sekund (np. 3600), wartość z przyrostkiem czasu (np. 3600s, 180m, 24h, 1d) lub makro użytkownika.

Wartość domyślna: 7d.
lifetime_type integer Scenariusz usuwania utraconych zasobów LLD.

Możliwe wartości:
0 - (domyślnie) usuń po osiągnięciu progu okresu przechowywania;
1 - nie usuwaj;
2 - usuń natychmiast.
enabled_lifetime string Okres, po którym pozycje, które nie są już wykrywane, zostaną wyłączone. Akceptuje liczbę sekund (np. 1, 60, 300), wartość z przyrostkiem czasu (np. 30s, 1m, 2h, 1d) lub makro użytkownika.

Wartość domyślna: 0.
enabled_lifetime_type integer Scenariusz wyłączania utraconych zasobów LLD.

Możliwe wartości:
0 - wyłącz po osiągnięciu progu okresu przechowywania;
1 - nie wyłączaj;
2 - (domyślnie) wyłącz natychmiast.
master_itemid ID Identyfikator nadrzędnej pozycji.
Reguła wykrywania nie może być nadrzędną pozycją dla innej reguły wykrywania.

Zachowanie właściwości:
- wymagana, jeśli type ma wartość „Dependent item”
- tylko do odczytu dla obiektów dziedziczonych
output_format integer Czy odpowiedź powinna zostać przekonwertowana do formatu JSON.

Możliwe wartości:
0 - (domyślnie) przechowuj dane surowe;
1 - konwertuj do formatu JSON.

Zachowanie właściwości:
- obsługiwana, jeśli type ma wartość „HTTP agent”
- tylko do odczytu dla obiektów dziedziczonych
params string Dodatkowe parametry zależne od typu reguły LLD:
- wykonywany skrypt dla reguł LLD SSH i Telnet;
- zapytanie SQL dla reguł LLD monitora bazy danych;
- formuła dla obliczanych reguł LLD;
- skrypt dla reguł LLD skryptu i przeglądarki.

Zachowanie właściwości:
- wymagana, 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ć unikatowe.

Zachowanie właściwości:
- obsługiwana, jeśli type ma wartość „Script” lub „Browser”
- tylko do odczytu dla obiektów dziedziczonych
password string Hasło do uwierzytelniania.

Zachowanie właściwości:
- wymagana, jeśli type ma wartość „JMX agent”, a username jest ustawione
- obsługiwana, 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 przechowywanej we właściwości posts.

Możliwe wartości:
0 - (domyślnie) dane surowe;
2 - dane JSON;
3 - dane XML.

Zachowanie właściwości:
- obsługiwana, jeśli type ma wartość „HTTP agent”
- tylko do odczytu dla obiektów dziedziczonych
posts string Dane treści żądania HTTP(S).

Zachowanie właściwości:
- wymagana, jeśli type ma wartość „HTTP agent”, a post_type ma wartość „JSON data” lub „XML data”
- obsługiwana, jeśli type ma wartość „HTTP agent”, a post_type ma wartość „Raw data”
- tylko do odczytu dla obiektów dziedziczonych
privatekey string Nazwa pliku klucza prywatnego.

Zachowanie właściwości:
- wymagana, jeśli type ma wartość „SSH agent”, a authtype ma wartość „public key”
publickey string Nazwa pliku klucza publicznego.

Zachowanie właściwości:
- wymagana, jeśli type ma wartość „SSH agent”, a authtype ma wartość „public key”
query_fields array Tablica pól zapytania, które zostaną wysłane podczas wykonywania żądania HTTP.

Zachowanie właściwości:
- obsługiwana, 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.

Zachowanie właściwości:
- obsługiwana, jeśli type ma wartość „HTTP agent”
- tylko do odczytu dla obiektów dziedziczonych
retrieve_mode integer Część odpowiedzi, która powinna 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.

Zachowanie właściwości:
- obsługiwana, jeśli type ma wartość „HTTP agent”
- tylko do odczytu dla obiektów dziedziczonych
snmp_oid string OID SNMP.

Zachowanie właściwości:
- wymagana, jeśli type ma wartość „SNMP agent”
- tylko do odczytu dla obiektów dziedziczonych
ssl_cert_file string Ścieżka do pliku publicznego klucza SSL.

Zachowanie właściwości:
- obsługiwana, jeśli type ma wartość „HTTP agent”
- tylko do odczytu dla obiektów dziedziczonych
ssl_key_file string Ścieżka do pliku prywatnego klucza SSL.

Zachowanie właściwości:
- obsługiwana, jeśli type ma wartość „HTTP agent”
- tylko do odczytu dla obiektów dziedziczonych
ssl_key_password string Hasło do pliku klucza SSL.

Zachowanie właściwości:
- obsługiwana, 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ługiwana.

Zachowanie właściwości:
- tylko do odczytu
status integer Stan 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 stanu HTTP, rozdzielone przecinkami. Obsługuje również makra użytkownika jako część listy rozdzielonej przecinkami.

Przykład: 200,200-{$M},{$M},200-400

Zachowanie właściwości:
- obsługiwana, jeśli type ma wartość „HTTP agent”
- tylko do odczytu dla obiektów dziedziczonych
templateid ID Identyfikator nadrzędnej reguły LLD szablonu.

Zachowanie właściwości:
- tylko do odczytu
timeout string Limit czasu żądania odpytywania danych pozycji.
Akceptuje liczbę sekund (np. 1, 60, 300) lub wartość z przyrostkiem czasu (np. 30s, 1m). Akceptuje również makra użytkownika.

Zakres możliwych wartości: 1-600s.

Wartość domyślna: "" - użyj ustawień proxy/globalnych.

Zachowanie właściwości:
- obsługiwana, jeśli type ma wartość „Zabbix agent” (0), „Simple check” (3), a 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), a snmp_oid zaczyna się od „walk[” lub „get[”, „Script” (21), „Browser” (22), „Telemetry query” (24)
- tylko do odczytu dla obiektów dziedziczonych,
- jeśli zastosowano wartość domyślną, a pozycja należy do hosta monitorowanego przez niedostępny proxy lub grupę proxy, używany jest globalny limit czasu.
trapper_hosts string Dozwolone hosty.

Zachowanie właściwości:
- obsługiwana, jeśli type ma wartość „Zabbix trapper” lub jeśli type ma wartość „HTTP agent”, a allow_traps ma wartość „Allow incoming data”.
Jeśli właściwość zostanie pominięta, zostanie automatycznie ustawiona na {$TRAPPER.ALLOWED_HOSTS} — makro użytkownika (wartość domyślna). Domyślnie {$TRAPPER.ALLOWED_HOSTS} ma wartość 127.0.0.1,::1.
Jeśli właściwość zostanie ustawiona na pusty ciąg, połączenia przychodzące będą odrzucane ze wszystkich hostów.
username string Nazwa użytkownika do uwierzytelniania.

Zachowanie właściwości:
- wymagana, jeśli type ma wartość „SSH agent”, „TELNET agent” lub jeśli type ma wartość „JMX agent”, a password jest ustawione
- obsługiwana, 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 unikatowy identyfikator używany do łączenia zaimportowanych reguł LLD z już istniejącymi regułami. Generowany automatycznie, jeśli nie zostanie podany.

Zachowanie właściwości:
- obsługiwana, jeśli reguła LLD należy do szablonu
verify_host integer Czy należy sprawdzić, czy nazwa hosta używana dla połączenia jest zgodna z nazwą w certyfikacie hosta.

Możliwe wartości:
0 - (domyślnie) nie sprawdzaj;
1 - sprawdzaj.

Zachowanie właściwości:
- obsługiwana, jeśli type ma wartość „HTTP agent”
- tylko do odczytu dla obiektów dziedziczonych
verify_peer integer Czy należy sprawdzić autentyczność certyfikatu hosta.

Możliwe wartości:
0 - (domyślnie) nie sprawdzaj;
1 - sprawdzaj.

Zachowanie właściwości:
- obsługiwana, jeśli type ma wartość „HTTP agent”
- tylko do odczytu dla obiektów dziedziczonych
query object Konfiguracja zapytania telemetrycznego. Określa, jakie dane reguła LLD pobiera ze źródła danych telemetrycznych, jak je filtruje i jak agreguje wynik.

Zachowanie właściwości:
- wymagana, jeśli type ma wartość „Telemetry query”
- tylko do odczytu dla obiektów dziedziczonych
time_shift string Minimalny czas między końcem zakresu czasu zapytania a bieżącym czasem.

Akceptuje liczbę sekund (np. 1, 60, 300) lub wartość z przyrostkiem czasu (np. 30s, 1m, 2h, 1d). Akceptuje również makra użytkownika.

Zakres możliwych wartości: 0-86400s.

Wartość domyślna: 15s.

Zachowanie właściwości:
- obsługiwana, jeśli type ma wartość „Telemetry query”
lookback_limit string Jak daleko wstecz — przed końcem zakresu czasu zapytania — rozpoczyna się zakres czasu zapytania, jeśli:
- nie ma poprzedniego zapytania, od którego można kontynuować (np. podczas pierwszego uruchomienia reguły LLD);
- kontynuowanie poprzedniego zapytania spowodowałoby, że zakres czasu zapytania byłby dłuższy niż lookback_limit (np. z powodu niedostępności serwera Zabbix).

Akceptuje liczbę sekund (np. 1, 60, 300) lub wartość z przyrostkiem czasu (np. 30s, 1m, 2h, 1d). Akceptuje również makra użytkownika.

Zakres możliwych wartości: 1-259200s.

Wartość domyślna: 10m.

Zachowanie właściwości:
- obsługiwana, jeśli type ma wartość „Telemetry query”
granularity string Długość przedziału, na który dzielony jest zakres czasu zapytania.

Akceptuje liczbę sekund (np. 1, 60, 300) lub wartość z przyrostkiem czasu (np. 30s, 1m, 2h, 1d). Akceptuje również makra użytkownika.

Wartość nie może być większa niż lookback_limit.

Zakres możliwych wartości: 1-86400s.

Wartość domyślna: 15s.

Zachowanie właściwości:
- obsługiwana, jeśli type ma wartość „Telemetry query”

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

Zapytanie telemetryczne

Obiekt zapytania telemetrycznego ma następujące właściwości.

Właściwość Typ Opis
signal_type integer Typ sygnału, którego dotyczy zapytanie reguły LLD.

Możliwe wartości:
0 - Ślady;
1 - Metryki;
2 - Logi.

Zachowanie właściwości:
- wymagana
metric_point_type integer Typ punktu metryki, którego dotyczy zapytanie reguły LLD.

Możliwe wartości:
0 - Suma;
1 - Wskaźnik;
2 - Histogram;
3 - Histogram wykładniczy.

Zachowanie właściwości:
- wymagana, jeśli signal_type ma wartość „Metrics”
columns array Tablica kolumn danych telemetrycznych, których dotyczy zapytanie reguły LLD. Może być pusta.

Zachowanie właściwości:
- wymagana
aggregated_columns array Tablica zagregowanych kolumn danych telemetrycznych, których dotyczy zapytanie reguły LLD, oraz sposób obliczania wartości na podstawie rekordów kolumn.

Zachowanie właściwości:
- wymagana
filter object Filtr zapytania telemetrycznego dla rekordów kolumn w zapytaniu.

Zachowanie właściwości:
- wymagana
Kolumny danych telemetrycznych

Obiekt kolumn danych telemetrycznych ma następujące właściwości.

Property Type Description
column string Nazwa kolumny danych telemetrycznych, którą odpytuje reguła LLD.
Zapoznaj się z obsługiwanymi kolumnami danych telemetrycznych.

W przypadku wielu kolumn zawierających pojedyncze wartości każda wartość column musi być unikatowa. W przypadku wielu kolumn zawierających pary klucz-wartość każda para column i attribute_key musi być unikatowa.
attribute_key string Nazwa klucza, którego szuka reguła LLD w kolumnie zawierającej pary klucz-wartość.

W przypadku wielu kolumn zawierających pary klucz-wartość każda para column i attribute_key musi być unikatowa.

Zachowanie właściwości:
- required, jeśli column jest ustawiona na kolumnę zawierającą pary klucz-wartość
Kolumny zagregowanych danych telemetrycznych

Obiekt kolumn zagregowanych danych telemetrycznych ma następujące właściwości.

Właściwość Typ Opis
column string Nazwa kolumny danych telemetrycznych, którą odpytuje reguła LLD.
Patrz obsługiwane kolumny danych telemetrycznych.

W przypadku wielu kolumn każda wartość column musi być unikatowa.

Ta właściwość nie jest obsługiwana, jeśli function ma wartość „Count”.

Zachowanie właściwości:
- wymagana, jeśli function ma wartość „Min”, „Max”, „Average”, „Sum” lub „Percentile”
function integer Funkcja stosowana przez regułę LLD do rekordów kolumny.

Możliwe wartości:
1 - Min;
2 - Max;
3 - Average;
4 - Count;
5 - Sum;
8 - Percentile.

Zachowanie właściwości:
- wymagana
parameters array Percentyl obliczany przez regułę LLD na podstawie rekordów kolumny.

Możliwa wartość: liczba od 0 do 100 podana jako ciąg znaków.

Zachowanie właściwości:
- wymagana, jeśli function ma wartość „Percentile”
alias string Unikatowa nazwa obliczonej wartości, używana do identyfikowania jej w wartości reguły LLD.

Każda wartość alias musi być unikatowa i nie może mieć wartości clock.

Zachowanie właściwości:
- wymagana
Filtr danych telemetrycznych

Obiekt filtru danych telemetrycznych ma następujące właściwości.

Property Type Description
conditions array Warunki filtru danych telemetrycznych, które musi spełniać rekord w kolumnie danych telemetrycznych.

Zachowanie właściwości:
- required
evaltype integer Metoda oceny warunków filtru.

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 używane do oceny warunków filtru. Wyrażenie zawiera identyfikatory odwołujące się do określonych warunków filtru za pomocą ich formulaid. Wartość eval_formula jest równa wartości formula w przypadku 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 określonych warunków filtru za pomocą ich formulaid. Identyfikatory użyte w wyrażeniu muszą dokładnie odpowiadać identyfikatorom zdefiniowanym w warunkach filtru: żaden warunek nie może pozostać nieużyty ani zostać pominięty.

Zachowanie właściwości:
- required jeśli evaltype ma wartość „Wyrażenie niestandardowe”
Warunki filtrowania danych telemetrycznych

Obiekt warunków filtrowania danych telemetrycznych ma następujące właściwości.

Property Type Description
column string Nazwa kolumny danych telemetrycznych, do której odnosi się warunek filtrowania.
Patrz obsługiwane kolumny danych telemetrycznych.

Zachowanie właściwości:
- wymagane
attribute_key string Nazwa klucza, do którego odnosi się warunek, w kolumnie zawierającej pary klucz-wartość.

Zachowanie właściwości:
- wymagane, jeśli column jest ustawione na kolumnę zawierającą pary klucz-wartość
operator integer Operator warunku filtrowania.

Możliwe wartości dla kolumn zawierających pojedynczą wartość:
0 - Jest równe;
1 - Nie jest równe;
2 - Zawiera;
3 - Nie zawiera.

Możliwe wartości dla kolumn zawierających pary klucz-wartość:
0 - Jest równe;
1 - Nie jest równe;
12 - Istnieje.

Zachowanie właściwości:
- wymagane
value string Wartość, z którą należy porównać.

Zachowanie właściwości:
- wymagane, jeśli operator jest ustawione na „Jest równe”, „Nie jest równe”, „Zawiera” lub „Nie zawiera”
formulaid string Dowolny unikatowy 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 filtrowania, ale przy kolejnym żądaniu zostanie wygenerowany ponownie.

Zachowanie właściwości:
- wymagane, jeśli evaltype obiektu filtra zapytania telemetrycznego jest ustawione na „Wyrażenie niestandardowe”

Filtr reguły LLD

Obiekt filtra reguły LLD definiuje zestaw warunków, które mogą być używane do filtrowania wykrytych obiektów. Ma następujące właściwości:

Właściwość Typ Opis
conditions object/array Zestaw warunków filtra używanych do filtrowania wyników. Warunki zostaną posortowane zgodnie z kolejnością ich występowania w formule.

Zachowanie właściwości:
- wymagane
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:
- wymagane
eval_formula string Wygenerowane wyrażenie, które będzie używane do oceny warunków filtra. Wyrażenie zawiera identyfikatory odnoszące się do określonych warunków filtra przez ich formulaid. Wartość eval_formula jest równa wartości formula dla filtrów z wyrażeniem niestandardowym.

Zachowanie właściwości:
- tylko do odczytu
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 odnoszące się do określonych warunków filtra przez 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:
- wymagane, jeśli evaltype jest ustawione na „custom expression”

Warunek filtra reguły LLD

Obiekt warunku filtra reguły LLD definiuje oddzielne sprawdzenie wykonywane na wartości makra LLD. Ma następujące właściwości:

Właściwość Type Opis
macro string Makro LLD, na którym ma zostać wykonane sprawdzenie.

Property behavior:
- required
value string Wartość do porównania.

Property behavior:
- required 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 niestandardowego wyrażenia. Może zawierać wyłącznie wielkie litery. Identyfikator musi zostać zdefiniowany przez użytkownika podczas modyfikowania warunków filtra, ale zostanie wygenerowany ponownie przy późniejszym ich pobieraniu.

Property behavior:
- required jeśli evaltype obiektu LLD rule filter object jest ustawiony na „custom expression”
operator integer Operator warunku.

Możliwe wartości:
8 - (domyślnie) pasuje do wyrażenia regularnego;
9 - nie pasuje do wyrażenia regularnego;
12 - istnieje;
13 - nie istnieje.

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

Wstępne przetwarzanie reguły LLD

Obiekt wstępnego przetwarzania reguły LLD ma następujące właściwości.

Property Type Description
type integer Typ opcji wstępnego przetwarzania.

Możliwe wartości:
5 - Wyrażenie regularne;
11 - XML XPath;
12 - JSONPath;
14 - Pasuje do wyrażenia regularnego;
15 - Nie pasuje do wyrażenia regularnego;
16 - Sprawdzenie błędu w JSON;
17 - Sprawdzenie błędu w XML;
20 - Odrzucenie niezmienionych wartości z sygnałem heartbeat;
21 - JavaScript;
23 - Prometheus do JSON;
24 - CSV do JSON;
25 - Zastąpienie;
27 - XML do JSON;
28 - Wartość SNMP walk;
29 - SNMP walk do JSON;
30 - Pobranie wartości SNMP.

Property behavior:
- required
params string Dodatkowe parametry używane przez opcję wstępnego przetwarzania. Wiele parametrów jest rozdzielanych znakiem nowego wiersza (\n).

Property behavior:
- required jeśli type ma wartość „Wyrażenie regularne” (5), „XML XPath” (11), „JSONPath” (12), „Pasuje do wyrażenia regularnego” (14), „Nie pasuje do wyrażenia regularnego” (15), „Sprawdzenie błędu w JSON” (16), „Sprawdzenie błędu w XML” (17), „Odrzucenie niezmienionych wartości z sygnałem heartbeat” (20), „JavaScript” (21), „Prometheus do JSON” (23), „CSV do JSON” (24), „Zastąpienie” (25), „Wartość SNMP walk” (28), „SNMP walk do JSON” (29) lub „Pobranie wartości SNMP” (30)
error_handler integer Typ działania używanego w przypadku niepowodzenia kroku wstępnego przetwarzania.

Możliwe wartości:
0 - Komunikat o błędzie jest ustawiany przez serwer Zabbix;
1 - Odrzucenie wartości;
2 - Ustawienie wartości niestandardowej;
3 - Ustawienie niestandardowego komunikatu o błędzie.

Property behavior:
- required jeśli type ma wartość „Wyrażenie regularne” (5), „XML XPath” (11), „JSONPath” (12), „Pasuje do wyrażenia regularnego” (14), „Nie pasuje do wyrażenia regularnego” (15), „Sprawdzenie błędu w JSON” (16), „Sprawdzenie błędu 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 „Pobranie wartości SNMP” (30)
error_handler_params string Parametry obsługi błędów.

Property behavior:
- required jeśli error_handler ma wartość „Ustawienie wartości niestandardowej” lub „Ustawienie niestandardowego komunikatu o błędzie”

Dla każdego typu wstępnego przetwarzania obsługiwane są następujące parametry i procedury obsługi błędów.

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 Pasuje do wyrażenia regularnego pattern1 0, 1, 2, 3
15 Nie pasuje do wyrażenia regularnego pattern1 0, 1, 2, 3
16 Sprawdzenie błędu w JSON path3 0, 1, 2, 3
17 Sprawdzenie błędu w XML path3 0, 1, 2, 3
20 Odrzucenie niezmienionych wartości z sygnałem 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 Zastąpienie 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 - Liczba całkowita 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 - Liczba całkowita z BITS		 0, 1, 2, 3
30 Pobranie wartości SNMP Format:
1 - UTF-8 z Hex-STRING
2 - MAC z Hex-STRING
3 - Liczba całkowita 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 składnik wzorca Prometheus (metryka, nazwa etykiety, wartość etykiety i wartość metryki) może być makrem użytkownika.
7 Obsługuje wiele rekordów „Field name,OID prefix,Format” rozdzielonych znakiem nowego wiersza.

Nadpisania reguł LLD

Obiekt nadpisań reguł LLD definiuje zestaw reguł (filtrów, warunków i operacji), które są używane do nadpisywania właściwości różnych obiektów prototypów. Ma następujące właściwości:

Właściwość Type Opis
name string Unikalna nazwa nadpisania.

Zachowanie właściwości:
- wymagane
step integer Unikalny numer kolejności nadpisania.

Zachowanie właściwości:
- wymagane
stop integer Zatrzymaj przetwarzanie kolejnych nadpisań, jeśli wystąpi dopasowanie.

Możliwe wartości:
0 - (domyślnie) nie zatrzymuj przetwarzania nadpisań;
1 - zatrzymaj przetwarzanie nadpisań, jeśli filtr pasuje.
filter object Filtr nadpisania.
operations object/array Operacje nadpisania.

Filtr nadpisania reguły LLD

Obiekt filtra nadpisania reguły LLD definiuje zestaw warunków, które po dopasowaniu do wykrytego obiektu powodują zastosowanie nadpisania. Ma następujące właściwości:

Właściwość Typ Opis
conditions object/array Zestaw warunków filtra nadpisania używanych do dopasowywania wykrytych obiektów. Warunki zostaną posortowane zgodnie z kolejnością ich umieszczenia w formule.

Zachowanie właściwości:
- wymagane
evaltype integer Metoda oceny warunków filtra nadpisania.

Możliwe wartości:
0 - And/Or;
1 - And;
2 - Or;
3 - Wyrażenie niestandardowe.

Zachowanie właściwości:
- wymagane
eval_formula string Wygenerowane wyrażenie, które będzie używane do oceny warunków filtra nadpisania. Wyrażenie zawiera identyfikatory odwołujące się do określonych warunków filtra nadpisania 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:
- tylko do odczytu
formula string Wyrażenie zdefiniowane przez użytkownika, używane do oceny warunków filtrów nadpisania z wyrażeniem niestandardowym. Wyrażenie musi zawierać identyfikatory odwołujące się do określonych warunków filtra nadpisania za pomocą ich formulaid. Identyfikatory użyte w wyrażeniu muszą dokładnie odpowiadać tym zdefiniowanym w warunkach filtra nadpisania: żaden warunek nie może pozostać nieużyty ani pominięty.

Zachowanie właściwości:
- wymagane, jeśli evaltype jest ustawione na „wyrażenie niestandardowe”
Warunek filtra nadpisania reguły LLD

Obiekt warunku filtra nadpisania reguły LLD definiuje oddzielne sprawdzenie wykonywane na wartości makra LLD. Ma następujące właściwości:

Właściwość Type Opis
macro string Makro LLD, dla którego 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 „pasuje do wyrażenia regularnego” lub „nie pasuje do wyrażenia regularnego”
formulaid string Dowolny unikalny identyfikator używany do odwoływania się do warunku z niestandardowego wyrażenia. Może zawierać wyłącznie wielkie litery. Identyfikator musi zostać zdefiniowany przez użytkownika podczas modyfikowania warunków filtra, ale zostanie wygenerowany ponownie przy późniejszym żądaniu tych warunków.

Zachowanie właściwości:
- wymagane, jeśli evaltype obiektu filtra nadpisania reguły LLD jest ustawiony na „wyrażenie niestandardowe”
operator integer Operator warunku.

Możliwe wartości:
8 - (domyślnie) pasuje do wyrażenia regularnego;
9 - nie pasuje do wyrażenia regularnego;
12 - istnieje;
13 - nie istnieje.

Operacja nadpisania reguły LLD

Operacja nadpisania reguły LLD to połączenie warunków i działań wykonywanych na obiekcie prototypu. Ma następujące właściwości:

Właściwość Type Opis
operationobject integer Typ wykrytego obiektu, dla którego ma zostać wykonane działanie.

Możliwe wartości:
0 - Prototyp pozycji;
1 - Prototyp wyzwalacza;
2 - Prototyp wykresu;
3 - Prototyp hosta;
4 - Prototyp wykrywania.

Zachowanie właściwości:
- wymagane
operator integer Operator warunku nadpisania.

Możliwe wartości:
0 - (domyślnie) równa się;
1 - nie równa się;
2 - zawiera;
3 - nie zawiera;
8 - pasuje;
9 - nie pasuje.
value string Wzorzec do dopasowania do nazwy prototypu pozycji, wyzwalacza, wykresu lub hosta, zależnie od wybranego obiektu.
opstatus object Obiekt statusu operacji nadpisania dla obiektów prototypu pozycji, wyzwalacza i hosta.
opdiscover object Obiekt statusu wykrywania operacji nadpisania (wszystkie typy obiektów).
opperiod object Obiekt okresu operacji nadpisania (interwału aktualizacji) dla obiektu prototypu pozycji.
ophistory object Obiekt historii operacji nadpisania dla obiektu prototypu pozycji.
optrends object Obiekt trendów operacji nadpisania dla obiektu prototypu pozycji.
opseverity object Obiekt ważności operacji nadpisania dla obiektu prototypu wyzwalacza.
optag object/array Obiekt tagu operacji nadpisania dla obiektów prototypu wyzwalacza i hosta.
optemplate object/array Obiekt szablonu operacji nadpisania dla obiektu prototypu hosta.
opinventory object Obiekt inwentaryzacji operacji nadpisania dla obiektu prototypu hosta.
Status operacji nadpisania reguły LLD

Status operacji nadpisania reguły LLD ustawiany dla wykrytego obiektu. Ma następujące właściwości:

Właściwość Typ Opis
status integer Nadpisuje status wybranego obiektu.

Możliwe wartości:
0 - Utwórz włączony;
1 - Utwórz wyłączony.

Zachowanie właściwości:
- wymagane
Operacja nadpisania reguły LLD: discover

Status discover operacji nadpisania reguły LLD, który jest ustawiany dla wykrytego obiektu. Ma następujące właściwości:

Właściwość Typ Opis
discover integer Nadpisuje 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:
- wymagane
Okres operacji nadpisania reguły LLD

Okres operacji nadpisania reguły LLD to wartość interwału aktualizacji ustawiana dla wykrytej pozycji. Ma on następujące właściwości:

Property Type Description
delay string Nadpisuje interwał aktualizacji prototypu pozycji.

Akceptuje liczbę sekund (np. 1, 60, 300), wartość z przyrostkiem czasu (np. 30s, 1m, 2h, 1d) lub, opcjonalnie, jeden lub więcej niestandardowych interwałów, rozdzielonych średnikami. Niestandardowe interwały mogą być kombinacją interwałów elastycznych i harmonogramowych.

Akceptuje makra użytkownika lub makra LLD. Jeśli są używane, wartość musi być pojedynczym makrem. Wiele makr ani makra połączone z tekstem nie są obsługiwane. Interwały elastyczne można zapisać jako dwa makra rozdzielone 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:
- required
Historia operacji nadpisania reguły LLD

Wartość historii operacji nadpisania reguły LLD, która jest ustawiana dla wykrytej pozycji. Ma następujące właściwości:

Właściwość Type Opis
history string Nadpisuje historię prototypu pozycji, czyli jednostkę czasu określającą, jak długo dane historyczne powinny być przechowywane. Akceptuje również makro użytkownika i makro LLD.

Zachowanie właściwości:
- wymagane
Trendy operacji nadpisania reguły LLD

Wartość trendów operacji nadpisania reguły LLD, która jest ustawiana dla wykrytej pozycji. Ma następujące właściwości:

Właściwość Type Opis
trends string Nadpisuje trendy prototypu pozycji, czyli jednostkę czasu określającą, jak długo dane trendów mają być przechowywane. Akceptuje również makro użytkownika i makro LLD.

Zachowanie właściwości:
- required
Ważność operacji nadpisania reguły LLD

Wartość ważności operacji nadpisania reguły LLD, która jest ustawiana dla odkrytego wyzwalacza. Ma następujące właściwości:

Właściwość Typ Opis
severity integer Nadpisuje ważność prototypu wyzwalacza.

Możliwe wartości:
0 - (domyślnie) niesklasyfikowany;
1 - informacja;
2 - ostrzeżenie;
3 - średni;
4 - wysoki;
5 - katastrofa.

Zachowanie właściwości:
- wymagane
Znacznik operacji nadpisania reguły LLD

Obiekt znacznika operacji nadpisania reguły LLD zawiera nazwę znacznika i wartość 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.

Property behavior:
- required
value string Nowa wartość znacznika. Akceptuje również makro użytkownika i makro LLD.
Szablon operacji przesłaniania reguły LLD

Obiekt szablonu operacji przesłaniania reguły LLD, który jest powiązany z wykrytym hostem. Ma następujące właściwości:

Właściwość Type Opis
templateid ID Przesłania szablon powiązanych szablonów prototypu hosta.

Zachowanie właściwości:
- wymagane
Wartość trybu inwentaryzacji operacji nadpisania reguły LLD

Wartość trybu inwentaryzacji operacji nadpisania reguły LLD, która jest ustawiana dla wykrytego hosta. Ma następujące właściwości:

Właściwość Typ Opis
inventory_mode integer Nadpisuje tryb inwentaryzacji prototypu hosta.

Możliwe wartości:
-1 - wyłączony;
0 - (domyślnie) ręczny;
1 - automatyczny.

Zachowanie właściwości:
- wymagane