1 Vienuma izveide

Pārskats

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

  • Dodieties uz: Data collection > Hosts
  • Noklikšķiniet uz Items hosta rindā
  • Noklikšķiniet uz Create item ekrāna augšējā labajā stūrī
  • Formā ievadiet vienuma parametrus

Vienumu varat izveidot arī, atverot esošu vienumu, noklikšķinot uz pogas Clone un pēc tam 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
Nosaukums Vienuma nosaukums.
Tiek atbalstīti lietotāja makro.
Tips Vienuma tips. Skatiet atsevišķās vienuma tipu sadaļas.
Atslēga Vienuma atslēga (līdz 2048 rakstzīmēm).
Atbalstītās vienumu atslēgas ir atrodamas atsevišķās vienuma 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ģentam vai Zabbix serverim.
Skatiet arī: pareizais atslēgas formāts.
Informācijas tips Datu tips, kādā dati tiek glabāti datubāzē pēc konvertēšanas, ja tāda ir veikta.
Skaitlis (bez zīmes) - 64 bitu vesels skaitlis bez zīmes.
Ņemiet vērā, ka peldošā komata vērtībai, ja tā tiek saņemta veselā skaitļa vienumam, decimāldaļa tiks noņemta.
Skaitlis (peldošais komats) - 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ēram, 1.23E+7, 1e308, 1.1E-4.
Rakstzīme - īsi teksta dati.
Žurnāls - gari teksta dati ar neobligātām ar žurnālu saistītām īpašībām (laikspiedols, avots, nopietnība, logeventid).
Teksts - gari teksta dati. Skatiet arī teksta datu ierobežojumus.
Binārs - binārs skaitlis (tiek atbalstīts tikai atkarīgajiem vienumiem).
Vienumi, kas atgriež vērtības ar bināro datu tipu, netiek atbalstīti aprēķināto vienumu formulās vai trigeru izteiksmēs.
Vienumu atslēgām, kas atgriež datus tikai vienā noteiktā formātā, atbilstošais informācijas tips tiek atlasīts automātiski.
Hosta saskarne Atlasiet hosta saskarni. Šis lauks ir pieejams, rediģējot vienumu hosta līmenī.
Mērvienības 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, parādot 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 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 Skaitlis (bez zīmes).
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).
Papildu piemērus un informāciju par mērvienību simboliem un konvertēšanu skatiet sadaļā Vienuma vērtību sufiksi.
Atjaunināšanas intervāls Iegūstiet 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, ja vien tiem nav ieplānots vai elastīgs atjaunināšanas intervāls un Atjaunināšanas intervāls nav iestatīts uz 0.
Esošu pasīvu vienumu var nekavējoties aptaujāt, nospiežot Izpildīt tūlīt pogu.
Pielāgoti intervāli Varat izveidot pielāgotus noteikumus vienuma pārbaudei:
Elastīgs - izveidot izņēmumu Atjaunināšanas intervālam (intervālu ar citu biežumu).
Ieplānošana - izveidot pielāgotu aptaujas grafiku.
Detalizētu informāciju skatiet sadaļā Pielāgoti intervāli.
Intervāla 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.
Noildze Iestatiet vienuma pārbaudes noildzi (pieejama atbalstītajiem vienumu tipiem). Atlasiet noildzes opciju:
Globāla - tiek izmantota starpniekservera/globālā noildze (tā tiek parādīta pelēkajā Noildze laukā).
Ignorēt - tiek izmantota pielāgota noildze (iestatīta laukā Noildze; atļautais diapazons: 1–600 s). Tiek atbalstīti laika sufiksi, piemēram, 30s, 1m, kā arī lietotāja makro.
Noklikšķinot uz saites Noildzes, varat konfigurēt starpniekservera noildzes vai globālās noildzes (ja starpniekserveris netiek izmantots). Ņemiet vērā, ka saite Noildzes ir redzama tikai lietotājiem ar Super administratora tipu un atļaujām piekļūt Administration > General vai Administration > Proxies lietotāja saskarnes sadaļām.
Vēsture Atlasiet vienu no opcijām:
Neglabāt - vienuma vēsture netiek glabāta. Noder galvenajiem vienumiem, ja vēsture ir jāsaglabā tikai atkarīgajiem vienumiem.
Šo iestatījumu nevar ignorēt globālie housekeeper iestatījumi.
Glabāt līdz - 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 Glabāt līdz 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 garu vērtību vēsturi, varat ilgāk glabāt tendenču datus.
Skatiet arī Vēsture un tendences.
Tendences Atlasiet vienu no opcijām:
Neglabāt - tendences netiek glabātas.
Šo iestatījumu nevar ignorēt globālie housekeeper iestatījumi.
Glabāt līdz - 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 Glabāt līdz 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īmēm, žurnālam un tekstam.
Skatiet arī Vēsture un tendences.
Vērtību kartēšana 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 Skaitlis (bez zīmes), Skaitlis (peldošais komats) un Rakstzīme vienumiem.
Piemēram, “Windows service states”.
Žurnāla laika formāts Pieejams tikai Žurnāls 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 rakstzīmes “p” un “:” ir vietturi un var būt jebkuras rakstzīmes, izņemot “yMdhms”.
Aizpilda hosta inventāra lauku 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.
Šis lauks nav pieejams, ja Informācijas tips ir iestatīts uz “Žurnāls”.
Apraksts Ievadiet vienuma aprakstu. Tiek atbalstīti lietotāja makro.
Iespējots Atzīmējiet izvēles rūtiņu, lai iespējotu vienumu un to varētu apstrādāt.
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).
Jaunākie dati Noklikšķiniet uz saites, lai skatītu jaunākos vienuma datus.
Šī saite ir pieejama tikai tad, ja 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 veidlapas galvenē, lai pārietu uz veidnes līmeni un rediģētu tos tur, ņemot vērā, ka izmaiņas veidnes līmenī mainīs vienumu visiem hostiem, ar kuriem veidne ir saistīta.

Tagi cilnē varat 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 pārveidošanas 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 pārbaudī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 hosts 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 pārbaudī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ēgtā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 specifiskai informācijai (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 automātiski, t. i., vienumiem, kuriem nepieciešams aģents, informācija tiek ņemta no atlasītā hosta 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ēram, hosta adreses lauks un starpniekservera lauks ir atspējoti aprēķinātajiem vienumiem)

Lai pārbaudītu vienumu, noklikšķiniet uz Get value. Ja vērtība tiek veiksmīgi izgū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 izgūtajā vērtībā tiek noteikts "\n\r".

Noklikšķiniet uz Get value and test, lai pārbaudī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 512 KB lielumam. 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 512 KB, Zabbix serveris joprojām apstrādā pilnībā.

Ja konfigurācija ir nepareiza, tiek parādīts kļūdas ziņojums, kas apraksta iespējamo iemeslu.

Veiksmīgi izgūtu vērtību no hosta var izmantot arī, lai pārbaudī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.

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).