Vienuma izveide

Pārskats

Lai izveidotu vienumu Zabbix lietotāja saskarnē, rīkojieties, kā norādīts tālāk:

  1. Atveriet Data collection > Hosts.
  2. Hosts rindā noklikšķiniet uz Items.
  3. Ekrāna augšējā labajā stūrī noklikšķiniet uz Create item.
  4. Veidlapā ievadiet vienuma parametrus.

Varat arī izveidot vienumu, atverot esošu vienumu, noklikšķinot uz pogas Clone un saglabājot to ar citu nosaukumu.

Konfigurācija

Vienums cilnē ir ietverti vispārīgie vienuma atribūti.

Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti.

Parametrs Apraksts
Name Vienuma nosaukums.<br[Tiek atbalstīti lietotāja makro.
Type Vienuma tips. Skatiet atsevišķās vienumu tipu sadaļas.
Key Vienuma atslēga (līdz 2048 rakstzīmēm).
Tiek atbalstītas vienumu atslēgas, kas norādītas atsevišķajās vienumu tipu sadaļās.
Atslēgai ir jābūt unikālai viena hosta ietvaros.
Ja atslēgas tips ir “Zabbix agent”, “Zabbix agent (active)” vai “Simple check”, atslēgas vērtībai ir jābūt atbalstītai Zabbix aģentā vai Zabbix serverī.
Skatiet arī: pareizais atslēgas formāts.
Type of information Datu tips, kas tiek izmantots vienuma vērtības validēšanai un glabāšanai datubāzē, tostarp pēc jebkādas konvertēšanas:
Numeric (unsigned) - 64 bitu vesels skaitlis bez zīmes;
Numeric (float) - 64 bitu peldošā komata skaitlis;
Character - īss teksts;
Log - garš teksts ar žurnāla īpašībām vai bez tām (laikspiedols, avots, nopietnība, žurnāla notikuma ID);
Text - garš teksts;
Binary - binārs skaitlis (tiek atbalstīts tikai atkarīgajiem vienumiem);
JSON - strukturēti JSON dati, kas tiek glabāti datubāzē sākotnējā formātā (netiek atbalstīts aprēķinātajiem vienumiem).
Vienumi, kas atgriež bināra vai JSON datu tipa vērtības, netiek atbalstīti aprēķināto vienumu formulās vai trigeru izteiksmēs.
Glabāšanas ierobežojumus katram datu tipam un datubāzes aizmugursistēmai skatiet sadaļā Vienumu datu ierobežojumi.
Vienumiem, kas atgriež datus vienā noteiktā formātā, atbilstošais datu tips tiek atlasīts automātiski, piemēram, system.cpu.load un system.cpu.util abi atgriež 64 bitu peldošā komata skaitli, tāpēc Numeric (float) tiek atlasīts automātiski.
Host interface Atlasiet hosta saskarni. Šis lauks ir pieejams, rediģējot vienumu hosta līmenī.
Units Ja ir iestatīts mērvienības simbols, Zabbix veic saņemtās vienuma vērtības pēcapstrādi un parāda to ar norādīto mērvienības sufiksu.
Atbalstītie mērvienību simboli ar īpašu formatēšanu (un saņemtās vienuma vērtības → parādītās vērtības piemēri):
B - baiti (1024 → 1 KB)
Bps - baiti sekundē (1024 → 1 KBps)
s - sekundes, attēlotas, izmantojot līdz trim lielākajām vienībām, kas nav nulle (881764 → 10d 4h 56m)
uptime - pagājušais laiks formātā hh:mm:ss vai N days, hh:mm:ss (881764 → 10 days, 04:56:04)
unixtime - Unix laikspiedols, formatēts kā yyyy.mm.dd hh:mm:ss (881764 → 1970-01-11 04:56:04 AM); pareizai formatēšanai saņemtajai vienuma vērtībai ir jābūt Numeric (unsigned).
Citām mērvienībām (piemēram, Hz, W u. c.), ja saņemtā vērtība pārsniedz 1000, tā tiek dalīta ar 1000 un parādīta ar atbilstošu prefiksu (5000 → 5 KHz, 881764 → 881.76 KW).
Ja mērvienības simbola priekšā ir !, mērvienību konvertēšana un prefiksu pievienošana tiek atspējota (1024 !B → 1024 B, 61 !s → 61 s).
Vairāk piemēru un detalizētu informāciju par mērvienību simboliem un mērvienību konvertēšanu skatiet sadaļā Vienuma vērtību sufiksi.
Update interval Iegūt jaunu šī vienuma vērtību ik pēc N sekundēm. Maksimālais atļautais atjaunināšanas intervāls ir 86400 sekundes (1 diena).
Tiek atbalstīti laika sufiksi, piemēram, 30s, 1m, 2h, 1d.
Tiek atbalstīti lietotāja makro.
Vienam makro ir jāaizpilda viss lauks. Vairāki makro vienā laukā vai makro kopā ar tekstu netiek atbalstīti.
Piezīme: Atjaunināšanas intervālu var iestatīt uz “0” tikai tad, ja pastāv pielāgoti intervāli ar vērtību, kas nav nulle. Ja tas ir iestatīts uz “0” un pastāv pielāgots intervāls (elastīgs vai ieplānots) ar vērtību, kas nav nulle, vienums tiks aptaujāts pielāgotā intervāla laikā.
Ņemiet vērā, ka pirmā vienuma aptauja pēc vienuma aktivizēšanas vai pēc atjaunināšanas intervāla maiņas var notikt agrāk par konfigurēto vērtību.
Jauni vienumi tiks pārbaudīti 60 sekunžu laikā pēc to izveides, izņemot gadījumus, kad tiem ir Scheduling vai Flexible atjaunināšanas intervāls un Update interval ir iestatīts uz 0.
Esošu pasīvu vienumu var nekavējoties aptaujāt, nospiežot Execute now pogu.
Custom intervals Varat izveidot pielāgotus noteikumus vienuma pārbaudei:
Flexible - izveidot izņēmumu Update interval (intervālu ar citu biežumu).
Scheduling - izveidot pielāgotu aptaujas grafiku.
Detalizētu informāciju skatiet sadaļā Pielāgotie intervāli.
Interval laukā tiek atbalstīti laika sufiksi, piemēram, 30s, 1m, 2h, 1d.
Tiek atbalstīti lietotāja makro.
Vienam makro ir jāaizpilda viss lauks. Vairāki makro vienā laukā vai makro kopā ar tekstu netiek atbalstīti.
Timeout Iestatiet vienuma pārbaudes taimautu (pieejams atbalstītajiem vienumu tipiem). Atlasiet taimauta opciju:
Global - tiek izmantots starpniekservera vai globālais taimauts (parādīts pelēkotajā Timeout laukā).
Override - tiek izmantots pielāgots taimauts (iestatīts Timeout laukā; atļautais diapazons: 1–600 s). Tiek atbalstīti laika sufiksi, piemēram, 30s, 1m, un lietotāja makro.
Noklikšķinot uz saites Timeouts, varat konfigurēt starpniekservera taimautus vai globālos taimautus (ja starpniekserveris netiek izmantots). Ņemiet vērā, ka saite Timeouts ir redzama tikai lietotājiem ar Super admin tipu un atļaujām piekļūt Administration > General vai Administration > Proxies lietotāja saskarnes sadaļām.
History Atlasiet vienu no opcijām:
Do not store - vienuma vēsture netiek glabāta. Noder galvenajiem vienumiem, ja vēsture ir jāglabā tikai atkarīgajiem vienumiem.
Šo iestatījumu nevar ignorēt globālie housekeeper iestatījumi.
Store up to - norādiet detalizētas vēstures glabāšanas ilgumu datubāzē (no 1 stundas līdz 25 gadiem). Vecākus datus noņems housekeeper. Tiek glabāts sekundēs.
Tiek atbalstīti laika sufiksi, piemēram, 2h, 1d. Tiek atbalstīti lietotāja makro.
Vērtību Store up to var globāli ignorēt sadaļā Administration > Housekeeping.
Ja pastāv globāls ignorējošs iestatījums, tiek parādīta oranža informācijas ikona. Novietojot uz tās peles rādītāju, tiek parādīts brīdinājuma ziņojums, piemēram, Overridden by global housekeeper settings (1d).
Ieteicams ierakstītās vērtības glabāt pēc iespējas īsāku laiku, lai samazinātu vērtību vēstures izmēru datubāzē. Tā vietā, lai glabātu ilgu vērtību vēsturi, varat ilgāk glabāt tendenču datus.
Skatiet arī Vēsture un tendences.
Trends Atlasiet vienu no opcijām:
Do not store - tendences netiek glabātas.
Šo iestatījumu nevar ignorēt globālie housekeeper iestatījumi.
Store up to - norādiet apkopotās vēstures (stundas minimums, maksimums, vidējā vērtība, skaits) glabāšanas ilgumu datubāzē (no 1 dienas līdz 25 gadiem). Vecākus datus noņems housekeeper. Tiek glabāts sekundēs.
Tiek atbalstīti laika sufiksi, piemēram, 24h, 1d. Tiek atbalstīti lietotāja makro.
Vērtību Store up to var globāli ignorēt sadaļā Administration > Housekeeping.
Ja pastāv globāls ignorējošs iestatījums, tiek parādīta oranža informācijas ikona. Novietojot uz tās peles rādītāju, tiek parādīts brīdinājuma ziņojums, piemēram, Overridden by global housekeeper settings (7d).
Piezīme: tendenču glabāšana nav pieejama neciparu datiem - rakstzīmju, žurnāla un teksta datiem.
Skatiet arī Vēsture un tendences.
Value mapping Piemērojiet šim vienumam vērtību kartēšanu. Vērtību kartēšana nemaina saņemtās vērtības, tā paredzēta tikai datu attēlošanai.
Tā darbojas ar Numeric(unsigned), Numeric(float) un Character vienumiem.
Piemēram, “Windows service states”.
Log time format Pieejams tikai Log tipa vienumiem. Atbalstītie vietturi:
y: Gads (1970–2038).
M: Mēnesis (01–12).
d: Diena (01–31).
h: Stunda (00–23).
m: Minūte (00–59).
s: Sekunde (00–59).
Ja lauks ir tukšs, laikspiedols Unix laikā tiks iestatīts uz 0, kas apzīmē 1970. gada 1. janvāri.
Piemēram, aplūkosim šo rindu no Zabbix aģenta žurnālfaila:
“ 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211).”
Tā sākas ar sešām rakstzīmju pozīcijām PID, kam seko datums, laiks un pārējais ziņojums.
Šīs rindas žurnāla laika formāts būtu “pppppp:yyyyMMdd:hhmmss”.
Ņemiet vērā, ka “p” un “:” rakstzīmes ir vietturi un var būt jebkuras rakstzīmes, izņemot “yMdhms”.
Populates host inventory field Varat atlasīt hosta inventāra lauku, kurā tiks ievadīta vienuma vērtība. Tas darbosies, ja hostam ir iespējota automātiska inventāra aizpildīšana un tiek izmantoti Numeric(unsigned), Numeric(float), Character vai Text vienumi.
Description Ievadiet vienuma aprakstu. Tiek atbalstīti lietotāja makro.
Enabled Atzīmējiet izvēles rūtiņu, lai iespējotu vienumu un tas tiktu apstrādāts.
Atspējojot vienumu, tas nekavējoties tiek noņemts no vēstures kešatmiņas (izņemot tā pēdējo vērtību, kas tiek saglabāta žurnāliem).
Latest data Noklikšķiniet uz saites, lai skatītu jaunākos vienuma datus.
Šī saite ir pieejama tikai tad, kad rediģējat jau esošu vienumu.

