Obiekt prototypu reguły LLD

Następujące obiekty są bezpośrednio powiązane z API discoveryruleprototype.

Prototyp reguły LLD

Obiekt prototypu reguły wykrywania niskiego poziomu ma następujące właściwości.

Property Type Description
itemid ID ID prototypu reguły LLD.

Zachowanie właściwości:
- tylko do odczytu
- wymagane dla operacji aktualizacji
ruleid ID ID nadrzędnej reguły LLD/prototypu reguły LLD.

Zachowanie właściwości:
- tylko do odczytu
- wymagane dla operacji tworzenia
delay string Interwał aktualizacji prototypu reguły LLD.

Akceptuje sekundy lub jednostkę czasu z sufiksem (np. 30s, 1m, 2h, 1d) oraz opcjonalnie jeden lub więcej niestandardowych interwałów, oddzielonych średnikami. Niestandardowe interwały mogą być kombinacją interwałów elastycznych i harmonogramowanych.

Akceptuje makra użytkownika. Jeśli są używane, wartość musi być pojedynczym makrem. Wiele makr lub makra zmieszane 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}

Zachowanie właściwości:
- wymagane, jeśli type jest ustawione na "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 jest ustawione na "Zabbix agent (active)" (7), a key_ nie zawiera "mqtt.get"
hostid ID ID hosta, do którego należy prototyp reguły LLD.

Zachowanie właściwości:
- stałe
- wymagane dla operacji tworzenia
flags integer Pochodzenie prototypu reguły LLD.

Możliwe wartości:
3 - prototyp reguły wykrywania niskiego poziomu;
7 - wykryty prototyp reguły wykrywania niskiego poziomu.

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

Zachowanie właściwości:
- wymagane, jeśli prototyp reguły LLD należy do hosta, a type jest ustawione na "Zabbix agent", "IPMI agent", "JMX agent" lub "SNMP agent"
- obsługiwane, jeśli prototyp reguły LLD należy do hosta, a type jest ustawione na "Simple check", "External check", "SSH agent", "TELNET agent" lub "HTTP agent"
key_ string Klucz prototypu reguły LLD. Wymagane jest co najmniej jedno makro LLD.

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

Zachowanie właściwości:
- wymagane dla operacji tworzenia
- tylko do odczytu dla obiektów dziedziczonych
type integer Typ prototypu 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.

Zachowanie właściwości:
- wymagane dla operacji 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:
- wymagane, jeśli type jest ustawione na "HTTP agent"
- tylko do odczytu dla obiektów dziedziczonych
allow_traps integer Zezwala na wypełnianie wartości podobnie jak w pozycji trapper.

Możliwe wartości:
0 - (domyślnie) Nie zezwalaj na przyjmowanie danych przychodzących;
1 - Zezwalaj na przyjmowanie danych przychodzących.

Zachowanie właściwości:
- obsługiwane, jeśli type jest ustawione na "HTTP agent"
authtype integer Metoda uwierzytelniania.

Możliwe wartości, jeśli type jest ustawione na "SSH agent":
0 - (domyślnie) hasło;
1 - klucz publiczny.

Możliwe wartości, jeśli type jest ustawione na "HTTP agent":
0 - (domyślnie) brak;
1 - basic;
2 - NTLM.

Zachowanie właściwości:
- obsługiwane, jeśli type jest ustawione na "SSH agent" lub "HTTP agent"
- tylko do odczytu dla obiektów dziedziczonych (jeśli type jest ustawione na "HTTP agent")
description string Opis prototypu reguły LLD.
error string Tekst błędu, jeśli występują problemy z aktualizacją wartości prototypu reguły LLD.

Zachowanie właściwości:
- tylko do odczytu
follow_redirects integer Podążaj 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ługiwane, jeśli type jest ustawione na "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ługiwane, jeśli type jest ustawione na "HTTP agent"
- tylko do odczytu dla obiektów dziedziczonych
http_proxy string Ciąg połączenia proxy HTTP(S).

Zachowanie właściwości:
- obsługiwane, jeśli type jest ustawione na "HTTP agent"
- tylko do odczytu dla obiektów dziedziczonych
ipmi_sensor string Czujnik IPMI.

Zachowanie właściwości:
- wymagane, jeśli type jest ustawione na "IPMI agent", a key_ nie jest ustawione na "ipmi.get"
- obsługiwane, jeśli type jest ustawione na "IPMI agent"
- tylko do odczytu dla obiektów dziedziczonych
jmx_endpoint string Niestandardowy ciąg połączenia JMX agent.

