- LLD noteikuma prototipa objekts
- LLD kārtulas prototips
- HTTP galvene
- HTTP vaicājuma lauks
- Telemetrijas vaicājums
- Telemetrijas datu kolonnas
- Telemetrijas datu apkopoto kolonnu objekts
- Telemetrijas datu filtrs
- LLD noteikuma prototipa filtrs
- LLD makro ceļš
- LLD kārtulas prototipa priekšapstrāde
- LLD noteikuma prototipa pārrakstīšanas
- LLD noteikuma prototipa ignorēšanas filtrs
- LLD noteikuma prototipa pārrakstīšanas operācija
- LLD noteikuma prototipa ignorēšanas operācijas statuss
- LLD kārtulas prototipa ignorēšanas operācijas atklāšanas statuss
- LLD kārtulas prototipa ignorēšanas darbības periods
- LLD noteikuma prototipa ignorēšanas operācijas vēsture
- LLD noteikuma prototipa ignorēšanas operācijas tendenču iestatījumi
- LLD kārtulas prototipa ignorēšanas operācijas trigera nopietnība
- LLD noteikuma prototipa ignorēšanas operācijas tags
- LLD noteikuma prototipa ignorēšanas darbības veidne
- LLD noteikuma prototipa ignorēšanas darbības inventarizācija
- LLD kārtulas prototips
LLD noteikuma prototipa objekts
Tālāk norādītie objekti ir tieši saistīti ar discoveryruleprototype API.
LLD kārtulas prototips
Zema līmeņa atklāšanas kārtulas prototipa objektam ir tālāk norādītie rekvizīti.
| Property | Type | Description |
|---|---|---|
| itemid | ID | LLD kārtulas prototipa ID. Rekvizīta darbība: - tikai lasāms - obligāts atjaunināšanas darbībām |
| ruleid | ID | Vecākās LLD kārtulas/LLD kārtulas prototipa ID. Rekvizīta darbība: - tikai lasāms - obligāts izveides darbībām |
| delay | string | LLD kārtulas prototipa 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īgu un plānošanas intervālu kombinācija.Atbalsta lietotāja makro. Ja tas tiek izmantots, 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 ar slīpsvītru atdalītus makro (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 | Hosts ID, kuram pieder LLD kārtulas prototips. Rekvizīta darbība: - nemainīgs - obligāts izveides darbībām |
| flags | integer | LLD kārtulas prototipa izcelsme. Iespējamās vērtības: 3 - zema līmeņa atklāšanas kārtulas prototips; 7 - atklāts zema līmeņa atklāšanas kārtulas prototips. Rekvizīta darbība: - tikai lasāms |
| interfaceid | ID | LLD kārtulas prototipa hosts saskarnes ID. Rekvizīta darbība: - obligāts, ja LLD kārtulas prototips pieder hostam un type ir iestatīts uz "Zabbix agent", "IPMI agent", "JMX agent" vai "SNMP agent"- atbalstīts, ja LLD kārtulas prototips pieder hostam un type ir iestatīts uz "Simple check", "External check", "SSH agent", "TELNET agent" vai "HTTP agent" |
| key_ | string | LLD kārtulas prototipa atslēga. Nepieciešams vismaz viens LLD makro. Rekvizīta darbība: - obligāts izveides darbībām - tikai lasāms mantotiem objektiem |
| name | string | LLD kārtulas prototipa nosaukums. Rekvizīta darbība: - obligāts izveides darbībām - tikai lasāms mantotiem objektiem |
| type | integer | LLD kārtulas prototipa 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; 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ību aizpildīt 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 - pamata; 2 - NTLM. 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 kārtulas prototipa apraksts. |
| error | string | Kļūdas teksts, ja rodas problēmas ar LLD kārtulas prototipa vērtības atjaunināšanu. Rekvizīta darbība: - tikai lasāms |
| follow_redirects | integer | Sekot atbildes novirzēm datu aptaujas laikā. 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 vienumi, kas vairs netiek atklāti, tiks dzēsti. 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: 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 ilguma sliekšņa sasniegšanas; 1 - nedzēst; 2 - dzēst nekavējoties. |
| enabled_lifetime | string | Laika periods, pēc kura vienumi, kas vairs netiek atklāti, tiks atspējoti. 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 ilguma sliekšņa sasniegšanas; 1 - neatspējot; 2 - (noklusējums) atspējot nekavējoties. |
| master_itemid | ID | Galvenā vienuma ID. Atklāšanas kārtula nevar būt galvenais vienums citai atklāšanas kārtulai. 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 kārtulas prototipa tipa: - izpildāmais skripts SSH un Telnet LLD kārtulām; - SQL vaicājums datubāzes pārraudzības LLD kārtulām; - formula aprēķinātām LLD kārtulām; - skripts skripta un pārlūka LLD kārtulām. 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 | Parole autentifikācijai. 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 kārtulas prototipa 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 kārtulas prototipa statuss. Iespējamās vērtības: 0 - (noklusējums) iespējots LLD kārtulas prototips; 1 - atspējots LLD kārtulas prototips. |
| 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ākās veidnes LLD kārtulas prototipa 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). Atbalsta arī lietotāja makro.Iespējamais 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 |
| 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 | Lietotājvārds autentifikācijai. 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 kārtulu prototipu sasaistīšanai ar jau esošajiem. Ja nav norādīts, tiek ģenerēts automātiski. Rekvizīta darbība: - atbalstīts, ja LLD kārtulas prototips pieder veidnei |
| verify_host | integer | Vai pārbaudīt, ka savienojuma hosts nosaukums atbilst hosts sertifikātā norādītajam. 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 kārtulas prototips 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). Atbalsta arī lietotāja makro un LLD makro.Iespējamais 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 kārtulas prototipa pirmajā izpildes reizē); - 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). Atbalsta arī lietotāja makro un LLD makro.Iespējamais 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 | Tvertnes 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). Atbalsta arī lietotāja makro un LLD makro.Vērtība nedrīkst būt lielāka par lookback_limit.Iespējamais 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.
| Property | Type | Description |
|---|---|---|
| signal_type | integer | Signāla tips, ko vaicā LLD noteikuma prototips. Iespējamās vērtības: 0 - Traces; 1 - Metrics; 2 - Logs. Rekvizīta darbība: - required |
| metric_point_type | integer | Metrikas punkta tips, ko vaicā LLD noteikuma prototips. Iespējamās vērtības: 0 - Sum; 1 - Gauge; 2 - Histogram; 3 - Exponential histogram. Rekvizīta darbība: - required if signal_type is set to "Metrics" |
| columns | array | Telemetrijas datu kolonnu masīvs, ko vaicā LLD noteikuma prototips. Var būt tukšs. Rekvizīta darbība: - required |
| aggregated_columns | array | Telemetrijas datu apkopoto kolonnu masīvs, ko vaicā LLD noteikuma prototips, kā arī veids, kā tas aprēķina vērtību no kolonnu ierakstiem. Rekvizīta darbība: - required |
| filter | object | Telemetrijas vaicājuma filtrs vaicājuma kolonnu ierakstiem. Rekvizīta darbība: - required |
Telemetrijas datu kolonnas
Telemetrijas datu kolonnu objektam ir šādas īpašības.
| Property | Type | Description |
|---|---|---|
| column | string | Telemetrijas datu kolonnas nosaukums, ko vaicā LLD kārtulas prototips. Skatiet atbalstītās telemetrijas datu kolonnas. Vairākām vienas vērtības kolonnām 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 LLD kārtulas prototips vaicā 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 |
Telemetrijas datu apkopoto kolonnu objekts
Telemetrijas datu apkopoto kolonnu objektam ir šādas īpašības.
| Property | Type | Description |
|---|---|---|
| column | string | Telemetrijas datu kolonnas nosaukums, ko vaicā LLD kārtulas prototips. Skatiet atbalstītās telemetrijas datu kolonnas. Ja tiek izmantotas vairākas kolonnas, katrai column vērtībai ir jābūt unikālai.Šis rekvizīts netiek atbalstīts, ja function ir iestatīts uz "Count".Rekvizīta darbība: - obligāts, ja function ir iestatīts uz "Min", "Max", "Average", "Sum" vai "Percentile" |
| function | integer | Funkcija, ko LLD kārtulas prototips lieto kolonnas ierakstiem. Iespējamās vērtības: 1 - Min; 2 - Max; 3 - Average; 4 - Count; 5 - Sum; 8 - Percentile. Rekvizīta darbība: - obligāts |
| parameters | array | Procentile, ko LLD kārtulas prototips aprēķina no kolonnas ierakstiem. Iespējamā vērtība: skaitlis no 0 līdz 100, kas norādīts kā virkne. Rekvizīta darbība: - obligāts, ja function ir iestatīts uz "Percentile" |
| alias | string | Unikāls aprēķinātās vērtības nosaukums, ko izmanto tās identificēšanai LLD kārtulas prototipa vērtībā. Katrai alias vērtībai ir jābūt unikālai, un tā nedrīkst būt clock.Rekvizīta darbība: - obligāts |
Telemetrijas datu filtrs
Telemetrijas datu filtra objektam ir šādas īpašības.
| Property | Type | Description |
|---|---|---|
| conditions | array | Telemetrijas datu filtra nosacījumi, kuriem jāatbilst ierakstam telemetrijas datu kolonnā. Īpašības 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 - Pielāgota izteiksme. Īpašības darbība: - obligāts |
| 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, izmantojot 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āms |
| formula | string | Lietotāja definēta izteiksme, kas jāizmanto filtru nosacījumu ar pielāgotu izteiksmi novērtēšanai. Izteiksmei jāsatur ID, kas atsaucas uz konkrētiem filtra nosacījumiem, izmantojot to formulaid. Izteiksmē izmantotajiem ID ir precīzi jāatbilst filtra nosacījumos definētajiem ID: neviens nosacījums nedrīkst palikt neizmantots vai tikt izlaists.Īpašības darbība: - obligāts, ja evaltype ir iestatīts uz “Pielāgota izteiksme” |
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 Telemetry query filter objekta evaltype ir iestatīts uz “Custom expression” |
LLD noteikuma prototipa filtrs
LLD noteikuma prototipa 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 prototipa filtra nosacījums
LLD noteikuma prototipa filtra nosacījuma objekts definē atsevišķu pārbaudi, kas jāveic LLD makro vērtībai. Tam ir šādas īpašības:
| Īpašība | Tips | Apraksts |
|---|---|---|
| macro | string | LLD makro, kuram jāveic pārbaude. Īpašības darbība: - obligāta |
| value | string | Vērtība, ar ko salīdzināt. Īpašības darbība: - obligāta, 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. Tas var saturēt tikai lielos burtus. ID lietotājam jānorāda, modificējot filtra nosacījumus, taču pēc tam, pieprasot tos atkārtoti, tas tiks ģenerēts no jauna. Īpašības darbība: - obligāta, ja LLD noteikuma prototipa 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 discoveryruleprototype.get un discoveryruleprototype.create lapās.
LLD makro ceļš
LLD makro ceļam ir šādas īpašības:
| Īpašība | Type | Apraksts |
|---|---|---|
| lld_macro | string | LLD makro. Īpašības darbība: - required |
| path | string | Selektors vērtībai, kas tiks piešķirta atbilstošajam makro. Īpašības darbība: - required |
LLD kārtulas prototipa priekšapstrāde
LLD kārtulas prototipa priekšapstrādes objektam ir šādi rekvizīti.
| Rekvizīts | Tips | Apraksts |
|---|---|---|
| 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: - obligāts |
| params | string | Papildu parametri, kas tiek izmantoti priekšapstrādes opcijai. Vairāki parametri tiek atdalīti ar jaunās rindas (\n) rakstzīmi. Rekvizīta darbība: - obligāts, 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: - obligāts, 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: - obligāts, 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.
| Priekšapstrādes tips | Nosaukums | 1. parametrs | 2. parametrs | 3. parametrs | Atbalstītie kļūdu apstrādātāji |
|---|---|---|---|---|---|
| 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 makro
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 makro.
7 Atbalsta vairākus "Field name,OID prefix,Format records" ierakstus, kas atdalīti ar jaunās rindas rakstzīmi.
LLD noteikuma prototipa pārrakstīšanas
LLD noteikuma prototipa 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 | Type | 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 prototipa ignorēšanas filtrs
LLD noteikuma prototipa ignorēšanas filtra objekts definē nosacījumu kopu, kuru atbilstības gadījumā 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 - And/Or; 1 - And; 2 - Or; 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 prototipa ignorēšanas filtra nosacījums
LLD noteikuma prototipa ignorēšanas filtra nosacījuma objekts definē atsevišķu pārbaudi, kas jāveic LLD makro vērtībai. Tam ir šādas īpašības:
| Īpašība | Tips | Apraksts |
|---|---|---|
| macro | string | LLD makro, kuram jāveic pārbaude. Īpašības darbība: - obligāta |
| value | string | Vērtība, ar ko salīdzināt. Īpašības darbība: - obligāta, 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 drīkst saturēt tikai lielos burtus. ID lietotājam jādefinē, modificējot filtra nosacījumus, taču pēc tam, pieprasot tos atkārtoti, tas tiks ģenerēts no jauna. Īpašības darbība: - obligāta, ja LLD noteikuma prototipa 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 prototipa pārrakstīšanas operācija
LLD noteikuma prototipa pārrakstīšanas operācija ir nosacījumu un darbību kombinācija, ko izpilda ar prototipa objektu. Tai ir šādas īpašības:
| Īpašība | Type | Apraksts |
|---|---|---|
| operationobject | integer | Atklātā objekta tips, kuram izpildīt darbību. Iespējamās vērtības: 0 - vienuma prototips; 1 - trigera prototips; 2 - grafika prototips; 3 - hosta prototips. Īpašības darbība: - obligāts |
| operator | integer | Pārrakstīš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, lai atbilstu vienuma, trigera, grafika vai hosta prototipa nosaukumam atkarībā no izvēlētā objekta. |
| opstatus | object | Pārrakstīšanas operācijas statusa objekts vienuma, trigera un hosta prototipa objektiem. |
| opdiscover | object | Pārrakstīšanas operācijas atklāšanas statusa objekts (visiem objektu tipiem). |
| opperiod | object | Pārrakstīšanas operācijas perioda (atjaunināšanas intervāla) objekts vienuma prototipa objektam. |
| ophistory | object | Pārrakstīšanas operācijas vēstures objekts vienuma prototipa objektam. |
| optrends | object | Pārrakstīšanas operācijas tendenču objekts vienuma prototipa objektam. |
| opseverity | object | Pārrakstīšanas operācijas nopietnības objekts trigera prototipa objektam. |
| optag | object/array | Pārrakstīšanas operācijas taga objekts trigera un hosta prototipa objektiem. |
| optemplate | object/array | Pārrakstīšanas operācijas veidnes objekts hosta prototipa objektam. |
| opinventory | object | Pārrakstīšanas operācijas inventāra objekts hosta prototipa objektam. |
LLD noteikuma prototipa ignorēšanas operācijas statuss
LLD noteikuma prototipa 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: - obligāts |
LLD kārtulas prototipa ignorēšanas operācijas atklāšanas statuss
LLD kārtulas prototipa 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 atlasītā objekta atklāšanas statusu. 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 prototipa ignorēšanas darbības periods
LLD kārtulas prototipa 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 prototipa ignorēšanas operācijas vēsture
LLD noteikuma prototipa ignorēšanas operācijas vēstures vērtība, kas ir iestatīta atklātajam vienumam. Tai ir šādas īpašības:
| Īpašība | Type | Apraksts |
|---|---|---|
| history | string | Ignorēt vienuma prototipa vēsturi, kas ir laika vienība, cik ilgi jāglabā vēstures dati. Pieņem arī lietotāja makrosu un LLD makrosu. Īpašības darbība: - required |
LLD noteikuma prototipa ignorēšanas operācijas tendenču iestatījumi
LLD noteikuma prototipa ignorēšanas operācijas tendenču vērtība, kas tiek iestatīta atklātajam vienumam. Tai ir šādas īpašības:
| Īpašība | Type | Apraksts |
|---|---|---|
| trends | string | Ignorē vienuma prototipa tendenču iestatījumu, kas ir laika vienība, cik ilgi tendenču dati jāglabā. Pieņem arī lietotāja makrosu un LLD makrosu. Īpašības darbība: - obligāts |
LLD kārtulas prototipa ignorēšanas operācijas trigera nopietnība
LLD kārtulas prototipa 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 prototipa ignorēšanas operācijas tags
LLD noteikuma prototipa ignorēšanas operācijas taga objekts satur taga nosaukumu un vērtību, kas tiek iestatīti atklātajam objektam. Tam ir šādas īpašības:
| Īpašība | Type | Apraksts |
|---|---|---|
| tag | string | Jaunais taga nosaukums. Īpašības darbība: - obligāts |
| value | string | Jaunā taga vērtība. |
LLD noteikuma prototipa ignorēšanas darbības veidne
LLD noteikuma prototipa 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 prototipa ignorēšanas darbības inventarizācija
LLD noteikuma prototipa ignorēšanas darbības inventarizācijas režīma vērtība, kas tiek iestatīta atklātajam hostam. Tai ir šādas īpašības:
| Īpašība | Type | 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 |