1 Zabbix агент
Преглед
Овај одељак пружа детаље о кључевима ставки који користе комуникацију са Zabbix агентом за прикупљање података.
Постоје пасивне и активне провере агента. Када конфигуришете ставку, можете да изаберете тражени тип:
- Zabbix агент - за пасивне провере
- Zabbix агент (активан) - за активне провере
Имајте на уму да су сви кључеви ставки које подржава Zabbix агент на Windows-у такође подржани од нове генерације Zabbix агент 2. Погледајте додатну ставку кључеви које можете да користите само са агентом 2.
Подржани кључеви ставки
Кључеви ставки које можете користити са Zabbix агентом наведени су у наставку.
Кључеви ставки су наведени без параметара и додатних информација. Кликните на кључ ставке да бисте видели све детаље.
| Item key | Description | Item group |
|---|---|---|
| kernel.maxfiles | Максималан број отворених датотека које подржава ОС. | Kernel |
| kernel.maxproc | Максималан број процеса које подржава ОС. | |
| kernel.openfiles | Број тренутно отворених дескриптора датотека. | |
| log | Праћење датотеке дневника. | Log monitoring |
| log.count | Број подударних редова у надгледаној датотеци дневника. | |
| logrt | Праћење датотеке дневника која се ротира. | |
| logrt.count | Број подударних редова у надгледаној датотеци дневника која је ротирано. | |
| modbus.get | Чита Modbus податке. | Modbus |
| net.dns | Проверава статус DNS сервиса. | Network |
| net.dns.perf | Проверава перформансе DNS сервиса. | |
| net.dns.record | Врши DNS упит. | |
| net.if.collisions | Број колизија ван прозора. | |
| net.if.discovery | Листа мрежних интерфејса. | |
| net.if.in | Статистика долазног саобраћаја на мрежном интерфејсу. | |
| net.if.out | Статистика одлазног саобраћаја на мрежи интерфејс. | |
| net.if.total | Збир статистика долазног и одлазног саобраћаја на мрежном интерфејсу. |
|net.tcp.listen|Проверава да ли је овај TCP порт у стању LISTEN.|^| |net.tcp.port|Проверава да ли је могуће успоставити TCP везу са наведеним портом.|^| |net.tcp.service|Проверава да ли сервис ради и да ли прихвата TCP везе.|^| |net.tcp.service.perf|Проверава перформансе TCP сервиса.|^| |net.tcp.socket.count|Враћа број TCP сокета који се подударају параметри.|^| |net.udp.listen|Проверава да ли је овај UDP порт у стању LISTEN.|^| |net.udp.service|Проверава да ли сервис ради и да ли одговара на UDP захтеве.|^| |net.udp.service.perf|Проверава перформансе UDP сервиса.|^| |net.udp.socket.count|Враћа број UDP сокета који одговарају параметрима.|^| |proc.cpu.util|Процес искоришћења процесора процеса.|Процеси| |proc.get|Листа ОС процеса и њихових параметара.|^| |proc.mem|Меморија коју процес користи у бајтовима.|^| |proc.num|Број процеса.|^| |sensor|Очитавање хардверског сензора.|Сензори| |system.boottime|Време покретања система.|Систем| |system.cpu.discovery|Листа детектованих процесора/језгара процесора.|^| |system.cpu.intr|Прекиди уређаја.|^| |system.cpu.load|Оптерећење процесора.|^| |system.cpu.num|Број процесора.|^| |system.cpu.switches|Број прекидача контекста.|^| |system.cpu.util|Искоришћеност процесора проценат.|^| |system.hostname|Име системског домаћина.|^| |system.hw.chassis|Информације о шасији.|^| |system.hw.cpu|Информације о процесору.|^| |system.hw.devices|Листа PCI или USB уређаја.|^| |system.hw.macaddr|Листа MAC адреса.|^| |system.localtime|Системско време.|^| |system.run|Покрените наведену команду на домаћина.|^| |system.stat|Системска статистика.|^| |system.sw.arch|Софтверска архитектура информације.|^| |system.sw.os|Информације о оперативном систему.|^| |system.sw.os.get|Детаљне информације о оперативном систему (верзија, тип, назив дистрибуције, споредна и главна верзија, итд.).|^| |system.sw.packages|Листа инсталираних пакета.|^| |system.sw.packages.get|Детаљна листа инсталираних пакета.|^| |system.sw.packages.get|Детаљна листа инсталираних пакета.|^| |system.swap.in|Статистика swap-in-а (са уређаја у меморију).|^| |system.swap.out|Статистика swap-out-а (са меморије на уређај).|^| |system.swap.size|Величина swap простора у бајтовима или у процентима од укупно.|^| |system.uname|Идентификација система.|^| |system.uptime|Време непрекидног рада система у секундама.|^| |system.users.num|Број пријављених корисника.|^| |vfs.dev.discovery|Листа блок уређаја и њихов тип.|Виртуелни фајл системи| |vfs.dev.read|Статистика читања диска.|^| |vfs.dev.write|Статистика писања на диск.|^| |vfs.dir.count|Број уноса у директоријум.|^| |vfs.dir.get|Унос у директоријум листа.|^| |vfs.dir.size|Величина директоријума.|^| |vfs.file.cksum|Контролна сума датотеке, израчуната помоћу UNIX cksum алгоритма.|^| |vfs.file.contents|Преузимање садржаја датотеке.|^| |vfs.file.exists|Проверава да ли датотека постоји.|^| |vfs.file.get|Враћа информације о датотеци.|^| |vfs.file.md5sum|MD5 контролна сума датотеке.|^| |vfs.file.owner|Преузима власника датотека.|^| |vfs.file.permissions|Враћа четвороцифрени стринг који садржи октални број са UNIX дозволама.|^| |vfs.file.regexp|Преузима стринг у датотеци.|^| |vfs.file.regmatch|Проналази стринг у датотеци.|^| |vfs.file.size|Величина датотеке.|^| |vfs.file.time|Информације о времену датотеке.|^| |vfs.fs.discovery|Листа монтираних фајл система са њиховим типом и опцијама монтирања.|^| |vfs.fs.get|Листа монтираних фајл система са њиховим типом, расположиви простор на диску, статистика инода и опције монтирања.|^| |vfs.fs.inode|Број или проценат инода.|^| |vfs.fs.size|Простор на диску у бајтовима или у процентима од укупног броја.|^| |vm.memory.size|Величина меморије у бајтовима или у процентима од укупног броја.|Виртуелна меморија| |web.page.get|Преузмите садржај веб странице.|Веб праћење||web.page.perf|Време учитавања целе веб странице.|^| |web.page.regexp|Пронађите стринг на веб страници.|^| |agent.hostmetadata|Метаподаци хоста агента.|Zabbix| |agent.hostname|Име домаћина агента.|^| |agent.ping|Доступност агента провери.|^| |agent.variant|Варијанта Zabbix агента (Zabbix агент или Zabbix агент 2).|^| |agent.version|Верзија Zabbix агента.|^| |zabbix.stats|Враћа скуп интерних метрика Zabbix сервера или проксија на даљину.|^| |zabbix.stats|Враћа број праћених ставки у реду које су одложене на Zabbix серверу или проксију на даљину.|^|
Подржане платформе
Осим ако није другачије назначено у детаљима ставке, ставке агента (и сви параметри) су подржане на:
- Linux
- FreeBSD
- Solaris
- HP-UX
- AIX
- MacOS X
- OpenBSD
- NetBSD
Многе ставке агента су такође подржане на Windows. Погледајте страницу Ставка Windows агента за детаље.
Кључни детаљи ставке
Параметри без угластих заграда су обавезни. Параметри означени угластим заградама < > су опциони.
kernel.maxfiles
Максималан број отворених датотека које подржава ОС.
Повратна вредност: Integer.
Подржане платформе: Linux, FreeBSD, MacOS X, OpenBSD, NetBSD.
kernel.maxproc
Максимални број процеса које подржава ОС.
Повратна вредност: Integer.
Подржане платформе: Linux 2.6 and later, FreeBSD, Solaris, MacOS X, OpenBSD, NetBSD.
kernel.openfiles
Број тренутно отворених дескриптора датотека.
Повратна вредност: Integer.
Подржане платформе: Linux (ставка може радити на другим UNIX-оликим платформама).
log[file,<regexp>,<encoding>,<maxlines>,<mode>,<output>,<maxdelay>,<options>,<persistent dir>]
Праћење лог датотеке.
Враћена вредност: Log.
Погледајте подржане платформе.
Параметри:
- file - пуна путања и име лог датотеке;
- regexp - регуларни израз који описује потребни образац;
- encoding - кодна страница идентификатор;
- maxlines - максималан број нових линија у секунди које ће агент послати Zabbix серверу или проксију. Овај параметар замењује вредност „MaxLinesPerSecond“ у zabbix_agentd.conf;
- mode - могуће вредности: all (подразумевано) или skip - прескочи обраду старијих података (утиче само на новокреиране ставке);
- output - опциони шаблон за форматирање излаза. Ескејп секвенца \0 се замењује подударним делом текста (од првог карактера где подударање почиње до карактера где подударање завршава), док се ескејп секвенца \N (где је N=1...9) замењује N-том подударном групом (или празним низом ако N премашује број снимљених група);
- maxdelay - максимално кашњење у секундама. Тип: float. Вредности: 0 - (подразумевано) никада не игнорисати линије датотеке дневника; > 0.0 - игнорисати старије линије како би се најновији линије анализирали у року од „maxdelay“ секунди. Прочитајте напомене о maxdelay пре употребе!
- options - додатне опције:
mtime-noreread - нејединствени записи, поново се читају само ако се величина датотеке промени (игноришите промену времена измене). (Овај параметар је застарео од верзије 5.0.2, јер се сада mtime игнорише.) - persistent dir (само у zabbix_agentd на Unix системима; није подржано у Zabbix агенту 2) - апсолутна путања директоријума где се чувају перзистентне датотеке. Погледајте и додатне напомене о перзистентним датотекама.
Коментари:
- Ставка мора бити конфигурисана као активна провера;
- Ако датотека недостаје или дозволе не дозвољавају приступ, ставка постаје неподржана;
- Ако се
outputостави празно - враћа се цео ред који садржи подударни текст. Имајте на уму да сви глобални типови регуларних израза осим 'Result is TRUE' увек враћају цео подударни ред и параметарoutputсе игнорише. - Екстракција садржаја помоћу параметра
outputсе одвија на агенту.
Примери:
log[/var/log/syslog] log[/var/log/syslog,error] log[/home/zabbix/logs/logfile,,,100]
Пример коришћења параметра output за издвајање броја из записа дневника:
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"] #ова ставка ће се подударати са записом у дневнику "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" и пошаљите измењени запис "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08" на сервер.
log.count[file,<regexp>,<encoding>,<maxproclines>,<mode>,<maxdelay>,<options>,<persistent dir>]
Број подударних редова у праћеној датотеци дневника.
Враћена вредност: Цео број.
Погледајте подржане платформе.
Параметри:
- file - пуна путања и име датотеке дневника;
- regexp - регуларни израз који описује потребни образац;
- encoding - кодна страница идентификатор;
- maxproclines - максималан број нових редова у секунди које ће агент анализирати (не може бити већи од 10000). Подразумевана вредност је 10*'MaxLinesPerSecond' у zabbix_agentd.conf.
- mode - могуће вредности: all (подразумевано) или skip - прескочи обраду старијих података (утиче само на новокреиране ставке).
- maxdelay - максимално кашњење у секундама. Тип: float. Вредности: 0 - (подразумевано) никада не игноришите линије датотеке дневника; > 0.0 - игноришите старије линије како бисте анализирали најновије линије у року од "maxdelay" секунди. Прочитајте напомене за maxdelay пре употребе!
- options - додатне опције:
mtime-noreread - нејединствени записи, поново се читају само ако се величина датотеке промени (игноришите промену времена измене). (Овај параметар је застарео од верзије 5.0.2, јер се сада mtime игнорише.) - persistent dir (само у zabbix_agentd на Unix системима; није подржано у Zabbix агенту 2) - апсолутна путања директоријума где се чувају перзистентне датотеке. Погледајте и додатне напомене о перзистентним датотекама.
Коментари:
- Ставка мора бити конфигурисана као активна провера;
- Подударни редови се броје у новим редовима од последње провере лога од стране агента и стога зависе од интервала ажурирања ставке;
- Ако датотека недостаје или дозволе не дозвољавају приступ, ставка постаје неподржана.
logrt[file regexp,<regexp>,<encoding>,<maxlines>,<mode>,<output>,<maxdelay>,<options>,<persistent dir>]
Праћење лог датотеке која се ротира.
Враћена вредност: Log.
Погледајте подржане платформе.
Параметри:
- file regexp - апсолутна путања до датотеке, са именом датотеке наведеним помоћу регуларног израза. Имајте на уму да се регуларни израз примењује само на име датотеке и не мора да се подудара са целим именом (нпр., /путања/до/агента ће се подударати са zabbix_agentd.log).
- regexp - регуларни израз који описује потребан образац садржаја.
- encoding - [идентификатор] кодне странице(/manual/config/items/itemtypes/zabbix_agent#encoding_settings).
- maxlines - максималан број нових линија у секунди које ће агент послати Zabbix серверу или проксију. Овај параметар замењује вредност 'MaxLinesPerSecond' у zabbix_agentd.conf.
- mode - могуће вредности: all (подразумевано) или skip - прескочи обраду старијих података (утиче само на новокреиране ставке).
- output - опциони шаблон за форматирање излаза. Ескејп секвенца \0 се замењује подударним делом текста (од првог карактера где подударање почиње до карактера где подударање завршава), док се ескејп секвенца \N (где је N=1...9) замењује N-том подударном групом (или празним низом ако N премашује број снимљених група).
- maxdelay - максимално кашњење у секундама. Тип: float. Вредности: 0 - (подразумевано) никада не игнорисати линије датотеке дневника; > 0.0 - игнорисати старије линије како би се најновији линије анализирали у року од „maxdelay“ секунди. Прочитајте напомене за maxdelay пре употребе!
- options - тип ротације датотеке дневника и друге опције. Могуће вредности:
rotate (подразумевано),
copytruncate - имајте на уму да се copytruncate не може користити заједно са maxdelay. У овом случају maxdelay мора бити 0 или није наведено; Видите copytruncate напомене,
mtime-reread - нејединствени записи, поново се читају ако се време модификације или величина промене (подразумевано),
mtime-noreread - нејединствени записи, поново се читају само ако се величина промени (игноришите промену времена модификације). - persistent dir (само у zabbix_agentd на Unix системима; није подржано у Zabbix агенту 2) - апсолутна путања директоријума где се чувају перзистентне датотеке. Видите и додатне напомене о перзистентним датотекама.
Коментари:
- Ставка мора бити конфигурисана као активна провера;
- Ротација дневника се заснива на времену последње модификације датотека;
- Имајте на уму да је logrt дизајниран за рад са једном тренутно активном лог датотеком, са неколико других одговарајућих неактивних датотека које се ротирају. Ако, на пример, директоријум има много активних лог датотека, за сваку од њих треба креирати посебну лог ставку. У супротном, ако једна лог ставка покупи превише датотека, то може довести до исцрпљивања меморије и пада праћења.
- Ако се
outputостави празно - враћа се цео ред који садржи подударни текст. Имајте на уму да сви глобални типови регуларних израза осим 'Result is TRUE' увек враћају цео подударни ред и параметарoutputсе игнорише. - Екстракција садржаја помоћу параметра
outputсе одвија на агенту. - У параметру
file regexp, путања директоријума дневника и регуларни израз датотеке дневника морају бити раздвојени исправним сепаратором директоријума: - на Windows-у, сепаратор мора бити обрнута коса црта (\); косе црте унапред могу бити толерисане на другим позицијама, осим оне која раздваја путању директоријума дневника и регуларни израз датотеке дневника (погледајте примере испод).
- на другим системима, мора бити коса црта унапред (/).
Примери за Windows:
logrt["c:/dir1/dir2/dir3\filename..log","pattern_to_match"] #ова ставка ће прикупљати податке из лог датотека у "c:/dir1/dir2/dir3" где име датотеке почиње са "filename" и завршава се било којом екстензијом која одговара ".log". logrt["//example.com/share/dir1/dir2/dir3\filename..log","pattern_to_match"] #ова ставка ће прикупљати податке из лог датотека у мрежном дељењу "//example.com/share/dir1/dir2/dir3" где име датотеке почиње са "filename" и завршава се било којом екстензијом која одговара ".log".
Примери за друге системе:
logrt["/home/zabbix/logs/^logfile[0-9]{1,3}$",,,100] #ова ставка ће се подударати са датотеком као што је "logfile1" (неће се подударати са ".logfile1"). logrt["/home/user/^logfile.*[0-9]{1,3}$","pattern_to_match","UTF-8",100] #ова ставка ће прикупљати податке из датотека као што су "logfile_abc_1" или "logfile__001".
Пример коришћења параметра output за издвајање броја из записа дневника:
logrt[/app1/^test.*log$,"task run [0-9.]+ sec, processed ([0-9]+) records, [0-9]+ errors",,,,\1] #ова ставка ће се подударати са записом дневника "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" и послати само '6080' серверу. Пошто се шаље нумеричка вредност, „Тип информација“ за ову ставку може се подесити на "Numeric (unsigned)" и вредност се може користити у графиконима, окидачима итд.
Пример коришћења параметра output за преписивање записа дневника пре слања на сервер:
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"] #ова ставка ће се подударати са записом дневника "2015-11-13 10:08:26 извршавање задатка 6.08 сек, обрађено 6080 записа, 0 грешака" и послати измењени запис "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08" до сервера.
logrt.count[file regexp,<regexp>,<encoding>,<maxproclines>,<mode>,<maxdelay>,<options>,<persistent dir>]
Број подударних редова у праћеној датотеци дневника која се ротира.
Враћена вредност: Цео број.
Погледајте подржане платформе.
Параметри:
- file regexp - апсолутна путања до датотеке, са именом датотеке наведеним помоћу регуларног израза. Имајте на уму да се регуларни израз примењује само на име датотеке и не мора да се подудара са целим именом (нпр., /path/to/agent ће се подударати са zabbix_agentd.log).
- regexp - регуларни израз који описује потребни образац.
- encoding - [идентификатор] кодне странице(/manual/config/items/itemtypes/zabbix_agent#encoding_settings).
- maxproclines - максималан број нових линија у секунди које ће агент анализирати (не може бити већи од 10000). Подразумевана вредност је 10*'MaxLinesPerSecond' у zabbix_agentd.conf.
- mode - могуће вредности: all (подразумевано) или skip - прескочи обраду старијих података (утиче само на новокреиране ставке).
- maxdelay - максимално кашњење у секундама. Тип: float. Вредности: 0 - (подразумевано) никада не игноришите линије лог датотеке; > 0.0 - игноришите старије линије како бисте анализирали најновије линије у року од "maxdelay" секунди. Прочитајте напомене maxdelay пре употребе!
- options - тип ротације лог датотеке и друге опције. Могуће вредности:
rotate (подразумевано),
copytruncate - имајте на уму да се copytruncate не може користити заједно са maxdelay. У овом случају maxdelay мора бити 0 или није наведено; видети напомене у copytruncate,
mtime-reread - нејединствени записи, поново се читају ако се време модификације или величина промене (подразумевано),
mtime-noreread - нејединствени записи, поново се читају само ако се величина промени (игноришите промену времена модификације). - persistent dir (само у zabbix_agentd на Unix системима; није подржано у Zabbix агенту 2) - апсолутна путања директоријума где се чувају перзистентне датотеке. Видети такође додатне напомене о перзистентним датотекама.
Коментари:
- Ставка мора бити конфигурисана као активна провера;
- Подударни редови се броје у новим редовима од последње провере дневника од стране агента и стога зависе од интервала ажурирања ставке;
- Ротација дневника се заснива на времену последње измене датотека;
- У параметру
file regexp, путања директоријума дневника и регуларни израз датотеке дневника морају бити одвојени исправним сепаратором директоријума:- на Windows-у, сепаратор мора бити обрнута коса црта (\); косе црте унапред могу бити толерисане на другим позицијама, осим оне која раздваја путању директоријума дневника и регуларни израз датотеке дневника (погледајте примере испод).
- на другим системима, мора бити коса црта унапред (/).
Примери за Windows:
logrt.count["c:/dir1/dir2/dir3\filename..log","pattern_to_match"] #ова ставка ће бројати број подударања за образац "pattern_to_match" у датотекама дневника које се налазе у "c:/dir1/dir2/dir3". logrt.count["//example.com/share/dir1/dir2/dir3\filename..log","pattern_to_match"] #ова ставка ће бројати број подударања за образац "pattern_to_match" у лог датотекама на мрежном дељењу "//example.com/share/dir1/dir2/dir3".
Примери за друге системе:
logrt.count["/home/zabbix/logs/logfile[0-9]{1,3}$",,,100] #ова ставка ће бројати број подударања за образац "logfile[0-9]{1,3}$" у лог датотекама у директоријуму "/home/zabbix/logs". logrt.count["/home/user/^logfile.*[0-9]{1,3}$","pattern_to_match","UTF-8",100] #ова ставка ће бројати број појављивања шаблона "pattern_to_match" у лог датотекама које се налазе у "/home/user".
modbus.get[endpoint,<slave id>,<function>,<address>,<count>,<type>,<endianness>,<offset>]
Чита Modbus податке.
Повратна вредност: JSON објекат.
Подржане платформе: Linux.
Параметри:
- endpoint - крајња тачка дефинисана као
protocol://connection_string; - *slave id - ID подређеног уређаја;
- function - Modbus функција;
- address - адреса првог регистра, калема или улаза;
- count - број записа за читање;
- type - тип података;
- endianness - конфигурација бајтног поретка;
- offset - број регистара, почевши од 'address', чији ће резултати бити одбачени.
Погледајте детаљни опис параметара.
net.dns[<ip>,name,<type>,<timeout>,<count>,<protocol>]
Проверава статус DNS сервиса.
Враћене вредности: 0 - DNS разрешавање није успело (DNS сервер није одговорио или је вратио грешку); 1 - DNS разрешавање је успело.
Погледајте подржане платформе.
Параметри:
- ip (игнорише се на Windows-у осим ако се не користи Zabbix агент 2) - IP адреса DNS сервера (оставите празно за подразумевани DNS сервер);
- name - DNS име за упит;
- type - тип записа који се упитује (подразумевано је SOA);
- timeout (игнорише се на Windows-у осим ако се не користи Zabbix агент 2) - време чекања за захтев у секундама (подразумевано је 1 секунда);
- count (игнорише се на Windows-у осим ако се не користи Zabbix агент 2) - број покушаја захтева (подразумевано је 2);
- protocol - протокол који се користи за извршавање DNS упита: udp (подразумевано) или tcp.
Коментари:
- Могуће вредности за
typeсу: ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (није подржано за Zabbix агент на Windows-у, Zabbix агент 2 на свим оперативним системима), HINFO, MINFO, TXT, SRV - За обрнуте DNS претраге (када је
typeподешено на PTR), можете навести DNS име и у обрнутом и у необрнутом формату (погледајте примере испод). Имајте на уму да када се захтева PTR запис, DNS име је заправо IP адреса. - Интернационализована имена домена нису подржана, уместо њих користите имена кодирана IDNA.
Примери:
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.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>]
Проверава перформансе DNS сервиса.
Враћена вредност: Float (0 - сервис не ради; seconds - број секунди чекања на одговор сервиса).
Погледајте подржане платформе.
Параметри:
- ip (игнорише се на Windows-у осим ако се не користи Zabbix агент 2) - IP адреса DNS сервера (оставите празно за подразумевани DNS сервер);
- name - DNS име за упит;
- type - тип записа који се упитује (подразумевано је SOA);
- timeout (игнорише се на Windows-у осим ако се не користи Zabbix агент 2) - време чекања за захтев у секундама (подразумевано је 1 секунда);
- count (игнорише се на Windows-у осим ако се не користи Zabbix агент 2) - број покушаја захтева (подразумевано је 2);
- protocol - протокол који се користи за извршавање DNS упита: udp (подразумевано) или tcp.
Коментари:
- Могуће вредности за
typeсу:
ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (није подржано за Zabbix агент на Windows-у, Zabbix агент 2 на свим оперативним системима), HINFO, MINFO, TXT, SRV - За обрнуте DNS претраге (када је
typeподешено на PTR), можете навести DNS име и у обрнутом и у необрнутом формату (погледајте примере испод). Имајте на уму да када се захтева PTR запис, DNS име је заправо IP адреса. - Интернационализована имена домена нису подржана, уместо тога користите имена кодирана IDNA.
- Ставка враћа време одзива уместо
0када DNS сервер одговори кодом грешке (на пример,NXDOMAINилиSERVFAIL).
Примери:
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.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>]
Извршава DNS упит.
Zabbix агент 2 такође пружа net.dns.get, који нуди додатне функције као што су више типова записа и већа контрола над DNS праћењем.
Враћена вредност: низ карактера са потребним типом информација.
Погледајте подржане платформе.
Параметри:
- ip (игнорише се на Windows-у осим ако се користи Zabbix агент 2) - IP адреса DNS сервера (оставите празно за подразумевани DNS сервер);
- name - DNS име за упит;
- type - тип записа који треба упитати (подразумевано је SOA);
- timeout (игнорише се на Windows-у осим ако се не користи Zabbix агент 2) - време чекања за захтев у секундама (подразумевано је 1 секунда);
- count (игнорише се на Windows-у осим ако се не користи Zabbix агент 2) - број покушаја за захтев (подразумевано је 2);
- protocol - протокол који се користи за извршавање DNS упита: udp (подразумевано) или tcp.
Коментари:
- Могуће вредности за
typeсу:
ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (није подржано за Zabbix агент на Windows-у, Zabbix агент 2 на свим оперативним системима), HINFO, MINFO, TXT, SRV - За обрнуте DNS претраге (када је
typeподешен на PTR), можете навести DNS име у обрнутом или необрнутом формату (погледајте примере испод). Имајте на уму да када се захтева PTR запис, DNS име је заправо IP адреса. - Интернационализована имена домена нису подржана, уместо тога користите IDNA кодирана имена.
Примери:
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.8.0.f.0.0.4.0.5.4.1.0.0.a.2.ip6.arpa,PTR]
net.if.collisions[if]
Број колизија ван прозора.
Повратна вредност: Integer.
Подржане платформе: Linux, FreeBSD, Solaris, AIX, MacOS X, OpenBSD, NetBSD. Root привилегије су потребне на NetBSD-у.
Параметар:
- if - назив мрежног интерфејса
net.if.discovery
Листа мрежних интерфејса. Користи се за откривање ниског нивоа.
Повратна вредност: JSON објекат.
Подржане платформе: Linux, FreeBSD, Solaris, HP-UX, AIX, OpenBSD, NetBSD.
net.if.in[if,<mode>]
Статистика долазног саобраћаја на мрежном интерфејсу.
Враћена вредност: Цео број.
Подржане платформе: Linux, FreeBSD, Solaris5, HP-UX, AIX, MacOS X, OpenBSD, NetBSD. На NetBSD-у су потребне root привилегије.
Параметри:
- if - назив мрежног интерфејса (Unix); пун опис мрежног интерфејса или IPv4 адреса; или, ако је у заградама, GUID мрежног интерфејса (Windows);
- mode - могуће вредности:
bytes - број бајтова (подразумевано)
packets - број пакета
errors - број грешака
dropped - број испуштених пакета
overruns (fifo) - број грешака у FIFO баферу
frame - број грешака у оквиру пакета
compressed - број компримованих пакета које је примио драјвер уређаја
multicast - број мултикаст оквира које је примио драјвер уређаја
Коментари:
- Овај кључ можете користити са кораком претходне обраде Промена у секунди да бисте добили статистику бајтова у секунди;
- Режим dropped је подржан само на Linux, FreeBSD, HP-UX, MacOS X, OpenBSD, NetBSD;
- Режими overruns, frame, compressed, multicast су подржани само на Linux;
- На HP-UX-у ова ставка не пружа детаље о интерфејсима за повратну петљу (нпр. lo0).
Примери:
net.if.in[eth0] net.if.in[eth0,errors]
net.if.out[if,<mode>]
Статистика одлазног саобраћаја на мрежном интерфејсу.
Враћена вредност: Цео број.
Подржане платформе: Linux, FreeBSD, Solaris5, HP-UX, AIX, MacOS X, OpenBSD, NetBSD. На NetBSD-у су потребне root привилегије.
Параметри:
- if - назив мрежног интерфејса (Unix); пун опис мрежног интерфејса или IPv4 адреса; или, ако је у заградама, GUID мрежног интерфејса (Windows);
- mode - могуће вредности:
bytes - број бајтова (подразумевано)
packets - број пакета
errors - број грешака
dropped - број испуштених пакета
overruns (fifo) - број грешака FIFO бафера
collisions (colls) - број колизија откривених на интерфејсу
carrier - број губитака носиоца које је открио драјвер уређаја
compressed - број компресованих пакета које је пренео драјвер уређаја
Коментари:
- Овај кључ можете користити са кораком претходне обраде Промена у секунди да бисте добили статистику бајтова у секунди;
- Режим dropped је подржан само на Linux-у, HP-UX-у;
- Режими overruns, collision, carrier, compressed су подржани само на Linux-у;
- На HP-UX-у ова ставка не пружа детаље о интерфејсима за повратну петљу (нпр. lo0).
Примери:
net.if.out[eth0] net.if.out[eth0,errors]
net.if.total[if,<mode>]
Збир статистика долазног и одлазног саобраћаја на мрежном интерфејсу.
Враћена вредност: Цео број.
Подржане платформе: Linux, FreeBSD, Solaris5, HP-UX, AIX, MacOS X, OpenBSD, NetBSD. На NetBSD-у су потребне root привилегије.
Параметри:
- if - назив мрежног интерфејса (Unix); пун опис мрежног интерфејса или IPv4 адреса; или, ако је у заградама, GUID мрежног интерфејса (Windows);
- mode - могуће вредности:
bytes - број бајтова (подразумевано)
packets - број пакета
errors - број грешака
dropped - број испуштених пакета
overruns (fifo) - број грешака FIFO бафера
collisions (colls) - број колизија откривених на интерфејсу
compressed - број компресованих пакета које је драјвер уређаја послао или примио
Коментари:
- Овај кључ можете користити са кораком претходне обраде Промена у секунди да бисте добили статистику бајтова у секунди;
- Режим dropped је подржан само на Linux-у, HP-UX. Испуштени пакети су подржани само ако и
net.if.inиnet.if.outраде за испуштене пакете на вашој платформи. - Режими overruns, collision, compressed су подржани само на Linux-у;
- На HP-UX-у ова ставка не пружа детаље о интерфејсима за повратну петљу (нпр. lo0).
Примери:
net.if.total[eth0] net.if.total[eth0,errors]
net.tcp.listen[port]
Проверава да ли је овај TCP порт у стању LISTEN.
Повратне вредности: 0 - није у стању LISTEN; 1 - налази се у стању LISTEN.
Подржане платформе: Linux, FreeBSD, Solaris, MacOS X.
Параметар:
- port - Број TCP порта
На Linux језгрима 2.6.14 и новијим, информације о слушању TCP socket-а се добијају из NETLINK интерфејсима језгара, ако је могуће. У супротном, информације се преузимају из /proc/net/tcp и /roc/net/tcp6 датотека.
Пример:
net.tcp.listen[80]
net.tcp.port[<ip>,port]
Проверава да ли је могуће успоставити TCP конекцију са наведеним портом.
Повратне вредности: 0 - не може се повезати; 1 - може да се повеже.
Погледајте подржане платформе.
Параметри:
- ip - IP адреса или DNS име (подразумевано је 127.0.0.1);
- port - број порта.
Коментари:
- За једноставно тестирање TCP перформанси користите
net.tcp.service.perf[tcp,<ip>,<port>]; - Ове провере могу да доведу до додатних порука у system daemon logfiles (обично се евидентирају SMTP and SSH сесије).
Пример:
net.tcp.port[,80] #this item can be used to test the web server availability running on port 80
net.tcp.service[service,<ip>,<port>]
Проверава да ли сервис ради и да ли прихвата TCP везе.
Враћене вредности: 0 - сервис не ради; 1 - сервис ради.
Погледајте подржане платформе.
Параметри:
- service - ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https или telnet (погледајте details);
- ip - IP адреса или DNS име (подразумевано је 127.0.0.1);
- port - број порта (подразумевано се користи стандардни број порта сервиса).
Коментари:
- Ове провере могу резултирати додатним порукама у лог датотекама системских демона (SMTP и SSH сесије се обично бележе);
- Провера шифрованих протокола (као што су IMAP на порту 993 или POP на порту 995) тренутно није подржана. Као заобилазно решење, користите
net.tcp.port[]за овакве провере. - Провера LDAP-а и HTTPS-а на Windows-у је подржана само од стране Zabbix агента 2;
- Телнет провера тражи промпт за пријаву (':' на крају).
Пример:
net.tcp.service[ftp,,45] #ова ставка се може користити за тестирање доступности FTP сервера на TCP порту 45
net.tcp.service.perf[service,<ip>,<port>]
Проверава перформансе TCP сервиса.
Враћене вредности: Float (0 - сервис не ради; seconds - број секунди чекања на одговор од сервиса).
Погледајте подржане платформе.
Параметри:
- service - ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https или telnet (погледајте details);
- ip - IP адреса или DNS име (подразумевано је 127.0.0.1);
- port - број порта (подразумевано се користи стандардни број сервисног порта).
Коментари:
- Провера шифрованих протокола (као што су IMAP на порту 993 или POP на порту 995) тренутно није подржана. Као заобилазно решење, користите
net.tcp.service.perf[tcp,<ip>,<port>]за овакве провере. - Телнет провера тражи промпт за пријаву (':' на крају).
Пример:
net.tcp.service.perf[ssh] #ова ставка се може користити за тестирање брзине почетног одговора са SSH сервера
net.tcp.socket.count[<laddr>,<lport>,<raddr>,<rport>,<state>]
Враћа број TCP socket-а који одговарају параметрима.
Повратна вредност: Integer.
Подржане платформе: Linux.
Параметри:
- laddr - локална IPv4/6 адреса или CIDR подмрежа;
- lport - локални број порта или назив сервиса;
- raddr - удаљена IPv4/6 адреса или CIDR подмрежа;
- rport - број удаљеног порта или назив сервиса;
- state - стање везе (established, syn_sent, syn_recv, fin_wait1, fin_wait2, time_wait, close, close_wait, last_ack, listen, closing).
Пример:
net.tcp.socket.count[,80,,,established] #the number of connections to local TCP port 80 in the established state
net.udp.listen[port]
Проверава да ли је овај UDP порт у стању LISTEN.
Повратне вредности: 0 - није у стању LISTEN; 1 - налази се у стању LISTEN.
Подржане платформе: Linux, FreeBSD, Solaris, MacOS X.
Параметар:
- port - Број UDP порта
Пример:
net.udp.listen[68]
net.udp.service[service,<ip>,<port>]
Проверава да ли је сервис покренут и да ли одговара на UDP захтеве.
Враћане вредности: 0 - сервис не ради; 1 - сервис је покренут.
Погледајте подржане платформе.
Параметри:
- сервис - ntp (погледајте детаљи);
- ip - IP адреса или DNS име (подразумевано је 127.0.0.1);
- порт - број порта (подразумевано се користи стандардни број порта сервиса).
Пример:
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>]
Проверава перформансе UDP сервиса.
Враћане вредности: Float (0 – сервис не ради; секунде – број секунди утрошених чекајући одговор од услуге).
Погледајте подржане платформе.
Параметри:
- сервис - ntp (погледајте детаље);
- ip - IP адреса или DNS име (подразумевано је 127.0.0.1);
- порт - број порта (подразумевано се користи стандардни број порта сервиса).
Пример:
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>]
Враћа број UDP сокета који одговарају параметрима.
Повратна вредност: Integer.
Подржане платформе: Linux.
Параметри:
- laddr - локална IPv4/6 адреса или CIDR подмрежа;
- lport - локални број порта или име сервиса;
- raddr - удаљена IPv4/6 адреса или CIDR подмрежа;
- rport - број удаљеног порта или име сервиса;
- state - стање везе (established, unconn).
Пример:
net.udp.socket.count[,,,,established] #returns the number of UDP sockets in the connected state
proc.cpu.util[<name>,<user>,<type>,<cmdline>,<mode>,<zone>]
Проценат искоришћења процесора процеса.
Враћена вредност: Float.
Подржане платформе: Linux, Solaris6.
Параметри:
- name - име процеса (подразумевано је сви процеси);
- user - корисничко име (подразумевано је сви корисници);
- type - тип искоришћења процесора: укупно (подразумевано), корисник или систем;
- cmdline - филтрирање по командној линији (то је регуларни израз);
- mode - режим прикупљања података: avg1 (подразумевано), avg5 или avg15;
- zone - циљна зона: current (подразумевано) или all. Овај параметар је подржан само на Solaris-у.
Коментари:
- Враћена вредност је заснована на проценту искоришћења једног језгра процесора. На пример, искоришћење процесора процеса који у потпуности користи два језгра је 200%.
- Подаци о искоришћењу процесора процеса прикупљају се помоћу колектора који подржава највише 1024 јединствена (по имену, кориснику и командној линији) упита. Упити којима није приступљено током последња 24 сата уклањају се из колектора.
- Када се параметар
zoneподеси на current (или подразумевано) у случају да је агент компајлиран на Solaris-у без подршке за зоне, али ради на новијем Solaris-у где су зоне подржане, агент ће вратити NOTSUPPORTED (агент не може ограничити резултате само на тренутну зону). Међутим, all је подржано у овом случају.
Примери:
proc.cpu.util[,root] #Искоришћеност процесора свих процеса који се покрећу под "root" корисником proc.cpu.util[zabbix_server,zabbix] #Искоришћеност процесора свих zabbix_server процеса који се покрећу под zabbix корисником
proc.get[<име>,<корисник>,<цмдлине>,<режим>]
Листа ОС процеса и њихових параметара. Може се користити за откривање ниског нивоа.
Враћена вредност: JSON стринг.
Подржане платформе: Linux, FreeBSD, Windows, OpenBSD, NetBSD.
Параметри:
- name - име процеса (подразумевано сви процеси);
- user - корисничко име (подразумевано сви корисници);
- cmdline - филтрирање по командној линији (то је регуларни израз). Овај параметар није подржан за Windows; на другим платформама није подржан ако је режим подешен на „summary“.
- mode - могуће вредности:
процес (подразумевано), нит (није подржано за NetBSD), summary. Погледајте листу параметара процеса враћених за сваки режим и ОС.
Коментари:
-
Ако се вредност не може преузети, на пример, због грешке (процес је већ умро, недостатак дозвола, неуспех системског позива), вратиће се
-1; -
Погледајте белешке о одабиру процеса са параметрима
nameиcmdline(специфично за Linux).
Примери:
proc.get[zabbix_server,zabbix,,process] #листа свих zabbix_server процеса који се покрећу под zabbix корисником, враћа један унос по PID-у proc.get[java,,,thread] #листа свих Java процеса, враћа један унос по нити proc.get[,zabbix,,summary] #комбиновани подаци за процесе сваког типа који се покрећу под zabbix корисником, враћа један унос по имену процеса
proc.mem[<име>,<корисник>,<режим>,<цмдлине>,<тип меморије>]
Меморија коју процес користи у бајтовима.
Враћена вредност: Цео број - са mode као max, min, sum; Float - са mode као avg
Подржане платформе: Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.
Параметри:
- name - име процеса (подразумевано је сви процеси);
- user - корисничко име (подразумевано је сви корисници);
- mode - могуће вредности: просек, макс, мин или сум (подразумевано);
- cmdline - филтрира по командној линији (то је регуларни израз);
- memtype - тип меморије коју користи процес
Коментари:
- Параметар
memtypeје подржан само на Linux-у, FreeBSD-у, Solaris-у6, AIX-у; - Када неколико процеса користи дељену меморију, збир меморије коју процеси користе може резултирати великим, нереалним вредностима.
Погледајте notes о одабиру процеса са параметримаnameиcmdline(специфично за Linux).
Када се ова ставка позове из командне линије и садржи параметар командне линије (нпр. коришћењем режима тестирања агента:zabbix_agentd -t proc.mem[,,,apache2]), биће урачунат један додатни процес, јер ће агент урачунати самог себе.
Примери:
proc.mem[,root] #меморија коју користе сви процеси који се покрећу под „root“ корисником proc.mem[zabbix_server,zabbix] #меморија коју користе сви zabbix_server процеси који се покрећу под zabbix корисником proc.mem[,oracle,max,oracleZABBIX] #меморија коју користи процес који највише користи меморију, а који се покреће под Oracle-ом и има oracleZABBIX у својој командној линији
proc.num[<name>,<user>,<state>,<cmdline>,<zone>]
Број процеса.
Враћена вредност: Цео број.
Подржане платформе: Linux, FreeBSD, Solaris6, HP-UX, AIX, OpenBSD, NetBSD.
Параметри:
- name - име процеса (подразумевано је сви процеси);
- user - корисничко име (подразумевано је сви корисници);
- state - могуће вредности:
сви (подразумевано),
диск - непрекидно спавање,
рун - покрећено,
спавање - прекидно спавање,
трас - заустављено,
зомб - зомби; - cmdline - филтрирај по командној линији (то је регуларни израз);
- zone - циљна зона: current (подразумевано) или all. Овај параметар је подржан само на Solaris-у.
Коментари:
- Параметри стања disk и trace су подржани само на Linux-у, FreeBSD-у, OpenBSD-у, NetBSD-у;
- Када се ова ставка позове из командне линије и садржи параметар командне линије (нпр. коришћењем режима тестирања агента:
zabbix_agentd -t proc.num[,,,apache2]), биће урачунат један додатни процес, јер ће агент сам себе урачунати; - Када се параметар
zoneподеси на current (или подразумевано) у случају да је агент компајлиран на Solaris-у без подршке за зоне, али ради на новијем Solaris-у где су зоне подржане, агент ће вратити NOTSUPPORTED (агент не може ограничити резултате само на тренутну зону). Међутим, све је подржано у овом случају. - Видите notes о одабиру процеса са параметрима
nameиcmdline(специфично за Linux).
Примери:
proc.num[,mysql] #број процеса који се покрећу под mysql корисником proc.num[apache2,www-data] #број apache2 процеса који се покрећу под www-data корисником proc.num[,oracle,sleep,oracleZABBIX] #број процеса у стању спавања који се покрећу под Oracle-ом који имају oracleZABBIX у својој командној линији
sensor[device,sensor,<mode>]
Очитавање хардверског сензора.
Враћена вредност: Float.
Подржане платформе: Linux, OpenBSD.
Параметри:
- device - назив уређаја, може бити регуларни израз ако је mode изостављен;
- sensor - назив сензора, може бити регуларни израз ако је mode изостављен;
- mode - могуће вредности: avg, max или min (ако је овај параметар изостављен, уређај и сензор се третирају дословно).
Коментари:
- Чита /proc/sys/dev/sensors на Linux-у 2.4;
- Чита /sys/class/hwmon на Linux-у 2.6+. Погледајте детаљнији опис ставке sensor на Linux-у.
- Чита MIB hw.sensors на OpenBSD-у.
Примери:
sensor[w83781d-i2c-0-2d,temp1] sensor[cpu0,temp0] #температура једног процесора sensor["cpu[0-2]$",temp,avg] #просечна температура прва три процесора
system.boottime
Време покретања система.
Повратна вредност: Integer (Unix timestamp).
Подржане платформе: Linux, FreeBSD, Solaris, MacOS X, OpenBSD, NetBSD.
system.cpu.discovery
Листа детектованих процесора/језгара процесора. Користи се за откривање ниског нивоа.
Враћена вредност: JSON стринг.
Погледајте подржане платформе.
system.cpu.intr
Уређај прекида.
Повратна вредност: Integer.
Подржане платформе: Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.
system.cpu.load[<cpu>,<mode>]
Оптерећење процесора.
Враћена вредност: Float.
Погледајте подржане платформе.
Параметри:
- cpu - могуће вредности: all (подразумевано) или percpu (укупно оптерећење подељено бројем онлајн процесора);
- mode - могуће вредности: avg1 (једноминутни просек, подразумевано), avg5 или avg15.
Пример:
system.cpu.load[,avg5]
system.cpu.num[<type>]
Број CPU-а.
Повратна вредност: Integer.
Подржане платформе: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD.
Параметар:
- тип - могуће вредности: online (подразумевано) или max
Параметар типа max је подржан само на Linux, FreeBSD, Solaris, MacOS X.
Пример:
system.cpu.num
system.cpu.switches
Број промена контекста.
Повратна вредност: Integer.
Подржане платформе: Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.
system.cpu.util[<cpu>,<type>,<mode>,<logical or physical>]
Проценат искоришћења процесора.
Враћена вредност: Float.
Подржане платформе: Linux, FreeBSD, Solaris, HP-UX, AIX, OpenBSD, NetBSD.
Параметри:
- cpu - <CPU number> или all (подразумевано);
- type - могуће вредности: user (подразумевано), idle, nice, system, iowait, interrupt, softirq, steal, spin (на OpenBSD-у), guest (на Linux језгрима 2.6.24 и новијим), или guest_nice (на Linux језгрима 2.6.33 и новијим);
- mode - могуће вредности: avg1 (једноминутни просек, подразумевано), avg5 или avg15;
- logical or physical - могуће вредности: logical (подразумевано) или physical. Овај параметар је подржан само на AIX-у.
Коментари:
- Параметар типа nice је подржан само на Linux-у, FreeBSD-у, HP-UX-у, OpenBSD-у, NetBSD-у.
- Параметар типа iowait је подржан само на Linux-у 2.6 и новијим верзијама, Solaris-у, AIX-у.
- Параметар типа interrupt је подржан само на Linux-у 2.6 и новијим верзијама, FreeBSD-у, OpenBSD-у.
- Параметри типа softirq, steal, guest, guest_nice су подржани само на Linux-у 2.6 и новијим верзијама.
- Параметри режима avg5 и avg15 су подржани на Linux-у, FreeBSD-у, Solaris-у, HP-UX-у, AIX-у, OpenBSD-у, NetBSD-у.
Пример:
system.cpu.util[0,user,avg5]
system.hostname[<type>,<transform>]
Име системског домаћина.
Повратна вредност: String.
Погледајте подржане платформе.
Параметри:
- тип - могуће вредности: netbios (подразумевано на Windows-у), host (подразумевано на Linux-у), shorthost (враћа део имена домаћина пре прве тачке, цео стринг имена без тачака) , fqdn (враћа потпуно квалификовано име домена);
- transform - могуће вредности: none (подразумевано) или lower (конвертовање у мала слова).
Вредност се добија узимањем nodename из излаза система API uname().
Примери враћених вредности:
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>]
Информације о шасији.
Повратна вредност: Стринг.
Подржане платформе: Linux.
Параметар:
- инфо - могуће вредности: full (подразумевано), model, serial, type, или vendor
Коментари:
- Овај кључ ставке зависи од доступности табеле SMBIOS
- Покушаће да прочита DMI табелу из sysfs-а, ако приступ sysfs-у не успе, покушајте да читате директно из меморије;
- Потребне су Root дозволе јер се вредност добија читањем из sysfs-а или меморије.
Пример:
system.hw.chassis[full] → Hewlett-Packard HP Pro 3010 Small Form Factor PC CZXXXXXXXX Desktop
system.hw.cpu[<cpu>,<info>]
Информације о CPU-у.
Повратна вредност: String или Integer.
Подржане платформе: Linux.
Параметри:
- cpu - <CPU број> или all (подразумевано);
- info - могуће вредности: full (подразумевано), curfreq, maxfreq, model или vendor.
Коментари:
- Прикупља информације из
/proc/cpuinfoи/sys/devices/system/cpu/[cpunum]/cpufreq/cpuinfo_max_freq; - Ако је специфициран CPU број и curfreq or maxfreq, враћа се нумеричка вредност (Hz).
Пример:
system.hw.cpu[0,vendor] → AuthenticAMD
system.hw.devices[<type>]
Списак PCI или USB уређаја.
Повратна вредност: Text.
Подржане платформе: Linux.
Параметар:
- тип - pci (подразумевано) или usb
Враћа излаз било lspci или lsusb услужног програма (извршено без икаквих параметара).
Пример:
system.hw.devices → 00:00.0 Host bridge: Advanced Micro Devices [AMD] RS780 Host Bridge
system.hw.macaddr[<interface>,<format>]
Списак MAC адреса.
Повратна вредност: String.
Подржане платформе: Linux.
Параметри:
- интерфејс - all (подразумевано) или регуларни израз;
- формат - full (подразумевано) или short
Коментари:
- Листа MAC адреса интерфејса чије име одговара датом
interfaceрегуларном изразу (all листе за све интерфејсе); - Ако је
formatнаведен као short, имена интерфејса и идентичне MAC адресе нису наведене.
Пример:
system.hw.macaddr["eth0$",full] → [eth0] 00:11:22:33:44:55
system.localtime[<type>]
Системско време.
Повратна вредност: Integer - са type као utc; Стринг - са type као local.
Погледајте подржане платформе.
Параметри:
- тип - могуће вредности: utc - (подразумевано) време од епохе (00:00:00 UTC, 1. јануар 1970), мерено у секундама или local - време у 'yyyy-mm-dd,hh:mm:ss.nnn,+hh:mm' формат
Мора се користити само као пасивна провера.
Пример:
system.localtime[local] #create an item using this key and then use it to display the host time in the *Clock* dashboard widget.
system.run[command,<mode>]
Покрените наведену команду на домаћину.
Враћена вредност: Текст резултат команде или 1 - са mode као nowait (без обзира на резултат команде).
Погледајте подржане платформе.
Параметри:
- command - команда за извршавање;
- mode - могуће вредности: wait - чекање краја извршавања (подразумевано) или nowait - не чекати.
Коментари:
- Ова ставка је подразумевано онемогућена. Сазнајте како да је омогућите;
- Враћена вредност ставке је стандардни излаз заједно са стандардном грешком коју производи команда. Провера излазног кода се не врши;
- Да би се правилно обрадила, повратна вредност команде мора бити типа података
text. Дозвољен је и празан резултат; - Повратна вредност је ограничена на 16MB (укључујући скраћене размаке на крају); такође се примењују ограничења базе података;
- Видите такође: Извршавање команде.
Пример:
system.run[ls -l /] #return a detailed file list of the root directory
system.stat[resource,<type>]
Системска статистика.
Враћена вредност: Цео број или број са покретном фреквенцијом.
Подржане платформе: AIX.
Параметри:
- ent - број процесорских јединица које ова партиција има право да прими (број са покретном фреквенцијом);
- kthr,<type> - информације о стањима нити језгра:
r - просечан број нити језгра које се могу извршити (float)
b - просечан број нити језгра смештених у ред чекања менаџера виртуелне меморије (float) - memory,<type> - информације о коришћењу виртуелне и реалне меморије:
avm - активне виртуелне странице (integer)
fre - величина листе слободних страница (integer) - page,<type> - информације о грешкама страница и активности страничења:
fi - уноси странице у датотеку у секунди (float)
fo - износи странице у датотеку у секунди (float)
pi - странице страничене из простора за страничење (float)
po - странице страничене у простор за страничење (float)
fr - ослобођене странице (замена странице) (float)
sr - странице скениране алгоритмом за замену страница (float) - faults,<type> - брзина пребацивања и прекида:
in - прекиди уређаја (float)
sy - системски позиви (float)
cs - прекидачи контекста нити језгра (float) - cpu,<type> - преглед процентуалне употребе процесорског времена:
us - време корисника (float)
sy - системско време (float)
id - време неактивности (float)
wa - време неактивности током којег је систем имао неизвршене захтеве за диск/NFS I/O (float)
pc - број потрошених физичких процесора (float)
ec - проценат потрошеног капацитета (float)
lbusy - означава проценат искоришћења логичког процесора који се догодио током извршавања на нивоу корисника и система (float)
app - означава доступне физичке процесоре у дељеном базену (float) - disk,<type> - статистика диска:
bps - означава количину подаци пренети (прочитани или записани) на диск у бајтовима у секунди (цео број)
tps - означава број преноса у секунди који су издати на физички диск/траку (float)
Коментари:
- Обратите пажњу на следећа ограничења у овим ставкама:
system.stat[cpu,app]- подржано само на AIX LPAR типа "Shared"
system.stat[cpu,ec]- подржано на AIX LPAR типа "Shared" и "Dedicated" ("Dedicated" увек враћа 100 (процената))
system.stat[cpu,lbusy]- подржано само на AIX LPAR типа "Shared"
system.stat[cpu,pc]- подржано на AIX LPAR типа "Shared" и "Dedicated"
system.stat[ent]- подржано на AIX LPAR типа "Shared" и "Dedicated"
system.sw.arch
Информације о архитектури софтвера.
Повратна вредност: Стринг.
Погледајте подржане платформе.
Информације се добијају из функције uname().
Пример:
system.sw.arch → i686
system.sw.os[<info>]
Информације о оперативном систему.
Повратна вредност: String.
Подржане платформе: Linux, Windows.
Параметар:
- инфо - могуће вредности: full (подразумевано), short, или name
Информације су добијене од (имајте на уму да нису све датотеке и опције присутне у свим дистрибуцијама):
/proc/version(full) на Linux-у;/proc/version_signature(short) на Linux-у;- параметар PRETTY_NAME из
/etc/os-releaseна Linux системима који га подржавају или/etc/issue.net(name); - кључ регистра
HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersionна Windows-у.
Примери:
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
Детаљне информације о оперативном систему (верзија, тип, назив дистрибуције, споредна и главна верзија итд.).
Враћена вредност: JSON стринг.
Подржане платформе: Linux, Windows.
system.sw.packages[<regexp>,<manager>,<format>]
Листа инсталираних пакета.
Враћена вредност: Текст.
Подржане платформе: Linux.
Параметри:
- regexp - all (подразумевано) или регуларни израз;
- manager - all (подразумевано) или менаџер пакета;
- format - full (подразумевано) или short.
Коментари:
- Наводи (по абецедном реду) инсталиране пакете чије име одговара датом регуларном изразу (all их све наводи);
- Подржани менаџери пакета (извршена команда):
dpkg (dpkg --get-selections)
pkgtool (ls /var/log/packages)
rpm (rpm -qa)
pacman (pacman -Q)
portage - Ако је
formatнаведено као full, пакети се групишу по менаџерима пакета (сваки менаџер у посебном реду који почиње својим именом у угластим заградама); - Ако је
formatнаведено као short, пакети се не групишу и наведени су у једном реду.
Пример:
system.sw.packages[mini,dpkg,short] → python-minimal, python2.6-minimal, ubuntu-minimal
system.sw.packages.get[<regexp>,<manager>]
Детаљан списак инсталираних пакета.
Повратна вредност: JSON објекат.
Подржане платформе: Linux.
Параметри:
- regexp - all (подразумевано) или регуларни израз;
- manager - all (подразумевано) или менаџер пакета (могуће вредности: rpm, dpkg, pkgtool, pacman, или portage).
Коментари:
- Враћа неформатирани JSON са инсталираним пакетима чије име одговара датом регуларном изразу;
- Излаз је низ објеката од којих сваки садржи следеће кључеве: name, manager, version, size, architecture, buildtime и installtime (погледајте више детаља).
system.swap.in[<device>,<type>]
Статистика замене (са уређаја у меморију).
Повратна вредност: Integer.
Подржане платформе: Linux, FreeBSD, OpenBSD.
Параметри:
- device - наведите уређај који се користи за замену (само за Linux) или all (подразумевано);
- type - могуће вредности: count (број замена, подразумевано на не-Linux платформама), sectors (сектори су замењени) или pages (странице замењене, подразумевано на Linux-у).
Коментари:
- Извор ових информација је:
/proc/swaps, /proc/partitions, /proc/stat (Linux 2.4)
/proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6) - Имајте на уму да ће pages радити само ако уређај није наведен;
- Параметар типа sectors је подржан само на Linux-у.
Пример:
system.swap.in[,pages]
system.swap.out[<device>,<type>]
Статистика замене (из меморије на уређај).
Повратна вредност: Integer.
Подржане платформе: Linux, FreeBSD, OpenBSD.
Параметри:
- device - наведите уређај који се користи за замену (само за Linux) или all (подразумевано);
- type - могуће вредности: count (број замена, подразумевано на не-Linux платформама), sectors (сектори замењени) или pages (странице замењене, подразумевано на Linux-у).
Коментари:
- Извор ових информација је:
/proc/swaps,/proc/partitions,/proc/stat(Linux 2.4)/proc/swaps,/proc/diskstats,/proc/vmstat(Linux 2.6) - Имајте на уму да ће pages радити само ако уређај није наведен;
- Параметар типа sectors је подржан само на Linux-у.
Пример:
system.swap.out[,pages]
system.swap.size[<uređaj>,<tip>]
Величина swap простора у бајтовима или у процентима од укупне вредности.
Враћена вредност: Integer - за бајтове; Float - за проценат.
Подржане платформе: Linux, FreeBSD, Solaris, AIX, OpenBSD.
Параметри:
- device - наведите уређај који се користи за swap (само за FreeBSD) или sve (подразумевано);
- type - могуће вредности: free (слободан swap простор, подразумевано), pfree (слободан swap простор, у процентима), pused (искоришћен swap простор, у процентима), total (укупан swap простор) или used (искоришћен swap простор).
Коментари:
- Имајте на уму да pfree, pused нису подржани на Windows-у ако је величина swap-а 0;
- Ако уређај није наведен, Zabbix агент ће узети у обзир само swap уређаје (датотеке), физичка меморија ће бити игнорисана. На пример, на Solaris системима, команда
swap -sукључује део физичке меморије и swap уређаје (за разлику одswap -l).
Пример:
system.swap.size[,pfree] → проценат слободног swap простора
system.uname
Идентификација система.
Враћена вредност: String.
Погледајте подржане платформе.
Коментари:
- На UNIX-у, вредност за ову ставку се добија системским позивом uname();
- На Windows-у, ставка враћа архитектуру оперативног система, док на UNIX-у враћа архитектуру процесора.
Примери:
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
Време рада система у секундама.
Враћена вредност: Цео број.
Подржане платформе: Linux, FreeBSD, Solaris, AIX, MacOS X, OpenBSD, NetBSD.
У конфигурацији ставке, користите јединице s или uptime да бисте добили читљиве вредности.
system.users.num
Број пријављених корисника.
Повратна вредност: Integer.
Погледајте подржане платформе.
Команда who се користи на страни агента за добијање вредности.
vfs.dev.discovery
Списак блок уређаја и њихов тип. Користи се за откривање ниског нивоа.
Повратна вредност: JSON објекат.
Подржане платформе: Linux.
vfs.dev.read[<уређај>,<тип>,<режим>]
Статистика читања диска.
Враћена вредност: Цео број - са тип у секторима, операцијама, бајтовима; Број са покретним покретом - са type у sps, ops, bps.
Подржане платформе: Linux, FreeBSD, Solaris, AIX, OpenBSD.
Параметри:
- device - уређај диска (подразумевано је сви 3);
- type - могуће вредности: sectors, operations, bytes, sps, ops или bps ( sps, ops, bps означавају: секторе, операције, бајтове у секунди, респективно);
- mode - могуће вредности: avg1 (просек од једног минута, подразумевано), avg5 или avg15. Овај параметар је подржан само са
typeу: sps, ops, bps.
Коментари:
- Ако користите интервал ажурирања од три сата или више2, ова ставка ће увек вратити '0';
- Параметри типа sectors и sps су подржани само на Linux-у;
- Параметар типа ops је подржан само на Linux-у и FreeBSD-у;
- Параметар типа bps је подржан само на FreeBSD-у;
- Параметар типа bytes је подржан само на FreeBSD-у, Solaris-у, AIX-у, OpenBSD-у;
- Параметар
modeје подржан само на Linux-у, FreeBSD-у; - Можете користити релативна имена уређаја (на пример,
sda) као и опциони префикс /dev/ (на пример,/dev/sda); - LVM логички томови су подржани;
- Подразумеване вредности параметра „type“ за различите оперативне системе:
AIX - operations
FreeBSD - bps
Linux - sps
OpenBSD - operations
Solaris - bytes - sps, ops и bps на подржаним платформама су ограничени на 1024 уређаја (1023 појединачна и један за све).
Пример:
vfs.dev.read[,operations]
vfs.dev.write[<уређај>,<тип>,<режим>]
Статистика писања на диск.
Враћена вредност: Цео број - са type у секторима, операцијама, бајтовима; Број са покретним покретом - са type у sps, ops, bps.
Подржане платформе: Linux, FreeBSD, Solaris, AIX, OpenBSD.
Параметри:
- уређај - уређај на диску (подразумевано је сви 3);
- тип - могуће вредности: сектори, операције, бајтови, спс, опс или бпс (спс, опс, бпс означавају: секторе, операције, бајтове у секунди, респективно);
- mode - могуће вредности: avg1 (просек од једног минута, подразумевано), avg5 или avg15. Овај параметар је подржан само са
typeу: sps, ops, bps.
Коментари:
- Ако користите интервал ажурирања од три сата или више2, ова ставка ће увек вратити '0';
- Параметри типа sectors и sps су подржани само на Linux-у;
- Параметар типа ops је подржан само на Linux-у и FreeBSD-у;
- Параметар типа bps је подржан само на FreeBSD-у;
- Параметар типа bytes је подржан само на FreeBSD-у, Solaris-у, AIX-у, OpenBSD-у;
- Параметар
modeје подржан само на Linux-у, FreeBSD-у; - Можете користити релативна имена уређаја (на пример,
sda) као и опциони префикс /dev/ (на пример,/dev/sda); - LVM логички томови су подржани;
- Подразумеване вредности параметра „type“ за различите оперативне системе:
AIX - operations
FreeBSD - bps
Linux - sps
OpenBSD - operations
Solaris - bytes - sps, ops и bps на подржаним платформама су ограничени на 1024 уређаја (1023 појединачна и један за све).
Пример:
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>]
Број уноса у директоријум.
Враћена вредност: Цео број.
Погледајте подржане платформе.
Параметри:
- dir - апсолутна путања до директоријума;
- regex incl - регуларни израз који описује образац имена ентитета (датотеке, директоријума, симболичке везе) који треба укључити; укључи све ако је празно (подразумевана вредност);
- regex excl - регуларни израз који описује образац имена ентитета (датотека, директоријум, симболичка веза) који треба искључити; не искључуј ниједан ако је празно (подразумевана вредност);
- types incl - типови уноса у директоријум који треба бројати, могуће вредности: file - регуларна датотека, dir - поддиректоријум, sym - симболичка веза, sock - сокет, bdev - блок уређај, cdev - карактерни уређај, fifo - FIFO, dev - синоним за "bdev,cdev", all - сви типови (подразумевано), тј. "file,dir,sym,sock,bdev,cdev,fifo". Вишеструки типови морају бити одвојени зарезом и наводницима.
- types excl - типови уноса у директоријум (видети
types incl) који се НЕ рачунају. Ако се неки тип уноса налази и уtypes inclи уtypes excl, уноси у директоријум овог типа се НЕ рачунају. - максимална дубина - максимална дубина поддиректоријума за прелазак:
-1 (подразумевано) - неограничено,
0 - без спуштања у поддиректоријуме. - мин величина - минимална величина (у бајтовима) за датотеку која ће се бројати. Мање датотеке се неће бројати. Могу се користити суфикси меморије.
- максимална величина - максимална величина (у бајтовима) за датотеку која ће се бројати. Веће датотеке се неће бројати. Могу се користити суфикси меморије.
- мин старост - минимална старост (у секундама) уноса у директоријум који ће се бројати. Новији уноси се неће бројати. Могу се користити временски суфикси.
- max age - максимална старост (у секундама) уноса у директоријум који ће се бројати. Уноси толико стари и старији неће се рачунати (време измене). Могу се користити временски суфикси.
- regex excl dir - регуларни израз који описује образац имена директоријума који треба искључити. Сав садржај директоријума ће бити искључен (за разлику од regex_excl)
Коментари:
- Променљиве окружења, нпр. %APP_HOME%, $HOME и %TEMP% нису подржане;
- Псеудо-директоријуми "." и ".." се никада не рачунају;
- Симболичке везе се никада не прате за обилазак директоријума;
- И
regex inclиregex exclсе примењују на датотеке и директоријуме приликом израчунавања броја уноса, али се игноришу приликом избора поддиректоријума за прелазак (ако јеregex incl"(?i)\^.+\.zip$" иmax depthније подешено, онда ће се прећи сви поддиректоријуми, али ће се рачунати само датотеке типа zip). - Време извршавања је ограничено вредношћу временског ограничења у агенту configuration (3 сек). Пошто прелазак великих директоријума може трајати дуже од тога, подаци се неће вратити и ставка ће постати неподржана. Делимични број се неће вратити.
- Приликом филтрирања по величини, само обичне датотеке имају значајне величине. Под Linux-ом и BSD-ом, директоријуми такође имају величине које нису нула (типично неколико Kb). Уређаји имају величине нула, нпр. величина /dev/sda1 не одражава одговарајућу величину партиције. Стога, када се користе
<min_size>и<max_size>, препоручљиво је да се<types_incl>наведе као "file", како би се избегла изненађења.
Примери:
vfs.dir.count[/dev] #прати број уређаја у /dev (Linux)
vfs.dir.count["C:\Users\ADMINI~1\AppData\Local\Temp"] #прати број датотека у привременом директоријуму
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>]
Листа уноса директоријума.
Враћена вредност: JSON string.
Погледајте подржане платформе.
Параметри:
- dir - апсолутна путања до директоријума;
- regex incl - регуларни израз који описује образац имена ентитета (датотека, директоријум, симболичка веза) који треба укључити; укључи све ако је празно (подразумевана вредност);
- regex excl - регуларни израз који описује образац имена ентитета (датотека, директоријум, симболичка веза) који треба искључити; не искључуј ниједан ако је празно (подразумевана вредност);
- types incl - типови уноса директоријума за навођење, могуће вредности: file - регуларна датотека, dir - поддиректоријум, sym - симболичка веза, sock - сокет, bdev - блок уређај, cdev - карактерни уређај, fifo - FIFO, dev - синоним за "bdev,cdev", all - сви типови (подразумевано), тј. "file,dir,sym,sock,bdev,cdev,fifo". Вишеструки типови морају бити одвојени зарезом и наводницима.
- types excl - типови уноса директоријума (видети
types incl) који НЕ треба навести. Ако се неки тип уноса налази и уtypes inclи уtypes excl, уноси директоријума овог типа НИСУ наведени. - max depth - максимална дубина поддиректоријума за прелазак:
-1 (подразумевано) - неограничено,
0 - без спуштања у поддиректоријуме. - min size - минимална величина (у бајтовима) за датотеку која ће бити наведена. Мање датотеке неће бити наведене. Могу се користити суфикси меморије.
- max size - максимална величина (у бајтовима) за датотеку која ће бити наведена. Веће датотеке неће бити наведене. Могу се користити суфикси меморије.
- min age - минимална старост (у секундама) уноса директоријума који ће бити наведен. Новији уноси неће бити наведени. Могу се користити временски суфикси.
- max age - максимална старост (у секундама) уноса у директоријум који ће бити наведен. Уноси толико стари и старији неће бити наведени (време измене). Могу се користити временски суфикси.
- regex excl dir - регуларни израз који описује образац имена директоријума који треба искључити. Сав садржај директоријума ће бити искључен (за разлику од
regex excl)
Коментари:
- Променљиве окружења, нпр. %APP_HOME%, $HOME и %TEMP% нису подржане;
- Псеудо-директоријуми "." и ".." никада нису наведени;
- Симболичке везе се никада не прате за обилазак директоријума;
- И
regex inclиregex exclсе примењују на датотеке и директоријуме приликом генерисања листе уноса, али се игноришу приликом избора поддиректоријума за прелазак (ако јеregex incl"(?i)\^.+\.zip$" иmax depthније подешено, онда ће се прећи сви поддиректоријуми, али ће се рачунати само датотеке типа zip). - Време извршавања је ограничено вредношћу временског ограничења у конфигурацији агента (/manual/appendix/config/zabbix_agentd#timeout). Пошто прелазак великих директоријума може трајати дуже од тога, подаци се неће вратити и ставка ће постати неподржана. Делимична листа се неће вратити.
- Приликом филтрирања по величини, само обичне датотеке имају значајне величине. Под Linux-ом и BSD-ом, директоријуми такође имају величине које нису нула (типично неколико Kb). Уређаји имају величине нула, нпр. величина /dev/sda1 не одражава одговарајућу величину партиције. Стога, када се користе
min sizeиmax size, препоручљиво је да сеtypes inclнаведе као "file", како би се избегла изненађења.
Примери:
vfs.dir.get[/dev] #преузима листу уређаја у /dev (Linux)
vfs.dir.get["C:\Users\ADMINI~1\AppData\Local\Temp"] #преузима листу датотека у привременом директоријуму
vfs.dir.size[dir,<regex incl>,<regex excl>,<mode>,<max depth>,<regex excl dir>]
Величина директоријума (у бајтовима).
Враћена вредност: Цео број.
Подржане платформе: Linux. Ставка може да ради и на другим UNIX-сличним платформама.
Параметри:
- dir - апсолутна путања до директоријума;
- regex incl - регуларни израз који описује образац имена ентитета (датотека, директоријум, симболичка веза) који треба укључити; укључи све ако је празно (подразумевана вредност);
- regex excl - регуларни израз који описује образац имена ентитета (датотека, директоријум, симболичка веза) који треба искључити; не искључуј ниједан ако је празно (подразумевана вредност);
- mode - могуће вредности: apparent (подразумевано) - добија привидне величине датотека уместо коришћења диска (делује као
du -sb dir), disk - добија коришћење диска (делује каоdu -s -B1 dir). За разлику од командеdu, ставка vfs.dir.size узима у обзир скривене датотеке приликом израчунавања величине директоријума (делује каоdu -sb .[^.]* *унутар директоријума). - max depth - максимална дубина поддиректоријума за прелазак: -1 (подразумевано) - неограничено, 0 - без спуштања у поддиректоријуме.
- regex excl dir - регуларни израз који описује образац имена директоријума који треба искључити. Сав садржај директоријума ће бити искључен (за разлику од
regex excl)
Коментари:
- Израчунавају се само директоријуми са најмање дозволом за читање за zabbix корисника. За директоријуме са дозволом само за читање, израчунава се величина самог директоријума. Директоријуми са дозволама за читање и извршавање израчунавају се укључујући садржај.
- Код великих директоријума или спорих дискова, ова ставка може имати временско ограничење због подешавања Временско ограничење у конфигурационим датотекама agent и server/proxy. Повећајте вредности временског ограничења по потреби.
- Ограничење величине датотеке зависи од подршке за велике датотеке.
Примери:
vfs.dir.size[/tmp,log] #израчунава величину свих датотека у /tmp које садрже 'log' у својим именима
vfs.dir.size[/tmp,log,^.+\.old$] #израчунава величину свих датотека у /tmp које садрже 'log' у својим именима, искључујући датотеке чија се имена завршавају са '.old'
vfs.file.cksum[file,<mode>]
Контролна сума датотеке, израчуната помоћу UNIX cksum алгоритма.
Враћена вредност: Цео број - са mode као crc32, String - са mode као md5, sha256.
Погледајте подржане платформе.
Параметри:
- file - пуна путања до датотеке;
- mode - crc32 (подразумевано), md5 или sha256.
Ограничење величине датотеке зависи од подршке за велике датотеке.
Пример:
vfs.file.cksum[/etc/passwd]
Примери враћених вредности (crc32/md5/sha256 респективно):
675436101 9845acf68b73991eb7fd7ee0ded23c44 ae67546e4aac995e5c921042d0cf0f1f7147703aa42bfbfb65404b30f238f2dc
vfs.file.contents[file,<encoding>]
Преузимање садржаја датотеке7.
Повратна вредност: Text.
Погледајте подржане платформе.
Параметри:
- датотека - комплетна путања до датотеке;
- кодирање - кодна страница идентификатор.
Коментари:
- Повратна вредност је ограничена на 16MB (укључујући размак на крају који је скраћен); ограничења базе података такође се примењују;
- Празан стринг се враћа ако је датотека празна или садржи само LF/CR карактере;
- Ознака реда бајтова (BOM) је искључена из излаза.
Пример:
vfs.file.contents[/etc/passwd]
vfs.file.exists[file,<типови укључени>,<типови искључени>]
Проверава да ли датотека постоји.
Враћена вредност: 0 - није пронађено; 1 - датотека наведеног типа постоји.
Погледајте подржане платформе.
Параметри:
- file - пуна путања до датотеке;
- **types incl** - листа типова датотека које треба укључити, могуће вредности: file (обична датотека, подразумевано (ако types_excl није подешено)), dir (директоријум), sym (симболичка веза), sock (сокет), bdev (блок уређај), cdev (карактерски уређај), fifo (FIFO), dev (синоним за "bdev,cdev"), all* (сви поменути типови, подразумевано ако је types_excl подешено).
- types excl - листа типова датотека које треба искључити, погледајте types_incl за могуће вредности (подразумевано ниједан тип није искључен)
Коментари:
- Више типова мора бити одвојено зарезом, а цео скуп стављен под наводнике "";
- Ако је исти тип и у <types_incl> и у <types_excl>, датотеке овог типа су искључене;
- Ограничење величине датотеке зависи од подршке за велике датотеке.
Примери:
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]
Враћа информације о датотеци.
Повратна вредност: JSON објекат.
Погледајте подржане платформе.
Параметар:
- датотека - kompletna путања до датотеке
Коментари:
- Подржани типови датотека на UNIX-оликим системима: обична датотека, директоријум, симболичка веза, socket, блок уређај, уређај карактера, FIFO.
- Ограничење величине датотеке зависи од подршке за велике датотеке.
Пример:
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]
MD5 контролни збир датотеке.
Повратна вредност: низ карактера (MD5 хеш датотеке).
Погледајте подржане платформе.
Параметар:
- датотека - комплетна путања до датотеке
Ограничење величине датотеке зависи од подршке за велике датотеке.
Пример:
vfs.file.md5sum[/usr/local/etc/zabbix_agentd.conf]
Пример враћене вредности:
b5052decb577e0fffd622d6ddc017e82
vfs.file.owner[file,<ownertype>,<resulttype>]
Враћа власника датотеке.
Враћена вредност: String.
Погледајте подржане платформе.
Параметри:
- file - пуна путања до датотеке;
- ownertype - user (подразумевано) или group (само за Unix);
- resulttype - name (подразумевано) или id; за id - врати uid/gid на Unix-у, SID на Windows-у.
Ограничење величине датотеке зависи од подршке за велике датотеке.
Примери:
vfs.file.owner[/tmp/zabbix_server.log] #врати власника датотеке /tmp/zabbix_server.log vfs.file.owner[/tmp/zabbix_server.log,,id] #врати ИД власника датотеке /tmp/zabbix_server.log
vfs.file.permissions[file]
Врати 4-цифрени стринг који садржи октални број са UNIX дозволама.
Повратна вредност: String.
Подржане платформе: Linux. Ставка може радити на другим UNIX-оликим платформама.
Параметри:
- file - комплетна путања до датотеке
Ограничење величине датотеке зависи од подршке за велике датотеке.
Пример:
vfs.file.permissions[/etc/passwd] #return permissions of /etc/passwd, на пример, '0644'
vfs.file.regexp[file,regexp,<encoding>,<start line>,<end line>,<output>]
Преузмите стринг у датотеци7.
Враћена вредност: Линија која садржи подударни стринг или како је наведено опционим параметром output.
Погледајте подржане платформе.
Параметри:
- file - пуна путања до датотеке;
- regexp - регуларни израз који описује потребни образац;
- encoding - кодна страница идентификатор;
- start line - број првог реда за претрагу (први ред датотеке подразумевано);
- end line - број последњег реда за претрагу (последњи ред датотеке подразумевано);
- output - опциони шаблон за форматирање излаза. Излазни низ \0 се замењује подударним делом текста (од првог карактера где подударање почиње до карактера где подударање завршава), док се излазни низ \N (где је N=1...9) замењује са N-том подударном групом (или празним низом ако N премашује број снимљених група).
Коментари:
- Ограничење величине датотеке зависи од подршке за велике датотеке.
- Враћа се само први подударни ред;
- Враћа се празан низ ако се ниједан ред не подудара са изразом;
- Ознака редоследа бајтова (BOM) се искључује из излаза;
- Екстракција садржаја помоћу параметра
outputсе врши на агенту.
Примери:
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] → getting the ID of user zabbix
vfs.file.regmatch[file,regexp,<encoding>,<start line>,<end line>]
Пронађите стринг у датотеци7.
Повратне вредности: 0 - подударање није пронађено; 1 - пронађено.
Погледајте подржане платформе.
Параметри:
- file - комплетна путања до датотеке;
- regexp - обичан израз који описује тражени образац;
- encoding - кодна страница идентификатор;
- start line - број првог реда за претрагу (први ред датотеке подразумевано);
- end line - број последњег реда за претрагу (подразумевано последњи ред датотеке).
Коментари:
- Ограничење величине датотеке зависи од подршке за велике датотеке.
- Ознака реда бајтова (BOM) се игнорише.
Пример:
vfs.file.regmatch[/var/log/app.log,error]
vfs.file.size[file,<mode>]
Величина датотеке (у бајтовима).
Повратна вредност: Integer.
Погледајте подржане платформе.
Параметри:
- датотека - комплетна путања до датотеке;
- режим - могуће вредности: bytes (подразумевано) или lines (броје се и празне линије).
Коментари:
- Датотека мора имати дозволе за читање за zabbix корисника;
- Ограничење величине датотеке зависи од подршке за велике датотеке.
Пример:
vfs.file.size[/var/log/syslog]
vfs.file.time[file,<mode>]
Информације о времену датотеке.
Повратна вредност: Integer (Unix временска ознака).
Погледајте подржане платформе.
Параметри:
- датотека - комплетна путања до датотеке;
- режим - могуће вредности:
modify (подразумевано) - последњи пут измене садржаја датотеке,
access - последње време читања датотеке,
change - последњи пут када сте променили својства датотеке
Ограничење величине датотеке зависи од подршке за велике датотеке.
Пример:
vfs.file.time[/etc/passwd,modify]
vfs.fs.discovery
Листа монтираних фајл система са њиховим типом и опцијама монтирања. Користи се за откривање ниског нивоа.
Враћена вредност: JSON стринг.
Подржане платформе: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD.
vfs.fs.get
Листа монтираних система датотека са њиховим типом, расположивим простором на диску, inode статистикама и опцијама монтирања. Може се користити за откривање ниског нивоа.
Повратна вредност: JSON објекат.
Подржане платформе: Linux, FreeBSD, Solaris, HP-UX, AIX, MacOS X, OpenBSD, NetBSD.
Коментари:
- Системи датотека са бројем inode-а једнаким нули, што може бити случај за системе датотека са динамичким inode-ом (нпр. btrfs), такође су пријављени;
- Погледајте такође: Откривање монтираних система датотека.
vfs.fs.inode[fs,<mode>]
Број или проценат inode-а.
Повратна вредност: Integer - за број; Float - за проценат.
Погледајте подржане платформе.
Параметри:
- fs - систем датотека;
- mode - могуће вредности: total (подразумевано), free, used, pfree (бесплатно, проценат) или pused (коришћено, проценат).
Ако је број inode-а једнак нули, што може бити случај за системе датотека са динамичким inode-има (нпр. btrfs), вредности pfree/pused ће бити пријављене као "100" и "0" респективно.
Пример:
vfs.fs.inode[/,pfree]
vfs.fs.size[fs,<mode>]
Простор на диску у бајтовима или у процентима од укупног.
Повратна вредност: Integer - за бајтове; Float - за проценат.
Погледајте подржане платформе.
Параметри:
- fs - систем датотека;
- mode - могуће вредности: total (подразумевано), free, used, pfree (бесплатно, проценат) или pused (коришћено, проценат).
Коментари:
- Ако систем датотека није монтиран, враћа величину локалног система датотека где се налази тачка монтирања;
- Резервисани простор система датотека се узима у обзир и није укључен када се користи free режим.
Пример:
vfs.fs.size[/tmp,free]
vm.memory.size[<mode>]
Величина меморије у бајтовима или у процентима од укупне вредности.
Враћена вредност: Цео број - за бајтове; Број са покретним покретом - за проценат.
Погледајте подржане платформе.
Параметар:
- mode - могуће вредности: total (подразумевано), active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, slab, wired, used, pused (used, percentage), available или pavailable (available, percentage).
Коментари:
- Ова ставка прихвата три категорије параметара:
1) total - укупна количина меморије
2) типови меморије специфични за платформу: active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, slab, wired
3) процене на нивоу корисника о томе колико меморије се користи и колико је доступно: used, pused, available, pavailable - Параметар режима active је подржан само на FreeBSD, HP-UX, MacOS X, OpenBSD, NetBSD;
- Параметри режима anon, exec, file су подржани само на NetBSD;
- Параметар режима buffers је подржан само на Linux, FreeBSD, OpenBSD, NetBSD;
- Параметар режима cached је подржан само на Linux-у, FreeBSD-у, AIX-у, OpenBSD-у, NetBSD-у;
- Параметри режима inactive и wired су подржани само на FreeBSD-у, MacOS X-у, OpenBSD-у, NetBSD-у;
- Параметар режима pinned је подржан само на AIX-у;
- Параметар режима shared је подржан само на Linux-у 2.4, FreeBSD-у, OpenBSD-у, NetBSD-у;
- Погледајте такође додатне детаље за ову ставку.
Пример:
vm.memory.size[pavailable]
web.page.get[host,<path>,<port>]
Добијте садржај веб странице.
Враћена вредност: Изворни код веб странице као текст (укључујући заглавља).
Погледајте подржане платформе.
Параметри:
- host - име домаћина или URL (као
scheme://host:port/path, где је само host обавезно). Дозвољене URL шеме: http, https4. Недостајућа шема ће се третирати као http. Ако је URL наведен,pathиportморају бити празни. Навођење корисничког имена/лозинке приликом повезивања са серверима који захтевају аутентификацију, на пример:http://user:[email protected]је могуће само уз подршку за cURL 4. Punycode је подржан у именима домаћина. - path - путања до HTML документа (подразумевано је /);
- port - број порта (подразумевано је 80 за HTTP)
Коментари:
- Ова ставка постаје неподржана ако ресурс наведен у
hostне постоји или није доступан; hostможе бити име домаћина, име домена, IPv4 или IPv6 адреса. Али за IPv6 адресу, Zabbix агент мора бити компајлиран са омогућеном IPv6 подршком.
Примери:
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.perf[host,<path>,<port>]
Време учитавања целе веб странице (у секундама).
Враћена вредност: Float.
Погледајте подржане платформе.
Параметри:
- host - име домаћина или URL (као
scheme://host:port/path, где је само host обавезно). Дозвољене URL шеме: http, https4. Недостајућа шема ће се третирати као http. Ако је URL наведенpath, аportмора бити празан. Навођење корисничког имена/лозинке приликом повезивања са серверима који захтевају аутентификацију, на пример:http://user:[email protected]је могуће само уз подршку за cURL 4. Punycode је подржан у именима домаћина. - path - путања до HTML документа (подразумевано је /);
- port - број порта (подразумевано је 80 за HTTP)
Коментари:
- Ова ставка постаје неподржана ако ресурс наведен у
hostне постоји или није доступан; hostможе бити име хоста, име домена, IPv4 или IPv6 адреса. Али за IPv6 адресу Zabbix агент мора бити компајлиран са омогућеном IPv6 подршком.
Примери:
web.page.perf[www.example.com,index.php,80] web.page.perf[https://www.example.com]
web.page.regexp[host,<path>,<port>,regexp,<length>,<output>]
Пронађи стринг на веб страници.
Враћена вредност: Подударни стринг или како је наведено опционим параметром output.
Погледајте подржане платформе.
Параметри:
- host - име домаћина или URL (као
scheme://host:port/path, где је само host обавезно). Дозвољене URL шеме: http, https4. Недостајућа шема ће се третирати као http. Ако је URL наведен,pathиportморају бити празни. Навођење корисничког имена/лозинке приликом повезивања са серверима који захтевају аутентификацију, на пример:http://user:[email protected]је могуће само уз подршку за cURL 4. Пуникод је подржан у именима домаћина. - path - путања до HTML документа (подразумевано је /);
- port - број порта (подразумевано је 80 за HTTP)
- regexp - регуларни израз који описује потребан образац;
- length - максималан број знакова за враћање;
- output - опциони шаблон за форматирање излаза. Ескејп секвенца \0 се замењује подударним делом текста (од првог карактера где подударање почиње до карактера где подударање завршава), док се ескејп секвенца \N (где је N=1...9) замењује N-том подударном групом (или празним низом ако N премашује број забележених група).
Коментари:
- Ова ставка постаје неподржана ако ресурс наведен у
hostне постоји или није доступан; hostможе бити име домаћина, име домена, IPv4 или IPv6 адреса. Али за IPv6 адресу, Zabbix агент мора бити компајлиран са омогућеном IPv6 подршком.- Екстракција садржаја помоћу параметра
outputсе одвија на агенту.
Примери:
web.page.regexp[www.example.com,index.php,80,OK,2] web.page.regexp[https://www.example.com,,,OK,2]|
agent.hostmetadata
Метаподаци домаћина агента.
Повратна вредност: String.
Погледајте подржане платформе.
Враћа вредност параметара HostMetadata или [HostMetadataItem]
(/manual/appendix/config/zabbix_agentd#hostmetadataitem) или је празан стринг ако ниједан није дефинисан.
agent.hostname
Име домаћина агента.
Повратна вредност: String.
Погледајте подржане платформе.
Враћа:
- Као пасивна провера - име првог домаћина наведеног у параметру Hostname конфигурационе датотеке агента;
- Као активна провера - име тренутног имена домаћина.
agent.ping
Провера доступности агента.
Повратна вредност: Ништа - недоступно; 1 - доступно.
Погледајте подржане платформе.
Користите функцију окидача nodata() да проверите недоступност домаћина.
agent.variant
Варијанта Zabbix агента (Zabbix агент или Zabbix агент 2).
Повратна вредност: 1 - Zabbix агент; 2 - Zabbix агент 2.
Погледајте подржане платформе.
agent.version
Верзија Zabbix агента.
Повратна вредност: String.
Погледајте подржане платформе.
Пример враћене вредности:
6.0.3
zabbix.stats[<ip>,<port>]
Враћа скуп интерних метрика Zabbix сервера или проксија на даљински начин.
Враћена вредност: JSON string.
Погледајте подржане платформе.
Параметри:
- ip - листа IP/DNS/мрежних маски сервера/проксија који се даљински испитују (подразумевано је 127.0.0.1);
- port - порт сервера/проксија који се даљински испитује (подразумевано је 10051)
Коментари:
- Ова ставка враћа изабрани скуп интерних метрика. За детаље, погледајте Даљинско праћење Zabbix статистике;
- Имајте на уму да ће захтев за статистику бити прихваћен само са адреса наведених у параметру "StatsAllowedIP" сервер/proxy на циљној инстанци.
zabbix.stats[<ip>,<port>,queue,<from>,<to>]
Враћа број надгледаних ставки у реду које су одложене на Заббик серверу или проксију на даљину.
Повратна вредност: JSON објекат.
Погледајте подржане платформе.
Параметри:
- ip - the IP/DNS/network маски сервера/проксија за које се даљински испитује (подразумевано је 127.0.0.1);
- port - порт сервера/проксија за који се даљински испитује (подразумевано је 10051)
- queue - константа (користи се онако како јесте)
- from - одложено најмање (подразумевано је 6 секунди)
- to - одложено највише (подразумевано је бесконачност)
Имајте на уму да ће захтев за статистику бити прихваћен само са адреса наведених у параметру 'StatsAllowedIP' сервер/прокси на циљној инстанци.
Фусноте
1Напомена специфична за Linux. Zabbix агент мора имати приступ само за читање фајл система /proc. Закрпе за језгро са www.grsecurity.org ограничавају права приступа непривилегованих корисника.
2 vfs.dev.read[], vfs.dev.write[]: Zabbix агент ће прекинути
"stale" везе уређаја ако се вредностима ставки не приступа дуже од
3 сата. Ово се може десити ако систем има уређаје са динамички
променљивим путањама или ако се уређај ручно уклони. Такође имајте на уму да
ће ове ставке, ако користе интервал ажурирања од 3 сата или дуже, увек
вратити '0'.
3 vfs.dev.read[], vfs.dev.write[]: Ако се подразумевано all користи
за први параметар, онда ће кључ вратити резимирану статистику,
укључујући све блок уређаје попут sda, sdb и њихове партиције (sda1,
sda2, sdb3...) и више уређаја (MD raid) на основу тих блок
уређаја/партиција и логичких томова (LVM) на основу тих блок
уређаја/партиција. У таквим случајевима враћене вредности треба сматрати
само као релативну вредност (динамичку у времену), а не као апсолутне вредности.
4 SSL (HTTPS) је подржан само ако је агент компајлиран са cURL подршком. У супротном, ставка ће постати неподржана.
5 Вредности bytes и errors нису подржане за loopback интерфејсе на Solaris системима до Solaris 10 6/06 укључујући и њих, јер статистику бајтова, грешака и коришћења језгро не чува и/или не извештава. Међутим, ако пратите Соларис систем путем net-snmp-а, вредности могу бити враћене јер net-snmp носи наслеђени код из cmu-snmp-а, датираног још из 1997. године, који, након неуспеха у читању вредности бајтова из статистике интерфејса, враћа бројач пакета (који постоји на loopback интерфејсима) помножен са произвољном вредношћу од 308. Ово претпоставља да је просечна дужина пакета 308 октета, што је веома груба процена јер је MTU ограничење на Соларис системима за loopback интерфејсе 8892 бајта. Ове вредности не треба сматрати тачним или чак ни приближно тачним. То су процене. Zabbix агент не нагађа, али net-snmp ће вратити вредност за ова поља.
6 Командна линија на Соларису, добијена из /proc/pid/psinfo, ограничена је на 80 бајтова и садржи командну линију каква је била када је процес покренут.
7 Ставке vfs.file.contents[], vfs.file.regexp[], vfs.file.regmatch[] могу се користити за преузимање садржаја датотека. Ако желите да ограничите приступ одређеним датотекама са осетљивим информацијама, покрените Zabbix агент под корисником који нема дозволе за преглед ових датотека.
Коришћење алата са командне линије
Имајте на уму да када тестирате или користите кључеве ставки са zabbix_agentd или zabbix_get из командне линије треба узети у обзир и shell синтаксу.
На пример, ако се одређени параметар кључа мора ставити под двоструке наводнике морате експлицитно да избегнете двоструке наводнике, иначе ће их shell исећи као специјалне карактере и неће бити прослеђени Zabbix алату.
Примери:
zabbix_agentd -t 'vfs.dir.count[/var/log,,,"file,dir",,0]'
zabbix_agentd -t vfs.dir.count[/var/log,,,\"file,dir\",,0]
Подешавања кодирања
Да бисте били сигурни да стечени подаци нису оштећени, можете навести
исправно кодирање за обраду провера (нпр. 'vfs.file.contents')
у параметру encoding. Листа подржаних кодирања (кодна страница
идентификатора) може се наћи у документацији за
libiconv (GNU пројекат) или у
Microsoft Windows SDK документацији за "Code Page Identifiers".
Ако у параметру encoding није наведено кодирање, следеће
стратегије решавања се примењују:
- Ако кодирање није наведено (или је празан стринг) претпоставља се да је UTF-8, подаци се обрађују "онакви какви јесу";
- BOM анализа - применљиво за ставке 'vfs.file.contents', 'vfs.file.regexp', 'vfs.file.regmatch'. Покушава да се одреди исправно енкодирање коришћењем ознаке реда бајтова (BOM) на почетку датотеке. Ако BOM није присутан - примењује се стандардно решење (погледајте горе).
Решавање проблема са ставкама агента
У случају пасивних провера, да спречите да та ставка не добије никакву вредност јер захтев сервера агенту прво истекне, треба напоменути следеће:
- Када је верзија агента старија од верзије сервера, вредност Timeout у конфигурацији ставке (или глобално временско ограничење) можда треба да буде већа од вредности
Timeoutу агенту конфигурационе датотеке. - Тамо где је верзија агента новија од верзије сервера, вредност
Timeoutна серверу конфигурационе датотеке ће можда морати да буде већа од вредностиTimeoutу агенту конфигурациона датотека.