LLD noteikuma objekts

Tālāk norādītie objekti ir tieši saistīti ar discoveryrule API.

LLD noteikums

Zema līmeņa atklāšanas noteikuma objektam ir šādi rekvizīti.

Rekvizīts Tips Apraksts
itemid ID LLD noteikuma ID.

Rekvizīta darbība:
- tikai lasāms
- obligāts atjaunināšanas darbībām
delay string LLD noteikuma atjaunināšanas intervāls.

Pieņem sekunžu skaitu (piemēram, 1, 60, 300), vērtību ar laika sufiksu (piemēram, 30s, 1m, 2h, 1d) vai, pēc izvēles, vienu vai vairākus pielāgotus intervālus, kas atdalīti ar semikoliem. Pielāgotie intervāli var būt elastīgo un plānošanas intervālu kombinācija.

Pieņem lietotāja makro. Ja tiek izmantots makro, vērtībai jābūt vienam makro. Vairāki makro vai makro kombinācijā ar tekstu netiek atbalstīti. Elastīgos intervālus var norādīt kā divus makro, kas atdalīti ar slīpsvītru (piemēram, {$FLEX_INTERVAL}/{$FLEX_PERIOD}).

Piemērs:
1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}

Rekvizīta darbība:
- obligāts, ja type ir iestatīts uz "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) vai ja type ir iestatīts uz "Zabbix agent (active)" (7) un key_ nesatur "mqtt.get"
hostid ID Tā hosts ID, kuram pieder LLD noteikums.

Rekvizīta darbība:
- konstants
- obligāts izveides darbībām
flags integer Atklāšanas noteikuma izcelsme.

Iespējamās vērtības:
1 - zema līmeņa atklāšanas noteikums;
5 - no prototipa pārveidots zema līmeņa atklāšanas noteikums.

Rekvizīta darbība:
- tikai lasāms
interfaceid ID LLD noteikuma hosts saskarnes ID.

Rekvizīta darbība:
- obligāts, ja LLD noteikums pieder hostam un type ir iestatīts uz "Zabbix agent", "IPMI agent", "JMX agent" vai "SNMP agent"
- atbalstīts, ja LLD noteikums pieder hostam un type ir iestatīts uz "Simple check", "External check", "SSH agent", "TELNET agent" vai "HTTP agent"
key_ string LLD noteikuma atslēga.

Rekvizīta darbība:
- obligāta izveides darbībām
- tikai lasāma mantotiem objektiem
name string LLD noteikuma nosaukums.

Rekvizīta darbība:
- obligāts izveides darbībām
- tikai lasāms mantotiem objektiem
type integer LLD noteikuma tips.

Iespējamās vērtības:
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. Šis tips ir atļauts tikai tad, ja noteikuma vecāks ir veidne (tiek pieņemts, ka atklāšanas laikā tā ir saistīta ar hosts prototipu) vai atklāts hosts (kura saknē ir LLD noteikums);
24 - Telemetry query.

Rekvizīta darbība:
- obligāts izveides darbībām
- tikai lasāms mantotiem objektiem
url string URL virkne.
Atbalsta lietotāja makro, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {ITEM.ID}, {ITEM.KEY}.

Rekvizīta darbība:
- obligāts, ja type ir iestatīts uz "HTTP agent"
- tikai lasāms mantotiem objektiem
allow_traps integer Atļaut vērtības aizpildīšanu līdzīgi kā trapper vienumam.

Iespējamās vērtības:
0 - (noklusējums) nepieņemt ienākošos datus;
1 - pieņemt ienākošos datus.

Rekvizīta darbība:
- atbalstīts, ja type ir iestatīts uz "HTTP agent"
authtype integer Autentifikācijas metode.

Iespējamās vērtības, ja type ir iestatīts uz "SSH agent":
0 - (noklusējums) parole;
1 - publiskā atslēga.

Iespējamās vērtības, ja type ir iestatīts uz "HTTP agent":
0 - (noklusējums) nav;
1 - basic;
2 - NTLM;
3 - Kerberos;
4 - Digest.

Rekvizīta darbība:
- atbalstīts, ja type ir iestatīts uz "SSH agent" vai "HTTP agent"
- tikai lasāms mantotiem objektiem (ja type ir iestatīts uz "HTTP agent")
description string LLD noteikuma apraksts.
error string Kļūdas teksts, ja rodas problēmas ar LLD noteikuma vērtības atjaunināšanu.

Rekvizīta darbība:
- tikai lasāms
follow_redirects integer Datu aptaujas laikā sekot atbildes novirzēm.

Iespējamās vērtības:
0 - nesekot novirzēm;
1 - (noklusējums) sekot novirzēm.

Rekvizīta darbība:
- atbalstīts, ja type ir iestatīts uz "HTTP agent"
- tikai lasāms mantotiem objektiem
headers array Galveņu masīvs, kas tiks nosūtīts, veicot HTTP pieprasījumu.

Rekvizīta darbība:
- atbalstīts, ja type ir iestatīts uz "HTTP agent"
- tikai lasāms mantotiem objektiem
http_proxy string HTTP(S) starpniekservera savienojuma virkne.

Rekvizīta darbība:
- atbalstīts, ja type ir iestatīts uz "HTTP agent"
- tikai lasāms mantotiem objektiem
ipmi_sensor string IPMI sensors.

Rekvizīta darbība:
- obligāts, ja type ir iestatīts uz "IPMI agent" un key_ nav iestatīts uz "ipmi.get"
- atbalstīts, ja type ir iestatīts uz "IPMI agent"
- tikai lasāms mantotiem objektiem
jmx_endpoint string JMX aģenta pielāgotā savienojuma virkne.

Noklusējums: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi

Rekvizīta darbība:
- atbalstīts, ja type ir iestatīts uz "JMX agent"
lifetime string Laika periods, pēc kura tiks dzēsti vienumi, kas vairs netiek atklāti. Pieņem sekunžu skaitu (piemēram, 3600), vērtību ar laika sufiksu (piemēram, 3600s, 180m, 24h, 1d) vai lietotāja makro.

Noklusējums: 7d.
lifetime_type integer Scenārijs zaudēto LLD resursu dzēšanai.

Iespējamās vērtības:
0 - (noklusējums) dzēst pēc dzīves cikla sliekšņa sasniegšanas;
1 - nedzēst;
2 - dzēst nekavējoties.
enabled_lifetime string Laika periods, pēc kura tiks atspējoti vienumi, kas vairs netiek atklāti. Pieņem sekunžu skaitu (piemēram, 1, 60, 300), vērtību ar laika sufiksu (piemēram, 30s, 1m, 2h, 1d) vai lietotāja makro.

Noklusējums: 0.
enabled_lifetime_type integer Scenārijs zaudēto LLD resursu atspējošanai.

Iespējamās vērtības:
0 - atspējot pēc dzīves cikla sliekšņa sasniegšanas;
1 - neatspējot;
2 - (noklusējums) atspējot nekavējoties.
master_itemid ID Galvenā vienuma ID.
Atklāšanas noteikums nevar būt galvenais vienums citam atklāšanas noteikumam.

Rekvizīta darbība:
- obligāts, ja type ir iestatīts uz "Dependent item"
- tikai lasāms mantotiem objektiem
output_format integer Vai atbilde jāpārveido par JSON.

Iespējamās vērtības:
0 - (noklusējums) saglabāt neapstrādātus datus;
1 - pārveidot par JSON.

Rekvizīta darbība:
- atbalstīts, ja type ir iestatīts uz "HTTP agent"
- tikai lasāms mantotiem objektiem
params string Papildu parametri atkarībā no LLD noteikuma tipa:
- izpildāmais skripts SSH un Telnet LLD noteikumiem;
- SQL vaicājums datubāzes pārraudzības LLD noteikumiem;
- formula aprēķinātajiem LLD noteikumiem;
- skripts skripta un pārlūka LLD noteikumiem.

Rekvizīta darbība:
- obligāts, ja type ir iestatīts uz "Database monitor", "SSH agent", "TELNET agent", "Script" vai "Browser"
- tikai lasāms mantotiem objektiem (ja type ir iestatīts uz "Script" vai "Browser")
parameters object/array Papildu parametri, ja type ir iestatīts uz "Script" vai "Browser".
Objektu masīvs ar name un value rekvizītiem, kur name jābūt unikālam.

Rekvizīta darbība:
- atbalstīts, ja type ir iestatīts uz "Script" vai "Browser"
- tikai lasāms mantotiem objektiem
password string Autentifikācijas parole.

Rekvizīta darbība:
- obligāts, ja type ir iestatīts uz "JMX agent" un username ir iestatīts
- atbalstīts, ja type ir iestatīts uz "Simple check", "Database monitor", "SSH agent", "TELNET agent" vai "HTTP agent"
- tikai lasāms mantotiem objektiem (ja type ir iestatīts uz "HTTP agent")
post_type integer posts rekvizītā saglabāto POST datu pamatteksta tips.

Iespējamās vērtības:
0 - (noklusējums) neapstrādāti dati;
2 - JSON dati;
3 - XML dati.

Rekvizīta darbība:
- atbalstīts, ja type ir iestatīts uz "HTTP agent"
- tikai lasāms mantotiem objektiem
posts string HTTP(S) pieprasījuma pamatteksta dati.

Rekvizīta darbība:
- obligāts, ja type ir iestatīts uz "HTTP agent" un post_type ir iestatīts uz "JSON data" vai "XML data"
- atbalstīts, ja type ir iestatīts uz "HTTP agent" un post_type ir iestatīts uz "Raw data"
- tikai lasāms mantotiem objektiem
privatekey string Privātās atslēgas faila nosaukums.

Rekvizīta darbība:
- obligāts, ja type ir iestatīts uz "SSH agent" un authtype ir iestatīts uz "public key"
publickey string Publiskās atslēgas faila nosaukums.

Rekvizīta darbība:
- obligāts, ja type ir iestatīts uz "SSH agent" un authtype ir iestatīts uz "public key"
query_fields array Vaicājuma lauku masīvs, kas tiks nosūtīts, veicot HTTP pieprasījumu.

Rekvizīta darbība:
- atbalstīts, ja type ir iestatīts uz "HTTP agent"
- tikai lasāms mantotiem objektiem
request_method integer Pieprasījuma metodes tips.

Iespējamās vērtības:
0 - (noklusējums) GET;
1 - POST;
2 - PUT;
3 - HEAD.

Rekvizīta darbība:
- atbalstīts, ja type ir iestatīts uz "HTTP agent"
- tikai lasāms mantotiem objektiem
retrieve_mode integer Kura atbildes daļa jāsaglabā.

Iespējamās vērtības, ja request_method ir iestatīts uz "GET", "POST" vai "PUT":
0 - (noklusējums) pamatteksts;
1 - galvenes;
2 - tiks saglabāts gan pamatteksts, gan galvenes.

Iespējamā vērtība, ja request_method ir iestatīts uz "HEAD":
1 - galvenes.

Rekvizīta darbība:
- atbalstīts, ja type ir iestatīts uz "HTTP agent"
- tikai lasāms mantotiem objektiem
snmp_oid string SNMP OID.

Rekvizīta darbība:
- obligāts, ja type ir iestatīts uz "SNMP agent"
- tikai lasāms mantotiem objektiem
ssl_cert_file string Publiskās SSL atslēgas faila ceļš.

