1 Zabbix агент

Преглед

Овај одељак пружа детаље о кључевима ставки који користе комуникацију са Zabbix агентом за прикупљање података.

Постоје пасивне и активне провере агента. Када конфигуришете ставку, можете да изаберете тражени тип:

Zabbix агент - за пасивне провере
Zabbix агент (активан) - за активне провере

Имајте на уму да су сви кључеви ставки које подржава Zabbix агент на Windows-у такође подржани од нове генерације Zabbix агент 2. Погледајте додатну ставку кључеви које можете да користите само са агентом 2.

Supported item keys

The item keys that you can use with Zabbix agent are listed below.

The item keys are listed without parameters and additional information. Click on the item key to see the full details.

Item key	Description	Item group
kernel.maxfiles	The maximum number of opened files supported by OS.	Kernel
kernel.maxproc	The maximum number of processes supported by OS.
kernel.openfiles	The number of currently open file descriptors.
log	The monitoring of a log file.	Log monitoring
log.count	The count of matched lines in a monitored log file.
logrt	The monitoring of a log file that is rotated.
logrt.count	The count of matched lines in a monitored log file that is rotated.
modbus.get	Reads Modbus data.	Modbus
net.dns	Checks the status of a DNS service.	Network
net.dns.perf	Checks the performance of a DNS service.
net.dns.record	Performs a DNS query.
net.if.collisions	The number of out-of-window collisions.
net.if.discovery	The list of network interfaces.
net.if.in	The incoming traffic statistics on a network interface.
net.if.out	The outgoing traffic statistics on a network interface.
net.if.total	The sum of incoming and outgoing traffic statistics on a network interface.
net.tcp.listen	Checks if this TCP port is in LISTEN state.
net.tcp.port	Checks if it is possible to make a TCP connection to the specified port.
net.tcp.service	Checks if a service is running and accepting TCP connections.
net.tcp.service.perf	Checks the performance of a TCP service.
net.tcp.socket.count	Returns the number of TCP sockets that match parameters.
net.udp.listen	Checks if this UDP port is in LISTEN state.
net.udp.service	Checks if a service is running and responding to UDP requests.
net.udp.service.perf	Checks the performance of a UDP service.
net.udp.socket.count	Returns the number of UDP sockets that match parameters.
proc.cpu.util	The process CPU utilization percentage.	Processes
proc.get	The list of OS processes and their parameters.
proc.mem	The memory used by the process in bytes.
proc.num	The number of processes.
sensor	Hardware sensor reading.	Sensors
system.boottime	The system boot time.	System
system.cpu.discovery	The list of detected CPUs/CPU cores.
system.cpu.intr	The device interrupts.
system.cpu.load	The CPU load.
system.cpu.num	The number of CPUs.
system.cpu.switches	The count of context switches.
system.cpu.util	The CPU utilization percentage.
system.hostname	The system host name.
system.hw.chassis	The chassis information.
system.hw.cpu	The CPU information.
system.hw.devices	The listing of PCI or USB devices.
system.hw.macaddr	The listing of MAC addresses.
system.localtime	The system time.
system.run	Run the specified command on the host.
system.stat	The system statistics.
system.sw.arch	The software architecture information.
system.sw.os	The operating system information.
system.sw.os.get	Detailed information about the operating system (version, type, distribution name, minor and major version, etc).
system.sw.packages	The listing of installed packages.
system.sw.packages.get	A detailed listing of installed packages.
system.swap.in	The swap-in (from device into memory) statistics.
system.swap.out	The swap-out (from memory onto device) statistics.
system.swap.size	The swap space size in bytes or in percentage from total.
system.uname	Identification of the system.
system.uptime	The system uptime in seconds.
system.users.num	The number of users logged in.
vfs.dev.discovery	The list of block devices and their type.	Virtual file systems
vfs.dev.read	The disk read statistics.
vfs.dev.write	The disk write statistics.
vfs.dir.count	The directory entry count.
vfs.dir.get	The directory entry list.
vfs.dir.size	The directory size.
vfs.file.cksum	The file checksum, calculated by the UNIX cksum algorithm.
vfs.file.contents	Retrieving the contents of a file.
vfs.file.exists	Checks if the file exists.
vfs.file.get	Returns information about a file.
vfs.file.md5sum	The MD5 checksum of file.
vfs.file.owner	Retrieves the owner of a file.
vfs.file.permissions	Returns a 4-digit string containing the octal number with UNIX permissions.
vfs.file.regexp	Retrieve a string in the file.
vfs.file.regmatch	Find a string in the file.
vfs.file.size	The file size.
vfs.file.time	The file time information.
vfs.fs.discovery	The list of mounted filesystems with their type and mount options.
vfs.fs.get	The list of mounted filesystems with their type, available disk space, inode statistics and mount options.
vfs.fs.inode	The number or percentage of inodes.
vfs.fs.size	The disk space in bytes or in percentage from total.
vm.memory.size	The memory size in bytes or in percentage from total.	Virtual memory
web.page.get	Get the content of a web page.	Web monitoring
web.page.perf	The loading time of a full web page.
web.page.regexp	Find a string on the web page.
agent.hostmetadata	The agent host metadata.	Zabbix
agent.hostname	The agent host name.
agent.ping	The agent availability check.
agent.variant	The variant of Zabbix agent (Zabbix agent or Zabbix agent 2).
agent.version	The version of Zabbix agent.
zabbix.stats	Returns a set of Zabbix server or proxy internal metrics remotely.
zabbix.stats	Returns the number of monitored items in the queue which are delayed on Zabbix server or proxy remotely.

