1 Vienuma izveide

Pārskats

Lai izveidotu vienumu Zabbix lietotāja saskarnē, rīkojieties šādi:

  • Dodieties uz: Datu ievākšana > Hosts
  • Noklikšķiniet uz Vienumi attiecīgā hosta rindā
  • Noklikšķiniet uz Izveidot vienumu ekrāna augšējā labajā stūrī
  • Veidlapā ievadiet vienuma parametrus

Vienumu var izveidot arī, atverot esošu vienumu, nospiežot pogu Klonēt un pēc tam saglabājot to ar citu nosaukumu.

Konfigurācija

Cilne Vienums satur vispārīgos vienuma atribūtus.

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

Parameter Description
Name Vienuma nosaukums.
Lietotāja makro tiek atbalstīti.
Type Vienuma tips. Skatiet atsevišķas sadaļas par vienuma tipu.
Key Vienuma atslēga (līdz 2048 rakstzīmēm).
Atbalstītās vienuma atslēgas ir atrodamas atsevišķās vienuma tipa sadaļās.
Atslēgai jābūt unikālai viena hosta ietvaros.
Ja atslēgas tips ir 'Zabbix aģents', 'Zabbix aģents (aktīvs)' vai 'Simple check', atslēgas vērtībai jābūt atbalstītai Zabbix aģentam vai Zabbix serverim.
Skatiet arī: pareizais atslēgas formāts.
Type of information Datu tips, kāds tas tiek saglabāts datubāzē pēc konvertēšanas, ja tāda tiek veikta.
Numeric (unsigned) - 64 bitu neparakstīts vesels skaitlis.
Ņemiet vērā, ka peldošā komata vērtība, ja tā tiek saņemta vesela skaitļa vienumam, tiks saīsināta, noņemot decimāldaļu.
Numeric (float) - 64 bitu peldošā komata skaitlis.
Šis tips nodrošina aptuveni 15 ciparu precizitāti un diapazonu no aptuveni -1.79E+308 līdz 1.79E+308 (izņemot PostgreSQL 11 un vecākas versijas).
Tiek atbalstīta arī vērtību saņemšana zinātniskajā pierakstā, piem., 1.23E+7, 1e308, 1.1E-4.
Character - īsi teksta dati.
Log - gari teksta dati ar izvēles žurnāla saistītām īpašībām (timestamp, source, severity, logeventid).
Text - gari teksta dati. Skatiet arī teksta datu ierobežojumus.
Binary - binārs skaitlis (atbalstīts tikai atkarīgajiem vienumiem).
Vienumi, kas atgriež vērtības bināro datu tipā, netiek atbalstīti aprēķināto vienumu formulās vai trigeru izteiksmēs.
Vienuma atslēgām, kas atgriež datus tikai vienā noteiktā formātā, atbilstošais informācijas tips tiek izvēlēts automātiski.
Host interface Izvēlieties hosta saskarni. Šis lauks ir pieejams, rediģējot vienumu hosta līmenī.
Units Ja ir iestatīts vienības simbols, Zabbix veic saņemtās vienuma vērtības pēcapstrādi un parāda to ar norādīto vienības sufiksu.
Atbalstītie vienību simboli ar īpašu formatējumu (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, tiek parādītas, izmantojot līdz trim lielākajām nenulles laika vienībām (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 laika zīmogs, formatēts kā yyyy.mm.dd hh:mm:ss (881764 → 1970-01-11 04:56:04 AM); pareizam formatējumam saņemtajai vienuma vērtībai jābūt Numeric (unsigned).
Citiem vienību simboliem (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 vienības simbolam priekšā ir !, vienību konvertēšana un prefiksu pievienošana tiek atspējota (1024 !B → 1024 B, 61 !s → 61 s).
Vairāk piemēru un informāciju par vienību simboliem un vienību konvertēšanu skatiet sadaļā Vienuma vērtības sufiksi.
Update interval Iegūt jaunu šī vienuma vērtību ik pēc N sekundēm. Maksimāli atļautais atjaunināšanas intervāls ir 86400 sekundes (1 diena).
Tiek atbalstīti laika sufiksi, piem., 30s, 1m, 2h, 1d.
Lietotāja makro tiek atbalstīti.
Viens makro ir jāaizpilda visā laukā. 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 nenulles vērtību. Ja tas ir iestatīts uz '0' un pastāv pielāgots intervāls (elastīgs vai plānots) ar nenulles vērtību, vienums tiks aptaujāts pielāgotā intervāla laikā.
Piezīme, ka pirmā vienuma aptauja pēc tam, kad vienums kļūst aktīvs vai pēc atjaunināšanas intervāla maiņas, var notikt agrāk nekā konfigurētā vērtība.
Jauni vienumi tiks pārbaudīti 60 sekunžu laikā pēc to izveides, ja vien tiem nav plānotais vai elastīgais atjaunināšanas intervāls un Update interval nav iestatīts uz 0.
Esošu pasīvu vienumu var nekavējoties aptaujāt, nospiežot pogu Execute now button.
Custom intervals Varat izveidot pielāgotus noteikumus vienuma pārbaudei:
Flexible - izveido izņēmumu Update interval (intervāls ar citu biežumu).
Scheduling - izveido pielāgotu aptaujas grafiku.
Detalizētu informāciju skatiet sadaļā Custom intervals.
Laukā Interval tiek atbalstīti laika sufiksi, piem., 30s, 1m, 2h, 1d.
Lietotāja makro tiek atbalstīti.
Viens makro ir jāaizpilda visā laukā. Vairāki makro vienā laukā vai makro kopā ar tekstu netiek atbalstīti.
Timeout Iestatiet vienuma pārbaudes noildzi (pieejams atbalstītajiem vienumu tipiem). Izvēlieties noildzes opciju:
Global - tiek izmantota starpniekservera/globalā noildze (tiek parādīta pelēkā Timeout laukā).
Override - tiek izmantota pielāgota noildze (iestatīta laukā Timeout; atļautais diapazons: 1 - 600s). Tiek atbalstīti laika sufiksi, piem., 30s, 1m, un lietotāja makro.
Noklikšķinot uz saites Timeouts, varat konfigurēt starpniekservera noildzes vai globālās noildzes (ja starpniekserveris netiek izmantots). Ņemiet vērā, ka saite Timeouts ir redzama tikai lietotājiem ar Super admin tipu un tiesībām uz Administration > General vai Administration > Proxies lietotāja saskarnes sadaļām.
History Izvēlieties vienu no šiem:
Do not store - vienuma vēsture netiek saglabāta. Noder galvenajiem vienumiem, ja vēsture jāsaglabā tikai atkarīgajiem vienumiem.
Šo iestatījumu nevar pārrakstīt globālie housekeeper iestatījumi.
Store up to - norādiet detalizētās vēstures glabāšanas ilgumu datubāzē (no 1 stundas līdz 25 gadiem). Vecākie dati tiks dzēsti ar housekeeper. Tiek glabāts sekundēs.
Tiek atbalstīti laika sufiksi, piem., 2h, 1d. Tiek atbalstīti lietotāja makro.
Vērtību Store up to var globāli pārrakstīt sadaļā Administration > Housekeeping.
Ja pastāv globāls pārrakstīšanas iestatījums, tiek parādīta oranža informācijas ikona . Novietojot uz tās peles kursoru, tiek parādīts brīdinājuma ziņojums, piem., Overridden by global housekeeper settings (1d).
Ieteicams saglabāt reģistrētās vērtības pēc iespējas īsāku laiku, lai samazinātu vērtību vēstures apjomu datubāzē. Ilgas vērtību vēstures glabāšanas vietā varat ilgāk glabāt trendu datus.
Skatiet arī History and trends.
Trends Izvēlieties vienu no šiem:
Do not store - trendi netiek saglabāti.
Šo iestatījumu nevar pārrakstīt globālie housekeeper iestatījumi.
Store up to - norādiet agregētās (stundu min, max, avg, count) vēstures glabāšanas ilgumu datubāzē (no 1 dienas līdz 25 gadiem). Vecākie dati tiks dzēsti ar housekeeper. Tiek glabāts sekundēs.
Tiek atbalstīti laika sufiksi, piem., 24h, 1d. Tiek atbalstīti lietotāja makro.
Vērtību Store up to var globāli pārrakstīt sadaļā Administration > Housekeeping.
Ja pastāv globāls pārrakstīšanas iestatījums, tiek parādīta oranža informācijas ikona . Novietojot uz tās peles kursoru, tiek parādīts brīdinājuma ziņojums, piem., Overridden by global housekeeper settings (7d).
Piezīme: trendu glabāšana nav pieejama neciparu datiem - character, log un text.
Skatiet arī History and trends.
Value mapping Piemērojiet šim vienumam vērtību kartēšanu. Vērtību kartēšana nemaina saņemtās vērtības, tā ir 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 atstāts tukšs, laika zīmogs tiks iestatīts uz 0 Unix laikā, kas atbilst 1970. gada 1. janvārim.
Piemēram, aplūkojiet šādu rindu no Zabbix aģents ž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 rakstzīmes "p" un ":" ir vietturi un var būt jebkuras rakstzīmes, izņemot "yMdhms".
Populates host inventory field Varat izvēlēties hosta inventāra lauku, kuru aizpildīs vienuma vērtība. Tas darbosies, ja hostam ir iespējota automātiska inventāra aizpildīšana.
Šis lauks nav pieejams, ja Type of information ir iestatīts uz 'Log'.
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.
Kad vienumu atspējojat, 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, rediģējot jau esošu vienumu.

Vienuma tipam specifiskie lauki ir aprakstīti attiecīgajā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 formas galvenē un pāriet uz veidnes līmeni, lai tos rediģētu tur, paturot prātā, ka izmaiņas veidnes līmenī mainīs vienumu visiem hostiem, kuriem veidne ir piesaistīta.

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

Vienuma vērtības priekšapstrāde

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

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īgu laika joslu iestatīšana serverī un starpniekserverī neietekmēs testēšanas rezultātu.

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

Testēšana ir pieejama host un veidnes vienumiem, vienumu prototipiem un zemā 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
  • Datu bāzes monitors
  • HTTP aģents
  • Skripts
  • Pārlūks

Lai testētu vienumu, vienuma konfigurācijas formas apakšā noklikšķiniet uz pogas Testēt. Ņemiet vērā, ka poga Testēt 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 host parametriem (host adrese, ports, testēšana ar serveri/starpniekserveri (starpniekservera nosaukums)) un vienumam specifiskām detaļām (piemēram, SNMPv2 kopiena vai SNMPv3 drošības akreditācijas dati). Šie lauki ir konteksta ziņā atbilstoši:

  • Vērtības tiek aizpildītas iepriekš, ja iespējams, t. i., vienumiem, kuriem nepieciešams aģents, informācija tiek ņemta no atlasītā host aģenta interfeisa.
  • Veidnes vienumiem vērtības jāaizpilda manuāli.
  • Tiek atrisinātas vienkārša teksta makro vērtības.
  • 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., host adreses lauks un starpniekservera lauks ir atspējoti aprēķinātajiem vienumiem)

Lai testētu vienumu, noklikšķiniet uz Get value. Ja vērtība tiek veiksmīgi iegūta, tā aizpildīs lauku 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 iegūtajā vērtībā tiek noteikts "\n\r".

Noklikšķiniet uz Get value and test, lai testētu pirmapstrādi.

No host iegūtās vērtības un testēšanas rezultāti, nosūtot tos uz lietotāja saskarne, tiek saīsināti līdz maksimālajam 512KB izmēram. Ja rezultāts ir saīsināts, tiek parādīta brīdinājuma ikona. Brīdinājuma apraksts tiek parādīts, uzvedot peli virs tā. Ņemiet vērā, ka dati, kas ir lielāki par 512KB, joprojām tiek pilnībā apstrādāti Zabbix serveris.

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

Veiksmīgi iegūtu vērtību no host var izmantot arī, lai testētu pirmapstrā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 jaunai vienuma vērtībai. Atbalstīts tikai pasīvajām pārbaudēm (skatiet sīkāku informāciju).
Ņemiet vērā, ka, nekavējoties pārbaudot vērtību, konfigurācijas kešatmiņa netiek atjaunināta, tādēļ vērtība neatspoguļos pavisam nesenā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.

Teksta datu limiti

Teksta datu limiti ir atkarīgi no datubāzes aizmugursistēmas. Pirms teksta vērtību saglabāšanas datubāzē tās tiek saīsinātas, lai atbilstu datubāzes vērtības tipa limitam:

Datubāze Informācijas veids
Rakstzīme Žurnāls Teksts
MySQL 255 rakstzīmes 65536 baiti 65536 baiti
PostgreSQL 255 rakstzīmes 65536 rakstzīmes 65536 rakstzīmes
SQLite (only Zabbix proxy) 255 rakstzīmes 65536 rakstzīmes 65536 rakstzīmes

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ārtraukt pārbaudi kā neveiksmīgu.

Kad noildze ir 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ē dati veiksmīgi tiek savākti tikai vienam no vairākiem OID).

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

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

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

Noildzes prioritāte

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

No Zabbix serveris vai starpniekserveris konfigurācijas noildze neietekmē pārbaudes, kurām ir iestatītas elastīgas noildzes.

Elastīga taimauta atbalsts

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

Neatbalstītie vienumi

Neatbalstītie vienumi tiek ziņoti ar statusu Not supported un joprojām tiek atkārtoti pārbaudīti atbilstoši to standarta Update interval.

Vienums kļūst neatbalstīts, ja tā vērtību kāda iemesla dēļ nevar iegūt (piem., savienojuma kļūda, nav konfigurētu polleru, kas apstrādātu vienumu). Turklāt vienumi, kas nesaņem vēsturiskos datus, paliek statusā Not supported. Tā ir sagaidāma darbība — vienums pāriet uz statusu 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 vairs nav pieejami vēsturiskie dati. 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ļā triggers calculation time).