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.

Parametrs Apraksts
Name Vienuma nosaukums.
Tiek atbalstīti lietotāja makrosi.
Type Vienuma tips. Skatiet atsevišķās vienumu tipu sadaļas.
Key Vienuma atslēga (līdz 2048 rakstzīmēm).
Atbalstītās vienumu atslēgas var atrast atsevišķās vienumu tipu sadaļās.
Atslēgai 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 jābūt atbalstītai Zabbix aģentā vai Zabbix serverī.
Skatiet arī: pareizais atslēgas formāts.
Type of information Datu tips, ko izmanto vienuma vērtības validēšanai un glabāšanai datubāzē, arī pēc jebkādām konversijām:
Numeric (unsigned) - 64 bitu neparakstīts vesels skaitlis;
Numeric (float) - 64 bitu peldošā komata skaitlis;
Character - īss teksts;
Log - garš teksts ar vai bez žurnāla īpašībām (laika zīmogs, avots, svarīgums, žurnāla notikuma ID);
Text - garš teksts;
Binary - binārs skaitlis (atbalstīts tikai atkarīgajiem vienumiem);
JSON - strukturēti JSON dati, kas datubāzē tiek glabāti natīvi (nav atbalstīts aprēķinātajiem vienumiem).
Vienumi, kas atgriež vērtības ar bināro vai JSON datu tipu, netiek atbalstīti aprēķināto vienumu formulās vai trigeru izteiksmēs.
Skatiet vienuma datu ierobežojumus, lai uzzinātu glabāšanas ierobežojumus katram datu tipam un datubāzes aizmugursistēmai.
Vienumiem, kas atgriež datus vienā konkrētā formātā, atbilstošais datu tips tiek izvēlē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 izvēlē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 piemēro pēcapstrādi saņemtajai vienuma vērtībai un attēlo to ar norādīto mērvienības sufiksu.
Atbalstītie mērvienību simboli ar īpašu formatējumu (un saņemtās vienuma vērtības → attēlotās vērtības piemēriem):
B - baiti (1024 → 1 KB)
Bps - baiti sekundē (1024 → 1 KBps)
s - sekundes, attēlotas, izmantojot līdz trim lielākajām nenulles laika vienībām (881764 → 10d 4h 56m)
uptime - pagājušais laiks hh:mm:ss vai N days, hh:mm:ss formātā (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).
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 attēlota ar atbilstošu prefiksu (5000 → 5 KHz, 881764 → 881.76 KW).
Ja mērvienības simbolam priekšā ir !, mērvienību konvertēšana un prefiksu pievienošana tiek atspējota (1024 !B → 1024 B, 61 !s → 61 s).
Lai skatītu vairāk piemēru un detalizētu informāciju par mērvienību simboliem un mērvienību konvertēšanu, skatiet Vienuma vērtību sufiksi.
Update interval Iegūt jaunu vērtību šim vienumam 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ēram, 30s, 1m, 2h, 1d.
Tiek atbalstīti lietotāja makrosi.
Vienam makrosam jāaizpilda viss lauks. Vairāki makrosi vienā laukā vai makrosi 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 plānots) ar vērtību, kas nav nulle, vienums tiks aptaujāts pielāgotā intervāla darbības laikā.
Ņemiet vērā, 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 Scheduling vai Flexible atjaunināšanas intervāla un Update interval nav iestatīts uz 0.
Esošu pasīvu vienumu var nekavējoties aptaujāt, nospiežot pogu Execute now.
Custom intervals Varat izveidot pielāgotus noteikumus vienuma pārbaudei:
Flexible - izveidot izņēmumu Update interval vērtībai (intervāls 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 makrosi.
Vienam makrosam jāaizpilda viss lauks. Vairāki makrosi vienā laukā vai makrosi kopā ar tekstu netiek atbalstīti.
Timeout Iestatiet vienuma pārbaudes noildzi (pieejama atbalstītajiem vienumu tipiem). Atlasiet noildzes opciju:
Global - tiek izmantota starpniekservera/globālā noildze (attēlota pelēkajā Timeout laukā).
Override - tiek izmantota pielāgota noildze (iestatīta Timeout laukā; atļautais diapazons: 1 - 600s). Tiek atbalstīti laika sufiksi, piemēram, 30s, 1m, un lietotāja makrosi.
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 Super admin tipa lietotājiem ar atļaujām uz lietotāja saskarnes sadaļām Administration > General vai Administration > Proxies.
History Atlasiet vienu no iespējām:
Do not store - vienuma vēsture netiek glabāta. Noderīgi galvenajiem vienumiem, ja vēsture jāsaglabā tikai atkarīgajiem vienumiem.
Šo iestatījumu nevar pārrakstīt ar globālajiem housekeeper iestatījumiem.
Store up to - norādiet, cik ilgi datubāzē glabāt detalizēto vēsturi (no 1 stundas līdz 25 gadiem). Vecākie dati tiks noņemti ar housekeeper. Tiek glabāts sekundēs.
Tiek atbalstīti laika sufiksi, piemēram, 2h, 1d. Tiek atbalstīti lietotāja makrosi.
Store up to vērtību var globāli pārrakstīt sadaļā Administration > Housekeeping.
Ja pastāv globāls pārrakstošs iestatījums, tiek attēlota oranža informācijas ikona . Novietojot peles kursoru virs tās, tiek parādīts brīdinājuma ziņojums, piemēram, Overridden by global housekeeper settings (1d).
Ieteicams saglabāt ierakstītās vērtības pēc iespējas īsāku laiku, lai samazinātu vērtību vēstures apjomu 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 iespējām:
Do not store - tendences netiek glabātas.
Šo iestatījumu nevar pārrakstīt ar globālajiem housekeeper iestatījumiem.
Store up to - norādiet, cik ilgi datubāzē glabāt agregēto (stundas minimums, maksimums, vidējais, skaits) vēsturi (no 1 dienas līdz 25 gadiem). Vecākie dati tiks noņemti ar housekeeper. Tiek glabāts sekundēs.
Tiek atbalstīti laika sufiksi, piemēram, 24h, 1d. Tiek atbalstīti lietotāja makrosi.
Store up to vērtību var globāli pārrakstīt sadaļā Administration > Housekeeping.
Ja pastāv globāls pārrakstošs iestatījums, tiek attēlota oranža informācijas ikona. Novietojot peles kursoru virs tās, 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 neskaitliskiem datiem - character, log un text.
Skatiet arī Vēsture un tendences.
Value mapping Piemērot vērtību kartēšanu šim vienumam. 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 lauks tiek atstāts tukšs, laika zīmogs Unix laikā tiks iestatīts uz 0, kas atbilst 1970. gada 1. janvārim.
Piemēram, apsveriet šādu rindu no Zabbix aģenta žurnāla faila:
" 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 atlasīt hosta inventāra lauku, kuru aizpildīs 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 un Text vienumi.
Description Ievadiet vienuma aprakstu. Tiek atbalstīti lietotāja makrosi.
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.

Vienuma tipam 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 formas galvenē, lai pārietu uz veidnes līmeni un rediģētu tos 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 sistēmas laiks serverī un starpniekserverī ir sinhronizēts. Ja servera laiks atpaliek, 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 konfigurēts pareizi, saņemt reālu vērtību. Testēšanu var veikt pat pirms vienums ir saglabāts.

Testēšana ir pieejama hostu un veidņu vienumiem, vienumu prototipiem un zema līmeņa atklāšanas kārtulām. Testēšana nav pieejama aktīvajiem vienumiem.

Vienuma testēšana ir pieejama šādiem pasīvo 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šējie
  • Aprēķinātie vienumi
  • Ārējās pārbaudes
  • Datubāzes monitors
  • HTTP aģents
  • Skripts
  • Pārlūks

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

Vienuma testēšanas forma satur laukus nepieciešamajiem hosta parametriem (hosta adrese, ports, testēšana ar serveri/starpniekserveri (starpniekservera nosaukums)) un vienumam specifisku informāciju (piemēram, SNMPv2 kopienu vai SNMPv3 drošības akreditācijas datus). Šie lauki ir atkarīgi no konteksta:

  • Vērtības tiek aizpildītas automātiski, kad tas ir iespējams, piemēram, vienumiem, kuriem nepieciešams aģents, izmantojot informāciju no hosta izvēlētās aģenta saskarnes.
  • Veidņu 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 tās daļa) ir slepens vai Vault makro, ir tukši un jāaizpilda manuāli. Ja kāds vienuma parametrs satur slepena 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 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), kā arī mēģinot noteikt EOL secību un pārslēgties uz CRLF, ja iegūtajā vērtībā tiek konstatēts "\n\r".

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