Подржане платформе

Осим ако није другачије назначено у детаљима ставке, ставке агента (и сви параметри) су подржане на:

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>]

The monitoring of a log file.
Return value: Log.
See supported platforms.

Parameters:

file - the full path and name of a log file;
regexp - a regular expression describing the required pattern;
encoding - the code page identifier;
maxlines - the maximum number of new lines per second the agent will send to Zabbix server or proxy. This parameter overrides the value of 'MaxLinesPerSecond' in zabbix_agentd.conf;
mode - possible values: all (default) or skip - skip processing of older data (affects only newly created items);
output - an optional output formatting template. The \0 escape sequence is replaced with the matched part of text (from the first character where match begins until the character where match ends) while an \N (where N=1...9) escape sequence is replaced with Nth matched group (or an empty string if the N exceeds the number of captured groups);
maxdelay - the maximum delay in seconds. Type: float. Values: 0 - (default) never ignore log file lines; > 0.0 - ignore older lines in order to get the most recent lines analyzed within "maxdelay" seconds. Read the maxdelay notes before using it!
options - additional options:
mtime-noreread - non-unique records, reread only if the file size changes (ignore modification time change). (This parameter is deprecated since 5.0.2, because now mtime is ignored.)
persistent dir (only in zabbix_agentd on Unix systems; not supported in Zabbix agent 2) - the absolute pathname of directory where to store persistent files. See also additional notes on persistent files.

Comments:

The item must be configured as an active check;
If the file is missing or permissions do not allow access, the item turns unsupported;
If output is left empty - the whole line containing the matched text is returned. Note that all global regular expression types except 'Result is TRUE' always return the whole matched line and the output parameter is ignored.
Content extraction using the output parameter takes place on the agent.

Examples:

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

Example of using the output parameter for extracting a number from log record:

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.

Example of using the output parameter for rewriting a log record before sending to server:

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>]

Број подударних редова у праћеној датотеци дневника.
Враћена вредност: Цео број.
Погледајте подржане платформе.

Параметри:

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.*.log","pattern_to_match"] #ова ставка ће прикупљати податке из лог датотека у "c:/dir1/dir2/dir3" где име датотеке почиње са "filename" и завршава се било којом екстензијом која одговара ".log". logrt["//example.com/share/dir1/dir2/dir3.*.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.*.log","pattern_to_match"] #ова ставка ће бројати број подударања за образац "pattern_to_match" у датотекама дневника које се налазе у "c:/dir1/dir2/dir3". logrt.count["//example.com/share/dir1/dir2/dir3.*.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, Solaris⁵, 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, Solaris⁵, 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, Solaris⁵, 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, Solaris⁶.