Vienumu tipiem specifiskie lauki ir aprakstīti atbilstošajās lapās.

Rediģējot esošu veidnes līmeņa vienumu hosta līmenī, vairāki lauki ir tikai lasāmi. Varat izmantot saiti veidlapas galvenē, lai pārietu uz veidnes līmeni un rediģētu laukus tur, ņemot vērā, ka izmaiņas veidnes līmenī mainīs vienumu visiem hostiem, ar kuriem veidne ir saistīta.

Tags cilne ļauj definēt vienuma līmeņa tagus.

Vienuma vērtības priekšapstrāde

Cilne Priekšapstrāde ļauj definēt transformācijas noteikumus saņemtajām vērtībām.

Vienuma testēšana

Lai veiktu vienuma testēšanu, pārliecinieties, ka servera un starpniekservera sistēmas laiks ir sinhronizēts. Ja servera laiks ir aizkavēts, vienuma testēšana var atgriezt kļūdas ziņojumu "The task has been expired." Tomēr atšķirīgi laika joslu iestatījumi serverī un starpniekserverī neietekmēs testēšanas rezultātu.

Ir iespējams testēt vienumu un, ja tas ir pareizi konfigurēts, saņemt atpakaļ reālu vērtību. Testēšanu var veikt pat pirms vienums ir saglabāts.

