Zabbix aģents

Pārskats

Šī sadaļa sniedz informāciju par vienumu atslēgām, kas datu iegūšanai izmanto saziņu ar Zabbix aģentu.

Ir pasīvas un aktīvas aģenta pārbaudes. Konfigurējot vienumu, varat atlasīt nepieciešamo tipu:

  • Zabbix aģents - pasīvām pārbaudēm
  • Zabbix aģents (aktīvs) - aktīvām pārbaudēm

Ņemiet vērā, ka visas vienumu atslēgas, ko atbalsta Zabbix aģents, atbalsta arī jaunās paaudzes Zabbix aģents 2. Skatiet papildu vienumu atslēgas, ko varat izmantot tikai ar aģentu 2.

Atbalstītās vienumu atslēgas

Tālāk ir norādītas vienumu atslēgas, kuras varat izmantot kopā ar Zabbix aģentu.

Vienumu atslēgas ir norādītas bez parametriem un papildu informācijas.
Noklikšķiniet uz vienuma atslēgas, lai skatītu pilnu informāciju.

Vienuma atslēga Apraksts Vienumu grupa
kernel.maxfiles Maksimālais OS atbalstītais atvērto failu skaits. Kodols
kernel.maxproc Maksimālais OS atbalstītais procesu skaits.
kernel.openfiles Pašlaik atvērto failu deskriptoru skaits.
log Žurnālfaila uzraudzība. Žurnālu uzraudzība
log.count Atbilstošo rindu skaits uzraudzītajā žurnālfailā.
logrt Rotēta žurnālfaila uzraudzība.
logrt.count Atbilstošo rindu skaits rotētajā uzraudzītajā žurnālfailā.
modbus.get Nolasa Modbus datus. Modbus
net.dns Pārbauda DNS pakalpojuma statusu. Tīkls
net.dns.perf Pārbauda DNS pakalpojuma veiktspēju.
net.dns.record Veic DNS vaicājumu.
net.if.collisions Sadursmju skaits ārpus loga.
net.if.discovery Tīkla saskarņu saraksts.
net.if.get Tīkla saskarņu saraksts ar detalizētu informāciju.
net.if.in Ienākošās datplūsmas statistika tīkla saskarnē.
net.if.out Izejošās datplūsmas statistika tīkla saskarnē.
net.if.total Ienākošās un izejošās datplūsmas statistikas summa tīkla saskarnē.
net.tcp.listen Pārbauda, vai šis TCP ports ir stāvoklī LISTEN.
net.tcp.port Pārbauda, vai ir iespējams izveidot TCP savienojumu ar norādīto portu.
net.tcp.service Pārbauda, vai pakalpojums darbojas un pieņem TCP savienojumus.
net.tcp.service.perf Pārbauda TCP pakalpojuma veiktspēju.
net.tcp.socket.count Atgriež parametriem atbilstošo TCP ligzdu skaitu.
net.udp.listen Pārbauda, vai šis UDP ports ir stāvoklī LISTEN.
net.udp.service Pārbauda, vai pakalpojums darbojas un atbild uz UDP pieprasījumiem.
net.udp.service.perf Pārbauda UDP pakalpojuma veiktspēju.
net.udp.socket.count Atgriež parametriem atbilstošo UDP ligzdu skaitu.
proc.cpu.util Procesa CPU izmantojuma procentuālā daļa. Procesi
proc.get OS procesu un to parametru saraksts.
proc.mem Procesa izmantotā atmiņa baitos.
proc.num Procesu skaits.
sensor Aparatūras sensora rādījums. Sensori
system.boottime Sistēmas sāknēšanas laiks. Sistēma
system.cpu.discovery Noteikto CPU/procesora kodolu saraksts.
system.cpu.intr Ierīču pārtraukumi.
system.cpu.load CPU noslodze.
system.cpu.num CPU skaits.
system.cpu.switches Konteksta pārslēgšanu skaits.
system.cpu.util CPU izmantojuma procentuālā daļa.
system.hostname Sistēmas hosts nosaukums.
system.hw.chassis Informācija par šasiju.
system.hw.cpu Informācija par CPU.
system.hw.devices PCI vai USB ierīču saraksts.
system.hw.macaddr MAC adrešu saraksts.
system.localtime Sistēmas laiks.
system.run Palaiž norādīto komandu hostā.
system.stat Sistēmas statistika.
system.sw.arch Informācija par programmatūras arhitektūru.
system.sw.os Informācija par operētājsistēmu.
system.sw.os.get Detalizēta informācija par operētājsistēmu (versija, tips, distribūcijas nosaukums, mazā un lielā versija u. c.).
system.sw.packages Instalēto pakotņu saraksts.
system.sw.packages.get Detalizēts instalēto pakotņu saraksts.
system.swap.in Swap-in (no ierīces atmiņā) statistika.
system.swap.out Swap-out (no atmiņas uz ierīci) statistika.
system.swap.size Swap vietas lielums baitos vai procentos no kopējā apjoma.
system.uname Sistēmas identifikācija.
system.uptime Sistēmas darbības laiks sekundēs.
system.users.num Pieteikušos lietotāju skaits.
vfs.dev.discovery Blokierīču un to tipu saraksts. Virtuālās failu sistēmas
vfs.dev.get Blokierīču saraksts ar detalizētu informāciju.
vfs.dev.read Diska lasīšanas statistika.
vfs.dev.write Diska rakstīšanas statistika.
vfs.dir.count Direktorijas ierakstu skaits.
vfs.dir.get Direktorijas ierakstu saraksts.
vfs.dir.size Direktorijas lielums.
vfs.file.cksum Faila kontrolsumma, kas aprēķināta, izmantojot UNIX cksum algoritmu.
vfs.file.contents Faila satura izgūšana.
vfs.file.exists Pārbauda, vai fails pastāv.
vfs.file.get Atgriež informāciju par failu.
vfs.file.md5sum Faila MD5 kontrolsumma.
vfs.file.owner Iegūst faila īpašnieku.
vfs.file.permissions Atgriež četrciparu virkni, kas satur oktālo skaitli ar UNIX atļaujām.
vfs.file.regexp Iegūst virkni no faila.
vfs.file.regmatch Atrod virkni failā.
vfs.file.size Faila lielums.
vfs.file.time Informācija par faila laiku.
vfs.fs.discovery Piemontēto failu sistēmu saraksts ar to tipu un montēšanas opcijām.
vfs.fs.get Piemontēto failu sistēmu saraksts ar to tipu un montēšanas opcijām, kā arī full režīmā pieejamās diska vietas un inode statistika.
vfs.fs.inode Inode skaits vai procentuālā daļa.
vfs.fs.size Diska vieta baitos vai procentos no kopējā apjoma.
vm.memory.size Atmiņas lielums baitos vai procentos no kopējā apjoma. Virtuālā atmiņa
web.page.get Iegūst tīmekļa lapas saturu. Tīmekļa uzraudzība
web.page.perf Pilnas tīmekļa lapas ielādes laiks.
web.page.regexp Atrod virkni tīmekļa lapā.
agent.hostmetadata Aģenta hosts metadati. Zabbix
agent.hostname Aģenta hosts nosaukums.
agent.ping Aģenta pieejamības pārbaude.
agent.variant Zabbix aģenta variants (Zabbix aģents vai Zabbix aģents 2).
agent.version Zabbix aģenta versija.
zabbix.stats Atgriež Zabbix servera vai starpniekservera iekšējo metriku kopu. Ja ir norādīti ip un port, metrikas tiek iegūtas no attālās instances; pretējā gadījumā — no lokālās instances.
zabbix.stats (queue) Atgriež uzraudzīto vienumu skaitu rindā, kuru apstrāde Zabbix serverī vai starpniekserverī ir aizkavēta. Ja ir norādīti ip un port, metrikas tiek iegūtas no attālās instances; pretējā gadījumā — no lokālās instances.

Atbalstītās platformas

Ja vien vienuma detaļās nav norādīts citādi, aģenta vienumi (un visi parametri) tiek atbalstīti šādās platformās:

  • Linux
  • FreeBSD
  • Solaris
  • HP-UX
  • AIX
  • MacOS X
  • OpenBSD
  • NetBSD

Daudzi aģenta vienumi tiek atbalstīti arī Windows vidē. Sīkāku informāciju skatiet lapā Windows aģenta vienums.

Vienuma atslēgas detaļas

Parametri bez leņķiekavām ir obligāti. Parametri, kas atzīmēti ar leņķiekavām < >, ir neobligāti.

kernel.maxfiles


Maksimālais atvērto failu skaits, ko atbalsta operētājsistēma.
Atgrieztā vērtība: vesels skaitlis.
Atbalstītās platformas: Linux, FreeBSD, MacOS X, OpenBSD, NetBSD.

kernel.maxproc


Maksimālais procesu skaits, ko atbalsta operētājsistēma.
Atgrieztā vērtība: Integer.
Atbalstītās platformas: Linux 2.6 un jaunākas versijas, FreeBSD, Solaris, MacOS X, OpenBSD, NetBSD.

kernel.openfiles


Pašlaik atvērto failu deskriptoru skaits.
Atgrieztā vērtība: Integer.
Atbalstītās platformas: Linux (vienums var darboties arī citās UNIX tipa platformās).

log[file,<regexp>,<encoding>,<maxlines>,<mode>,<output>,<maxdelay>,<options>,<persistent dir>]


Log faila uzraudzība.
Atgrieztā vērtība: Log.
Skatiet atbalstītās platformas.

Parametri:

  • file - pilns ceļš un log faila nosaukums;
  • regexp - regulāra izteiksme, kas apraksta nepieciešamo rakstu;
  • encoding - kodu lapas identifikators;
  • maxlines - maksimālais jauno rindu skaits sekundē, ko aģents nosūtīs uz serveris vai starpniekserveris. Šis parametrs pārraksta MaxLinesPerSecond vērtību zabbix_agentd.conf;
  • mode - iespējamās vērtības:
    • all (noklusējums);
    • skip - izlaist vecāku datu apstrādi (ietekmē tikai jaunizveidotos vienumus);
  • output - neobligāta izvades formatēšanas veidne. \0 bēgšanas secība tiek aizstāta ar atbilstošo teksta daļu (no pirmās rakstzīmes, kur sākas atbilstība, līdz rakstzīmei, kur atbilstība beidzas), savukārt \N (kur N=1...9) bēgšanas secība tiek aizstāta ar N-to atbilstošo grupu (vai ar tukšu virkni, ja N pārsniedz uztverto grupu skaitu);
  • maxdelay - maksimālā aizture sekundēs. Tips: float. Vērtības:
    • 0 - (noklusējums) nekad neignorēt log faila rindas;
    • > 0.0 - ignorēt vecākas rindas, lai pēdējās analizētās rindas tiktu iegūtas "maxdelay" sekunžu laikā. Pirms lietošanas izlasiet piezīmes par maxdelay!
  • options - papildu opcijas:
    mtime-noreread - neunikāli ieraksti, pārlasīt tikai tad, ja faila izmērs mainās (ignorēt modifikācijas laika izmaiņas). (Šis parametrs ir novecojis kopš 5.0.2, jo tagad mtime tiek ignorēts.)
  • persistent dir (tikai zabbix_agentd Unix sistēmās; netiek atbalstīts Zabbix agent 2) - direktorijas absolūtais ceļš, kur glabāt pastāvīgos failus. Skatiet arī papildu piezīmes par pastāvīgajiem failiem.

Komentāri:

  • Vienums ir jākonfigurē kā aktīvā pārbaude.
  • Ja fails nav pieejams vai atļaujas liedz piekļuvi, vienums kļūst neatbalstīts.
  • Ja output ir atstāts tukšs - tiek atgriezta visa rinda, kurā ir atbilstošais teksts. Ņemiet vērā, ka visi globālo regulāro izteiksmju tipi, izņemot Matches regular expression, vienmēr atgriež visu atbilstošo rindu, un parametrs output tiek ignorēts.
  • Satura izvilkšana, izmantojot output parametru, notiek aģentā.

Piemēri:

log[/var/log/syslog]
log[/var/log/syslog,error]
log[/home/zabbix/logs/logfile,,,100]

Piemērs output parametra izmantošanai skaitļa izvilkšanai no log ieraksta:

log[/app1/app.log,"task run [0-9.]+ sec, processed ([0-9]+) records, [0-9]+ errors",,,,\1] #this item will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send only '6080' to server. Because a numeric value is being sent, the "Type of information" for this item can be set to "Numeric (unsigned)" and the value can be used in graphs, triggers etc.

Piemērs output parametra izmantošanai log ieraksta pārrakstīšanai pirms nosūtīšanas uz serveris:

log[/app1/app.log,"([0-9 :-]+) task run ([0-9.]+) sec, processed ([0-9]+) records, ([0-9]+) errors",,,,"\1 RECORDS: \3, ERRORS: \4, DURATION: \2"] #this item will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send a modified record "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08" to the server.
log.count[file,<regexp>,<encoding>,<maxproclines>,<mode>,<maxdelay>,<options>,<persistent dir>]


Sakritoto rindu skaits uzraudzītajā žurnāla failā.
Atgrieztā vērtība: Integer.
Skatiet atbalstītās platformas.

Parametri:

  • file - pilns žurnāla faila ceļš un nosaukums;
  • regexp - regulāra izteiksme, kas apraksta nepieciešamo rakstu;
  • encoding - kodu lapas identifikators;
  • maxproclines - maksimālais jauno rindu skaits sekundē, ko aģents analizēs (nedrīkst pārsniegt 10000). Noklusējuma vērtība ir 10*MaxLinesPerSecond failā zabbix_agentd.conf.
  • mode - iespējamās vērtības:
    • all (noklusējums);
    • skip - izlaist vecāku datu apstrādi (ietekmē tikai jaunizveidotos vienumus).
  • maxdelay - maksimālā aizkave sekundēs. Tips: float. Vērtības:
    • 0 - (noklusējums) nekad neignorēt žurnāla faila rindas;
    • > 0.0 - ignorēt vecākas rindas, lai jaunākās rindas tiktu analizētas "maxdelay" sekunžu laikā. Pirms lietošanas izlasiet piezīmes par maxdelay!
  • options - papildu opcijas:
    mtime-noreread - neunikāli ieraksti, pārlasīt tikai tad, ja mainās faila izmērs (ignorēt modifikācijas laika izmaiņas). (Šis parametrs ir novecojis kopš 5.0.2, jo tagad mtime tiek ignorēts.)
  • persistent dir (tikai zabbix_agentd Unix sistēmās; nav atbalstīts Zabbix aģents 2) - direktorijas absolūtais ceļš, kur glabāt pastāvīgos failus. Skatiet arī papildu piezīmes par pastāvīgajiem failiem.

Komentāri:

  • Vienums ir jākonfigurē kā aktīvā pārbaude.
  • Sakritīgās rindas tiek skaitītas jaunajās rindās kopš pēdējās žurnāla pārbaudes, ko veicis aģents, un tādējādi ir atkarīgas no vienuma atjaunināšanas intervāla.
  • Ja fails nav atrodams vai piekļuve tam nav atļauta, vienums kļūst neatbalstīts.
logrt[file regexp,<regexp>,<encoding>,<maxlines>,<mode>,<output>,<maxdelay>,<options>,<persistent dir>]


Pārraudzība rotētam žurnālfailam.
Atgrieztā vērtība: Log.
Skatiet atbalstītās platformas.