Параметри:

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[<name>,<user>,<cmdline>,<mode>]

Листа OS процеса и њихових параметара. Може се користити за откривање ниског нивоа.
Враћена вредност: JSON објекат.
Подржане платформе: Linux, FreeBSD, Windows, OpenBSD, NetBSD.

Параметри:

name - име процеса (подразумевано сви процеси);
user - корисничко име (подразумевано сви корисници);
cmdline - филтрирање по командној линији (то је регуларни израз). Овај параметар није подржан за Windows; на другим платформама није подржан ако је режим подешен на 'summary'.
mode - могуће вредности:
process (default), thread (није подржано за NetBSD), summary. Погледајте листу параметара процеса враћених за сваки режим и OS.

Коментари:

Ако се вредност не може преузети, на пример, због грешке (процес је већ умро, недостатак дозвола, неуспех системског позива), вратиће се -1;
Погледајте notes о одабиру процеса са параметрима 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[<name>,<user>,<mode>,<cmdline>,<memtype>]

Меморија коју процес користи у бајтовима.
Враћена вредност: Integer - са mode као max, min, sum; Float - са mode као avg
Подржане платформе: Linux, FreeBSD, Solaris, AIX, OpenBSD, NetBSD.

Параметри:

name - име процеса (подразумевано је сви процеси);
user - корисничко име (подразумевано је сви корисници);
mode - могуће вредности: avg, max, min или sum (подразумевано);
cmdline - филтрира по командној линији (то је регуларни израз);
memtype - тип меморије коју користи процес

Коментари:

Параметар memtype је подржан само на Linux-у, FreeBSD-у, Solaris-у⁶, 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, Solaris⁶, 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

Листа откривених CPUs/CPU језгара. Користи се за откривање ниског нивоа.
Повратна вредност: 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>]

The system statistics.
Return value: Integer or float.
Supported platforms: AIX.

Parameters:

ent - the number of processor units this partition is entitled to receive (float);
kthr,<type> - information about kernel thread states:
r - average number of runnable kernel threads (float)
b - average number of kernel threads placed in the Virtual Memory Manager wait queue (float)
memory,<type> - information about the usage of virtual and real memory:
avm - active virtual pages (integer)
fre - size of the free list (integer)
page,<type> - information about page faults and paging activity:
fi - file page-ins per second (float)
fo - file page-outs per second (float)
pi - pages paged in from paging space (float)
po - pages paged out to paging space (float)
fr - pages freed (page replacement) (float)
sr - pages scanned by page-replacement algorithm (float)
faults,<type> - trap and interrupt rate:
in - device interrupts (float)
sy - system calls (float)
cs - kernel thread context switches (float)
cpu,<type> - breakdown of percentage usage of processor time:
us - user time (float)
sy - system time (float)
id - idle time (float)
wa - idle time during which the system had outstanding disk/NFS I/O request(s) (float)
pc - number of physical processors consumed (float)
ec - the percentage of entitled capacity consumed (float)
lbusy - indicates the percentage of logical processor(s) utilization that occurred while executing at the user and system level (float)
app - indicates the available physical processors in the shared pool (float)
disk,<type> - disk statistics:
bps - indicates the amount of data transferred (read or written) to the drive in bytes per second (integer)
tps - indicates the number of transfers per second that were issued to the physical disk/tape (float)|

Comments:

Take note of the following limitations in these items:
system.stat[cpu,app] - supported only on AIX LPAR of type "Shared"
system.stat[cpu,ec] - supported on AIX LPAR of type "Shared" and "Dedicated" ("Dedicated" always returns 100 (percent))
system.stat[cpu,lbusy] - supported only on AIX LPAR of type "Shared"
system.stat[cpu,pc] - supported on AIX LPAR of type "Shared" and "Dedicated"
system.stat[ent] - supported on AIX LPAR of type "Shared" and "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>]