Rekvizīta darbība:
- atbalstīts, ja type ir iestatīts uz "HTTP agent"
- tikai lasāms mantotiem objektiem
ssl_key_file string Privātās SSL atslēgas faila ceļš.

Rekvizīta darbība:
- atbalstīts, ja type ir iestatīts uz "HTTP agent"
- tikai lasāms mantotiem objektiem
ssl_key_password string SSL atslēgas faila parole.

Rekvizīta darbība:
- atbalstīts, ja type ir iestatīts uz "HTTP agent"
- tikai lasāms mantotiem objektiem
state integer LLD noteikuma stāvoklis.

Iespējamās vērtības:
0 - (noklusējums) normāls;
1 - netiek atbalstīts.

Rekvizīta darbība:
- tikai lasāms
status integer LLD noteikuma statuss.

Iespējamās vērtības:
0 - (noklusējums) iespējots LLD noteikums;
1 - atspējots LLD noteikums.
status_codes string Nepieciešamo HTTP statusa kodu diapazoni, atdalīti ar komatiem. Atbalsta arī lietotāja makro kā daļu no ar komatiem atdalīta saraksta.

Piemērs: 200,200-{$M},{$M},200-400

Rekvizīta darbība:
- atbalstīts, ja type ir iestatīts uz "HTTP agent"
- tikai lasāms mantotiem objektiem
templateid ID Vecāka veidnes LLD noteikuma ID.

Rekvizīta darbība:
- tikai lasāms
timeout string Vienuma datu aptaujas pieprasījuma taimauts.
Pieņem sekunžu skaitu (piemēram, 1, 60, 300) vai vērtību ar laika sufiksu (piemēram, 30s, 1m). Pieņem arī lietotāja makro.

Iespējamo vērtību diapazons: 1-600s.

Noklusējums: "" - izmantot starpniekservera/globālos iestatījumus.

Rekvizīta darbība:
- atbalstīts, ja type ir iestatīts uz "Zabbix agent" (0), "Simple check" (3) un key_ nesākas ar "vmware." un "icmpping", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "HTTP agent" (19), "SNMP agent" (20) un snmp_oid sākas ar "walk[" vai "get[", "Script" (21), "Browser" (22), "Telemetry query" (24)
- tikai lasāms mantotiem objektiem,
- ja tiek lietota noklusējuma vērtība un vienums pieder hostam, kuru pārrauga nepieejams starpniekserveris vai starpniekserveru grupa, tiek izmantots globālais taimauts.
trapper_hosts string Atļautie hosti.

Rekvizīta darbība:
- atbalstīts, ja type ir iestatīts uz "Zabbix trapper" vai ja type ir iestatīts uz "HTTP agent" un allow_traps ir iestatīts uz "Allow incoming data".
Ja rekvizīts nav norādīts, tam automātiski tiek iestatīts {$TRAPPER.ALLOWED_HOSTS} lietotāja makro (noklusējuma vērtība). Pēc noklusējuma {$TRAPPER.ALLOWED_HOSTS} ir 127.0.0.1,::1.
Ja rekvizīts ir iestatīts uz tukšu virkni, ienākošie savienojumi no visiem hostiem tiks noraidīti.
username string Autentifikācijas lietotājvārds.

Rekvizīta darbība:
- obligāts, ja type ir iestatīts uz "SSH agent", "TELNET agent" vai ja type ir iestatīts uz "JMX agent" un password ir iestatīts
- atbalstīts, ja type ir iestatīts uz "Simple check", "Database monitor" vai "HTTP agent"
- tikai lasāms mantotiem objektiem (ja type ir iestatīts uz "HTTP agent")
uuid string Universāls unikāls identifikators, ko izmanto importēto LLD noteikumu sasaistīšanai ar jau esošajiem noteikumiem. Ja nav norādīts, tiek ģenerēts automātiski.

Rekvizīta darbība:
- atbalstīts, ja LLD noteikums pieder veidnei
verify_host integer Vai pārbaudīt, ka savienojuma hosts nosaukums atbilst tam, kas norādīts hosts sertifikātā.

Iespējamās vērtības:
0 - (noklusējums) nepārbaudīt;
1 - pārbaudīt.

Rekvizīta darbība:
- atbalstīts, ja type ir iestatīts uz "HTTP agent"
- tikai lasāms mantotiem objektiem
verify_peer integer Vai pārbaudīt, ka hosts sertifikāts ir autentisks.

Iespējamās vērtības:
0 - (noklusējums) nepārbaudīt;
1 - pārbaudīt.

Rekvizīta darbība:
- atbalstīts, ja type ir iestatīts uz "HTTP agent"
- tikai lasāms mantotiem objektiem
query object Telemetry query konfigurācija. Nosaka, ko LLD noteikums vaicā telemetrijas datu avotā, kā tas filtrē datus un kā apkopo rezultātu.

Rekvizīta darbība:
- obligāts, ja type ir iestatīts uz "Telemetry query"
- tikai lasāms mantotiem objektiem
time_shift string Minimālais laiks starp vaicājuma laika diapazona beigām un pašreizējo laiku.

Pieņem sekunžu skaitu (piemēram, 1, 60, 300) vai vērtību ar laika sufiksu (piemēram, 30s, 1m, 2h, 1d). Pieņem arī lietotāja makro.

Iespējamo vērtību diapazons: 0-86400s.

Noklusējums: 15s.