Testēšana ir pieejama hosts un veidnes vienumiem, vienumu prototipiem un zema līmeņa atklāšanas noteikumiem. Testēšana nav pieejama aktīvajiem vienumiem.

Vienuma testēšana ir pieejama šādiem pasīvajiem vienumu tipiem:

  • Zabbix aģents
  • SNMP aģents (v1, v2, v3)
  • IPMI aģents
  • SSH pārbaudes
  • Telnet pārbaudes
  • JMX aģents
  • Vienkāršās pārbaudes (izņemot icmpping*, vmware.* vienumus)
  • Zabbix iekšējais
  • Aprēķinātie vienumi
  • Ārējās pārbaudes
  • Datubāzes monitors
  • HTTP aģents
  • Skripts
  • Pārlūks

Lai testētu vienumu, vienuma konfigurācijas formas apakšā noklikšķiniet uz pogas Test. Ņemiet vērā, ka poga Test būs atspējota vienumiem, kurus nevar testēt (piemēram, aktīvajām pārbaudēm, izslēgtajām vienkāršajām pārbaudēm).

Vienuma testēšanas formai ir lauki nepieciešamajiem hosts parametriem (hosta adrese, ports, testēt ar serveri/starpniekserveri (starpniekservera nosaukums)) un vienumam specifiskām detaļām (piemēram, SNMPv2 kopienai vai SNMPv3 drošības akreditācijas datiem). Šie lauki ir konteksta ziņā atbilstoši:

  • Vērtības, ja iespējams, tiek aizpildītas iepriekš, t. i., vienumiem, kuriem nepieciešams aģents, izmantojot informāciju no izvēlētās hosta aģenta saskarnes.
  • Veidnes vienumiem vērtības jāaizpilda manuāli.
  • Vienkārša teksta makro vērtības tiek atrisinātas.
  • Lauki, kuros vērtība (vai daļa no vērtības) ir noslēpums vai Vault makro, ir tukši un jāievada manuāli. Ja kāds vienuma parametrs satur noslēpuma makro vērtību, tiek parādīts šāds brīdinājuma ziņojums: "Item contains user-defined macros with secret values. Values of these macros should be entered manually."
  • Lauki tiek atspējoti, ja tie nav nepieciešami konkrētā vienuma tipa kontekstā (piemēram, hosta adreses lauks un starpniekservera lauks ir atspējoti aprēķinātajiem vienumiem)