Parametri:

  • file regexp - absolūtais ceļš uz failu, kur faila nosaukums ir norādīts, izmantojot regulāro izteiksmi. Ņemiet vērā, ka regulārā izteiksme attiecas tikai uz faila nosaukumu un tai nav jāsakrīt ar visu nosaukumu (piem., /path/to/agent sakritīs ar zabbix_agentd.log).
  • regexp - regulārā izteiksme, kas apraksta nepieciešamo satura paraugu.
  • encoding - kodu lapas identifikators.
  • maxlines - maksimālais jauno rindu skaits sekundē, ko aģents nosūtīs uz Zabbix serveris vai starpniekserveris. Šis parametrs pārraksta MaxLinesPerSecond vērtību zabbix_agentd.conf.
  • mode - iespējamās vērtības:
    • all (noklusējums);
    • skip - izlaiž vecāku datu apstrādi (ietekmē tikai jaunizveidotos vienumus).
  • output - neobligāta izvades formatēšanas veidne. \0 bēgšanas secība tiek aizstāta ar atrasto teksta daļu (no pirmās rakstzīmes, kur sākas sakritība, līdz rakstzīmei, kur sakritība beidzas), savukārt \N (kur N=1...9) bēgšanas secība tiek aizstāta ar N-to atrasto grupu (vai tukšu virkni, ja N pārsniedz uztverto grupu skaitu).
  • maxdelay - maksimālā aizture sekundēs. Tips: float. Vērtības:
    • 0 - (noklusējums) nekad neignorēt žurnālfaila rindas;
    • > 0.0 - ignorēt vecākas rindas, lai pēdējās analizētās rindas tiktu iegūtas "maxdelay" sekunžu laikā. Pirms lietošanas izlasiet piezīmes par maxdelay!
  • options - žurnālfaila rotācijas veids un citas opcijas. Iespējamās vērtības:
    • rotate (noklusējums).
    • copytruncate - ņemiet vērā, ka copytruncate nevar izmantot kopā ar maxdelay. Šajā gadījumā maxdelay jābūt 0 vai arī tas nav jānorāda; skatiet piezīmes par copytruncate.
    • mtime-reread - nedublējoši ieraksti, pārlasa, ja mainās modificēšanas laiks vai izmērs (pēc noklusējuma tiek izmantots, ja nav skaidri iestatīta neviena mtime-* opcija).
    • mtime-noreread - nedublējoši ieraksti, pārlasa tikai tad, ja mainās izmērs (ignorē modificēšanas laika izmaiņas).
  • persistent dir (tikai zabbix_agentd Unix sistēmās; Zabbix aģents 2 netiek atbalstīts) - direktorijas absolūtais ceļš, kur glabāt pastāvīgos failus. Skatiet arī papildu piezīmes par pastāvīgajiem failiem.

Piezīmes:

  • Vienums ir jākonfigurē kā aktīvā pārbaude.
  • Žurnālfaila rotācija balstās uz failu pēdējo modificēšanas laiku.
  • Ņemiet vērā, ka logrt ir paredzēts darbam ar vienu pašlaik aktīvu žurnālfailu, kam ir vairāki citi atbilstoši neaktīvi rotēti faili. Ja, piemēram, direktorijā ir daudz aktīvu žurnālfailu, katram no tiem jāizveido atsevišķs logrt vienums. Pretējā gadījumā, ja viens logrt vienums apstrādā pārāk daudz failu, tas var izraisīt atmiņas izsīkumu un pārraudzības avāriju.
  • Ja output tiek atstāts tukšs, tiek atgriezta visa rinda, kurā ir atrastais teksts. Ņemiet vērā, ka visi globālo regulāro izteiksmju tipi, izņemot Matches regular expression, vienmēr atgriež visu atrasto rindu, un output parametrs tiek ignorēts.
  • Satura izvilkšana, izmantojot output parametru, notiek aģentā.
  • Parametrā file regexp žurnāla direktorijas ceļam un žurnālfaila regulārajai izteiksmei jābūt atdalītiem ar pareizo direktorijas atdalītāju:
    • Operētājsistēmā Windows atdalītājam jābūt slīpsvītrai atpakaļ (\); slīpsvītras uz priekšu var tikt pieņemtas citās vietās, izņemot to, kas atdala žurnāla direktorijas ceļu un žurnālfaila regulāro izteiksmi (skatiet piemērus zemāk).
    • Citās sistēmās tam jābūt slīpsvītrai uz priekšu (/).

Windows piemēri:

logrt["c:/dir1/dir2/dir3\filename.*\.log","pattern_to_match"] #this item will collect data from log files in "c:/dir1/dir2/dir3" where the file name starts with "filename" and ends with any extension matching ".log".
logrt["//example.com/share/dir1/dir2/dir3\filename.*\.log","pattern_to_match"] #this item will collect data from log files in the network share "//example.com/share/dir1/dir2/dir3" where the file name starts with "filename" and ends with any extension matching ".log".

Piemēri citām sistēmām:

logrt["/home/zabbix/logs/^logfile[0-9]{1,3}$",,,100] #this item will match a file like "logfile1" (will not match ".logfile1").
logrt["/home/user/^logfile_.*_[0-9]{1,3}$","pattern_to_match","UTF-8",100] #this item will collect data from files such as "logfile_abc_1" or "logfile__001".

Piemērs output parametra izmantošanai skaitļa izvilkšanai no žurnāla ieraksta:

logrt[/app1/^test.*log$,"task run [0-9.]+ sec, processed ([0-9]+) records, [0-9]+ errors",,,,\1] #this item will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send only '6080' to server. Because a numeric value is being sent, the "Type of information" for this item can be set to "Numeric (unsigned)" and the value can be used in graphs, triggers etc.

Piemērs output parametra izmantošanai žurnāla ieraksta pārrakstīšanai pirms nosūtīšanas uz serveris:

logrt[/app1/^test.*log$,"([0-9 :-]+) task run ([0-9.]+) sec, processed ([0-9]+) records, ([0-9]+) errors",,,,"\1 RECORDS: \3, ERRORS: \4, DURATION: \2"] #this item will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send a modified record "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08" to server.
logrt.count[file regexp,<regexp>,<encoding>,<maxproclines>,<mode>,<maxdelay>,<options>,<persistent dir>]


Pārraudzītā rotējošā žurnālfailā atrasto atbilstošo rindu skaits.
Atgrieztā vērtība: Integer.
Skatiet atbalstītās platformas.

Parametri:

  • file regexp - absolūtais ceļš uz failu, kur faila nosaukums ir norādīts, izmantojot regulāru izteiksmi. Ņemiet vērā, ka regulārā izteiksme attiecas tikai uz faila nosaukumu un tai nav jāsakrīt ar visu nosaukumu (piem., /path/to/agent sakritīs ar zabbix_agentd.log).
  • regexp - regulāra izteiksme, kas apraksta nepieciešamo rakstu.
  • encoding - kodu lapas identifikators.
  • maxproclines - maksimālais jauno rindu skaits sekundē, ko aģents analizēs (nedrīkst pārsniegt 10000). Noklusējuma vērtība ir 10*MaxLinesPerSecond failā zabbix_agentd.conf.
  • mode - iespējamās vērtības:
    • all (noklusējums);
    • skip - izlaiž vecāku datu apstrādi (ietekmē tikai jaunizveidotos vienumus).
  • maxdelay - maksimālā aizture sekundēs. Tips: float. Vērtības:
    • 0 - (noklusējums) nekad neignorēt žurnālfaila rindas;
    • > 0.0 - ignorēt vecākas rindas, lai jaunākās rindas tiktu analizētas "maxdelay" sekunžu laikā. Pirms lietošanas izlasiet piezīmes par maxdelay!
  • options - žurnālfaila rotācijas veids un citas opcijas. Iespējamās vērtības:
    • rotate (noklusējums).
    • copytruncate - ņemiet vērā, ka copytruncate nevar izmantot kopā ar maxdelay. Šajā gadījumā maxdelay jābūt 0 vai tas nav jānorāda; skatiet piezīmes par copytruncate.
    • mtime-reread - nedubultoti ieraksti, pārlasīt, ja mainās modificēšanas laiks vai izmērs (noklusējums).
    • mtime-noreread - nedubultoti ieraksti, pārlasīt tikai tad, ja mainās izmērs (ignorēt modificēšanas laika izmaiņas).
  • persistent dir (tikai zabbix_agentd Unix sistēmās; nav atbalstīts Zabbix aģents 2) - direktorijas absolūtais ceļš, kur glabāt pastāvīgos failus. Skatiet arī papildu piezīmes par pastāvīgajiem failiem.

Komentāri:

  • Vienums ir jākonfigurē kā aktīvā pārbaude.
  • Atbilstošās rindas tiek skaitītas jaunajās rindās kopš pēdējās žurnāla pārbaudes, ko veic aģents, un tādējādi ir atkarīgas no vienuma atjaunināšanas intervāla.
  • Žurnālfaila rotācija balstās uz failu pēdējo modificēšanas laiku.
  • Parametrā file regexp žurnāla direktorijas ceļš un žurnālfaila regulārā izteiksme ir jāatdala ar pareizo direktorijas atdalītāju:
    • Operētājsistēmā Windows atdalītājam jābūt slīpsvītrai pretējā virzienā (\); slīpsvītras uz priekšu var tikt pieņemtas citās pozīcijās, izņemot to, kas atdala žurnāla direktorijas ceļu un žurnālfaila regulāro izteiksmi (skatiet piemērus zemāk).
    • Citās sistēmās tam jābūt slīpsvītrai uz priekšu (/).

Piemēri operētājsistēmai Windows:

logrt.count["c:/dir1/dir2/dir3\filename.*\.log","pattern_to_match"] #šis vienums skaitīs atbilstību skaitu rakstam "pattern_to_match" žurnālfailos, kas atrodas "c:/dir1/dir2/dir3".
logrt.count["//example.com/share/dir1/dir2/dir3\filename.*\.log","pattern_to_match"] #šis vienums skaitīs atbilstību skaitu rakstam "pattern_to_match" žurnālfailos tīkla koplietojumā "//example.com/share/dir1/dir2/dir3".

Piemēri citām sistēmām:

logrt.count["/home/zabbix/logs/.*","^logfile[0-9]{1,3}$",,100] #šis vienums skaitīs atbilstību skaitu rakstam "^logfile[0-9]{1,3}$" žurnālfailos direktorijā "/home/zabbix/logs".
logrt.count["/home/user/^logfile_.*_[0-9]{1,3}$","pattern_to_match","UTF-8",100] #šis vienums skaitīs raksta "pattern_to_match" sastopamību skaitu žurnālfailos, kas atrodas "/home/user".
modbus.get[endpoint,<slave id>,<function>,<address>,<count>,<type>,<endianness>,<offset>]


Nolasa Modbus datus.
Atgrieztā vērtība: JSON virkne.
Atbalstītās platformas: Linux, Windows.

Parametri:

  • endpoint - galapunkts, kas definēts kā protocol://connection_string;
  • slave id - slave ID;
  • function - Modbus funkcija;
  • address - pirmā reģistra, coil vai ievades adrese;
  • count - nolasāmo ierakstu skaits;
  • type - datu tips;
  • endianness - baitu secības konfigurācija;
  • offset - reģistru skaits, sākot no address, kuru rezultāti tiks ignorēti.

Operētājsistēmā Windows šis vienums seko UNC ceļiem endpoint parametrā, kas var būt drošības risks.

Skatiet detalizētu parametru aprakstu.

net.dns[<ip>,name,<type>,<timeout>,<count>,<protocol>]


Pārbauda DNS pakalpojuma statusu.
Atgrieztās vērtības:

  • 0 - DNS atrisināšana neizdevās (DNS serveris neatbildēja vai atgrieza kļūdu);
  • 1 - DNS atrisināšana izdevās.
    Skatiet atbalstītās platformas.

Parametri:

  • ip (tiek ignorēts operētājsistēmā Windows, ja vien netiek izmantots Zabbix aģents 2) - DNS servera IP adrese (atstājiet tukšu, lai izmantotu noklusējuma DNS serveri);
  • name - DNS nosaukums, ko vaicāt;
  • type - ieraksta tips, ko vaicāt (noklusējums ir SOA);
  • timeout (tiek ignorēts operētājsistēmā Windows, ja vien netiek izmantots Zabbix aģents 2) - pieprasījuma noildze sekundēs (noklusējums ir 1 sekunde);
  • count (tiek ignorēts operētājsistēmā Windows, ja vien netiek izmantots Zabbix aģents 2) - pieprasījuma mēģinājumu skaits (noklusējums ir 2);
  • protocol - protokols, ko izmanto DNS vaicājumu veikšanai: udp (noklusējums) vai tcp.

Piezīmes:

  • Iespējamās type vērtības ir: ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (netiek atbalstīts Zabbix aģentam operētājsistēmā Windows, Zabbix aģentam 2 visās OS), HINFO, MINFO, TXT, SRV.
  • Apgrieztajiem DNS uzmeklējumiem (ja type ir iestatīts uz PTR) DNS nosaukumu var norādīt gan apgrieztā, gan neapgrieztā formātā (skatiet piemērus tālāk). Ņemiet vērā, ka, pieprasot PTR ierakstu, DNS nosaukums faktiski ir IP adrese.
  • Internacionalizētie domēna vārdi netiek atbalstīti, lūdzu, izmantojiet IDNA kodētus nosaukumus.

Piemēri:

net.dns[198.51.100.1,example.com,MX,2,1]

net.dns[,198.51.100.1,PTR]
net.dns[,1.100.51.198.in-addr.arpa,PTR]

net.dns[,2a00:1450:400f:800::200e,PTR]
net.dns[,e.0.0.2.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.0.f.0.0.4.0.5.4.1.0.0.a.2.ip6.arpa,PTR]
net.dns.perf[<ip>,name,<type>,<timeout>,<count>,<protocol>]


Pārbauda DNS pakalpojuma veiktspēju.
Atgrieztā vērtība: Float (0 - pakalpojums nedarbojas; sekundes - sekunžu skaits, kas pavadīts, gaidot atbildi no pakalpojuma).
Skatiet atbalstītās platformas.

Parametri:

  • ip (Windows sistēmā tiek ignorēts, ja vien netiek izmantots Zabbix aģents 2) - DNS servera IP adrese (atstājiet tukšu, lai izmantotu noklusējuma DNS serveri);
  • name - DNS nosaukums, kuru vaicāt;
  • type - ieraksta tips, kuru vaicāt (noklusējums ir SOA);
  • timeout (Windows sistēmā tiek ignorēts, ja vien netiek izmantots Zabbix aģents 2) - pieprasījuma noildze sekundēs (noklusējums ir 1 sekunde);
  • count (Windows sistēmā tiek ignorēts, ja vien netiek izmantots Zabbix aģents 2) - pieprasījuma mēģinājumu skaits (noklusējums ir 2);
  • protocol - protokols, ko izmanto DNS vaicājumu veikšanai: udp (noklusējums) vai tcp.

Komentāri:

  • Iespējamās type vērtības ir:
    ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (nav atbalstīts Zabbix aģentam operētājsistēmā Windows, Zabbix aģentam 2 visās OS), HINFO, MINFO, TXT, SRV.
  • Veicot reversos DNS vaicājumus (kad type ir iestatīts uz PTR), DNS nosaukumu var norādīt gan apgrieztā, gan neapgrieztā formātā (skatiet piemērus zemāk). Ņemiet vērā, ka, pieprasot PTR ierakstu, DNS nosaukums faktiski ir IP adrese.
  • Internacionalizētie domēna vārdi netiek atbalstīti, lūdzu, izmantojiet IDNA kodētus nosaukumus.
  • Vienums atgriež atbildes laiku, nevis 0, ja DNS serveris atbild ar kļūdas kodu (piemēram, NXDOMAIN vai SERVFAIL).

Piemēri:

net.dns.perf[198.51.100.1,example.com,MX,2,1]

net.dns.perf[,198.51.100.1,PTR]
net.dns.perf[,1.100.51.198.in-addr.arpa,PTR]