Rekvizīta darbība:
- atbalstīts, ja type ir iestatīts uz "Telemetry query"
lookback_limit string Cik tālu atpakaļ (pirms vaicājuma laika diapazona beigām) sākas vaicājuma laika diapazons, ja:
- nav iepriekšēja vaicājuma, no kura turpināt (piemēram, LLD noteikuma pirmās palaišanas laikā);
- turpināšana no iepriekšējā vaicājuma padarītu vaicājuma laika diapazonu garāku par lookback_limit (piemēram, tāpēc, ka Zabbix serveris nedarbojās).

Pieņem sekunžu skaitu (piemēram, 1, 60, 300) vai vērtību ar laika sufiksu (piemēram, 30s, 1m, 2h, 1d). Pieņem arī lietotāja makro.

Iespējamo vērtību diapazons: 1-259200s.

Noklusējums: 10m.

Rekvizīta darbība:
- atbalstīts, ja type ir iestatīts uz "Telemetry query"
granularity string Tā segmenta ilgums, kurā tiek sadalīts vaicājuma laika diapazons.

Pieņem sekunžu skaitu (piemēram, 1, 60, 300) vai vērtību ar laika sufiksu (piemēram, 30s, 1m, 2h, 1d). Pieņem arī lietotāja makro.

Vērtība nedrīkst būt lielāka par lookback_limit.

Iespējamo vērtību diapazons: 1-86400s.

Noklusējums: 15s.

Rekvizīta darbība:
- atbalstīts, ja type ir iestatīts uz "Telemetry query"

HTTP galvene

Galvenes objektam ir šādas īpašības:

Īpašība Tips Apraksts
name string HTTP galvenes nosaukums.

Īpašības darbība:
- obligāta
value string Galvenes vērtība.

Īpašības darbība:
- obligāta

HTTP vaicājuma lauks

Vaicājuma lauka objekts definē nosaukumu un vērtību, ko izmanto URL parametra norādīšanai. Tam ir šādas īpašības:

Īpašība Tips Apraksts
name string Parametra nosaukums.

Īpašības darbība:
- obligāts
value string Parametra vērtība.

Īpašības darbība:
- obligāts

Telemetrijas vaicājums

Telemetrijas vaicājuma objektam ir šādi rekvizīti.

Rekvizīts Tips Apraksts
signal_type integer Signāla tips, ko vaicā LLD noteikums.

Iespējamās vērtības:
0 - Traces;
1 - Metrics;
2 - Logs.

Rekvizīta darbība:
- obligāts
metric_point_type integer Metrikas punkta tips, ko vaicā LLD noteikums.

Iespējamās vērtības:
0 - Sum;
1 - Gauge;
2 - Histogram;
3 - Exponential histogram.

Rekvizīta darbība:
- obligāts, ja signal_type ir iestatīts uz “Metrics”
columns array Telemetrijas datu kolonnu masīvs, ko vaicā LLD noteikums. Var būt tukšs.

Rekvizīta darbība:
- obligāts
aggregated_columns array Telemetrijas datu apkopoto kolonnu masīvs, ko vaicā LLD noteikums, kā arī veids, kā tas aprēķina vērtību no kolonnu ierakstiem.

Rekvizīta darbība:
- obligāts
filter object Telemetrijas vaicājuma filtrs vaicājuma kolonnu ierakstiem.

Rekvizīta darbība:
- obligāts
Telemetrijas datu kolonnas

Telemetrijas datu kolonnu objektam ir šādas īpašības.

Property Type Description
column string Telemetrijas datu kolonnas nosaukums, ko vaicā LLD noteikums.
Skatiet atbalstītās telemetrijas datu kolonnas.

Vairākām kolonnām ar vienu vērtību katrai column vērtībai ir jābūt unikālai. Vairākām kolonnām, kurās tiek glabāti atslēgas un vērtības pāri, katram column un attribute_key pārim ir jābūt unikālam.
attribute_key string Atslēgas nosaukums, ko vaicā LLD noteikums kolonnā, kurā tiek glabāti atslēgas un vērtības pāri.

Vairākām kolonnām, kurās tiek glabāti atslēgas un vērtības pāri, katram column un attribute_key pārim ir jābūt unikālam.

Īpašības darbība:
- required, ja column ir iestatīta uz kolonnu, kurā tiek glabāti atslēgas un vērtības pāri
Apkopoto telemetrijas datu kolonnu objekts

Apkopoto telemetrijas datu kolonnu objektam ir šādas īpašības.

Īpašība Tips Apraksts
column string Telemetrijas datu kolonnas nosaukums, ko vaicā LLD noteikums.
Skatiet atbalstītās telemetrijas datu kolonnas.

Ja tiek izmantotas vairākas kolonnas, katrai column vērtībai ir jābūt unikālai.

Šī īpašība netiek atbalstīta, ja function ir iestatīta uz "Count".

Īpašības darbība:
- obligāta, ja function ir iestatīta uz "Min", "Max", "Average", "Sum" vai "Percentile"
function integer Funkcija, ko LLD noteikums lieto kolonnas ierakstiem.

Iespējamās vērtības:
1 - Min;
2 - Max;
3 - Average;
4 - Count;
5 - Sum;
8 - Percentile.

Īpašības darbība:
- obligāta
parameters array Procentile, ko LLD noteikums aprēķina no kolonnas ierakstiem.

Iespējamā vērtība: skaitlis no 0 līdz 100, kas norādīts kā virkne.

Īpašības darbība:
- obligāta, ja function ir iestatīta uz "Percentile"
alias string Unikāls aprēķinātās vērtības nosaukums, ko izmanto tās identificēšanai LLD noteikuma vērtībā.

Katrai alias vērtībai ir jābūt unikālai, un tā nedrīkst būt clock.

Īpašības darbība:
- obligāta
Telemetrijas datu filtrs

Telemetrijas datu filtra objektam ir šādi rekvizīti.