Lai testētu vienumu, noklikšķiniet Get value. Ja vērtība tiek veiksmīgi izgūta, tā tiks ievietota laukā Value, pārvietojot pašreizējo vērtību (ja tāda ir) uz lauku Previous value, vienlaikus aprēķinot lauku Prev. time, t. i., laika starpību starp abām vērtībām (klikšķiem), un mēģinot noteikt EOL secību un pārslēgties uz CRLF, ja izgūtajā vērtībā tiek noteikts "\n\r".

Noklikšķiniet Get value and test, lai testētu priekšapstrādi.

No hosta izgūtās vērtības un testēšanas rezultāti, nosūtot uz lietotāja saskarni, tiek saīsināti līdz maksimālajam 512KB lielumam. Ja testēšanas rezultāts ir saīsināts, tiek parādīta brīdinājuma ikona; novietojiet kursoru virs tās, lai skatītu detalizētu informāciju. Ja vērtība ir saīsināta, secīgos testos, kuros tiek salīdzinātas lielas vērtības (piemēram, JSON), var neizdoties datu tipa validācija; šādos gadījumos tiek parādīts kļūdas ziņojums. Ņemiet vērā, ka dati, kas ir lielāki par 512KB, Zabbix serveris joprojām apstrādā pilnībā.

Ja konfigurācija ir nepareiza, tiek parādīts kļūdas ziņojums, kurā aprakstīts iespējamais iemesls.

Veiksmīgi izgūtu vērtību no hosta var izmantot arī, lai testētu priekšapstrādes soļus.

Veidlapas pogas

Pogas veidlapas apakšdaļā ļauj veikt vairākas darbības.
Pievienot vienumu. Šī poga ir pieejama tikai jauniem vienumiem.
Atjaunināt vienuma rekvizītus.
Izveidot citu vienumu, pamatojoties uz pašreizējā vienuma rekvizītiem.
Nekavējoties izpildīt pārbaudi, lai iegūtu jaunu vienuma vērtību. Atbalstītas tikai pasīvās pārbaudes (skatiet papildinformāciju).
Piezīme: nekavējoties pārbaudot vērtību, konfigurācijas kešatmiņa netiek atjaunināta, tādēļ vērtība neatspoguļos pavisam nesen veiktās izmaiņas vienuma konfigurācijā.
Pārbaudīt, vai vienuma konfigurācija ir pareiza, iegūstot vērtību.
Dzēst vienuma vēsturi un tendences.
Dzēst vienumu.
Atcelt vienuma rekvizītu rediģēšanu.

Vienumu datu limiti

Vienumu datu limiti ir atkarīgi no vienuma datu tipa un datubāzes aizmugursistēmas.

Skaitliskās (bez zīmes) vērtības tiek saglabātas tādas, kādas tās ir. Ja tiek saņemta peldošā komata vērtība, tiek saglabāta tikai vesela daļa (piem., 1.23 → 1).

Skaitliskās (float) vērtības tiek saglabātas tādas, kādas tās ir, un atbalsta aptuveni 15 līdz 17 ciparu precizitāti ar diapazonu aptuveni no -1.79E+308 līdz 1.79E+308. Tiek atbalstītas arī vērtības zinātniskajā pierakstā (piem., 1.23E+7, 1e308, 1.1E-4).

Teksta vērtības pirms saglabāšanas tiek saīsinātas, lai atbilstu datubāzes vērtības tipa ierobežojumam:

Database Type of information
Character Log Text
MySQL 255 rakstzīmes 65536 baiti 65536 baiti
PostgreSQL 255 rakstzīmes 65536 rakstzīmes 65536 rakstzīmes
SQLite (only Zabbix starpniekserveris) 255 rakstzīmes 65536 rakstzīmes 65536 rakstzīmes

Binārās vērtības ir ierobežotas līdz 16 MiB (16777216 baitiem). Vērtības, kas pārsniedz šo limitu, tiek atmestas, un lietotāja saskarnē tiek parādīta atbilstoša kļūda.