net.dns.perf[,2a00:1450:400f:800::200e,PTR]
net.dns.perf[,e.0.0.2.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.0.f.0.0.4.0.5.4.1.0.0.a.2.ip6.arpa,PTR]
net.dns.record[<ip>,name,<type>,<timeout>,<count>,<protocol>]


Veic DNS vaicājumu.

Zabbix aģents 2 arī nodrošina net.dns.get, kas piedāvā papildu iespējas, piemēram, vairāk ierakstu tipu un lielāku kontroli pār DNS uzraudzību. Atgrieztā vērtība: rakstzīmju virkne ar nepieciešamo informācijas tipu.
Skatiet atbalstītās platformas.

Parametri:

  • ip (Windows sistēmā tiek ignorēts, ja vien netiek izmantots Zabbix aģents 2) - DNS servera IP adrese (atstājiet tukšu, lai izmantotu noklusējuma DNS serveri);
  • name - DNS nosaukums, kuru vaicāt;
  • type - vaicājamais ieraksta tips (noklusējuma vērtība ir SOA);
  • timeout (Windows sistēmā tiek ignorēts, ja vien netiek izmantots Zabbix aģents 2) - pieprasījuma noildze sekundēs (noklusējuma vērtība ir 1 sekunde);
  • count (Windows sistēmā tiek ignorēts, ja vien netiek izmantots Zabbix aģents 2) - pieprasījuma mēģinājumu skaits (noklusējuma vērtība ir 2);
  • protocol - protokols, ko izmanto DNS vaicājumu veikšanai: udp (noklusējuma) vai tcp.

Piezīmes:

  • Iespējamās type vērtības ir:
    ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (netiek atbalstīts Zabbix aģentam operētājsistēmā Windows, Zabbix aģentam 2 visās OS), HINFO, MINFO, TXT, SRV.
  • Apgrieztajiem DNS uzmeklējumiem (kad type ir iestatīts uz PTR) varat norādīt DNS nosaukumu gan apgrieztā, gan neapgrieztā formātā (skatiet piemērus zemāk). Ņemiet vērā, ka, pieprasot PTR ierakstu, DNS nosaukums faktiski ir IP adrese.
  • Internacionalizētie domēna vārdi netiek atbalstīti, lūdzu, izmantojiet IDNA kodētus nosaukumus.

Piemēri:

net.dns.record[198.51.100.1,example.com,MX,2,1]

net.dns.record[,198.51.100.1,PTR]
net.dns.record[,1.100.51.198.in-addr.arpa,PTR]

net.dns.record[,2a00:1450:400f:800::200e,PTR]
net.dns.record[,e.0.0.2.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.0.f.0.0.4.0.5.4.1.0.0.a.2.ip6.arpa,PTR]
net.if.collisions[if]


Ārpus loga sadursmju skaits.
Atgrieztā vērtība: Integer.
Atbalstītās platformas: Linux, FreeBSD, Solaris, AIX, MacOS X, OpenBSD, NetBSD. NetBSD ir nepieciešamas root privilēģijas.

Parametrs:

  • if - tīkla saskarnes nosaukums
net.if.discovery


Tīkla saskarņu saraksts. Izmanto zema līmeņa atklāšanai.
Atgrieztā vērtība: JSON string.
Atbalstītās platformas: Linux, FreeBSD, Solaris, HP-UX, AIX, OpenBSD, NetBSD, Windows.

net.if.get[<regexp>]


Tīkla saskarņu saraksts ar detalizētu informāciju.
Tiek izmantots zemā līmeņa atklāšanai.
Šis vienums ir paplašināta Zabbix aģenta vienuma net.if.discovery versija.
Atgrieztā vērtība: JSON objekts.
Atbalstītās platformas: Linux.

Parametri:

  • regexp - regulāra izteiksme, kas atbilst tīkla saskarņu nosaukumiem.

Komentāri:

  • Atgriež JSON objektu ar tīkla saskarnēm, kuru nosaukumi atbilst dotajai regulārajai izteiksmei (skatiet papildu informāciju).
net.if.in[if,<mode>]


Ienākošās datplūsmas statistika tīkla interfeisā.
Atgrieztā vērtība: Integer.
Atbalstītās platformas: Linux, FreeBSD, Solaris5, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows. NetBSD ir nepieciešamas root tiesības.

Parametri:

  • if - tīkla interfeisa nosaukums (Unix); tīkla interfeisa pilns apraksts vai IPv4 adrese; vai, ja iekļauts iekavās, tīkla interfeisa GUID (Windows);
  • mode - iespējamās vērtības:
    • bytes - baitu skaits (noklusējums);
    • packets - pakešu skaits;
    • errors - kļūdu skaits;
    • dropped - nomesto pakešu skaits;
    • overruns (fifo) - FIFO bufera kļūdu skaits;
    • frame - pakešu kadrējuma kļūdu skaits;
    • compressed - ierīces draivera saņemto saspiesto pakešu skaits;
    • multicast - ierīces draivera saņemto multicast kadru skaits.

Komentāri:

  • Varat izmantot šo atslēgu kopā ar priekšapstrādes soli Change per second, lai iegūtu baitu skaitu sekundē.
  • Režīms dropped tiek atbalstīts tikai Linux, FreeBSD, HP-UX, MacOS X, OpenBSD, NetBSD.
  • Režīmi overruns, frame, compressed, multicast tiek atbalstīti tikai Linux.
  • HP-UX šis vienums nesniedz detalizētu informāciju par loopback interfeisiem (piem., lo0).

Piemēri:

net.if.in[eth0]
net.if.in[eth0,errors]
net.if.out[if,<mode>]


Izejošās datplūsmas statistika tīkla interfeisā.
Atgrieztā vērtība: Integer.
Atbalstītās platformas: Linux, FreeBSD, Solaris5, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows. NetBSD ir nepieciešamas root tiesības.

Parametri:

  • if - tīkla interfeisa nosaukums (Unix); tīkla interfeisa pilns apraksts vai IPv4 adrese; vai, ja iekavās, tīkla interfeisa GUID (Windows);
  • mode - iespējamās vērtības:
    • bytes - baitu skaits (noklusējums);
    • packets - pakešu skaits;
    • errors - kļūdu skaits;
    • dropped - nomesto pakešu skaits;
    • overruns (fifo) - FIFO bufera kļūdu skaits;
    • collisions (colls) - sadursmju skaits, kas konstatētas interfeisā;
    • carrier - nesēja zudumu skaits, ko konstatējis ierīces draiveris;
    • compressed - saspiesto pakešu skaits, ko pārsūtījis ierīces draiveris.

Komentāri:

  • Lai iegūtu baitu sekundē statistiku, varat izmantot šo atslēgu kopā ar priekšapstrādes soli Change per second.
  • Režīms dropped tiek atbalstīts tikai Linux, HP-UX.
  • Režīmi overruns, collision, carrier, compressed tiek atbalstīti tikai Linux.
  • HP-UX šis vienums nesniedz detalizētu informāciju par loopback interfeisiem (piem., lo0).

Piemēri:

net.if.out[eth0]
net.if.out[eth0,errors]
net.if.total[if,<mode>]


Tīkla interfeisa ienākošās un izejošās datplūsmas statistikas summa.
Atgrieztā vērtība: Integer.
Atbalstītās platformas: Linux, FreeBSD, Solaris5, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows. NetBSD ir nepieciešamas root tiesības.

Parametri:

  • if - tīkla interfeisa nosaukums (Unix); tīkla interfeisa pilns apraksts vai IPv4 adrese; vai, ja iekļauts iekavās, tīkla interfeisa GUID (Windows);
  • mode - iespējamās vērtības:
    • bytes - baitu skaits (noklusējums);
    • packets - pakešu skaits;
    • errors - kļūdu skaits;
    • dropped - nomesto pakešu skaits;
    • overruns (fifo) - FIFO bufera kļūdu skaits;
    • collisions (colls) - interfeisā konstatēto sadursmju skaits;
    • compressed - ierīces draivera nosūtīto vai saņemto saspiesto pakešu skaits.

Komentāri:

  • Varat izmantot šo atslēgu kopā ar pirmapstrādes soli Change per second, lai iegūtu baitu sekundē statistiku.
  • Režīms dropped ir atbalstīts tikai Linux, HP-UX. Nomestās paketes tiek atbalstītas tikai tad, ja jūsu platformā gan net.if.in, gan net.if.out darbojas ar nomestajām paketēm.
  • Režīmi overruns, collision, compressed ir atbalstīti tikai Linux.
  • HP-UX šis vienums nesniedz detalizētu informāciju par loopback interfeisiem (piem., lo0).

Piemēri:

net.if.total[eth0]
net.if.total[eth0,errors]
net.tcp.listen[port]


Pārbauda, vai šis TCP ports ir LISTEN stāvoklī.
Atgrieztās vērtības: 0 - tas nav LISTEN stāvoklī; 1 - tas ir LISTEN stāvoklī.
Atbalstītās platformas: Linux, FreeBSD, Solaris, MacOS X, Windows.

Parametrs:

  • port - TCP porta numurs

Linux kodolos 2.6.14 un jaunākos informācija par TCP ligzdām, kas klausās, tiek iegūta no kodola NETLINK saskarnes, ja iespējams. Pretējā gadījumā informācija tiek iegūta no /proc/net/tcp un /roc/net/tcp6 failiem.

Piemērs:

net.tcp.listen[80]
net.tcp.port[<ip>,port]


Pārbauda, vai ir iespējams izveidot TCP savienojumu ar norādīto portu.
Atgrieztās vērtības: 0 - nevar izveidot savienojumu; 1 - var izveidot savienojumu.
Skatiet atbalstītās platformas.

Parametri:

  • ip - IP adrese vai DNS nosaukums (noklusējums ir 127.0.0.1);
  • port - porta numurs.

Komentāri:

  • Vienkāršai TCP veiktspējas testēšanai izmantojiet net.tcp.service.perf[tcp,<ip>,<port>].
  • Šīs pārbaudes var radīt papildu ziņojumus sistēmas dēmonu žurnālfailos (parasti tiek reģistrētas SMTP un SSH sesijas).

Piemērs:

net.tcp.port[,80] #šo vienumu var izmantot, lai pārbaudītu tīmekļa servera pieejamību, kas darbojas 80. portā
net.tcp.service[service,<ip>,<port>]


Pārbauda, vai pakalpojums darbojas un pieņem TCP savienojumus.
Atgrieztās vērtības: 0 - pakalpojums nedarbojas; 1 - pakalpojums darbojas.
Skatiet atbalstītās platformas.

Parametri:

  • service - ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https vai telnet (skatiet detalizētu informāciju);
  • ip - IP adrese vai DNS nosaukums (noklusējuma vērtība ir 127.0.0.1);
  • port - porta numurs (pēc noklusējuma tiek izmantots standarta pakalpojuma porta numurs).

Piezīmes:

  • Šīs pārbaudes var izraisīt papildu ziņojumus sistēmas dēmonu žurnālfailos (parasti tiek reģistrētas SMTP un SSH sesijas).
  • Šifrētu protokolu pārbaude (piemēram, IMAP uz porta 993 vai POP uz porta 995) pašlaik netiek atbalstīta. Kā risinājumu, lūdzu, izmantojiet net.tcp.port[] šādām pārbaudēm.
  • LDAP un HTTPS pārbaude Windows vidē tiek atbalstīta tikai ar Zabbix aģents 2.
  • Telnet pārbaude meklē pieteikšanās uzvedni (':' rindas beigās).

Piemērs:

net.tcp.service[ftp,,45] #this item can be used to test the availability of FTP server on TCP port 45
net.tcp.service.perf[service,<ip>,<port>]


Pārbauda TCP pakalpojuma veiktspēju.
Atgrieztās vērtības: Float (0 - pakalpojums nedarbojas; sekundes - sekunžu skaits, kas pavadīts, gaidot atbildi no pakalpojuma).
Skatiet atbalstītās platformas.

Parametri:

  • service - ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https vai telnet (skatiet detalizētu informāciju);
  • ip - IP adrese vai DNS nosaukums (noklusējuma vērtība ir 127.0.0.1);
  • port - porta numurs (pēc noklusējuma tiek izmantots standarta pakalpojuma porta numurs).

Piezīmes:

  • Šobrīd šifrētu protokolu pārbaude (piemēram, IMAP uz porta 993 vai POP uz porta 995) netiek atbalstīta. Kā risinājumu, lūdzu, izmantojiet net.tcp.service.perf[tcp,<ip>,<port>] šādām pārbaudēm.
  • Telnet pārbaude meklē pieteikšanās uzvedni (':' rindas beigās).

Piemērs:

net.tcp.service.perf[ssh] #šo vienumu var izmantot, lai pārbaudītu sākotnējās atbildes ātrumu no SSH serveris
net.tcp.socket.count[<laddr>,<lport>,<raddr>,<rport>,<state>]


Atgriež TCP ligzdu skaitu, kas atbilst parametriem.
Atgrieztā vērtība: Integer.
Atbalstītās platformas: Linux, Windows.

Parametri:

  • laddr — lokālā IPv4/6 adrese vai CIDR apakštīkls;
  • lport — lokālā porta numurs vai servisa nosaukums;
  • raddr — attālā IPv4/6 adrese vai CIDR apakštīkls;
  • rport — attālā porta numurs vai servisa nosaukums;
  • state — savienojuma stāvoklis (established, syn_sent, syn_recv, fin_wait1, fin_wait2, time_wait, close, close_wait, last_ack, listen, closing).

Piemērs:

net.tcp.socket.count[,80,,,established] #savienojumu skaits ar lokālo TCP portu 80 established stāvoklī
net.udp.listen[port]


Pārbauda, vai šis UDP ports ir LISTEN stāvoklī.
Atgrieztās vērtības: 0 - tas nav LISTEN stāvoklī; 1 - tas ir LISTEN stāvoklī.
Atbalstītās platformas: Linux, FreeBSD, Solaris, MacOS X.

Parametrs:

  • port - UDP porta numurs

Piemērs:

net.udp.listen[68]
net.udp.service[service,<ip>,<port>]


Pārbauda, vai pakalpojums darbojas un atbild uz UDP pieprasījumiem.
Atgrieztās vērtības: 0 - pakalpojums nedarbojas; 1 - pakalpojums darbojas.
Skatiet atbalstītās platformas.

Parametri:

  • service - ntp (skatiet detalizētu informāciju);
  • ip - IP adrese vai DNS nosaukums (noklusējuma vērtība ir 127.0.0.1);
  • port - porta numurs (pēc noklusējuma tiek izmantots standarta pakalpojuma porta numurs).

Piemērs:

net.udp.service[ntp,,45] #this item can be used to test the availability of NTP service on UDP port 45
net.udp.service.perf[service,<ip>,<port>]


Pārbauda UDP pakalpojuma veiktspēju.
Atgrieztās vērtības: Float (0 - pakalpojums nedarbojas; sekundes - sekunžu skaits, kas pavadīts, gaidot atbildi no pakalpojuma).
Skatiet atbalstītās platformas.

Parametri:

  • service - ntp (skatiet detalizētu informāciju);
  • ip - IP adrese vai DNS nosaukums (pēc noklusējuma tiek izmantots 127.0.0.1);
  • port - porta numurs (pēc noklusējuma tiek izmantots standarta pakalpojuma porta numurs).

Piemērs:

net.udp.service.perf[ntp] #this item can be used to test response time from NTP service
net.udp.socket.count[<laddr>,<lport>,<raddr>,<rport>,<state>]


Atgriež UDP ligzdu skaitu, kas atbilst parametriem.
Atgrieztā vērtība: Integer.
Atbalstītās platformas: Linux, Windows.