The listing of installed packages.
Return value: Text.
Supported platforms: Linux.

Parameters:

regexp - all (default) or a regular expression;
manager - all (default) or a package manager;
format - full (default) or short.

Comments:

Lists (alphabetically) installed packages whose name matches the given regular expression (all lists them all);
Supported package managers (executed command):
dpkg (dpkg --get-selections)
pkgtool (ls /var/log/packages)
rpm (rpm -qa)
pacman (pacman -Q)
portage
If format is specified as full, packages are grouped by package managers (each manager on a separate line beginning with its name in square brackets);
If format is specified as short, packages are not grouped and are listed on a single line.

Example:

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[<device>,<type>]

The swap space size in bytes or in percentage from total.
Return value: Integer - for bytes; Float - for percentage.
Supported platforms: Linux, FreeBSD, Solaris, AIX, Tru64, OpenBSD.

Parameters:

device - specify the device used for swapping (FreeBSD only) or all (default);
type - possible values: free (free swap space, default), pfree (free swap space, in percent), pused (used swap space, in percent), total (total swap space), or used (used swap space).

Comments:

Note that pfree, pused are not supported on Windows if swap size is 0;
If device is not specified Zabbix agent will only take into account swap devices (files), the physical memory will be ignored. For example, on Solaris systems the swap -s command includes a portion of physical memory and swap devices (unlike swap -l).

Example:

system.swap.size[,pfree] → free swap space percentage

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[<device>,<type>,<mode>]

The disk read statistics.
Return value: Integer - with type in sectors, operations, bytes; Float - with type in sps, ops, bps.
Supported platforms: Linux, FreeBSD, Solaris, AIX, OpenBSD.

Parameters:

device - disk device (default is all ³);
type - possible values: sectors, operations, bytes, sps, ops, or bps (sps, ops, bps stand for: sectors, operations, bytes per second, respectively);
mode - possible values: avg1 (one-minute average, default), avg5, or avg15. This parameter is supported only with type in: sps, ops, bps.

Comments:

If using an update interval of three hours or more², this item will always return '0';
The sectors and sps type parameters are supported only on Linux;
The ops type parameter is supported only on Linux and FreeBSD;
The bps type parameter is supported only on FreeBSD;
The bytes type parameter is supported only on FreeBSD, Solaris, AIX, OpenBSD;
The mode parameter is supported only on Linux, FreeBSD;
You may use relative device names (for example, sda) as well as an optional /dev/ prefix (for example, /dev/sda);
LVM logical volumes are supported;
The default values of 'type' parameter for different OSes:
AIX - operations
FreeBSD - bps
Linux - sps
OpenBSD - operations
Solaris - bytes
sps, ops and bps on supported platforms is limited to 1024 devices (1023 individual and one for all).

Example:

vfs.dev.read[,operations]

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

The disk write statistics.
Return value: Integer - with type in sectors, operations, bytes; Float - with type in sps, ops, bps.
Supported platforms: Linux, FreeBSD, Solaris, AIX, OpenBSD.

Parameters:

device - disk device (default is all ³);
type - possible values: sectors, operations, bytes, sps, ops, or bps (sps, ops, bps stand for: sectors, operations, bytes per second, respectively);
mode - possible values: avg1 (one-minute average, default), avg5, or avg15. This parameter is supported only with type in: sps, ops, bps.

Comments:

If using an update interval of three hours or more², this item will always return '0';
The sectors and sps type parameters are supported only on Linux;
The ops type parameter is supported only on Linux and FreeBSD;
The bps type parameter is supported only on FreeBSD;
The bytes type parameter is supported only on FreeBSD, Solaris, AIX, OpenBSD;
The mode parameter is supported only on Linux, FreeBSD;
You may use relative device names (for example, sda) as well as an optional /dev/ prefix (for example, /dev/sda);
LVM logical volumes are supported;
The default values of 'type' parameter for different OSes:
AIX - operations
FreeBSD - bps
Linux - sps
OpenBSD - operations
Solaris - bytes
sps, ops and bps on supported platforms is limited to 1024 devices (1023 individual and one for all).