Property Type Description
conditions array Telemetrijas datu filtra nosacījumiem jāatbilst ierakstam telemetrijas datu kolonnā.

Rekvizīta darbība:
- obligāts
evaltype integer Filtra nosacījumu novērtēšanas metode.

Iespējamās vērtības:
0 - And/Or;
1 - And;
2 - Or;
3 - Custom expression.

Rekvizīta darbība:
- obligāts
eval_formula string Ģenerēta izteiksme, kas tiks izmantota filtra nosacījumu novērtēšanai. Izteiksme satur ID, kas, izmantojot formulaid, atsaucas uz konkrētiem filtra nosacījumiem. Filtriem ar pielāgotu izteiksmi eval_formula vērtība ir vienāda ar formula vērtību.

Rekvizīta darbība:
- tikai lasāms
formula string Lietotāja definēta izteiksme, kas jāizmanto filtru nosacījumu novērtēšanai ar pielāgotu izteiksmi. Izteiksmē jābūt ietvertiem ID, kas, izmantojot formulaid, atsaucas uz konkrētiem filtra nosacījumiem. Izteiksmē izmantotajiem ID ir precīzi jāatbilst filtra nosacījumos definētajiem ID: neviens nosacījums nedrīkst palikt neizmantots vai izlaists.

Rekvizīta darbība:
- obligāts, ja evaltype ir iestatīts uz “Custom expression”
Telemetrijas datu filtra nosacījumi

Telemetrijas datu filtra nosacījumu objektam ir šādas īpašības.

Property Type Description
column string Telemetrijas datu kolonnas nosaukums, uz kuru attiecas filtra nosacījums.
Skatiet atbalstītās telemetrijas datu kolonnas.

Īpašības darbība:
- obligāta
attribute_key string Atslēgas nosaukums, uz kuru attiecas nosacījums, kolonnā, kurā ir atslēgu un vērtību pāri.

Īpašības darbība:
- obligāta, ja column ir iestatīta uz kolonnu, kurā ir atslēgu un vērtību pāri
operator integer Filtra nosacījuma operators.

Iespējamās vērtības kolonnām ar vienu vērtību:
0 - Vienāds;
1 - Nav vienāds;
2 - Satur;
3 - Nesatur.

Iespējamās vērtības kolonnām, kurās ir atslēgu un vērtību pāri:
0 - Vienāds;
1 - Nav vienāds;
12 - Pastāv.

Īpašības darbība:
- obligāta
value string Vērtība, ar kuru salīdzināt.

Īpašības darbība:
- obligāta, ja operator ir iestatīts uz “Vienāds”, “Nav vienāds”, “Satur” vai “Nesatur”
formulaid string Patvaļīgs unikāls ID, kas tiek izmantots, lai atsauktos uz nosacījumu pielāgotā izteiksmē. Var saturēt tikai lielos burtus. ID lietotājam ir jādefinē, modificējot filtra nosacījumus, taču, tos vēlāk pieprasot, tas tiks ģenerēts no jauna.

Īpašības darbība:
- obligāta, ja Telemetrijas vaicājuma filtra objekta evaltype ir iestatīts uz “Pielāgota izteiksme”

LLD noteikuma filtrs

LLD noteikuma filtra objekts definē nosacījumu kopu, ko var izmantot atklāto objektu filtrēšanai. Tam ir šādas īpašības:

Īpašība Tips Apraksts
conditions object/array Filtra nosacījumu kopa, ko izmantot rezultātu filtrēšanai. Nosacījumi tiks sakārtoti to izvietojuma secībā formulā.

Īpašības darbība:
- obligāta
evaltype integer Filtra nosacījumu novērtēšanas metode.

Iespējamās vērtības:
0 - Un/Vai;
1 - Un;
2 - Vai;
3 - Pielāgota izteiksme.

Īpašības darbība:
- obligāta
eval_formula string Ģenerēta izteiksme, kas tiks izmantota filtra nosacījumu novērtēšanai. Izteiksme satur ID, kas atsaucas uz konkrētiem filtra nosacījumiem pēc to formulaid. eval_formula vērtība ir vienāda ar formula vērtību filtriem ar pielāgotu izteiksmi.

Īpašības darbība:
- tikai lasāma
formula string Lietotāja definēta izteiksme, kas tiks izmantota filtru ar pielāgotu izteiksmi nosacījumu novērtēšanai. Izteiksmei jāsatur ID, kas atsaucas uz konkrētiem filtra nosacījumiem pēc to formulaid. Izteiksmē izmantotajiem ID precīzi jāsakrīt ar tiem, kas definēti filtra nosacījumos: neviens nosacījums nedrīkst palikt neizmantots vai izlaists.

Īpašības darbība:
- obligāta, ja evaltype ir iestatīts uz "custom expression"

LLD noteikuma filtra nosacījums

LLD noteikuma filtra nosacījuma objekts definē atsevišķu pārbaudi, kas jāveic LLD makro vērtībai. Tam ir šādas īpašības:

Īpašība Type Apraksts
macro string LLD makro, kuram jāveic pārbaude.

Īpašības darbība:
- required
value string Vērtība, ar ko salīdzināt.

Īpašības darbība:
- required ja operator ir iestatīts uz "atbilst regulārajai izteiksmei" vai "neatbilst regulārajai izteiksmei"
formulaid string Patvaļīgs unikāls ID, ko izmanto, lai atsauktos uz nosacījumu no pielāgotas izteiksmes. Var saturēt tikai lielos burtus. ID lietotājam jādefinē, modificējot filtra nosacījumus, taču pēc tam, kad tie tiek pieprasīti atkārtoti, tas tiks ģenerēts no jauna.

Īpašības darbība:
- required ja LLD noteikuma filtra objekta evaltype ir iestatīts uz "pielāgota izteiksme"
operator integer Nosacījuma operators.