Parametri:

  • laddr — lokālā IPv4/6 adrese vai CIDR apakštīkls;
  • lport — lokālā porta numurs vai servisa nosaukums;
  • raddr — attālā IPv4/6 adrese vai CIDR apakštīkls;
  • rport — attālā porta numurs vai servisa nosaukums;
  • state — savienojuma stāvoklis (established, unconn).

Piemērs:

net.udp.socket.count[,,,,established] #atgriež UDP ligzdu skaitu savienotā stāvoklī
proc.cpu.util[<name>,<user>,<type>,<cmdline>,<mode>,<zone>]


Procesa CPU izmantošanas procentuālā vērtība.
Atgrieztā vērtība: Float.
Atbalstītās platformas: Linux, Solaris6.

Parametri:

  • name - procesa nosaukums (noklusējums ir visi procesi);
  • user - lietotāja vārds (noklusējums ir visi lietotāji);
  • type - CPU izmantošanas tips: total (noklusējums), user vai system;
  • cmdline - filtrēšana pēc komandrindas (tas ir regulāra izteiksme);
  • mode - datu iegūšanas režīms: avg1 (noklusējums), avg5 vai avg15;
  • zone - mērķa zona: current (noklusējums) vai all. Šis parametrs tiek atbalstīts tikai Solaris.

Komentāri:

  • Atgrieztā vērtība ir balstīta uz viena CPU kodola izmantošanas procentuālo vērtību. Piemēram, procesa CPU izmantošana, kas pilnībā izmanto divus kodolus, ir 200%.
  • Procesa CPU izmantošanas dati tiek iegūti ar savācēju, kas atbalsta ne vairāk kā 1024 unikālus (pēc nosaukuma, lietotāja un komandrindas) vaicājumus. Vaicājumi, kuri nav izmantoti pēdējo 24 stundu laikā, tiek noņemti no savācēja.
  • Ja zone parametrs ir iestatīts uz current (vai noklusējumu) gadījumā, kad aģents ir kompilēts uz Solaris bez zonu atbalsta, bet darbojas jaunākā Solaris versijā, kur zonas tiek atbalstītas, aģents atgriezīs NOTSUPPORTED (aģents nevar ierobežot rezultātus tikai uz pašreizējo zonu). Tomēr šajā gadījumā all tiek atbalstīts.

Piemēri:

proc.cpu.util[,root] #CPU izmantošana visiem procesiem, kas darbojas zem "root" lietotāja
proc.cpu.util[zabbix_server,zabbix] #CPU izmantošana visiem zabbix_server procesiem, kas darbojas zem zabbix lietotāja
proc.get[<name>,<user>,<cmdline>,<mode>]


OS procesu un to parametru saraksts. Var izmantot zemlīmeņa atklāšanai.
Atgrieztā vērtība: JSON virkne.
Atbalstītās platformas: Linux, FreeBSD, Windows, OpenBSD, NetBSD.

Parametri:

  • name - procesa nosaukums (noklusējums visi procesi).
  • user - lietotāja vārds (noklusējums visi lietotāji).
  • cmdline - filtrēšana pēc komandrindas (tas ir regulāra izteiksme). Šis parametrs nav atbalstīts Windows; citās platformās tas nav atbalstīts, ja mode ir iestatīts uz 'summary'.
  • mode - iespējamās vērtības:
    • process (noklusējums);
    • thread (nav atbalstīts NetBSD);
    • summary. Skatiet katram režīmam un OS atgriezto procesu parametru sarakstu.

Komentāri:

  • Ja vērtību nevar izgūt, piemēram, kļūdas dēļ (process jau ir beidzis darbību, trūkst atļauju, sistēmas izsaukuma kļūme), tiks atgriezts -1.
  • Skatiet piezīmes par procesu atlasi ar name un cmdline parametriem (tikai Linux).

Piemēri:

proc.get[zabbix_server,zabbix,,process] #visu zabbix_server procesu saraksts, kas darbojas zem zabbix lietotāja, atgriež vienu ierakstu uz katru PID
proc.get[java,,,thread] #visu Java procesu saraksts, atgriež vienu ierakstu uz katru pavedienu
proc.get[,zabbix,,summary] #apkopotie dati par katra tipa procesiem, kas darbojas zem zabbix lietotāja, atgriež vienu ierakstu uz katru procesa nosaukumu
proc.mem[<name>,<user>,<mode>,<cmdline>,<memtype>]


Procesa izmantotā atmiņa baitos.
Atgrieztā vērtība:

  • Integer - ja mode ir max, min, sum;
  • Float - ja mode ir avg
    Atbalstītās platformas: Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.

Parametri:

  • name - procesa nosaukums (noklusējums ir all processes);
  • user - lietotāja vārds (noklusējums ir all users);
  • mode - iespējamās vērtības: avg, max, min vai sum (noklusējums);
  • cmdline - filtrēšana pēc komandrindas (tā ir regulāra izteiksme);
  • memtype - procesā izmantotās atmiņas tips

Komentāri:

  • memtype parametrs tiek atbalstīts tikai Linux, FreeBSD, Solaris6, AIX.
  • Ja vairāki procesi izmanto koplietojamo atmiņu, procesu izmantotās atmiņas summa var radīt lielas, nereālistiskas vērtības.

    Skatiet piezīmes par procesu atlasi ar name un cmdline parametriem (tikai Linux).

    Ja šis vienums tiek izsaukts no komandrindas un satur komandrindas parametru (piem., izmantojot aģents testa režīmu: zabbix_agentd -t proc.mem[,,,apache2]), tiks ieskaitīts viens papildu process, jo aģents skaitīs arī pats sevi.

Piemēri:

proc.mem[,root] #atmiņa, ko izmanto visi procesi, kas darbojas zem "root" lietotāja
proc.mem[zabbix_server,zabbix] #atmiņa, ko izmanto visi zabbix_server procesi, kas darbojas zem zabbix lietotāja
proc.mem[,oracle,max,oracleZABBIX] #atmiņa, ko izmanto process ar vislielāko atmiņas patēriņu, kas darbojas zem Oracle un kura komandrindā ir oracleZABBIX
proc.num[<name>,<user>,<state>,<cmdline>,<zone>]


Procesu skaits.
Atgrieztā vērtība: Integer.
Atbalstītās platformas: Linux, FreeBSD, Solaris6, HP-UX, AIX, OpenBSD, NetBSD, Windows.

Parametri:

  • name - procesa nosaukums (noklusējums ir all processes).
  • user - lietotāja vārds (noklusējums ir all users).
  • state - iespējamās vērtības:
    • all (noklusējums);
    • disk - nepārtraucams miegs;
    • run - darbojas;
    • sleep - pārtraucams miegs;
    • trace - apturēts;
    • zomb - zombijs.
  • cmdline - filtrē pēc komandrindas (tā ir regulāra izteiksme).
  • zone - mērķa zona: current (noklusējums) vai all. Šis parametrs tiek atbalstīts tikai Solaris.

Komentāri:

  • disk un trace stāvokļa parametri tiek atbalstīti tikai Linux, FreeBSD, OpenBSD, NetBSD.
  • Windows tiek atbalstīti tikai name un user parametri.
  • Ja šis vienums tiek izsaukts no komandrindas un satur komandrindas parametru (piem., izmantojot aģenta testa režīmu: zabbix_agentd -t proc.num[,,,apache2]), tiks ieskaitīts vēl viens process, jo aģents ieskaitīs pats sevi.
  • Ja, iestatot zone parametru uz current (vai noklusējumu), gadījumā, kad aģents ir kompilēts Solaris versijā bez zonu atbalsta, bet darbojas jaunākā Solaris versijā, kur zonas tiek atbalstītas, aģents atgriezīs NOTSUPPORTED (aģents nevar ierobežot rezultātus tikai līdz pašreizējai zonai). Tomēr šajā gadījumā tiek atbalstīts all.
  • Skatiet piezīmes par procesu atlasi ar name un cmdline parametriem (tikai Linux).

Piemēri:

proc.num[,mysql] #procesu skaits, kas darbojas zem mysql lietotāja
proc.num[apache2,www-data] #apache2 procesu skaits, kas darbojas zem www-data lietotāja
proc.num[,oracle,sleep,oracleZABBIX] #procesu skaits sleep stāvoklī, kas darbojas zem Oracle un kuru komandrindā ir oracleZABBIX
sensor[device,sensor,<mode>]


Aparatūras sensora nolasījums.
Atgrieztā vērtība: Float.
Atbalstītās platformas: Linux, OpenBSD.

Parametri:

  • device - ierīces nosaukums;
  • sensor - sensora nosaukums;
  • mode - iespējamās vērtības: avg, max vai min.

Komentāri:

  • Nolasa /proc/sys/dev/sensors Linux 2.4 sistēmās.
  • Nolasa /sys/class/hwmon Linux 2.6+ sistēmās. Skatiet detalizētāku sensor vienuma aprakstu Linux vidē.
  • Nolasa hw.sensors MIB OpenBSD sistēmās.
  • Linux 2.4 sistēmās, ja norādāt mode, tad device un sensor tiek apstrādāti kā regulāras izteiksmes.
  • Linux 2.6+ un OpenBSD sistēmās, vai ja mode nav norādīts, device un sensor tiek apstrādāti burtiski.

Piemēri:

sensor[w83781d-i2c-0-2d,temp1]
sensor[cpu0,temp0] #viena CPU temperatūra
sensor["cpu[0-2]$",temp,avg] #pirmo trīs CPU vidējā temperatūra
system.boottime


Sistēmas sāknēšanas laiks.
Atgrieztā vērtība: Integer (Unix timestamp).
Atbalstītās platformas: Linux, FreeBSD, Solaris, MacOS X, OpenBSD, NetBSD.

system.cpu.discovery


Atklāto CPU/CPU kodolu saraksts. Izmanto zema līmeņa atklāšanai.
Atgrieztā vērtība: JSON virkne.
Skatiet atbalstītās platformas.

system.cpu.intr


Ierīces pārtraukumi.
Atgrieztā vērtība: Integer.
Atbalstītās platformas: Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.

system.cpu.load[<cpu>,<mode>]


CPU slodze.
Atgrieztā vērtība: Float.
Skatiet atbalstītās platformas.

Parametri:

  • cpu — iespējamās vērtības: all (noklusējums) vai percpu (kopējā slodze dalīta ar tiešsaistē esošo CPU skaitu);
  • mode — iespējamās vērtības: avg1 (vienas minūtes vidējā vērtība, noklusējums), avg5 vai avg15.

Piemērs:

system.cpu.load[,avg5]
system.cpu.num[<type>]


CPU skaits.
Atgrieztā vērtība: Integer.
Atbalstītās platformas: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows.

Parametrs:

  • type — iespējamās vērtības: online (noklusējums) vai max

Parametrs max tiek atbalstīts tikai Linux, FreeBSD, Solaris, MacOS X.

Piemērs:

system.cpu.num
system.cpu.switches


Konteksta pārslēgšanu skaits.
Atgrieztā vērtība: Integer.
Atbalstītās platformas: Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.

system.cpu.util[<cpu>,<type>,<mode>,<logical or physical>]


CPU izmantošanas procents.
Atgrieztā vērtība: Float.
Atbalstītās platformas: Linux, FreeBSD, Solaris, HP-UX, AIX, OpenBSD, NetBSD, Windows.

Parametri:

  • cpu — <CPU number> vai all (noklusējums);
  • type — iespējamās vērtības: user (noklusējums), idle, nice, system, iowait, interrupt, softirq, steal, spin (OpenBSD), guest (Linux kodoliem 2.6.24 un jaunākiem) vai guest_nice (Linux kodoliem 2.6.33 un jaunākiem);
  • mode — iespējamās vērtības: avg1 (vienas minūtes vidējais, noklusējums), avg5 vai avg15;
  • logical or physical — iespējamās vērtības: logical (noklusējums) vai physical. Šis parametrs tiek atbalstīts tikai AIX.

Komentāri:

  • Parametrs nice tipam tiek atbalstīts tikai Linux, FreeBSD, HP-UX, OpenBSD, NetBSD.
  • Parametrs iowait tipam tiek atbalstīts tikai Linux 2.6 un jaunākās versijās, Solaris, AIX.
  • Parametrs interrupt tipam tiek atbalstīts tikai Linux 2.6 un jaunākās versijās, FreeBSD, OpenBSD.
  • Parametri softirq, steal, guest, guest_nice tipam tiek atbalstīti tikai Linux 2.6 un jaunākās versijās.
  • Režīma parametri avg5 un avg15 tiek atbalstīti Linux, FreeBSD, Solaris, HP-UX, AIX, OpenBSD, NetBSD.

Piemērs:

system.cpu.util[0,user,avg5]
system.hostname[<type>,<transform>]


Sistēmas hosta nosaukums.
Atgrieztā vērtība: String.
Skatiet atbalstītās platformas.

Parametri:

  • type - iespējamās vērtības:
    • netbios (noklusējums Windows);
    • host (noklusējums Linux);
    • shorthost (atgriež hosta nosaukuma daļu pirms pirmā punkta, pilnu virkni nosaukumiem bez punktiem);
    • fqdn (atgriež pilnībā kvalificētu domēna nosaukumu).
  • transform - iespējamās vērtības:
    • none (noklusējums);
    • lower (pārveido uz mazajiem burtiem).

Vērtība tiek iegūta, no uname() sistēmas API izvades paņemot nodename.

Atgriezto vērtību piemēri:

system.hostname → linux-w7x1
system.hostname → example.com
system.hostname[shorthost] → example
system.hostname → WIN-SERV2008-I6
system.hostname[host] → Win-Serv2008-I6LonG
system.hostname[host,lower] → win-serv2008-i6long
system.hostname[fqdn,lower] → blog.zabbix.com
system.hw.chassis[<info>]


Šasijas informācija.
Atgrieztā vērtība: String.
Atbalstītās platformas: Linux.

Parametrs:

  • info — iespējamās vērtības: full (noklusējums), model, serial, type vai vendor

Komentāri:

  • Šī vienuma atslēga ir atkarīga no SMBIOS tabulas pieejamības.
  • Tiks mēģināts nolasīt DMI tabulu no sysfs; ja piekļuve sysfs neizdosies, tad tiks mēģināts nolasīt to tieši no atmiņas.
  • Nepieciešamas root tiesības, jo vērtība tiek iegūta, nolasot datus no sysfs vai atmiņas.

Piemērs:

system.hw.chassis[full] → Hewlett-Packard HP Pro 3010 Small Form Factor PC CZXXXXXXXX Desktop
system.hw.cpu[<cpu>,<info>]


CPU informācija.
Atgrieztā vērtība: String vai Integer.
Atbalstītās platformas: Linux.

Parametri:

  • cpu — <CPU numurs> vai all (noklusējums);
  • info — iespējamās vērtības: full (noklusējums), curfreq, maxfreq, model vai vendor.

Komentāri:

  • Apkopo informāciju no /proc/cpuinfo un /sys/devices/system/cpu/[cpunum]/cpufreq/cpuinfo_max_freq.
  • Ja ir norādīts CPU numurs un curfreq vai maxfreq, tiek atgriezta skaitliska vērtība (Hz).

Piemērs:

system.hw.cpu[0,vendor] → AuthenticAMD
system.hw.devices[<type>]


PCI vai USB ierīču saraksts.
Atgrieztā vērtība: Teksts.
Atbalstītās platformas: Linux.

Parametrs:

  • type - pci (noklusējums) vai usb

Atgriež vai nu lspci, vai lsusb utilītas izvadi (izpildītas bez jebkādiem parametriem).

Piemērs:

system.hw.devices → 00:00.0 Host bridge: Advanced Micro Devices [AMD] RS780 Host Bridge
system.hw.macaddr[<interface>,<format>]


MAC adrešu uzskaitījums.
Atgrieztā vērtība: String.
Atbalstītās platformas: Linux.