Vērtības ar JSON datu tipu ir ierobežotas līdz 128 MiB (134217728 baitiem). Vērtības, kas pārsniedz šo limitu, tiek atmestas, un lietotāja saskarnē tiek parādīta atbilstoša kļūda. MySQL/MariaDB gadījumā apsveriet iespēju iestatīt dienas nodalījumus tabulai history_json (kas tiek izmantota JSON vērtību glabāšanai), jo tā var ātri kļūt liela un uz ilgu laiku bloķēt housekeeper. Ja jūsu lietošanas scenārijā ir lielas JSON vērtības (1 MiB vai vairāk), skatiet, kā konfigurēt sistēmu lielu JSON vērtību atbalstam.

Kad Zabbix raksta jebkādus vienuma datus datubāzē, tas izmanto INSERT vaicājumus un tos reģistrē (ja DebugLevel ir iestatīts uz 4 vai 5). Lieli žurnāla ieraksti tiek saīsināti līdz 64 KB.

Pielāgota skripta ierobežojums

Pieejamais pielāgotā skripta garums ir atkarīgs no izmantotās datubāzes:

Datubāze Ierobežojums rakstzīmēs Ierobežojums baitos
MySQL 65535 65535
PostgreSQL 65535 nav ierobežots
SQLite (tikai Zabbix starpniekserveris) 65535 nav ierobežots

Vienuma noildze

Vienuma noildze nosaka, cik ilgi Zabbix jāgaida, pirms pārbaude tiek pārtraukta kā neveiksmīga.

Kad noildze tiek sasniegta, pārbaude tiek pārtraukta pat tad, ja datu izgūšana vēl nav pabeigta. Ja dati tiek saņemti daļēji, vienums kļūst neatbalstīts, un tiek reģistrēts kļūdas ziņojums (piemēram, ja SNMP pārbaudē veiksmīgi tiek savākti dati tikai vienam no vairākiem OID).

Daudziem vienumu tipiem var iestatīt elastīgas vienumu noildzes:

  • vienam atsevišķam vienumam
  • vienumu tipam (starpniekservera līmenī)
  • vienumu tipam (globālā līmenī)

Pielāgota noildze vienam atsevišķam vienumam ir noderīga, ja vēlaties norādīt garāku noildzi konkrētam vienumam, vienlaikus saglabājot īsas noildzes citiem vienumiem.

Noildzes prioritāte

  1. Viena atsevišķa vienuma noildze pārraksta jebkuras citas noildzes.
  2. Starpniekservera līmeņa noildzes pārraksta globālās noildzes.

Zabbix serveris vai starpniekserveris konfigurācijā norādītajai noildzei nav nozīmes pārbaudēs, kurām ir iestatītas elastīgas noildzes.

Elastīga taimauta atbalsts

Elastīgi vienuma taimauti tiek atbalstīti šādiem vienumu tipiem:

Neatbalstīti vienumi

Par neatbalstītiem vienumiem tiek ziņots ar statusu Not supported, un tie joprojām tiek atkārtoti pārbaudīti to standarta Update interval laikā.

Vienums kļūst neatbalstīts, ja kāda iemesla dēļ nevar izgūt tā vērtību (piemēram, savienojuma kļūda, nav konfigurētu aptaujātāju, kas apstrādātu vienumu). Turklāt vienumi, kas nesaņem vēsturiskos datus, paliek statusā Not supported. Tā ir paredzēta darbība — vienums pāriet statusā Normal tikai tad, kad tas saņem jaunus, derīgus vēsturiskos datus.

Tāpat kā problēmas, neatbalstītie vienumi tiek pārvērtēti tikai tad, kad tiek saņemti jauni dati — pat ja šim vienumam vēsturiskie dati vairs nav pieejami. Citiem vārdiem sakot, vienumi un trigeri maina savu stāvokli tikai pēc jaunu datu saņemšanas. Tomēr, ja trigera izteiksme ietver date and time un/vai nodata() funkciju, trigeris tiks pārrēķināts ik pēc 30 sekundēm (sīkāku informāciju skatiet sadaļā trigeru aprēķināšanas laiks).