Iespējamās vērtības:
8 - (noklusējums) atbilst regulārajai izteiksmei;
9 - neatbilst regulārajai izteiksmei;
12 - eksistē;
13 - neeksistē.

Lai labāk saprastu, kā izmantot filtrus ar dažādiem izteiksmju tipiem, skatiet piemērus metožu lapās discoveryrule.get un discoveryrule.create.

LLD makro ceļš

LLD makro ceļam ir šādas īpašības:

Īpašība Type Apraksts
lld_macro string LLD makro.

Īpašības darbība:
- obligāts
path string Atlasītājs vērtībai, kas tiks piešķirta atbilstošajam makro.

Īpašības darbība:
- obligāts

LLD kārtulas priekšapstrāde

LLD kārtulas priekšapstrādes objektam ir šādi rekvizīti.

Property Type Description
type integer Priekšapstrādes opcijas tips.

Iespējamās vērtības:
5 - Regulārā izteiksme;
11 - XML XPath;
12 - JSONPath;
14 - Atbilst regulārajai izteiksmei;
15 - Neatbilst regulārajai izteiksmei;
16 - Pārbaudīt, vai JSON satur kļūdu;
17 - Pārbaudīt, vai XML satur kļūdu;
20 - Atmest nemainīto vērtību ar sirdspukstu;
21 - JavaScript;
23 - Prometheus uz JSON;
24 - CSV uz JSON;
25 - Aizstāt;
27 - XML uz JSON;
28 - SNMP walk vērtība;
29 - SNMP walk uz JSON;
30 - SNMP get vērtība.

Rekvizīta darbība:
- required
params string Papildu parametri, kas tiek izmantoti priekšapstrādes opcijā. Vairāki parametri tiek atdalīti ar jaunas rindas (\n) rakstzīmi.

Rekvizīta darbība:
- required, ja type ir iestatīts uz "Regulārā izteiksme" (5), "XML XPath" (11), "JSONPath" (12), "Atbilst regulārajai izteiksmei" (14), "Neatbilst regulārajai izteiksmei" (15), "Pārbaudīt, vai JSON satur kļūdu" (16), "Pārbaudīt, vai XML satur kļūdu" (17), "Atmest nemainīto vērtību ar sirdspukstu" (20), "JavaScript" (21), "Prometheus uz JSON" (23), "CSV uz JSON" (24), "Aizstāt" (25), "SNMP walk vērtība" (28), "SNMP walk uz JSON" (29) vai "SNMP get vērtība" (30)
error_handler integer Darbības tips, kas tiek izmantots priekšapstrādes soļa kļūmes gadījumā.

Iespējamās vērtības:
0 - Kļūdas ziņojumu iestata Zabbix serveris;
1 - Atmest vērtību;
2 - Iestatīt pielāgotu vērtību;
3 - Iestatīt pielāgotu kļūdas ziņojumu.

Rekvizīta darbība:
- required, ja type ir iestatīts uz "Regulārā izteiksme" (5), "XML XPath" (11), "JSONPath" (12), "Atbilst regulārajai izteiksmei" (14), "Neatbilst regulārajai izteiksmei" (15), "Pārbaudīt, vai JSON satur kļūdu" (16), "Pārbaudīt, vai XML satur kļūdu" (17), "Prometheus uz JSON" (23), "CSV uz JSON" (24), "XML uz JSON" (27), "SNMP walk vērtība" (28), "SNMP walk uz JSON" (29) vai "SNMP get vērtība" (30)
error_handler_params string Kļūdu apstrādātāja parametri.

Rekvizīta darbība:
- required, ja error_handler ir iestatīts uz "Iestatīt pielāgotu vērtību" vai "Iestatīt pielāgotu kļūdas ziņojumu"

Katram priekšapstrādes tipam tiek atbalstīti šādi parametri un kļūdu apstrādātāji.

Preprocessing type Name Parameter 1 Parameter 2 Parameter 3 Supported error handlers
5 Regulārā izteiksme pattern1 output2 0, 1, 2, 3
11 XML XPath path3 0, 1, 2, 3
12 JSONPath path3 0, 1, 2, 3
14 Atbilst regulārajai izteiksmei pattern1 0, 1, 2, 3
15 Neatbilst regulārajai izteiksmei pattern1 0, 1, 2, 3
16 Pārbaudīt, vai JSON satur kļūdu path3 0, 1, 2, 3
17 Pārbaudīt, vai XML satur kļūdu path3 0, 1, 2, 3
20 Atmest nemainīto vērtību ar sirdspukstu seconds4, 5
21 JavaScript script2
23 Prometheus uz JSON pattern5, 6 0, 1, 2, 3
24 CSV uz JSON character2 character2 0,1 0, 1, 2, 3
25 Aizstāt search string2 replacement2
27 XML uz JSON 0, 1, 2, 3
28 SNMP walk vērtība OID2 Formāts:
0 - Nemainīts
1 - UTF-8 no Hex-STRING
2 - MAC no Hex-STRING
3 - Integer no BITS		 0, 1, 2, 3
29 SNMP walk uz JSON7 Field name2 OID prefix2 Formāts:
0 - Nemainīts
1 - UTF-8 no Hex-STRING
2 - MAC no Hex-STRING
3 - Integer no BITS		 0, 1, 2, 3
30 SNMP get vērtība Formāts:
1 - UTF-8 no Hex-STRING
2 - MAC no Hex-STRING
3 - Integer no BITS		 0, 1, 2, 3

1 regulārā izteiksme
2 virkne
3 JSONPath vai XML XPath
4 pozitīvs vesels skaitlis (ar laika sufiksu atbalstu, piemēram, 30s, 1m, 2h, 1d)
5 lietotāja makross
6 Prometheus raksts, kas atbilst sintaksei: <metric name>{<label name>="<label value>", ...} == <value>. Katrs Prometheus raksta komponents (metrika, etiķetes nosaukums, etiķetes vērtība un metrikas vērtība) var būt lietotāja makross.
7 Atbalsta vairākus "Field name,OID prefix,Format records" ierakstus, kas atdalīti ar jaunas rindas rakstzīmi.

LLD noteikuma pārrakstīšanas

LLD noteikuma pārrakstīšanas objekts definē noteikumu kopu (filtrus, nosacījumus un operācijas), kas tiek izmantoti, lai pārrakstītu dažādu prototipu objektu īpašības. Tam ir šādas īpašības:

Īpašība Tips Apraksts
name string Unikāls pārrakstīšanas nosaukums.

Īpašības darbība:
- obligāta
step integer Unikāls pārrakstīšanas secības numurs.

Īpašības darbība:
- obligāta
stop integer Pārtraukt nākamo pārrakstīšanu apstrādi, ja ir atbilstība.

Iespējamās vērtības:
0 - (noklusējums) nepārtraukt pārrakstīšanu apstrādi;
1 - pārtraukt pārrakstīšanu apstrādi, ja filtrs atbilst.
filter object Pārrakstīšanas filtrs.
operations object/array Pārrakstīšanas operācijas.

LLD noteikuma ignorēšanas filtrs

LLD noteikuma ignorēšanas filtra objekts definē nosacījumu kopu, un, ja tie atbilst atklātajam objektam, tiek piemērota ignorēšana. Tam ir šādas īpašības:

Īpašība Tips Apraksts
conditions object/array Ignorēšanas filtra nosacījumu kopa, ko izmantot atklāto objektu atbilstības noteikšanai. Nosacījumi tiks sakārtoti to izvietojuma secībā formulā.

Īpašības darbība:
- obligāta
evaltype integer Ignorēšanas filtra nosacījumu novērtēšanas metode.

Iespējamās vērtības:
0 - Un/Vai;
1 - Un;
2 - Vai;
3 - Pielāgota izteiksme.

Īpašības darbība:
- obligāta
eval_formula string Ģenerēta izteiksme, kas tiks izmantota ignorēšanas filtra nosacījumu novērtēšanai. Izteiksme satur ID, kas atsaucas uz konkrētiem ignorēšanas filtra nosacījumiem pēc to formulaid. eval_formula vērtība ir vienāda ar formula vērtību filtriem ar pielāgotu izteiksmi.

Īpašības darbība:
- tikai lasāma
formula string Lietotāja definēta izteiksme, kas tiks izmantota, lai novērtētu ignorēšanas filtru nosacījumus ar pielāgotu izteiksmi. Izteiksmei jāsatur ID, kas atsaucas uz konkrētiem ignorēšanas filtra nosacījumiem pēc to formulaid. Izteiksmē izmantotajiem ID precīzi jāsakrīt ar tiem, kas definēti ignorēšanas filtra nosacījumos: nevienu nosacījumu nedrīkst atstāt neizmantotu vai izlaistu.

Īpašības darbība:
- obligāta, ja evaltype ir iestatīts uz "custom expression"
LLD noteikuma ignorēšanas filtra nosacījums

LLD noteikuma ignorēšanas filtra nosacījuma objekts definē atsevišķu pārbaudi, kas jāveic ar LLD makro vērtību. Tam ir šādas īpašības:

Īpašība Type Apraksts
macro string LLD makro, kuram jāveic pārbaude.

Īpašības darbība:
- required
value string Vērtība, ar ko salīdzināt.

Īpašības darbība:
- required ja operator ir iestatīts uz "atbilst regulārajai izteiksmei" vai "neatbilst regulārajai izteiksmei"
formulaid string Patvaļīgs unikāls ID, kas tiek izmantots, lai atsauktos uz nosacījumu no pielāgotas izteiksmes. Tas var saturēt tikai lielos burtus. ID lietotājam jādefinē, modificējot filtra nosacījumus, taču pēc tam, kad tie tiek pieprasīti atkārtoti, tas tiks ģenerēts no jauna.

Īpašības darbība:
- required ja LLD noteikuma ignorēšanas filtra objekta evaltype ir iestatīts uz "pielāgota izteiksme"
operator integer Nosacījuma operators.

Iespējamās vērtības:
8 - (noklusējums) atbilst regulārajai izteiksmei;
9 - neatbilst regulārajai izteiksmei;
12 - eksistē;
13 - neeksistē.

LLD noteikuma ignorēšanas operācija

LLD noteikuma ignorēšanas operācija ir nosacījumu un darbību kombinācija, kas jāveic ar prototipa objektu. Tai ir šādas īpašības:

Īpašība Type Apraksts
operationobject integer Atklātā objekta tips, kuram jāveic darbība.

Iespējamās vērtības:
0 - vienuma prototips;
1 - trigera prototips;
2 - grafika prototips;
3 - hosta prototips;
4 - atklāšanas prototips.

Īpašības darbība:
- obligāts
operator integer Ignorēšanas nosacījuma operators.