Parametri:

  • interface - all (noklusējums) vai regulāra izteiksme;
  • format - full (noklusējums) vai short.

Komentāri:

  • Uzskaita to interfeisu MAC adreses, kuru nosaukums atbilst norādītajai interface regulārajai izteiksmei (all uzskaita visiem interfeisiem).
  • Ja format ir norādīts kā short, interfeisu nosaukumi un identiskas MAC adreses netiek uzskaitītas.

Piemērs:

system.hw.macaddr["eth0$",full] → [eth0] 00:11:22:33:44:55
system.localtime[<type>]


Sistēmas laiks.
Atgrieztā vērtība: Integer - ja type ir utc; String - ja type ir local.
Skatiet atbalstītās platformas.

Parametri:

  • type - iespējamās vērtības:
    • utc - (noklusējums) laiks kopš Unix ēras sākuma (00:00:00 UTC, 1970. gada 1. janvāris), mērīts sekundēs;
    • local - laiks formātā 'yyyy-mm-dd,hh:mm:ss.nnn,+hh:mm'.

Jāizmanto kā pasīva pārbaude Zabbix aģentam; Zabbix aģents 2 to var konfigurēt kā aktīvu pārbaudi.

Piemērs:

system.localtime[local] #izveidojiet vienumu, izmantojot šo atslēgu, un pēc tam izmantojiet to, lai parādītu hosts laiku *Clock* informācijas paneļa logrīkā.
system.run[command,<mode>]


Izpilda norādīto komandu uz hosta.
Atgrieztā vērtība: Text komandas rezultāts vai 1 - ar mode kā nowait (neatkarīgi no komandas rezultāta).
Skatiet atbalstītās platformas.

Parametri:

  • command - komanda izpildei;
  • mode - iespējamās vērtības:
    • wait - gaidīt izpildes beigas (noklusējums);
    • nowait - negaidīt.

Piezīmes:

  • Pēc noklusējuma šis vienums ir atspējots. Uzziniet, kā to iespējot.
  • Vienuma atgrieztā vērtība ir standarta izvade kopā ar standarta kļūdu, ko rada komanda. Izpildes koda pārbaude netiek veikta.
  • Lai to apstrādātu pareizi, komandas atgrieztajai vērtībai jābūt text datu tipam. Tukšs rezultāts arī ir atļauts.
  • Atgrieztā vērtība ir ierobežota līdz 16 MB (ieskaitot beigu atstarpes, kas tiek saīsinātas); attiecas arī datubāzes ierobežojumi.
  • Skatiet arī: Komandu izpilde.

Piemērs:

system.run[ls -l /] #atgriež detalizētu saknes direktorija failu sarakstu
system.stat[resource,<type>]


Sistēmas statistika.
Atgrieztā vērtība: Integer vai float.
Atbalstītās platformas: AIX.

Parametri:

  • ent - procesora vienību skaits, uz kuru šai nodalījumam ir tiesības (float).
  • kthr,<type> - informācija par kodola pavedienu stāvokļiem:
    • r - izpildāmo kodola pavedienu vidējais skaits (float);
    • b - kodola pavedienu vidējais skaits, kas ievietoti Virtual Memory Manager gaidīšanas rindā (float).
  • memory,<type> - informācija par virtuālās un reālās atmiņas izmantošanu:
    • avm - aktīvās virtuālās lapas (integer);
    • fre - brīvā saraksta lielums (integer).
  • page,<type> - informācija par lapu kļūdām un lapošanas aktivitāti:
    • fi - failu lapu ielādes sekundē (float);
    • fo - failu lapu izlādes sekundē (float);
    • pi - lapas, kas ielādētas no lapošanas vietas (float);
    • po - lapas, kas izvadītas uz lapošanas vietu (float);
    • fr - atbrīvotās lapas (lapu aizstāšana) (float);
    • sr - lapas, ko skenējis lapu aizstāšanas algoritms (float).
  • faults,<type> - pārtraukumu un trapu biežums:
    • in - ierīču pārtraukumi (float);
    • sy - sistēmas izsaukumi (float);
    • cs - kodola pavedienu konteksta pārslēgšanās (float).
  • cpu,<type> - procesora laika izmantošanas procentuālais sadalījums:
    • us - lietotāja laiks (float);
    • sy - sistēmas laiks (float);
    • id - dīkstāves laiks (float);
    • wa - dīkstāves laiks, kurā sistēmai bija neizpildīti diska/NFS I/O pieprasījumi (float);
    • pc - izmantoto fizisko procesoru skaits (float);
    • ec - izmantotās piešķirtās jaudas procentuālā daļa (float);
    • lbusy - norāda loģisko procesoru izmantošanas procentuālo daļu, kas notikusi, izpildot lietotāja un sistēmas līmenī (float);
    • app - norāda pieejamos fiziskos procesorus koplietotajā pūlā (float).
  • disk,<type> - diska statistika:
    • bps - norāda uz ierīci pārsūtīto datu apjomu (lasīto vai rakstīto) baitos sekundē (integer);
    • tps - norāda pārsūtījumu skaitu sekundē, kas tika nosūtīti uz fizisko disku/lenti (float).

Komentāri:

  • Ņemiet vērā šādus ierobežojumus šajos vienumos:
    • system.stat[cpu,app] - atbalstīts tikai AIX LPAR tipa "Shared";
    • system.stat[cpu,ec] - atbalstīts AIX LPAR tipa "Shared" un "Dedicated" ("Dedicated" vienmēr atgriež 100 (procentus));
    • system.stat[cpu,lbusy] - atbalstīts tikai AIX LPAR tipa "Shared";
    • system.stat[cpu,pc] - atbalstīts AIX LPAR tipa "Shared" un "Dedicated";
    • system.stat[ent] - atbalstīts AIX LPAR tipa "Shared" un "Dedicated".
system.sw.arch


Programmatūras arhitektūras informācija.
Atgrieztā vērtība: String.
Skatiet atbalstītās platformas.

Informācija tiek iegūta no funkcijas uname().

Piemērs:

system.sw.arch → i686
system.sw.os[<info>]


Operētājsistēmas informācija.
Atgrieztā vērtība: String.
Atbalstītās platformas: Linux, Windows.

Parametrs:

  • info - iespējamās vērtības: full (noklusējuma), short vai name

Informācija tiek iegūta no (ņemiet vērā, ka ne visi faili un opcijas ir pieejami visos distributīvos):

  • /proc/version (full) Linux sistēmās;
  • /proc/version_signature (short) Linux sistēmās;
  • PRETTY_NAME parametrs no /etc/os-release Linux sistēmās, kas to atbalsta, vai /etc/issue.net (name);
  • reģistra atslēgas HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion Windows sistēmās.

Piemēri:

system.sw.os[short] → Ubuntu 2.6.35-28.50-generic 2.6.35.11
system.sw.os[full] → [s|Windows 10 Enterprise 22621.1.asd64fre.ni_release.220506-1250 Build 22621.963]
system.sw.os.get


Detalizēta informācija par operētājsistēmu (versija, tips, distribūcijas nosaukums, mazākā un lielākā versija utt.).
Atgrieztā vērtība: JSON virkne.
Atbalstītās platformas: Linux, Windows.

system.sw.packages[<regexp>,<manager>,<format>]


Instalēto pakotņu saraksts.
Atgrieztā vērtība: Text.
Atbalstītās platformas: Linux.

Parametri:

  • regexp - all (noklusējums) vai regulāra izteiksme;
  • manager - all (noklusējums) vai pakotņu pārvaldnieks;
  • format - full (noklusējums) vai short.

Komentāri:

  • Uzskaita (alfabētiskā secībā) instalētās pakotnes, kuru nosaukums atbilst norādītajai regulārajai izteiksmei (all uzskaita tās visas).
  • Atbalstītie pakotņu pārvaldnieki (izpildītā komanda):
    • pkg (dpkg --get-selections);
    • pkgtool (ls /var/log/packages);
    • rpm (rpm -qa);
    • pacman (pacman -Q);
    • portage.
  • Ja format ir norādīts kā full, pakotnes tiek grupētas pēc pakotņu pārvaldniekiem (katrs pārvaldnieks atsevišķā rindā, kas sākas ar tā nosaukumu kvadrātiekavās).
  • Ja format ir norādīts kā short, pakotnes netiek grupētas un tiek uzskaitītas vienā rindā.

Piemērs:

system.sw.packages[mini,dpkg,short] → python-minimal, python2.6-minimal, ubuntu-minimal
system.sw.packages.get[<regexp>,<manager>]


Detalizēts instalēto pakotņu saraksts.
Atgrieztā vērtība: JSON virkne.
Atbalstītās platformas: Linux.

Parametri:

  • regexp - all (noklusējums) vai regulāra izteiksme;
  • manager - all (noklusējums) vai pakotņu pārvaldnieks (iespējamās vērtības: rpm, dpkg, pkgtool, pacman vai portage).

Komentāri:

  • Atgriež neformatētu JSON ar instalētajām pakotnēm, kuru nosaukums atbilst norādītajai regulārajai izteiksmei.
  • Izvade ir objektu masīvs, kur katrs objekts satur šādus atslēgvārdus: name, manager, version, size, architecture, buildtime un installtime (skatiet sīkāku informāciju).
system.swap.in[<device>,<type>]


Swap-in (no ierīces atmiņā) statistika.
Atgrieztā vērtība: Integer.
Atbalstītās platformas: Linux, FreeBSD, OpenBSD.

Parametri:

  • device - norādiet ierīci, kas tiek izmantota swap operācijām (tikai Linux) vai all (noklusējums);
  • type - iespējamās vērtības:
    • count (swap-in skaits, noklusējums platformās, kas nav Linux);
    • sectors (swap-in sektori);
    • pages (swap-in lapas, noklusējums Linux).

Komentāri:

  • Šīs informācijas avots ir:
    • /proc/swaps, /proc/partitions, /proc/stat (Linux 2.4);
    • /proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6).
  • Ņemiet vērā, ka pages darbosies tikai tad, ja device nav norādīts.
  • sectors tipa parametrs tiek atbalstīts tikai Linux.

Piemērs:

system.swap.in[,pages]
system.swap.out[<device>,<type>]


Maiņas izrakstīšanas (no atmiņas uz ierīci) statistika.
Atgrieztā vērtība: Integer.
Atbalstītās platformas: Linux, FreeBSD, OpenBSD.

Parametri:

  • device - norādiet ierīci, kas tiek izmantota maiņai (tikai Linux) vai all (noklusējums);
  • type - iespējamās vērtības:
    • count (maiņas izrakstīšanas reižu skaits, noklusējums platformās, kas nav Linux);
    • sectors (izrakstītie sektori);
    • pages (izrakstītās lapas, noklusējums Linux).

Komentāri:

  • Šīs informācijas avots ir:
    • /proc/swaps, /proc/partitions, /proc/stat (Linux 2.4);
    • /proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6).
  • Ņemiet vērā, ka pages darbosies tikai tad, ja device nav norādīts.
  • Parametrs sectors tiek atbalstīts tikai Linux.

Piemērs:

system.swap.out[,pages]
system.swap.size[<device>,<type>]


Maiņas vietas lielums baitos vai procentos no kopējā apjoma.
Atgrieztā vērtība: Integer - baitos; Float - procentos.
Atbalstītās platformas: Linux, FreeBSD, Solaris, AIX, OpenBSD, Windows.

Parametri:

  • device - norādiet ierīci, ko izmanto maiņai (tikai FreeBSD) vai all (noklusējums);
  • type - iespējamās vērtības:
    • free (brīva maiņas vieta, noklusējums);
    • pfree (brīva maiņas vieta, procentos);
    • pused (izmantota maiņas vieta, procentos);
    • total (kopējā maiņas vieta);
    • used (izmantota maiņas vieta).

Piezīmes:

  • Ņemiet vērā, ka pfree, pused netiek atbalstīti Windows, ja maiņas vietas lielums ir 0.
  • Ja device nav norādīts, Zabbix aģents ņems vērā tikai maiņas ierīces (failus), fiziskā atmiņa tiks ignorēta. Piemēram, Solaris sistēmās komanda swap -s ietver daļu fiziskās atmiņas un maiņas ierīces (atšķirībā no swap -l).

Piemērs:

system.swap.size[,pfree] → brīvās maiņas vietas procentuālā daļa
system.uname


Sistēmas identifikācija.
Atgrieztā vērtība: String.
Skatiet atbalstītās platformas.

Komentāri:

  • UNIX sistēmās šī vienuma vērtība tiek iegūta, izmantojot uname() sistēmas izsaukumu.
  • Windows sistēmās vienums atgriež OS arhitektūru, savukārt UNIX sistēmās tas atgriež CPU arhitektūru.

Piemēri:

system.uname → FreeBSD localhost 4.2-RELEASE FreeBSD 4.2-RELEASE #0: Mon Nov i386
system.uname → Windows ZABBIX-WIN 6.0.6001 Microsoft® Windows Server® 2008 Standard Service Pack 1 x86
system.uptime


Sistēmas darbības laiks sekundēs.
Atgrieztā vērtība: Integer.
Atbalstītās platformas: Linux, FreeBSD, Solaris, AIX, MacOS X, OpenBSD, NetBSD, Windows.

Vienuma konfigurācijā izmantojiet s vai uptime mērvienības, lai iegūtu cilvēkam lasāmas vērtības.

system.users.num


Pieteikušos lietotāju skaits.
Atgrieztā vērtība: Integer.
Skatiet atbalstītās platformas.

Vērtības iegūšanai aģenta pusē tiek izmantota komanda who.

vfs.dev.discovery


Blokierīču un to tipa saraksts. Izmanto zema līmeņa atklāšanai.
Atgrieztā vērtība: JSON virkne.
Atbalstītās platformas: Linux.

vfs.dev.get[<mode>,<regexp>]


Bloku ierīču saraksts ar detalizētu informāciju. Tiek izmantots zemā līmeņa atklāšanai.
Atgrieztā vērtība: JSON virkne.
Atbalstītās platformas: Linux, AIX.

Parametri:

  • mode - iespējamās vērtības:
    • disks (noklusējums) - atgriež disku sarakstu;
    • disk_stats - atgriež statistiku par katru disku;
    • devices (tikai Linux) - atgriež bloku ierīču sarakstu (diski un nodalījumi);
    • device_stats (tikai Linux) - atgriež statistiku par katru ierīci (diski un nodalījumi).
  • regexp - regulāra izteiksme, ko izmanto bloku ierīču filtrēšanai pēc to nosaukuma.
vfs.dev.read[<device>,<type>,<mode>]


Diska lasīšanas statistika.
Atgrieztā vērtība:

  • Integer - ja type ir sectors, operations, bytes;
  • Float - ja type ir sps, ops, bps.
    Atbalstītās platformas: Linux, FreeBSD, Solaris, AIX, OpenBSD.

Parametri:

  • device - diska ierīce (noklusējums ir all 3);
  • type - iespējamās vērtības: sectors, operations, bytes, sps, ops vai bps (sps, ops, bps nozīmē attiecīgi: sektori, operācijas, baiti sekundē);
  • mode - iespējamās vērtības: avg1 (vienas minūtes vidējais, noklusējums), avg5 vai avg15. Šis parametrs tiek atbalstīts tikai tad, ja type ir: sps, ops, bps.