No hosta iegūtās vērtības un testēšanas rezultāti tiek saīsināti līdz maksimālajam izmēram 512KB, kad tie tiek nosūtīti uz lietotāja saskarni. Ja testa 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), tā var neizturēt datu tipa validāciju; šādos gadījumos tiek parādīts kļūdas ziņojums. Ņemiet vērā, ka dati, kas ir lielāki par 512KB, joprojām tiek pilnībā apstrādāti Zabbix serverī.

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

Veiksmīgi no hosta iegūtu vērtību 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 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.

Vienumu datu ierobežojumi

Vienumu datu ierobežojumi 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 veselā daļa (piemēram, 1.23 → 1).

Skaitliskās (peldošā komata) vērtības tiek saglabātas tādas, kādas tās ir, un atbalsta aptuveni 15 līdz 17 precizitātes ciparus diapazonā no aptuveni -1.79E+308 līdz 1.79E+308. Tiek atbalstītas arī vērtības zinātniskajā pierakstā (piemēram, 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:

Datubāze Informācijas tips
Rakstzīmes Žurnāls Teksts
MySQL 255 rakstzīmes 65536 baiti 65536 baiti
PostgreSQL 255 rakstzīmes 65536 rakstzīmes 65536 rakstzīmes
SQLite (tikai Zabbix starpniekserveris) 255 rakstzīmes 65536 rakstzīmes 65536 rakstzīmes

Binārās vērtības ir ierobežotas līdz 16MiB (16777216 baitiem). Vērtības, kas pārsniedz šo ierobežojumu, 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 128MiB (134217728 baitiem). Vērtības, kas pārsniedz šo ierobežojumu, tiek atmestas, un lietotāja saskarnē tiek parādīta atbilstoša kļūda. MySQL/MariaDB gadījumā apsveriet iespēju iestatīt ikdienas particionēšanu tabulai history_json (ko izmanto JSON vērtību glabāšanai), jo tā var ātri kļūt ļoti liela un uz ilgāku laiku bloķēt housekeeper. Ja jūsu lietošanas scenārijs ietver lielas JSON vērtības (1MiB vai vairāk), skatiet, kā konfigurēt savu sistēmu lielu JSON vērtību atbalstam.

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

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 tiek sasniegta noildze, pārbaude tiek pārtraukta pat tad, ja datu iegūšana vēl nav pabeigta. Ja dati tiek saņemti tikai daļēji, vienums kļūst neatbalstīts un kļūdas ziņojums tiek ierakstīts žurnālā (piemēram, ja SNMP pārbaudē dati tiek veiksmīgi savākti tikai vienam no vairākiem OID).

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

Pielāgota noildze katram atsevišķam vienumam ir noderīga, ja vēlaties noteikt garāku noildzi konkrētam vienumam, vienlaikus saglabājot zemas noildzes citiem vienumiem.

Noildzes prioritāte

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

Noildze no Zabbix serveris vai starpniekserveris konfigurācijas neietekmē pārbaudes, kurām ir iestatītas elastīgās 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).