Example:

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>]

The directory entry count.
Return value: Integer.
See supported platforms.

Parameters:

dir - the absolute path to directory;
regex incl - a regular expression describing the name pattern of the entity (file, directory, symbolic link) to include; include all if empty (default value);
regex excl - a regular expression describing the name pattern of the entity (file, directory, symbolic link) to exclude; don't exclude any if empty (default value);
types incl - directory entry types to count, possible values: file - regular file, dir - subdirectory, sym - symbolic link, sock - socket, bdev - block device, cdev - character device, fifo - FIFO, dev - synonymous with "bdev,cdev", all - all types (default), i.e. "file,dir,sym,sock,bdev,cdev,fifo". Multiple types must be separated with comma and quoted.
types excl - directory entry types (see types incl) to NOT count. If some entry type is in both types incl and types excl, directory entries of this type are NOT counted.
max depth - the maximum depth of subdirectories to traverse:
-1 (default) - unlimited,
0 - no descending into subdirectories.
min size - the minimum size (in bytes) for file to be counted. Smaller files will not be counted. Memory suffixes can be used.
max size - the maximum size (in bytes) for file to be counted. Larger files will not be counted. Memory suffixes can be used.
min age - the minimum age (in seconds) of directory entry to be counted. More recent entries will not be counted. Time suffixes can be used.
max age - the maximum age (in seconds) of directory entry to be counted. Entries so old and older will not be counted (modification time). Time suffixes can be used.
regex excl dir - a regular expression describing the name pattern of the directory to exclude. All content of the directory will be excluded (in contrast to regex_excl)

Comments:

Environment variables, e.g. %APP_HOME%, $HOME and %TEMP% are not supported;
Pseudo-directories "." and ".." are never counted;
Symbolic links are never followed for directory traversal;
Both regex incl and regex excl are being applied to files and directories when calculating the entry count, but are ignored when picking subdirectories to traverse (if regex incl is “(?i)^.+\.zip$” and max depth is not set, then all subdirectories will be traversed, but only the files of type zip will be counted).
The execution time is limited by the timeout value in agent configuration (3 sec). Since large directory traversal may take longer than that, no data will be returned and the item will turn unsupported. Partial count will not be returned.
When filtering by size, only regular files have meaningful sizes. Under Linux and BSD, directories also have non-zero sizes (a few Kb typically). Devices have zero sizes, e.g. the size of /dev/sda1 does not reflect the respective partition size. Therefore, when using <min_size> and <max_size>, it is advisable to specify <types_incl> as "file", to avoid surprises.

Examples:

vfs.dir.count[/dev] #monitors the number of devices in /dev (Linux)
       vfs.dir.count["C:\Users\ADMINI~1\AppData\Local\Temp"] #monitors the number of files in a temporary directory

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>]

The directory entry list.
Return value: JSON object.
See supported platforms.

Parameters:

dir - the absolute path to directory;
regex incl - a regular expression describing the name pattern of the entity (file, directory, symbolic link) to include; include all if empty (default value);
regex excl - a regular expression describing the name pattern of the entity (file, directory, symbolic link) to exclude; don't exclude any if empty (default value);
types incl - directory entry types to list, possible values: file - regular file, dir - subdirectory, sym - symbolic link, sock - socket, bdev - block device, cdev - character device, fifo - FIFO, dev - synonymous with "bdev,cdev", all - all types (default), i.e. "file,dir,sym,sock,bdev,cdev,fifo". Multiple types must be separated with comma and quoted.
types excl - directory entry types (see types incl) to NOT list. If some entry type is in both types incl and types excl, directory entries of this type are NOT listed.
max depth - the maximum depth of subdirectories to traverse:
-1 (default) - unlimited,
0 - no descending into subdirectories.
min size - the minimum size (in bytes) for file to be listed. Smaller files will not be listed. Memory suffixes can be used.
max size - the maximum size (in bytes) for file to be listed. Larger files will not be listed. Memory suffixes can be used.
min age - the minimum age (in seconds) of directory entry to be listed. More recent entries will not be listed. Time suffixes can be used.
max age - the maximum age (in seconds) of directory entry to be listed. Entries so old and older will not be listed (modification time). Time suffixes can be used.
regex excl dir - a regular expression describing the name pattern of the directory to exclude. All content of the directory will be excluded (in contrast to regex excl)