Komentāri:

  • Ja tiek izmantots atjaunināšanas intervāls trīs stundas vai ilgāks2, šis vienums vienmēr atgriezīs 0.
  • sectors un sps tipa parametri tiek atbalstīti tikai Linux.
  • ops tipa parametrs tiek atbalstīts tikai Linux un FreeBSD.
  • bps tipa parametrs tiek atbalstīts tikai FreeBSD.
  • bytes tipa parametrs tiek atbalstīts tikai FreeBSD, Solaris, AIX, OpenBSD.
  • Parametrs mode tiek atbalstīts tikai Linux, FreeBSD.
  • Var izmantot gan relatīvus ierīču nosaukumus (piemēram, sda), gan arī izvēles /dev/ prefiksu (piemēram, /dev/sda).
  • LVM loģiskie sējumi tiek atbalstīti.
  • Noklusējuma type parametra vērtības dažādām OS:
    • AIX - operations;
    • FreeBSD - bps;
    • Linux - sps;
    • OpenBSD - operations;
    • Solaris - bytes.
  • sps, ops un bps atbalstītajās platformās ir ierobežoti līdz 1024 ierīcēm (1023 atsevišķām un viena all).

Piemērs:

vfs.dev.read[,operations]
vfs.dev.write[<device>,<type>,<mode>]


Diska rakstīšanas statistika.
Atgrieztā vērtība: Integer - ja type ir sectors, operations, bytes; Float - ja type ir sps, ops, bps.
Atbalstītās platformas: Linux, FreeBSD, Solaris, AIX, OpenBSD.

Parametri:

  • device - diska ierīce (noklusējums ir all 3);
  • type - iespējamās vērtības: sectors, operations, bytes, sps, ops vai bps (sps, ops, bps nozīmē attiecīgi: sektori, operācijas, baiti sekundē);
  • mode - iespējamās vērtības: avg1 (vienas minūtes vidējais, noklusējums), avg5 vai avg15. Šis parametrs tiek atbalstīts tikai tad, ja type ir: sps, ops, bps.

Piezīmes:

  • Ja tiek izmantots atjaunināšanas intervāls trīs stundas vai vairāk2, šis vienums vienmēr atgriezīs 0.
  • sectors un sps tipa parametri tiek atbalstīti tikai Linux.
  • ops tipa parametrs tiek atbalstīts tikai Linux un FreeBSD.
  • bps tipa parametrs tiek atbalstīts tikai FreeBSD.
  • bytes tipa parametrs tiek atbalstīts tikai FreeBSD, Solaris, AIX, OpenBSD.
  • Parametrs mode tiek atbalstīts tikai Linux, FreeBSD.
  • Var izmantot gan relatīvus ierīču nosaukumus (piemēram, sda), gan arī izvēles /dev/ prefiksu (piemēram, /dev/sda).
  • LVM loģiskie sējumi tiek atbalstīti.
  • Noklusējuma type parametra vērtības dažādām OS:
    • AIX - operations
    • FreeBSD - bps
    • Linux - sps
    • OpenBSD - operations
    • Solaris - bytes
  • sps, ops un bps atbalstītajās platformās ir ierobežoti līdz 1024 ierīcēm (1023 atsevišķām un viena priekš all).

Piemērs:

vfs.dev.write[,operations]
vfs.dir.count[dir,<regex incl>,<regex excl>,<types incl>,<types excl>,<max depth>,<min size>,<max size>,<min age>,<max age>,<regex excl dir>]


Direktorija ierakstu skaits.
Atgrieztā vērtība: Integer.
Skatiet atbalstītās platformas.

Parametri:

  • dir - absolūtais ceļš uz direktoriju;
  • regex incl - regulāra izteiksme, kas apraksta iekļaujamās entītijas (faila, direktorijas, simboliskās saites) nosaukuma modeli; ja vērtība ir tukša, tiek iekļautas visas entītijas (noklusējuma vērtība);
  • regex excl - regulāra izteiksme, kas apraksta izslēdzamās entītijas (faila, direktorijas, simboliskās saites) nosaukuma modeli; ja vērtība ir tukša, nekas netiek izslēgts (noklusējuma vērtība);
  • types incl - skaitāmo direktorijas ierakstu tipi; iespējamās vērtības:
    • file - parasts fails;
    • dir - apakšdirektorija;
    • sym - simboliskā saite;
    • sock - ligzda;
    • bdev - bloka ierīce;
    • cdev - rakstzīmju ierīce;
    • fifo - FIFO;
    • dev - sinonīms vērtībām "bdev,cdev";
    • all - visi tipi (noklusējuma vērtība), t. i., "file,dir,sym,sock,bdev,cdev,fifo". Vairāki tipi jāatdala ar komatu un jāiekļauj pēdiņās.
  • types excl - direktorijas ierakstu tipi (skatiet types incl), kurus NEIESKAITA. Ja kāds ieraksta tips ir norādīts gan types incl, gan types excl, šāda tipa direktorijas ieraksti NETIEK ieskaitīti.
  • max depth - maksimālais apakšdirektoriju dziļums, līdz kuram veikt traversēšanu:
    • -1 (noklusējuma vērtība) - neierobežots;
    • 0 - neveikt traversēšanu apakšdirektorijās.
  • min size - minimālais faila izmērs (baitos), lai fails tiktu ieskaitīts. Mazāki faili netiks ieskaitīti. Var izmantot atmiņas sufiksus.
  • max size - maksimālais faila izmērs (baitos), lai fails tiktu ieskaitīts. Lielāki faili netiks ieskaitīti. Var izmantot atmiņas sufiksus.
  • min age - minimālais direktorijas ieraksta vecums (sekundēs), lai tas tiktu ieskaitīts. Jaunāki ieraksti netiks ieskaitīti. Var izmantot laika sufiksus.
  • max age - maksimālais direktorijas ieraksta vecums (sekundēs), lai tas tiktu ieskaitīts. Ieraksti, kas ir tikpat veci vai vecāki, netiks ieskaitīti (pēc modificēšanas laika). Var izmantot laika sufiksus.
  • regex excl dir - regulāra izteiksme, kas apraksta izslēdzamās direktorijas nosaukuma modeli. Viss direktorijas saturs tiks izslēgts (atšķirībā no regex_excl).

Komentāri:

  • Operētājsistēmā Windows šis vienums atbalsta UNC ceļus, kas var radīt drošības risku.
  • Vides mainīgie, piemēram, %APP_HOME%, $HOME un %TEMP%, netiek atbalstīti.
  • Pseidodirektorijas "." un ".." nekad netiek ieskaitītas.
  • Simboliskās saites nekad netiek izmantotas direktoriju traversēšanai.
  • Gan regex incl, gan regex excl tiek lietotas failiem un direktorijām, aprēķinot ierakstu skaitu, taču tās tiek ignorētas, izvēloties traversējamās apakšdirektorijas (ja regex incl ir (?i)^.+\.zip$ un max depth nav iestatīts, tiks traversētas visas apakšdirektorijas, bet tiks ieskaitīti tikai zip tipa faili).
  • Izpildes laiku ierobežo taimauta vērtība aģenta konfigurācijā (3 sek.). Tā kā lielas direktoriju struktūras traversēšana var aizņemt vairāk laika, dati netiks atgriezti un vienums kļūs neatbalstīts. Daļējs skaits netiks atgriezts.
  • Filtrējot pēc izmēra, nozīmīgs izmērs ir tikai parastajiem failiem. Linux un BSD sistēmās direktorijām arī ir izmērs, kas nav nulle (parasti daži KB). Ierīču izmērs ir nulle, piemēram, /dev/sda1 izmērs neatspoguļo attiecīgā nodalījuma izmēru. Tāpēc, izmantojot <min_size> un <max_size>, ieteicams norādīt <types_incl> kā "file", lai izvairītos no neparedzētiem rezultātiem.

Piemēri:

vfs.dir.count[/dev] #uzrauga ierīču skaitu direktorijā /dev (Linux)
vfs.dir.count["C:\Users\ADMINI~1\AppData\Local\Temp"] #uzrauga failu skaitu pagaidu direktorijā
vfs.dir.get[dir,<regex incl>,<regex excl>,<types incl>,<types excl>,<max depth>,<min size>,<max size>,<min age>,<max age>,<regex excl dir>]


Direktorija ierakstu saraksts.
Atgrieztā vērtība: JSON virkne.
Skatiet atbalstītās platformas.

Parametri:

  • dir - absolūtais ceļš uz direktoriju;
  • regex incl - regulāra izteiksme, kas apraksta iekļaujamās entītijas (faila, direktorijas, simboliskās saites) nosaukuma modeli; ja vērtība ir tukša, tiek iekļautas visas entītijas (noklusējuma vērtība);
  • regex excl - regulāra izteiksme, kas apraksta izslēdzamās entītijas (faila, direktorijas, simboliskās saites) nosaukuma modeli; ja vērtība ir tukša, nekas netiek izslēgts (noklusējuma vērtība);
  • types incl - uzskaitāmo direktorijas ierakstu tipi; iespējamās vērtības:
    • file - parasts fails;
    • dir - apakšdirektorija;
    • sym - simboliskā saite;
    • sock - ligzda;
    • bdev - blokierīce;
    • cdev - rakstzīmierīce;
    • fifo - FIFO;
    • dev - sinonīms vērtībai "bdev,cdev";
    • all - visi tipi (noklusējuma vērtība), t. i., "file,dir,sym,sock,bdev,cdev,fifo". Vairāki tipi jāatdala ar komatu un jāiekļauj pēdiņās.
  • types excl - direktorijas ierakstu tipi (skatiet types incl), kurus NEUZSKAITĪT. Ja kāds ieraksta tips ir norādīts gan types incl, gan types excl, šī tipa direktorijas ieraksti NETIEK uzskaitīti.
  • max depth - maksimālais apakšdirektoriju dziļums, kurā veikt pārlūkošanu:
    • -1 (noklusējuma vērtība) - neierobežots;
    • 0 - neveikt pārlūkošanu apakšdirektorijās.
  • min size - minimālais faila izmērs (baitos), lai fails tiktu uzskaitīts. Mazāki faili netiks uzskaitīti. Var izmantot atmiņas sufiksus.
  • max size - maksimālais faila izmērs (baitos), lai fails tiktu uzskaitīts. Lielāki faili netiks uzskaitīti. Var izmantot atmiņas sufiksus.
  • min age - minimālais direktorijas ieraksta vecums (sekundēs), lai ieraksts tiktu uzskaitīts. Jaunāki ieraksti netiks uzskaitīti. Var izmantot laika sufiksus.
  • max age - maksimālais direktorijas ieraksta vecums (sekundēs), lai ieraksts tiktu uzskaitīts. Ieraksti, kas ir tikpat veci vai vecāki, netiks uzskaitīti (pēc modificēšanas laika). Var izmantot laika sufiksus.
  • regex excl dir - regulāra izteiksme, kas apraksta izslēdzamās direktorijas nosaukuma modeli. Viss direktorijas saturs tiks izslēgts (atšķirībā no regex excl).

Piezīmes:

  • Operētājsistēmā Windows šis vienums seko UNC ceļiem, kas var radīt drošības risku.
  • Vides mainīgie, piemēram, %APP_HOME%, $HOME un %TEMP%, netiek atbalstīti.
  • Pseidodirektorijas "." un ".." nekad netiek uzskaitītas.
  • Simboliskās saites direktoriju pārlūkošanas laikā nekad netiek izmantotas.
  • Gan regex incl, gan regex excl tiek lietotas failiem un direktorijām, ģenerējot ierakstu sarakstu, taču tās tiek ignorētas, izvēloties pārlūkojamās apakšdirektorijas (ja regex incl ir (?i)^.+\.zip$ un max depth nav iestatīts, tiks pārlūkotas visas apakšdirektorijas, bet tiks uzskaitīti tikai zip tipa faili).
  • Izpildes laiku ierobežo taimauta vērtība aģenta konfigurācijā. Tā kā lielas direktoriju struktūras pārlūkošana var aizņemt vairāk laika, dati netiks atgriezti un vienums kļūs neatbalstīts. Daļējs saraksts netiks atgriezts.
  • Filtrējot pēc izmēra, nozīmīgs izmērs ir tikai parastiem failiem. Linux un BSD sistēmās arī direktorijām ir izmērs, kas nav nulle (parasti daži KB). Ierīču izmērs ir nulle, piemēram, /dev/sda1 izmērs neatspoguļo attiecīgā nodalījuma izmēru. Tāpēc, izmantojot min size un max size, ieteicams norādīt types incl kā "file", lai izvairītos no neparedzētiem rezultātiem.

Piemēri:

vfs.dir.get[/dev] #iegūst ierīču sarakstu direktorijā /dev (Linux)
vfs.dir.get["C:\Users\ADMINI~1\AppData\Local\Temp"] #iegūst failu sarakstu pagaidu direktorijā
vfs.dir.size[dir,<regex incl>,<regex excl>,<mode>,<max depth>,<regex excl dir>]


Direktorijas izmērs (baitos).
Atgrieztā vērtība: Integer.
Atbalstītās platformas: Linux, Windows. Vienums var darboties arī citās UNIX līdzīgās platformās.

Parametri:

  • dir - absolūtais ceļš uz direktoriju;
  • regex incl - regulāra izteiksme, kas apraksta iekļaujamā objekta (fails, direktorija, simboliskā saite) nosaukuma rakstu; ja tukšs, iekļauj visus (noklusējuma vērtība);
  • regex excl - regulāra izteiksme, kas apraksta izslēdzamā objekta (fails, direktorija, simboliskā saite) nosaukuma rakstu; ja tukšs, neizslēdz nevienu (noklusējuma vērtība);
  • mode - iespējamās vērtības:
    • apparent (noklusējums) - iegūst failu šķietamo izmēru, nevis diska lietojumu (darbojas kā du -sb dir);
    • disk - iegūst diska lietojumu (darbojas kā du -s -B1 dir). Atšķirībā no du komandas, vfs.dir.size vienums, aprēķinot direktorijas izmēru, ņem vērā arī slēptos failus (darbojas kā du -sb .[^.]* * direktorijā).
  • max depth - maksimālais apakšdirektoriju dziļums, ko traversēt:
    • -1 (noklusējums) - neierobežots;
    • 0 - neieiet apakšdirektorijās.
  • regex excl dir - regulāra izteiksme, kas apraksta izslēdzamās direktorijas nosaukuma rakstu. Visa direktorijas satura apstrāde tiks izslēgta (atšķirībā no regex excl)

Komentāri:

  • Operētājsistēmā Windows šis vienums seko UNC ceļiem, kas var radīt drošības risku.
  • Tiek aprēķinātas tikai tās direktorijas, kurām lietotājam zabbix ir vismaz lasīšanas atļauja. Direktorijām tikai ar lasīšanas atļauju tiek aprēķināts pašas direktorijas izmērs. Direktorijas ar lasīšanas un izpildes atļaujām tiek aprēķinātas, iekļaujot saturu.
  • Lielām direktorijām vai lēniem diskiem šis vienums var pārsniegt noildzi aģents un serveris/starpniekserveris konfigurācijas failos norādītā Timeout iestatījuma dēļ. Palieliniet noildzes vērtības, ja nepieciešams.
  • Faila izmēra ierobežojums ir atkarīgs no lielo failu atbalsta.

Piemēri:

vfs.dir.size[/tmp,log] #aprēķina visu failu izmēru /tmp, kuru nosaukumos ir 'log'
vfs.dir.size[/tmp,log,^.+\.old$] #aprēķina visu failu izmēru /tmp, kuru nosaukumos ir 'log', izslēdzot failus, kuru nosaukumi beidzas ar '.old'
vfs.file.cksum[file,<mode>]


Faila kontrolsumma, kas aprēķināta, izmantojot UNIX cksum algoritmu.
Atgrieztā vērtība: Integer - ja mode ir crc32, String - ja mode ir md5, sha256.
Skatiet atbalstītās platformas.

Parametri:

  • file - pilnais ceļš uz failu;
  • mode - crc32 (noklusējums), md5 vai sha256.

Komentāri:

Piemērs:

vfs.file.cksum[/etc/passwd]

Atgriezto vērtību piemēri (attiecīgi crc32/md5/sha256):