Iespējamās vērtības:
0 - (noklusējums) vienāds ar;
1 - nav vienāds ar;
2 - satur;
3 - nesatur;
8 - atbilst;
9 - neatbilst.
value string Meklējamais šablons, kas atbilst vienuma, trigera, grafika vai hosta prototipa nosaukumam atkarībā no izvēlētā objekta.
opstatus object Ignorēšanas operācijas statusa objekts vienuma, trigera un hosta prototipa objektiem.
opdiscover object Ignorēšanas operācijas atklāšanas statusa objekts (visiem objektu tipiem).
opperiod object Ignorēšanas operācijas perioda (atjaunināšanas intervāla) objekts vienuma prototipa objektam.
ophistory object Ignorēšanas operācijas vēstures objekts vienuma prototipa objektam.
optrends object Ignorēšanas operācijas tendenču objekts vienuma prototipa objektam.
opseverity object Ignorēšanas operācijas smaguma pakāpes objekts trigera prototipa objektam.
optag object/array Ignorēšanas operācijas taga objekts trigera un hosta prototipa objektiem.
optemplate object/array Ignorēšanas operācijas veidnes objekts hosta prototipa objektam.
opinventory object Ignorēšanas operācijas inventāra objekts hosta prototipa objektam.
LLD noteikuma ignorēšanas operācijas statuss

LLD noteikuma ignorēšanas operācijas statuss, kas ir iestatīts atklātajam objektam. Tam ir šādas īpašības:

Īpašība Type Apraksts
status integer Ignorēt statusu atlasītajam objektam.

Iespējamās vērtības:
0 - Izveidot iespējotu;
1 - Izveidot atspējotu.

Īpašības darbība:
- required
LLD noteikuma ignorēšanas operācijas atklāšana

LLD noteikuma ignorēšanas operācijas atklāšanas statuss, kas ir iestatīts atklātajam objektam. Tam ir šādas īpašības:

Īpašība Tips Apraksts
discover integer Ignorēt atklāšanas statusu atlasītajam objektam.

Iespējamās vērtības:
0 - Jā, turpināt objektu atklāšanu;
1 - Nē, jauni objekti netiks atklāti, un esošie tiks atzīmēti kā zaudēti.

Īpašības darbība:
- obligāts
LLD kārtulas ignorēšanas darbības periods

LLD kārtulas ignorēšanas darbības periods ir atjaunināšanas intervāla vērtība, kas iestatīta atklātajam vienumam. Tam ir šādi rekvizīti:

Property Type Description
delay string Ignorēt vienuma prototipa atjaunināšanas intervālu.

Pieņem sekunžu skaitu (piemēram, 1, 60, 300), vērtību ar laika sufiksu (piemēram, 30s, 1m, 2h, 1d) vai, pēc izvēles, vienu vai vairākus pielāgotus intervālus, kas visi atdalīti ar semikoliem. Pielāgotie intervāli var būt elastīgo un plānošanas intervālu kombinācija.

Pieņem lietotāja makro vai LLD makro. Ja tiek izmantots makro, vērtībai jābūt vienam makro. Vairāki makro vai makro kombinācijā ar tekstu netiek atbalstīti. Elastīgos intervālus var norādīt kā divus makro, kas atdalīti ar slīpsvītru (piemēram, {$FLEX_INTERVAL}/{$FLEX_PERIOD}).

Piemērs:
1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}

Rekvizīta darbība:
- obligāts
LLD noteikuma ignorēšanas darbības vēsture

LLD noteikuma ignorēšanas darbības vēstures vērtība, kas ir iestatīta atklātajam vienumam. Tai ir šādas īpašības:

Īpašība Type Apraksts
history string Ignorē vienuma prototipa vēsturi, kas ir laika vienība, cik ilgi vēstures dati ir jāglabā. Pieņem arī lietotāja makrosu un LLD makrosu.

Īpašības darbība:
- obligāts
LLD noteikuma ignorēšanas operācijas tendenču iestatījums

LLD noteikuma ignorēšanas operācijas tendenču vērtība, kas tiek iestatīta atklātajam vienumam. Tam ir šādas īpašības:

Īpašība Type Apraksts
trends string Ignorēt vienuma prototipa tendenču iestatījumu, kas ir laika vienība, cik ilgi tendenču dati ir jāglabā. Pieņem arī lietotāja makrosu un LLD makrosu.

Īpašības darbība:
- required
LLD noteikuma ignorēšanas operācijas trigera nopietnība

LLD noteikuma ignorēšanas operācijas trigera nopietnības vērtība, kas tiek iestatīta atklātajam trigerim. Tai ir šādas īpašības:

Īpašība Tips Apraksts
severity integer Ignorēt trigera prototipa nopietnību.

Iespējamās vērtības:
0 - (noklusējums) nav klasificēts;
1 - informācija;
2 - brīdinājums;
3 - vidējs;
4 - augsts;
5 - katastrofa.

Īpašības darbība:
- obligāts
LLD noteikuma pārrakstīšanas operācijas taga

LLD noteikuma pārrakstīšanas operācijas taga objekts satur taga nosaukumu un vērtību, kas tiek iestatīti atklātajam objektam. Tam ir šādas īpašības:

Property Type Description
tag string Jauns taga nosaukums. Pieņem arī lietotāja makro un LLD makro.

Property behavior:
- required
value string Jauna taga vērtība. Pieņem arī lietotāja makro un LLD makro.
LLD noteikuma ignorēšanas darbības veidne

LLD noteikuma ignorēšanas darbības veidnes objekts, kas ir saistīts ar atklāto hostu. Tam ir šādas īpašības:

Īpašība Type Apraksts
templateid ID Ignorē hosta prototipa saistīto veidņu veidni.

Īpašības darbība:
- obligāts
LLD noteikuma ignorēšanas darbības inventarizācija

LLD noteikuma ignorēšanas darbības inventarizācijas režīma vērtība, kas ir iestatīta atklātajam hostam. Tai ir šādas īpašības:

Īpašība Tips Apraksts
inventory_mode integer Ignorēt hosta prototipa inventarizācijas režīmu.

Iespējamās vērtības:
-1 - atspējots;
0 - (noklusējums) manuāls;
1 - automātisks.

Īpašības darbība:
- obligāts