Domyślnie: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi

Zachowanie właściwości:
- obsługiwane, jeśli type jest ustawione na "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 lifetime;
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 lifetime;
1 - Nie wyłączaj;
2 - (domyślnie) Wyłącz natychmiast.
master_itemid ID ID nadrzędnej pozycji.
Reguła wykrywania nie może być nadrzędną pozycją dla innej reguły wykrywania.

Zachowanie właściwości:
- wymagane, jeśli type jest ustawione na "Dependent item"
- tylko do odczytu dla obiektów dziedziczonych
output_format integer Czy odpowiedź powinna zostać przekonwertowana do JSON.

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

Zachowanie właściwości:
- obsługiwane, jeśli type jest ustawione na "HTTP agent"
- tylko do odczytu dla obiektów dziedziczonych
params string Dodatkowe parametry zależne od typu prototypu 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.

Zachowanie właściwości:
- wymagane, jeśli type jest ustawione na "Database monitor", "SSH agent", "TELNET agent", "Script" lub "Browser"
- tylko do odczytu dla obiektów dziedziczonych (jeśli type jest ustawione na "Script" lub "Browser")
parameters object/array Dodatkowe parametry, jeśli type jest ustawione na "Script" lub "Browser".
Tablica obiektów z właściwościami name i value, gdzie name musi być unikalne.

Zachowanie właściwości:
- obsługiwane, jeśli type jest ustawione na "Script" lub "Browser"
- tylko do odczytu dla obiektów dziedziczonych
password string Hasło do uwierzytelniania.

Zachowanie właściwości:
- wymagane, jeśli type jest ustawione na "JMX agent", a username jest ustawione
- obsługiwane, jeśli type jest ustawione na "Simple check", "Database monitor", "SSH agent", "TELNET agent" lub "HTTP agent"
- tylko do odczytu dla obiektów dziedziczonych (jeśli type jest ustawione na "HTTP agent")
post_type integer Typ treści danych POST przechowywanej we właściwości posts.

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

Zachowanie właściwości:
- obsługiwane, jeśli type jest ustawione na "HTTP agent"
- tylko do odczytu dla obiektów dziedziczonych
posts string Dane treści żądania HTTP(S).

Zachowanie właściwości:
- wymagane, jeśli type jest ustawione na "HTTP agent", a post_type jest ustawione na "JSON data" lub "XML data"
- obsługiwane, jeśli type jest ustawione na "HTTP agent", a post_type jest ustawione na "Raw data"
- tylko do odczytu dla obiektów dziedziczonych
privatekey string Nazwa pliku klucza prywatnego.

Zachowanie właściwości:
- wymagane, jeśli type jest ustawione na "SSH agent", a authtype jest ustawione na "public key"
publickey string Nazwa pliku klucza publicznego.

Zachowanie właściwości:
- wymagane, jeśli type jest ustawione na "SSH agent", a authtype jest ustawione na "public key"
query_fields array Tablica pól zapytania, które zostaną wysłane podczas wykonywania żądania HTTP.

Zachowanie właściwości:
- obsługiwane, jeśli type jest ustawione na "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ługiwane, jeśli type jest ustawione na "HTTP agent"
- tylko do odczytu dla obiektów dziedziczonych
retrieve_mode integer Która część odpowiedzi powinna zostać zapisana.

Możliwe wartości, jeśli request_method jest ustawione na "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 jest ustawione na "HEAD":
1 - Nagłówki.

Zachowanie właściwości:
- obsługiwane, jeśli type jest ustawione na "HTTP agent"
- tylko do odczytu dla obiektów dziedziczonych
snmp_oid string OID SNMP.

Zachowanie właściwości:
- wymagane, jeśli type jest ustawione na "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ługiwane, jeśli type jest ustawione na "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ługiwane, jeśli type jest ustawione na "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ługiwane, jeśli type jest ustawione na "HTTP agent"
- tylko do odczytu dla obiektów dziedziczonych
state integer Stan prototypu reguły LLD.

Możliwe wartości:
0 - (domyślnie) normalny;
1 - nieobsługiwany.

Zachowanie właściwości:
- tylko do odczytu
status integer Status prototypu reguły LLD.