675436101
9845acf68b73991eb7fd7ee0ded23c44
ae67546e4aac995e5c921042d0cf0f1f7147703aa42bfbfb65404b30f238f2dc
vfs.file.contents[file,<encoding>]


Faila satura izgūšana7.
Atgrieztā vērtība: Text.
Skatiet atbalstītās platformas.

Parametri:

  • file - pilnais ceļš uz failu;
  • encoding - kodu lapas identifikators.

Komentāri:

  • Windows vidē šis vienums seko UNC ceļiem, kas var radīt drošības risku.
  • Atgrieztā vērtība ir ierobežota līdz 16 MB (ieskaitot beigu atstarpes, kas tiek saīsinātas); attiecas arī datubāzes ierobežojumi.
  • Tiek atgriezta tukša virkne, ja fails ir tukšs vai satur tikai LF/CR rakstzīmes.
  • Baitu secības atzīme (BOM) netiek iekļauta izvadē.

Piemērs:

vfs.file.contents[/etc/passwd]
vfs.file.exists[file,<types incl>,<types excl>]


Pārbauda, vai fails eksistē.
Atgrieztā vērtība: 0 - nav atrasts; 1 - norādītā tipa fails eksistē.
Skatiet atbalstītās platformas.

Parametri:

  • file - pilnais ceļš uz failu;
  • types incl - iekļaujamo failu tipu saraksts, iespējamās vērtības:
    • file (parasts fails, noklusējums (ja types_excl nav iestatīts));
    • dir (direktorija);
    • sym (simboliskā saite);
    • sock (sokets);
    • bdev (bloka ierīce);
    • cdev (rakstzīmju ierīce);
    • fifo (FIFO);
    • dev (sinonīms "bdev,cdev");
    • all (visi minētie tipi, noklusējums, ja types_excl ir iestatīts).
  • types excl - izslēdzamo failu tipu saraksts, skatiet types_incl par iespējamām vērtībām (pēc noklusējuma netiek izslēgti nekādi tipi)

Piezīmes:

  • Operētājsistēmā Windows šis vienums seko UNC ceļiem, kas var radīt drošības risku.
  • Vairāki tipi jāatdala ar komatu, un viss kopums jāievieto pēdiņās "".
  • Ja viens un tas pats tips ir gan <types_incl>, gan <types_excl>, šī tipa faili tiek izslēgti.
  • Faila izmēra ierobežojums ir atkarīgs no lielo failu atbalsta.

Piemēri:

vfs.file.exists[/tmp/application.pid]
vfs.file.exists[/tmp/application.pid,"file,dir,sym"]
vfs.file.exists[/tmp/application_dir,dir]
vfs.file.get[file]


Atgriež informāciju par failu.
Atgrieztā vērtība: JSON virkne.
Skatiet atbalstītās platformas.

Parametrs:

  • file - pilns ceļš uz failu

Komentāri:

  • Operētājsistēmā Windows šis vienums seko UNC ceļiem, kas var būt drošības risks.
  • Atbalstītie failu tipi UNIX līdzīgās sistēmās: parasts fails, direktorijs, simboliskā saite, ligzda, bloka ierīce, rakstzīmju ierīce, FIFO.
  • Faila lieluma ierobežojums ir atkarīgs no lielo failu atbalsta.

Piemērs:

vfs.file.get[/etc/passwd] #return a JSON with information about the /etc/passwd file (type, user, permissions, SID, uid etc)
vfs.file.md5sum[file]


Faila MD5 kontrolsumma.
Atgrieztā vērtība: rakstzīmju virkne (faila MD5 jaucējkods).
Skatiet atbalstītās platformas.

Parametrs:

  • file - pilnais ceļš uz failu

Komentāri:

Piemērs:

vfs.file.md5sum[/usr/local/etc/zabbix_agentd.conf]

Atgrieztās vērtības piemērs:

b5052decb577e0fffd622d6ddc017e82
vfs.file.owner[file,<ownertype>,<resulttype>]


Iegūst faila īpašnieku.
Atgrieztā vērtība: String.
Skatiet atbalstītās platformas.

Parametri:

  • file - pilns ceļš līdz failam;
  • ownertype - user (noklusējums) vai group (tikai Unix);
  • resulttype - name (noklusējums) vai id; ja id - Unix atgriež uid/gid, Windows - SID.

Komentāri:

Piemēri:

vfs.file.owner[/tmp/zabbix_server.log] #atgriež /tmp/zabbix_server.log faila īpašnieku
vfs.file.owner[/tmp/zabbix_server.log,,id] #atgriež /tmp/zabbix_server.log faila īpašnieka ID
vfs.file.permissions[file]


Atgriež 4 ciparu virkni, kas satur oktālo skaitli ar UNIX atļaujām.
Atgrieztā vērtība: Virkne.
Atbalstītās platformas: Linux. Vienums var darboties arī citās UNIX tipa platformās.

Parametri:

  • file - pilns ceļš uz failu

Faila lieluma ierobežojums ir atkarīgs no lielu failu atbalsta.

Piemērs:

vfs.file.permissions[/etc/passwd] #atgriež /etc/passwd atļaujas, piemēram, '0644'
vfs.file.regexp[file,regexp,<encoding>,<start line>,<end line>,<output>]


Iegūst virkni failā7.
Atgrieztā vērtība: rinda, kurā ir atrasta atbilstošā virkne, vai, kā norādīts izvēles output parametrā.
Skatiet atbalstītās platformas.

Parametri:

  • file - pilns faila ceļš;
  • regexp - regulāra izteiksme, kas apraksta nepieciešamo rakstu;
  • encoding - kodu lapas identifikators;
  • start line - pirmās meklējamās rindas numurs (pēc noklusējuma faila pirmā rinda);
  • end line - pēdējās meklējamās rindas numurs (pēc noklusējuma faila pēdējā rinda);
  • output - izvēles izvades formatēšanas veidne. Atsoļu secība \0 tiek aizstāta ar atrasto teksta daļu (no pirmās rakstzīmes, kur sākas atbilstība, līdz rakstzīmei, kur atbilstība beidzas), savukārt \N (kur N=1...9) atsoļu secība tiek aizstāta ar N-to atrasto grupu (vai ar tukšu virkni, ja N pārsniedz uztverto grupu skaitu).

Komentāri:

  • Operētājsistēmā Windows šis vienums seko UNC ceļiem, kas var radīt drošības risku.
  • Faila lieluma ierobežojums ir atkarīgs no lielo failu atbalsta.
  • Tiek atgriezta tikai pirmā rinda, kas atbilst.
  • Ja neviena rinda neatbilst izteiksmei, tiek atgriezta tukša virkne.
  • Baitu secības zīme (BOM) tiek izslēgta no izvades.
  • Satura iegūšana, izmantojot output parametru, notiek aģentā.

Piemēri:

vfs.file.regexp[/etc/passwd,zabbix]
vfs.file.regexp[/path/to/some/file,"([0-9]+)$",,3,5,\1]
vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1] → iegūst lietotāja *zabbix* ID
vfs.file.regmatch[file,regexp,<encoding>,<start line>,<end line>]


Atrod virkni failā7.
Atgrieztās vērtības: 0 - atbilstība nav atrasta; 1 - atrasta.
Skatiet atbalstītās platformas.

Parametri:

  • file - pilns ceļš uz failu;
  • regexp - regulāra izteiksme, kas apraksta nepieciešamo rakstu;
  • encoding - kodu lapas identifikators;
  • start line - pirmās meklējamās rindas numurs (pēc noklusējuma faila pirmā rinda);
  • end line - pēdējās meklējamās rindas numurs (pēc noklusējuma faila pēdējā rinda).

Komentāri:

  • Operētājsistēmā Windows šis vienums seko UNC ceļiem, kas var radīt drošības risku.
  • Faila lieluma ierobežojums ir atkarīgs no lielo failu atbalsta.
  • Baitu secības marķieris (BOM) tiek ignorēts.

Piemērs:

vfs.file.regmatch[/var/log/app.log,error]
vfs.file.size[file,<mode>]


Faila izmērs (baitos).
Atgrieztā vērtība: Integer.
Skatiet atbalstītās platformas.

Parametri:

  • file - pilnais ceļš uz failu;
  • mode - iespējamās vērtības:
    • bytes (noklusējums);
    • lines (tiek skaitītas arī tukšās rindas).

Komentāri:

  • Operētājsistēmā Windows šis vienums seko UNC ceļiem, kas var radīt drošības risku.
  • Failam jābūt ar lasīšanas atļaujām lietotājam zabbix.
  • Faila izmēra ierobežojums ir atkarīgs no lielo failu atbalsta.

Piemērs:

vfs.file.size[/var/log/syslog]
vfs.file.time[file,<mode>]


Faila laika informācija.
Atgrieztā vērtība: Integer (Unix laikspiedols).
Skatiet atbalstītās platformas.

Parametri:

  • file - pilnais ceļš uz failu;
  • mode - iespējamās vērtības:
    • modify (noklusējums) - pēdējais faila satura modificēšanas laiks (noklusējums);
    • access - pēdējais faila lasīšanas laiks;
    • change - pēdējais faila īpašību maiņas laiks.

Komentāri:

Piemērs:

vfs.file.time[/etc/passwd,modify]
vfs.fs.discovery


Pievienoto failu sistēmu saraksts ar to tipu un montēšanas opcijām. Izmanto zema līmeņa atklāšanai.
Atgrieztā vērtība: JSON virkne.
Atbalstītās platformas: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows.

vfs.fs.get[<mode>,<mountpoint>]


Pievienoto failu sistēmu saraksts ar to tipu un pievienošanas opcijām, kā arī full režīmā — pieejamās diska vietas un inode statistika. Var izmantot zema līmeņa atklāšanai.
Atgrieztā vērtība: JSON virkne.
Atbalstītās platformas: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD, Windows.

Parametri:

  • mode - iespējamās vērtības:
    • full (noklusējums) - failu sistēmas rekvizīti ar diska vietas un inode statistiku;
    • short - tikai failu sistēmas rekvizīti bez diska vietas un inode statistikas;
  • mountpoint - pievienošanas punkts, par kuru jāatgriež dati (piemēram, /var vai C:). Ja nav norādīts, tiek atgrieztas visas pievienotās failu sistēmas.

Komentāri:

  • short režīmā tiek atgriezts tikai failu sistēmas nosaukums, tips un pievienošanas opcijas (Windows sistēmā: nosaukums, tips, etiķete un diska tips). Failu sistēmām statistika netiek vaicāta; Unix līdzīgās sistēmās tiek nolasīts tikai pievienoto failu sistēmu saraksts (piemēram, /proc/mounts Linux sistēmā), tāpēc pārbaude neizraisa automātisku pievienošanu un to neietekmē nereaģējošas tīkla failu sistēmas. Tādēļ short režīms ir piemērots zema līmeņa atklāšanai.
  • mountpoint vērtībai precīzi jāatbilst fsname rekvizītam. Windows sistēmā salīdzināšana nav reģistrjutīga; norādiet pievienošanas punktu bez beigu slīpsvītras (piemēram, C:).
  • Ja mountpoint ir norādīts, dati tiek atgriezti tikai par šo pievienošanas punktu. Ja neviena pievienotā failu sistēma tam neatbilst, tiek atgriezts tukšs masīvs ([]).
  • Izvadē var būt vairāki ieraksti ar vienādu fsname, ja vienā direktorijā ir pievienota vairāk nekā viena failu sistēma.
  • full režīmā pieejamā diska vieta un inode statistika tiek atgriezta tikai tad, ja Zabbix aģenta lietotājam ir caurskates atļauja katrā direktorijā pievienošanas punkta ceļā; pretējā gadījumā failu sistēma tiek izlaista no izvades. Tas neattiecas uz short režīmu, kurā tādēļ var tikt uzskaitītas failu sistēmas, kas nav iekļautas full režīma izvadē.
  • Rekvizīti fslabel un fsdrivetype tiek atgriezti tikai Windows sistēmā; rekvizīti inodes un options Windows sistēmā netiek atgriezti.
  • Tiek uzrādītas arī failu sistēmas, kuru inode skaits ir vienāds ar nulli, kā tas var būt failu sistēmām ar dinamiskiem inode (piemēram, btrfs).
  • Skatiet arī: Pievienoto failu sistēmu atklāšana.

Piemēri:

vfs.fs.get #visas pievienotās failu sistēmas ar statistiku; tas pats, kas vfs.fs.get[full]
vfs.fs.get[short] #visas pievienotās failu sistēmas bez statistikas
vfs.fs.get[full,/var] #statistika tikai par /var pievienošanas punktu
vfs.fs.get[short,C:] #tikai C: sējuma rekvizīti (Windows)
vfs.fs.inode[fs,<mode>]


Inodu skaits vai procentuālā daļa.
Atgrieztā vērtība: Integer - skaitam; Float - procentuālajai daļai.
Skatiet atbalstītās platformas.

Parametri:

  • fs - failu sistēma;
  • mode - iespējamās vērtības: total (noklusējums), free, used, pfree (brīvs, procentos) vai pused (izmantots, procentos).

Ja inodu skaits ir nulle, kas var būt failu sistēmās ar dinamiskiem inodiem (piemēram, btrfs), pfree/pused vērtības tiks ziņotas attiecīgi kā "100" un "0".

Piemērs:

vfs.fs.inode[/,pfree]
vfs.fs.size[fs,<mode>]


Diska vieta baitos vai procentos no kopējā apjoma.
Atgrieztā vērtība: Integer - baitiem; Float - procentiem.
Skatiet atbalstītās platformas.

Parametri:

  • fs - failu sistēma;
  • mode - iespējamās vērtības: total (noklusējums), free, used, pfree (brīvs, procentos) vai pused (izmantots, procentos).

Komentāri:

  • Ja failu sistēma nav piemontēta, tiek atgriezts tās lokālās failu sistēmas lielums, kurā atrodas montēšanas punkts.
  • Failu sistēmas rezervētā vieta tiek ņemta vērā un netiek iekļauta, izmantojot free režīmu.

Piemērs:

vfs.fs.size[/tmp,free]
vm.memory.size[<mode>]


Atmiņas lielums baitos vai procentos no kopējā apjoma.
Atgrieztā vērtība: Integer - baitiem; Float - procentiem.
Skatiet atbalstītās platformas.

Parametrs:

  • mode - iespējamās vērtības: total (noklusējums), active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, slab, wired, used, pused (izmantots, procentos), available vai pavailable (pieejams, procentos).

Komentāri:

  • Šis vienums pieņem trīs parametru kategorijas:
    • total - kopējais atmiņas apjoms;
    • platformai specifiski atmiņas tipi: active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, slab, wired;
    • lietotāja līmeņa novērtējumi par to, cik daudz atmiņas ir izmantots un pieejams: used, pused, available, pavailable.
  • Parametrs active tiek atbalstīts tikai FreeBSD, HP-UX, MacOS X, OpenBSD, NetBSD.
  • Parametri anon, exec, file tiek atbalstīti tikai NetBSD.
  • Parametrs buffers tiek atbalstīts tikai Linux, FreeBSD, OpenBSD, NetBSD.
  • Parametrs cached tiek atbalstīts tikai Linux, FreeBSD, AIX, OpenBSD, NetBSD.
  • Parametri inactive, wired tiek atbalstīti tikai FreeBSD, MacOS X, OpenBSD, NetBSD.
  • Parametrs pinned tiek atbalstīts tikai AIX.
  • Parametrs shared tiek atbalstīts tikai Linux 2.4, FreeBSD, OpenBSD, NetBSD.
  • Skatiet arī papildu informāciju par šo vienumu.

Piemērs:

vm.memory.size[pavailable]
web.page.get[host,<path>,<port>,<redirect_limit>]