Comments:

Environment variables, e.g. %APP_HOME%, $HOME and %TEMP% are not supported;
Pseudo-directories "." and ".." are never listed;
Symbolic links are never followed for directory traversal;
Both regex incl and regex excl are being applied to files and directories when generating the entry list, but are ignored when picking subdirectories to traverse (if regex incl is “(?i)^.+\.zip$” and max depth is not set, then all subdirectories will be traversed, but only the files of type zip will be counted).
The execution time is limited by the timeout value in agent configuration. Since large directory traversal may take longer than that, no data will be returned and the item will turn unsupported. Partial list will not be returned.
When filtering by size, only regular files have meaningful sizes. Under Linux and BSD, directories also have non-zero sizes (a few Kb typically). Devices have zero sizes, e.g. the size of /dev/sda1 does not reflect the respective partition size. Therefore, when using min size and max size, it is advisable to specify types incl as "file", to avoid surprises.

Examples:

vfs.dir.get[/dev] #retrieves the device list in /dev (Linux)
       vfs.dir.get["C:\Users\ADMINI~1\AppData\Local\Temp"] #retrieves the file list in a temporary directory

vfs.dir.size[dir,<regex incl>,<regex excl>,<mode>,<max depth>,<regex excl dir>]

The directory size (in bytes).
Return value: Integer.
Supported platforms: Linux. The item may work on other UNIX-like platforms.

Parameters:

dir - the absolute path to directory;
regex incl - a regular expression describing the name pattern of the entity (file, directory, symbolic link) to include; include all if empty (default value);
regex excl - a regular expression describing the name pattern of the entity (file, directory, symbolic link) to exclude; don't exclude any if empty (default value);
mode - possible values: apparent (default) - gets apparent file sizes rather than disk usage (acts as du -sb dir), disk - gets disk usage (acts as du -s -B1 dir). Unlike the du command, the vfs.dir.size item takes hidden files in account when calculating the directory size (acts as du -sb .[^.]* * within dir).
max depth - the maximum depth of subdirectories to traverse: -1 (default) - unlimited, 0 - no descending into subdirectories.
regex excl dir - a regular expression describing the name pattern of the directory to exclude. All content of the directory will be excluded (in contrast to regex excl)

Comments:

Only directories with at least the read permission for zabbix user are calculated. For directories with read permission only, the size of the directory itself is calculated. Directories with read & execute permissions are calculated including contents.
With large directories or slow drives this item may time out due to the Timeout setting in agent and server/proxy configuration files. Increase the timeout values as necessary.
The file size limit depends on large file support.

Examples:

vfs.dir.size[/tmp,log] #calculates the size of all files in /tmp containing 'log' in their names
       vfs.dir.size[/tmp,log,^.+\.old$] #calculates the size of all files in /tmp containing 'log' in their names, excluding files with names ending with '.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>]

Преузимање садржаја датотеке⁷.
Повратна вредност: Text.
Погледајте подржане платформе.

Параметри:

датотека - комплетна путања до датотеке;
кодирање - кодна страница идентификатор.

Коментари:

Повратна вредност је ограничена на 16MB (укључујући размак на крају који је скраћен); ограничења базе података такође се примењују;
Празан стринг се враћа ако је датотека празна или садржи само LF/CR карактере;
Ознака реда бајтова (BOM) је искључена из излаза.

Пример:

vfs.file.contents[/etc/passwd]

vfs.file.exists[file,<types incl>,<types excl>]

Checks if the file exists.
Return value: 0 - not found; 1 - file of the specified type exists.
See supported platforms.

Parameters:

file - the full path to file;
types incl - the list of file types to include, possible values: file (regular file, default (if types_excl is not set)), dir (directory), sym (symbolic link), sock (socket), bdev (block device), cdev (character device), fifo (FIFO), dev (synonymous with "bdev,cdev"), all (all mentioned types, default if types_excl is set).
types excl - the list of file types to exclude, see types_incl for possible values (by default no types are excluded)

Comments:

Multiple types must be separated with a comma and the entire set enclosed in quotes "";
If the same type is in both <types_incl> and <types_excl>, files of this type are excluded;
The file size limit depends on large file support.

Examples:

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>]

Преузмите стринг у датотеци⁷.
Враћена вредност: Линија која садржи подударни стринг или како је наведено опционим параметром 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>]

Пронађите стринг у датотеци⁷.
Повратне вредности: 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, https⁴. Недостајућа шема ће се третирати као http. Ако је URL наведен, path и port морају бити празни. Навођење корисничког имена/лозинке приликом повезивања са серверима који захтевају аутентификацију, на пример: http://user:[email protected] је могуће само уз подршку за cURL ⁴. 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, https⁴. Недостајућа шема ће се третирати као http. Ако је URL наведен path, а port мора бити празан. Навођење корисничког имена/лозинке приликом повезивања са серверима који захтевају аутентификацију, на пример: http://user:[email protected] је могуће само уз подршку за cURL ⁴. 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, https⁴. Недостајућа шема ће се третирати као http. Ако је URL наведен, path и port морају бити празни. Навођење корисничког имена/лозинке приликом повезивања са серверима који захтевају аутентификацију, на пример: http://user:[email protected] је могуће само уз подршку за cURL ⁴. Пуникод је подржан у именима домаћина.
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 објекат.
Погледајте подржане платформе.

Параметри:

ip - листа IP/DNS/network маски сервера/проксија за које се даљински испитује (подразумевано је 127.0.0.1);
порт - порт сервера/проксија за који се даљински испитује (подразумевано је 10051)

Коментари:

Ова ставка враћа одабрани скуп интерних показатеља. За детаље погледајте Даљинско праћење Zabbix статистике;
Имајте на уму да ће захтев за статистику бити прихваћен само са адресе наведених у параметру 'StatsAllowedIP' сервер/прокси на циљној инстанци.

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

Враћа број надгледаних ставки у реду које су одложене на Заббик серверу или проксију на даљину.
Повратна вредност: JSON објекат.
Погледајте подржане платформе.

Параметри:

ip - the IP/DNS/network маски сервера/проксија за које се даљински испитује (подразумевано је 127.0.0.1);
port - порт сервера/проксија за који се даљински испитује (подразумевано је 10051)
queue - константа (користи се онако како јесте)
from - одложено најмање (подразумевано је 6 секунди)
to - одложено највише (подразумевано је бесконачност)

Имајте на уму да ће захтев за статистику бити прихваћен само са адреса наведених у параметру 'StatsAllowedIP' сервер/прокsи на циљној инстанци.

Фусноте

¹Напомена специфична за Linux. Zabbix агент мора имати приступ само за читање фајл система /proc. Закрпе за језгро са www.grsecurity.org ограничавају права приступа непривилегованих корисника.

² vfs.dev.read[], vfs.dev.write[]: Zabbix агент ће прекинути "stale" везе уређаја ако се вредностима ставки не приступа дуже од 3 сата. Ово се може десити ако систем има уређаје са динамички променљивим путањама или ако се уређај ручно уклони. Такође имајте на уму да ће ове ставке, ако користе интервал ажурирања од 3 сата или дуже, увек вратити '0'.

³ vfs.dev.read[], vfs.dev.write[]: Ако се подразумевано all користи за први параметар, онда ће кључ вратити резимирану статистику, укључујући све блок уређаје попут sda, sdb и њихове партиције (sda1, sda2, sdb3...) и више уређаја (MD raid) на основу тих блок уређаја/партиција и логичких томова (LVM) на основу тих блок уређаја/партиција. У таквим случајевима враћене вредности треба сматрати само као релативну вредност (динамичку у времену), а не као апсолутне вредности.

⁴ SSL (HTTPS) је подржан само ако је агент компајлиран са cURL подршком. У супротном, ставка ће постати неподржана.

⁵ Вредности bytes и errors нису подржане за loopback интерфејсе на Solaris системима до Solaris 10 6/06 укључујући и њих, јер статистику бајтова, грешака и коришћења језгро не чува и/или не извештава. Међутим, ако пратите Соларис систем путем net-snmp-а, вредности могу бити враћене јер net-snmp носи наслеђени код из cmu-snmp-а, датираног још из 1997. године, који, након неуспеха у читању вредности бајтова из статистике интерфејса, враћа бројач пакета (који постоји на loopback интерфејсима) помножен са произвољном вредношћу од 308. Ово претпоставља да је просечна дужина пакета 308 октета, што је веома груба процена јер је MTU ограничење на Соларис системима за loopback интерфејсе 8892 бајта. Ове вредности не треба сматрати тачним или чак ни приближно тачним. То су процене. Zabbix агент не нагађа, али net-snmp ће вратити вредност за ова поља.

⁶ Командна линија на Соларису, добијена из /proc/pid/psinfo, ограничена је на 80 бајтова и садржи командну линију каква је била када је процес покренут.

⁷ Ставке 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 у агенту конфигурациона датотека.

Documentation

1 Zabbix агент

Преглед

Supported item keys

Подржане платформе

Кључни детаљи ставке

kernel.maxfiles

kernel.maxproc

kernel.openfiles

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

log.count[file,<regexp>,<encoding>,<maxproclines>,<mode>,<maxdelay>,<options>,<persistent dir>]

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

logrt.count[file regexp,<regexp>,<encoding>,<maxproclines>,<mode>,<maxdelay>,<options>,<persistent dir>]

modbus.get[endpoint,<slave id>,<function>,<address>,<count>,<type>,<endianness>,<offset>]

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

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

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

net.if.collisions[if]

net.if.discovery

net.if.in[if,<mode>]

net.if.out[if,<mode>]

net.if.total[if,<mode>]

net.tcp.listen[port]

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

net.tcp.service[service,<ip>,<port>]

net.tcp.service.perf[service,<ip>,<port>]

net.tcp.socket.count[<laddr>,<lport>,<raddr>,<rport>,<state>]

net.udp.listen[port]

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

net.udp.service.perf[service,<ip>,<port>]

net.udp.socket.count[<laddr>,<lport>,<raddr>,<rport>,<state>]

proc.cpu.util[<name>,<user>,<type>,<cmdline>,<mode>,<zone>]

proc.get[<name>,<user>,<cmdline>,<mode>]

proc.mem[<name>,<user>,<mode>,<cmdline>,<memtype>]

proc.num[<name>,<user>,<state>,<cmdline>,<zone>]

sensor[device,sensor,<mode>]

system.boottime

system.cpu.discovery

system.cpu.intr

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

system.cpu.num[<type>]

system.cpu.switches

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

system.hostname[<type>,<transform>]

system.hw.chassis[<info>]

system.hw.cpu[<cpu>,<info>]

system.hw.devices[<type>]

system.hw.macaddr[<interface>,<format>]

system.localtime[<type>]

system.run[command,<mode>]

system.stat[resource,<type>]

system.sw.arch

system.sw.os[<info>]

system.sw.os.get

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

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

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

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

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

system.uname

system.uptime

system.users.num

vfs.dev.discovery

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

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

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>]

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>]

vfs.dir.size[dir,<regex incl>,<regex excl>,<mode>,<max depth>,<regex excl dir>]

vfs.file.cksum[file,<mode>]

vfs.file.contents[file,<encoding>]

vfs.file.exists[file,<types incl>,<types excl>]

vfs.file.get[file]

vfs.file.md5sum[file]

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

vfs.file.permissions[file]

vfs.file.regexp[file,regexp,<encoding>,<start line>,<end line>,<output>]

vfs.file.regmatch[file,regexp,<encoding>,<start line>,<end line>]

vfs.file.size[file,<mode>]

vfs.file.time[file,<mode>]

vfs.fs.discovery