Możliwe wartości:
0 - (domyślnie) włączony prototyp reguły LLD;
1 - wyłączony prototyp reguły LLD.
status_codes string Zakresy wymaganych kodów statusu HTTP, oddzielone przecinkami. Obsługuje również makra użytkownika jako część listy oddzielonej przecinkami.

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

Zachowanie właściwości:
- obsługiwane, jeśli type jest ustawione na "HTTP agent"
- tylko do odczytu dla obiektów dziedziczonych
templateid ID ID nadrzędnego prototypu reguły LLD szablonu.

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

Możliwy zakres wartości: 1-600s.

Domyślnie: "" - użyj ustawień proxy/globalnych.

Zachowanie właściwości:
- obsługiwane, jeśli type jest ustawione na "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), a snmp_oid zaczyna się od "walk[" lub "get[", "Script" (21), "Browser" (22)
- tylko do odczytu dla obiektów dziedziczonych
trapper_hosts string Dozwolone hosty.

Zachowanie właściwości:
- obsługiwane, jeśli type jest ustawione na "Zabbix trapper", lub jeśli type jest ustawione na "HTTP agent", a allow_traps jest ustawione na "Allow to accept incoming data"
username string Nazwa użytkownika do uwierzytelniania.

Zachowanie właściwości:
- wymagane, jeśli type jest ustawione na "SSH agent", "TELNET agent", lub jeśli type jest ustawione na "JMX agent", a password jest ustawione
- obsługiwane, jeśli type jest ustawione na "Simple check", "Database monitor" lub "HTTP agent"
- tylko do odczytu dla obiektów dziedziczonych (jeśli type jest ustawione na "HTTP agent")
uuid string Uniwersalny unikalny identyfikator, używany do łączenia importowanych prototypów reguł LLD z już istniejącymi. Generowany automatycznie, jeśli nie został podany.

Zachowanie właściwości:
- obsługiwane, jeśli prototyp reguły LLD należy do szablonu
verify_host integer Czy weryfikować, że nazwa hosta dla połączenia odpowiada nazwie w certyfikacie hosta.

Możliwe wartości:
0 - (domyślnie) Nie weryfikuj;
1 - Weryfikuj.

Zachowanie właściwości:
- obsługiwane, jeśli type jest ustawione na "HTTP agent"
- tylko do odczytu dla obiektów dziedziczonych
verify_peer integer Czy weryfikować, że certyfikat hosta jest autentyczny.

Możliwe wartości:
0 - (domyślnie) Nie weryfikuj;
1 - Weryfikuj.

Zachowanie właściwości:
- obsługiwane, jeśli type jest ustawione na "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 prototypu reguły LLD

Obiekt filtra prototypu 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ść Type 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 odwołują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 odwołują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 „wyrażenie niestandardowe”

Warunek filtra prototypu reguły LLD

Obiekt warunku filtra prototypu 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.

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 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 prototypu reguły LLD 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 discoveryruleprototype.get oraz discoveryruleprototype.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 prototypu reguły LLD

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

Właściwość Type Opis
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 - 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.

Zachowanie właściwości:
- wymagane
params string Dodatkowe parametry używane przez opcję wstępnego przetwarzania. Wiele parametrów jest rozdzielanych znakiem nowej linii (\n).

Zachowanie właściwości:
- wymagane, jeśli type jest ustawione na „Wyrażenie regularne” (5), „XML XPath” (11), „JSONPath” (12), „Pasuje do wyrażenia regularnego” (14), „Nie pasuje do 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 działania używanego w przypadku niepowodzenia kroku wstępnego przetwarzania.

Możliwe wartości:
0 - Komunikat o błędzie jest ustawiany przez Zabbix server;
1 - Odrzuć wartość;
2 - Ustaw własną wartość;
3 - Ustaw własny komunikat o błędzie.

Zachowanie właściwości:
- wymagane, jeśli type jest ustawione na „Wyrażenie regularne” (5), „XML XPath” (11), „JSONPath” (12), „Pasuje do wyrażenia regularnego” (14), „Nie pasuje do 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.

Zachowanie właściwości:
- wymagane, jeśli error_handler jest ustawione na „Ustaw własną wartość” lub „Ustaw własny komunikat o błędzie”

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

Typ wstępnego przetwarzania Nazwa Parametr 1 Parametr 2 Parametr 3 Obsługiwane procedury obsługi błędów
5 Wyrażenie regularne wzorzec1 wynik2 0, 1, 2, 3
11 XML XPath ścieżka3 0, 1, 2, 3
12 JSONPath ścieżka3 0, 1, 2, 3
14 Pasuje do wyrażenia regularnego wzorzec1 0, 1, 2, 3
15 Nie pasuje do wyrażenia regularnego wzorzec1 0, 1, 2, 3
16 Sprawdź błąd w JSON ścieżka3 0, 1, 2, 3
17 Sprawdź błąd w XML ścieżka3 0, 1, 2, 3
20 Odrzuć niezmienione z heartbeat sekundy4,\ 5
21 JavaScript skrypt2
23 Prometheus do JSON wzorzec5,\ 6 0, 1, 2, 3
24 CSV do JSON znak2 znak2 0,1 0, 1, 2, 3
25 Zamień szukany ciąg2 zamiennik2
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 Nazwa pola2 Prefiks OID2 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 komponent wzorca Prometheus (metryka, nazwa etykiety, wartość etykiety i wartość metryki) może być makrem użytkownika.
7 Obsługuje wiele rekordów „Nazwa pola,Prefiks OID,Format”, rozdzielonych znakiem nowej linii.

Nadpisania prototypów reguł LLD

Obiekt nadpisań prototypów 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ść Typ Opis
name string Unikalna nazwa nadpisania.

Zachowanie właściwości:
- wymagane
step integer Unikalny numer porządkowy 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 prototypu reguły LLD

Obiekt filtra nadpisania prototypu 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 nadpisania używanych do dopasowywania wykrytych obiektów. Warunki zostaną posortowane zgodnie z kolejnością ich umieszczenia w formule.

Property behavior:
- required
evaltype integer Metoda oceny warunku filtra nadpisania.

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

Property behavior:
- required
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 konkretnych warunków filtra nadpisania za pomocą ich formulaid. Wartość eval_formula jest równa wartości formula dla filtrów z wyrażeniem niestandardowym.

Property behavior:
- read-only
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 konkretnych 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.

Property behavior:
- required jeśli evaltype jest ustawione na "custom expression"
Warunek filtra nadpisania prototypu reguły LLD

Obiekt warunku filtra nadpisania prototypu reguły LLD definiuje osobne 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:
- wymagane
value string Wartość do porównania.

Property behavior:
- 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 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.

Property behavior:
- wymagane, jeśli evaltype obiektu LLD rule prototype override filter object jest ustawione 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.

Operacja nadpisania prototypu reguły LLD

Operacja nadpisania prototypu reguły LLD jest połączeniem 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.

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

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 prototypu reguły LLD

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

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

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

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

Status discover operacji nadpisania prototypu reguły LLD 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 prototypu reguły LLD

Okres operacji nadpisania prototypu reguły LLD jest wartością interwału aktualizacji ustawianą dla wykrytej pozycji. Ma następujące właściwości:

Właściwość Type Opis
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 rozdzielone średnikami. Interwały niestandardowe mogą stanowić mieszankę interwałów elastycznych i harmonogramowanych.

Akceptuje makra użytkownika lub makra LLD. Jeśli są używane, wartość musi być pojedynczym makrem. Wiele makr lub makra zmieszane z tekstem nie są obsługiwane. Interwały elastyczne mogą być zapisane 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 prototypu reguły LLD

Wartość historii operacji nadpisania prototypu 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 historii powinny być przechowywane. Akceptuje również makro użytkownika i makro LLD.

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

Wartość trendów operacji nadpisania prototypu 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 powinny być przechowywane. Akceptuje również makro użytkownika i makro LLD.

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

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

Właściwość Type 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 prototypu reguły LLD

Obiekt znacznika operacji nadpisania prototypu reguły LLD zawiera nazwę i wartość znacznika, które są ustawiane dla wykrytego obiektu. Ma następujące właściwości:

Właściwość Type Opis
tag string Nowa nazwa znacznika.

Zachowanie właściwości:
- wymagane
value string Nowa wartość znacznika.
Szablon operacji nadpisania prototypu reguły LLD

Obiekt szablonu operacji nadpisania prototypu reguły LLD, który jest połączony z wykrytym hostem. Ma następujące właściwości:

Właściwość Type Opis
templateid ID Nadpisuje szablon szablonów połączonych z prototypem hosta.

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

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

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

Możliwe wartości:
-1 - wyłączone;
0 - (domyślnie) ręczne;
1 - automatyczne.

Zachowanie właściwości:
- wymagane