Iegūt tīmekļa lapas saturu.
Atgrieztā vērtība: tīmekļa lapas avots kā teksts (tostarp galvenes).
Skatiet atbalstītās platformas.

Parametri:

  • host - resursdatora nosaukums vai URL (kā scheme://host:port/path, kur obligāts ir tikai host). Atļautās URL shēmas: http, https4. Ja shēma nav norādīta, tiks izmantots http. Ja ir norādīts URL, path un port ir jāatstāj tukši. Lietotājvārdu/paroli, pieslēdzoties serveriem, kuriem nepieciešama autentifikācija, piemēram, http://user:[email protected], var norādīt tikai tad, ja ir pieejams cURL atbalsts 4. Punycode tiek atbalstīts resursdatoru nosaukumos.
  • path - ceļš uz HTML dokumentu (noklusējums ir /);
  • port - porta numurs (noklusējums ir 80 HTTP gadījumā);
  • redirect_limit - maksimālais sekojamo novirzīšanu skaits 4, no 0 līdz 1000 (noklusējums ir 0 - novirzīšanām netiek sekots).

Komentāri:

  • Šis vienums kļūst neatbalstīts, ja host norādītais resurss neeksistē vai nav pieejams, vai ja redirect_limit ir lielāks par 0 un novirzīšanu skaits pārsniedz šo vērtību.
  • host var būt resursdatora nosaukums, domēna nosaukums, IPv4 vai IPv6 adrese. Tomēr IPv6 adresēm Zabbix aģentam jābūt kompilētam ar iespējotu IPv6 atbalstu.
  • Ja novirzīšanām tiek sekots, atgrieztā vērtība satur katras novirzīšanas atbildes galvenes, kam seko galīgās atbildes galvenes un pamatteksts.

Piemēri:

web.page.get[www.example.com,index.php,80]
web.page.get[https://www.example.com]
web.page.get[https://blog.example.com/?s=zabbix]
web.page.get[localhost:80]
web.page.get["[::1]/server-status"]
web.page.get[http://www.example.com,,,5]
web.page.perf[host,<path>,<port>,<redirect_limit>]


Pilnas tīmekļa lapas ielādes laiks (sekundēs).
Atgrieztā vērtība: Float.
Skatiet atbalstītās platformas.

Parametri:

  • host - resursdatora nosaukums vai URL (formātā scheme://host:port/path, kur tikai host ir obligāts). Atļautās URL shēmas: http, https4. Ja shēma nav norādīta, tiks izmantots http. Ja ir norādīts URL, path un port jāatstāj tukši. Lietotājvārdu/paroli, pieslēdzoties serveriem, kuriem nepieciešama autentifikācija, piemēram, http://user:[email protected], var norādīt tikai tad, ja ir pieejams cURL atbalsts 4. Resursdatoru nosaukumos tiek atbalstīts Punycode.
  • path - ceļš uz HTML dokumentu (noklusējums ir /);
  • port - porta numurs (noklusējums ir 80 HTTP gadījumā);
  • redirect_limit - maksimālais sekojamo novirzīšanu skaits 4, no 0 līdz 1000 (noklusējums ir 0 - novirzīšanas netiek izpildītas).

Komentāri:

  • Šis vienums kļūst neatbalstīts, ja host norādītais resurss neeksistē vai nav pieejams, vai ja redirect_limit ir lielāks par 0 un novirzīšanu skaits pārsniedz šo vērtību.
  • host var būt resursdatora nosaukums, domēna nosaukums, IPv4 vai IPv6 adrese. Tomēr IPv6 adresēm Zabbix aģentam jābūt kompilētam ar iespējotu IPv6 atbalstu.
  • Ja novirzīšanas tiek izpildītas, ielādes laiks ietver visu novirzīšanu izpildei patērēto laiku.

Piemēri:

web.page.perf[www.example.com,index.php,80]
web.page.perf[https://www.example.com]
web.page.perf[http://www.example.com,,,5]
web.page.regexp[host,<path>,<port>,regexp,<length>,<output>,<redirect_limit>]


Atrod virkni tīmekļa lapā.
Atgrieztā vērtība: atrastā virkne vai virkne, kas norādīta neobligātajā output parametrā.
Skatiet atbalstītās platformas.

Parametri:

  • host - resursdatora nosaukums vai URL (formātā scheme://host:port/path, kur obligāts ir tikai host). Atļautās URL shēmas: http, https4. Ja shēma nav norādīta, tiks izmantots http. Ja ir norādīts URL, parametriem path un port jābūt tukšiem. Lietotājvārdu/paroli, pieslēdzoties serveriem, kuriem nepieciešama autentifikācija, piemēram, http://user:[email protected], var norādīt tikai tad, ja ir pieejams cURL atbalsts 4. Saimniekdatoru nosaukumos tiek atbalstīts Punycode.
  • path - ceļš uz HTML dokumentu (noklusējums ir /).
  • port - porta numurs (noklusējums HTTP gadījumā ir 80).
  • regexp - regulāra izteiksme, kas apraksta nepieciešamo rakstu.
  • length - atgriežamo rakstzīmju maksimālais skaits;
  • output - neobligāta izvades formatēšanas veidne. \0 atsoļa secība tiek aizstāta ar atrasto teksta daļu (no pirmās rakstzīmes, kur sākas atbilstība, līdz rakstzīmei, kur atbilstība beidzas), savukārt \N (kur N=1...9) atsoļa secība tiek aizstāta ar N-to atrasto grupu (vai tukšu virkni, ja N pārsniedz uztverto grupu skaitu).
  • redirect_limit - maksimālais sekojamo novirzīšanu skaits 4, no 0 līdz 1000 (noklusējums ir 0 - novirzīšanām netiek sekots).

Komentāri:

  • Šis vienums kļūst neatbalstīts, ja host norādītais resurss neeksistē vai nav pieejams, vai ja redirect_limit ir lielāks par 0 un novirzīšanu skaits pārsniedz šo vērtību.
  • host var būt saimniekdatora nosaukums, domēna nosaukums, IPv4 vai IPv6 adrese. Tomēr IPv6 adresēm Zabbix aģentam jābūt kompilētam ar iespējotu IPv6 atbalstu.
  • Satura izvilkšana, izmantojot parametru output, notiek aģentā.
  • Ja novirzīšanām tiek sekots, tiek meklētas arī katras novirzīšanas atbildes galvenes.

Piemēri:

web.page.regexp[www.example.com,index.php,80,OK,2]
web.page.regexp[https://www.example.com,,,OK,2]
web.page.regexp[http://www.example.com,,,OK,2,,5]
aģents.hostmetadata


Aģenta hosta metadati.
Atgrieztā vērtība: String.
Skatiet atbalstītās platformas.

Atgriež HostMetadata vai HostMetadataItem parametru vērtību, vai tukšu virkni, ja neviens no tiem nav definēts.

aģents.hostname


Aģenta hosts nosaukums.
Atgrieztā vērtība: String.
Skatiet atbalstītās platformas.

Atgriež:

  • Kā pasīvajā pārbaudē - pirmā hosta nosaukumu, kas norādīts aģenta konfigurācijas faila Hostname parametrā;
  • Kā aktīvajā pārbaudē - pašreizējā hosta nosaukumu.
agent.ping


Aģenta pieejamības pārbaude.
Atgrieztā vērtība: Nekas - nav pieejams; 1 - pieejams.
Skatiet atbalstītās platformas.

Lai pārbaudītu host nepieejamību, izmantojiet nodata() trigera funkciju.

agent.variant


Zabbix aģents variants (Zabbix aģents vai Zabbix aģents 2).
Atgrieztā vērtība: 1 - Zabbix aģents; 2 - Zabbix aģents 2.
Skatiet atbalstītās platformas.

aģents.version


Zabbix aģenta versija.
Atgrieztā vērtība: String.
Skatiet atbalstītās platformas.

Atgrieztās vērtības piemērs:

6.0.3
zabbix.stats[<ip>,<port>]


Atgriež Zabbix servera vai starpniekservera iekšējo metrikas kopu. Ja ir norādīti ip un port, metrikas tiek izgūtas no attālā eksemplāra; pretējā gadījumā - no lokālā eksemplāra.
Atgrieztā vērtība: JSON virkne.
Skatiet atbalstītās platformas.

Parametri:

  • ip - serveru/starpniekserveru IP/DNS/tīkla masku saraksts, kam veikt attālo vaicājumu (noklusējums ir 127.0.0.1);
  • port - servera/starpniekservera ports, kam veikt attālo vaicājumu (noklusējums ir 10051)

Komentāri:

zabbix.stats[<ip>,<port>,queue,<from>,<to>]


Atgriež uzraudzīto vienumu skaitu rindā, kas ir aizkavēti Zabbix serverī vai starpniekserverī. Ja ir norādīti ip un port, metrikas tiek izgūtas no attālās instances; pretējā gadījumā - no lokālās instances.
Atgrieztā vērtība: JSON string.
Skatiet atbalstītās platformas.

Parametri:

  • ip - serveru/starpniekserveru IP/DNS/tīkla masku saraksts, kuriem veikt attālinātu vaicājumu (noklusējums ir 127.0.0.1);
  • port - servera/starpniekservera ports, kuram veikt attālinātu vaicājumu (noklusējums ir 10051)
  • queue - konstante (jāizmanto tāda, kāda tā ir)
  • from - aizkavēts vismaz par (noklusējums ir 6 sekundes)
  • to - aizkavēts ne vairāk kā par (noklusējums ir bezgalība)

Ņemiet vērā, ka stats pieprasījums tiks pieņemts tikai no adresēm, kas norādītas mērķa instances parametra 'StatsAllowedIP' serveris/starpniekserveris.

Zemsvītras piezīmes

1Piezīme, kas attiecas tikai uz Linux. Zabbix aģentam ir jābūt tikai lasīšanas piekļuvei failu sistēmai /proc. Kodola ielāpi no www.grsecurity.org ierobežo nepriviliģētu lietotāju piekļuves tiesības.

2 vfs.dev.read[], vfs.dev.write[]: Zabbix aģents pārtrauks “novecojušus” ierīču savienojumus, ja vienumu vērtībām vairāk nekā 3 stundas netiek piekļūts. Tas var notikt, ja sistēmā ir ierīces ar dinamiski mainīgiem ceļiem vai ja ierīce tiek manuāli noņemta. Ņemiet vērā arī to, ka šie vienumi, ja tiem izmantots atjaunināšanas intervāls, kas ir 3 stundas vai ilgāks, vienmēr atgriezīs “0”.

3 vfs.dev.read[], vfs.dev.write[]: Ja pirmajam parametram tiek izmantota noklusējuma vērtība all, atslēga atgriezīs kopsavilkuma statistiku, tostarp visu bloku ierīču, piemēram, sda, sdb, un to nodalījumu (sda1, sda2, sdb3...), kā arī vairāku ierīču (MD RAID), kuru pamatā ir šīs bloku ierīces/nodalījumi, un loģisko sējumu (LVM), kuru pamatā ir šīs bloku ierīces/nodalījumi, statistiku. Šādos gadījumos atgrieztās vērtības jāuzskata tikai par relatīvām vērtībām (dinamiskām laikā), nevis par absolūtām vērtībām.

4 HTTPS un sekošana novirzēm (redirect_limit, kas ir lielāks par 0) tiek atbalstīta tikai tad, ja Zabbix aģents ir kompilēts ar cURL atbalstu; pretējā gadījumā vienums kļūst neatbalstīts. Zabbix aģentam 2 cURL nav nepieciešams nevienā no šiem gadījumiem.

5 Vērtības bytes un errors netiek atbalstītas cilpas saskarnēm Solaris sistēmās līdz Solaris 10 6/06 versijai (ieskaitot), jo kodols nesaglabā un/vai neziņo baitu, kļūdu un izmantošanas statistiku. Tomēr, ja Solaris sistēma tiek pārraudzīta, izmantojot net-snmp, vērtības var tikt atgrieztas, jo net-snmp ietver mantotu kodu no cmu-snmp, kas datēts pat ar 1997. gadu un, nespējot nolasīt baitu vērtības no saskarnes statistikas, atgriež pakešu skaitītāju (kas cilpas saskarnēs pastāv), reizinātu ar patvaļīgu vērtību 308. Tas balstās uz pieņēmumu, ka paketes vidējais garums ir 308 okteti, kas ir ļoti aptuvens novērtējums, jo Solaris sistēmu cilpas saskarņu MTU ierobežojums ir 8892 baiti. Šīs vērtības nevajadzētu uzskatīt par pareizām vai pat aptuveni precīzām. Tās ir aptuvenas aplēses. Zabbix aģents neveic minējumus, taču net-snmp atgriezīs šo lauku vērtību.

6 Solaris komandrinda, kas iegūta no /proc/pid/psinfo, ir ierobežota līdz 80 baitiem un satur komandrindu tādā formā, kāda tā bija procesa palaišanas brīdī.

7 vfs.file.contents[], vfs.file.regexp[], vfs.file.regmatch[] vienumus var izmantot failu satura izgūšanai. Ja vēlaties ierobežot piekļuvi konkrētiem failiem ar sensitīvu informāciju, palaidiet Zabbix aģentu ar lietotāju, kuram nav piekļuves tiesību šo failu skatīšanai.

Lietošana ar komandrindas utilītām

Ņemiet vērā, ka, testējot vai izmantojot vienumu atslēgas ar zabbix_agentd vai zabbix_get no komandrindas, jāņem vērā arī čaulas sintakse.

Piemēram, ja noteikts atslēgas parametrs ir jāiekļauj dubultpēdiņās, jums ir skaidri jāekranē dubultpēdiņas, pretējā gadījumā čaula tās apstrādās kā speciālās rakstzīmes un tās netiks nodotas Zabbix utilītai.

Piemēri:

zabbix_agentd -t 'vfs.dir.count[/var/log,,,"file,dir",,0]'

zabbix_agentd -t vfs.dir.count[/var/log,,,\"file,dir\",,0]

Kodējuma iestatījumi

Lai nodrošinātu, ka iegūtie dati netiek bojāti, parametrā encoding varat norādīt pareizo kodējumu pārbaudes (piemēram, vfs.file.contents) apstrādei. Atbalstīto kodējumu (kodu lapu identifikatoru) saraksts ir pieejams libiconv (GNU Project) dokumentācijā vai Microsoft Windows SDK dokumentācijas sadaļā "Code Page Identifiers". Ņemiet vērā, ka Microsoft dažkārt dažas koda lapas atzīmē kā "available only to managed applications", kas nozīmē, ka tās ir pieejamas tikai, izmantojot .NET izpildlaiku, un nav pieejamas, izmantojot vietējās Win32 API. Zabbix aģents izmanto savu kodējuma pārveidošanas loģiku, tāpēc šīs koda lapas atbalsta Zabbix aģents arī tad, ja vietējās Windows funkcijas tās nenodrošina.

Ja parametrā encoding nav norādīts kodējums, tiek lietotas šādas noteikšanas stratēģijas:

  • Ja kodējums nav norādīts (vai ir tukša virkne), tiek pieņemts, ka tas ir UTF-8, un dati tiek apstrādāti "kā ir";
  • BOM analīze - attiecas uz vienumiem vfs.file.contents, vfs.file.regexp, vfs.file.regmatch. Tiek mēģināts noteikt pareizo kodējumu, izmantojot baitu secības marķieri (BOM) faila sākumā. Ja BOM nav pieejams, tā vietā tiek lietota standarta noteikšana (skatiet iepriekš).

Aģenta vienumu problēmu novēršana

Pasīvo pārbaužu gadījumā, lai novērstu situāciju, kad vienums nesaņem vērtību, jo servera pieprasījumam aģentam vispirms iestājas noildze, jāņem vērā tālāk norādītais: