This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
manual:config:items:itemtypes:zabbix_agent [2020/06/29 07:37] martins-v 'bps', 'bytes' not supported in Linux for vfs.dev.read/write (ZBX-17953) |
manual:config:items:itemtypes:zabbix_agent [2021/03/03 10:54] marinagen [ZBX-18345] net.tcp.port <ip> parameter can also be a DNS |
||
---|---|---|---|
Line 75: | Line 75: | ||
| ||||| | | ||||| | ||
^net.tcp.port[<ip>,port] ^^^^^ | ^net.tcp.port[<ip>,port] ^^^^^ | ||
- | ^ |Checks if it is possible to make TCP connection to specified port. |0 - cannot connect\\ \\ 1 - can connect |**ip** - IP address (default is 127.0.0.1)\\ **port** - port number |Example:\\ => net.tcp.port[,80] -> can be used to test availability of web server running on port 80.\\ \\ For simple TCP performance testing use net.tcp.service.perf[tcp,<ip>,<port>]\\ \\ Note that these checks may result in additional messages in system daemon logfiles (SMTP and SSH sessions being logged usually). \\ \\ Old naming: //check_port[*]//| | + | ^ |Checks if it is possible to make TCP connection to specified port. |0 - cannot connect\\ \\ 1 - can connect |**ip** - IP or DNS name (default is 127.0.0.1)\\ **port** - port number |Example:\\ => net.tcp.port[,80] -> can be used to test availability of web server running on port 80.\\ \\ For simple TCP performance testing use net.tcp.service.perf[tcp,<ip>,<port>]\\ \\ Note that these checks may result in additional messages in system daemon logfiles (SMTP and SSH sessions being logged usually). \\ \\ Old naming: //check_port[*]//| |
| ||||| | | ||||| | ||
^net.tcp.service[service,<ip>,<port>] ^^^^^ | ^net.tcp.service[service,<ip>,<port>] ^^^^^ | ||
Line 125: | Line 125: | ||
| ||||| | | ||||| | ||
^system.cpu.util[<cpu>,<type>,<mode>] ^^^^^ | ^system.cpu.util[<cpu>,<type>,<mode>] ^^^^^ | ||
- | ^ |CPU utilisation percentage. |Float |**cpu** - //<CPU number>// or //all// (default)\\ **type** - possible values:\\ //idle//, //nice//, //user// (default), //system// (default for Windows), //iowait//, //interrupt//, //softirq//, //steal//, //guest// (on Linux kernels 2.6.24 and above), //guest_nice// (on Linux kernels 2.6.33 and above). Parameters //user// and //nice// time no longer include //guest// time and //guest_nice// time since Zabbix 3.0.14.\\ **mode** - possible values:\\ //avg1// (one-minute average, default), //avg5//, //avg15// |Example:\\ => system.cpu.util[0,user,avg5]\\ \\ Old naming: //system.cpu.idleX, system.cpu.niceX, system.cpu.systemX, system.cpu.userX// | | + | ^ |CPU utilisation percentage. |Float |**cpu** - //<CPU number>// or //all// (default)\\ **type** - possible values:\\ //idle//, //nice//, //user// (default), //system// (default for Windows), //iowait//, //interrupt//, //softirq//, //steal//, //guest// (on Linux kernels 2.6.24 and above), //guest_nice// (on Linux kernels 2.6.33 and above). Parameters //user// and //nice// time no longer include //guest// time and //guest_nice// time since Zabbix 3.0.14.\\ See also [[:manual/appendix/items/supported_by_platform|platform-specific]] details for this parameter.\\ **mode** - possible values:\\ //avg1// (one-minute average, default), //avg5//, //avg15// |Example:\\ => system.cpu.util[0,user,avg5]\\ \\ Old naming: //system.cpu.idleX, system.cpu.niceX, system.cpu.systemX, system.cpu.userX// | |
| ||||| | | ||||| | ||
^system.hostname[<type>] ^^^^^ | ^system.hostname[<type>] ^^^^^ | ||
Line 160: | Line 160: | ||
| ||||| | | ||||| | ||
^system.sw.packages[<package>,<manager>,<format>] ^^^^^ | ^system.sw.packages[<package>,<manager>,<format>] ^^^^^ | ||
- | ^ |Listing of installed packages. |Text |**package** - //all// (default) or a regular expression\\ **manager** - //all// (default) or a package manager\\ **format** - //full// (default) or //short// |Lists (alphabetically) installed packages whose name matches the given ''package'' regexp (//all// lists them all).\\ \\ Example:\\ => system.sw.packages[mini,dpkg,short] -> python-minimal, python2.6-minimal, ubuntu-minimal\\ \\ Supported package managers (executed command):\\ dpkg (dpkg %%--get-selections%%)\\ pkgtool (ls /var/log/packages)\\ rpm (rpm -qa)\\ pacman (pacman -Q)\\ \\ If ''format'' is specified as //full//, packages are grouped by package managers (each manager on a seperate 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.\\ \\ Supported since Zabbix agent version 2.0. | | + | ^ |Listing of installed packages. |Text |**package** - //all// (default) or a regular expression\\ **manager** - //all// (default) or a package manager\\ **format** - //full// (default) or //short// |Lists (alphabetically) installed packages whose name matches the given ''package'' regexp (//all// lists them all).\\ \\ Example:\\ => system.sw.packages[mini,dpkg,short] -> python-minimal, python2.6-minimal, ubuntu-minimal\\ \\ Supported package managers (executed command):\\ dpkg (dpkg %%--get-selections%%)\\ pkgtool (ls /var/log/packages)\\ rpm (rpm -qa)\\ pacman (pacman -Q)\\ \\ 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.\\ \\ Supported since Zabbix agent version 2.0. | |
| ||||| | | ||||| | ||
^system.swap.in[<device>,<type>] ^^^^^ | ^system.swap.in[<device>,<type>] ^^^^^ | ||
- | ^ |Swap in (from device into memory) statistics. |Integer |**device** - device used for swapping (default is //all//)\\ **type** - possible values:\\ //count// (number of swapins), //sectors// (sectors swapped in), //pages// (pages swapped in). See [[manual:appendix:items:supported_by_platform|supported by platform]] for details on defaults.|Example:\\ => system.swap.in[,pages]\\ \\ The source of this information is:\\ /proc/swaps, /proc/partitions, /proc/stat (Linux 2.4)\\ /proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6) | | + | ^ |Swap in (from device into memory) statistics. |Integer |**device** - device used for swapping (default is //all//)\\ **type** - possible values:\\ //count// (number of swapins), //sectors// (sectors swapped in), //pages// (pages swapped in).\\ See also [[:manual/appendix/items/supported_by_platform|platform-specific]] details for this parameter. |Example:\\ => system.swap.in[,pages]\\ \\ The source of this information is:\\ /proc/swaps, /proc/partitions, /proc/stat (Linux 2.4)\\ /proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6) | |
| ||||| | | ||||| | ||
^system.swap.out[<device>,<type>] ^^^^^ | ^system.swap.out[<device>,<type>] ^^^^^ | ||
- | ^ |Swap out (from memory onto device) statistics. |Integer |**device** - device used for swapping (default is //all//)\\ **type** - possible values:\\ //count// (number of swapouts), //sectors// (sectors swapped out), //pages// (pages swapped out). See [[manual:appendix:items:supported_by_platform|supported by platform]] for details on defaults.|Example:\\ => system.swap.out[,pages]\\ \\ The source of this information is:\\ /proc/swaps, /proc/partitions, /proc/stat (Linux 2.4)\\ /proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6) | | + | ^ |Swap out (from memory onto device) statistics. |Integer |**device** - device used for swapping (default is //all//)\\ **type** - possible values:\\ //count// (number of swapouts), //sectors// (sectors swapped out), //pages// (pages swapped out).\\ See also [[:manual/appendix/items/supported_by_platform|platform-specific]] details for this parameter. |Example:\\ => system.swap.out[,pages]\\ \\ The source of this information is:\\ /proc/swaps, /proc/partitions, /proc/stat (Linux 2.4)\\ /proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6) | |
| ||||| | | ||||| | ||
^system.swap.size[<device>,<type>] ^^^^^ | ^system.swap.size[<device>,<type>] ^^^^^ | ||
- | ^ |Swap space size in bytes or in percentage from total. |Integer - for bytes\\ \\ Float - for percentage |**device** - device used for swapping (default is //all//)\\ **type** - possible values:\\ //free// (free swap space, default), //pfree// (free swap space, in percent), //pused// (used swap space, in percent), //total// (total swap space), //used// (used swap space) |Example:\\ => system.swap.size[,pfree] -> free swap space percentage\\ \\ If //device// is not specified Zabbix agent will only take into account swap devices (files), physical memory will be ignored. For example, on Solaris systems //swap -s// command includes a portion of physical memory and swap devices (unlike //swap -l//).\\ \\ Note that this key might report incorrect swap space size/percentage on virtualized (VMware ESXi, VirtualBox) Windows platforms. In this case you may use the ''perf_counter[\700(_Total)\702]'' key to obtain correct swap space percentage.\\ \\ Old naming: //system.swap.free//, //system.swap.total// | | + | ^ |Swap space size in bytes or in percentage from total. |Integer - for bytes\\ \\ Float - for percentage |**device** - device used for swapping (default is //all//)\\ **type** - possible values:\\ //free// (free swap space, default), //pfree// (free swap space, in percent), //pused// (used swap space, in percent), //total// (total swap space), //used// (used swap space)\\ See also [[:manual/appendix/items/supported_by_platform|platform-specific]] details for this parameter. |Example:\\ => system.swap.size[,pfree] -> free swap space percentage\\ \\ If //device// is not specified Zabbix agent will only take into account swap devices (files), physical memory will be ignored. For example, on Solaris systems //swap -s// command includes a portion of physical memory and swap devices (unlike //swap -l//).\\ \\ Note that this key might report incorrect swap space size/percentage on virtualized (VMware ESXi, VirtualBox) Windows platforms. In this case you may use the ''perf_counter[\700(_Total)\702]'' key to obtain correct swap space percentage.\\ \\ Old naming: //system.swap.free//, //system.swap.total// | |
| ||||| | | ||||| | ||
^system.uname ^^^^^ | ^system.uname ^^^^^ | ||
Line 181: | Line 181: | ||
| ||||| | | ||||| | ||
^vfs.dev.read[<device>,<type>,<mode>] ^^^^^ | ^vfs.dev.read[<device>,<type>,<mode>] ^^^^^ | ||
- | ^ |Disk read statistics. |Integer - with ''type'' in //sectors//, //operations//, //bytes//\\ \\ Float - with ''type'' in //sps//, //ops//, //bps//\\ \\ //Note//: Since 3.0.25, if using an update interval of three hours or more<sup>**[[#footnotes|2]]**</sup>, will always return '0' |**device** - disk device (default is //all// <sup>**[[#footnotes|3]]**</sup>) \\ **type** - possible values: //sectors//, //operations//, //bytes//, //sps//, //ops//, //bps//\\ Not all type parameters are supported per each platform (see [[:manual/appendix/items/supported_by_platform|Items supported per platform]] for details). This parameter must be specified, since defaults differ under various OSes.\\ //sps//, //ops//, //bps// stand for: sectors, operations, bytes per second, respectively.\\ **mode** - possible values: //avg1// (one-minute average, default), //avg5//, //avg15//.\\ This parameter is supported only with ''type'' in: sps, ops, bps. |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.\\ \\ Default values of 'type' parameter for different OSes:\\ AIX - operations\\ FreeBSD - bps\\ Linux - sps\\ OpenBSD - operations\\ Solaris - bytes\\ \\ Example:\\ => vfs.dev.read[,operations]\\ \\ //sps//, //ops// and //bps// on supported platforms used to be limited to 8 devices (7 individual and one //all//). Since Zabbix 2.0.1 this limit is 1024 devices (1023 individual and one for //all//).\\ \\ Old naming: //io[*]// | | + | ^ |Disk read statistics. |Integer - with ''type'' in //sectors//, //operations//, //bytes//\\ \\ Float - with ''type'' in //sps//, //ops//, //bps//\\ \\ //Note//: Since 3.0.25, if using an update interval of three hours or more<sup>**[[#footnotes|2]]**</sup>, will always return '0' |**device** - disk device (default is //all// <sup>**[[#footnotes|3]]**</sup>) \\ **type** - possible values: //sectors//, //operations//, //bytes//, //sps//, //ops//, //bps//\\ Note that 'type' parameter support and defaults depend on the platform. See [[:manual/appendix/items/supported_by_platform|platform-specific]] details.\\ //sps//, //ops//, //bps// stand for: sectors, operations, bytes per second, respectively.\\ **mode** - possible values: //avg1// (one-minute average, default), //avg5//, //avg15//.\\ This parameter is supported only with ''type'' in: sps, ops, bps. |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.\\ \\ Default values of 'type' parameter for different OSes:\\ AIX - operations\\ FreeBSD - bps\\ Linux - sps\\ OpenBSD - operations\\ Solaris - bytes\\ \\ Example:\\ => vfs.dev.read[,operations]\\ \\ //sps//, //ops// and //bps// on supported platforms used to be limited to 8 devices (7 individual and one //all//). Since Zabbix 2.0.1 this limit is 1024 devices (1023 individual and one for //all//).\\ \\ Old naming: //io[*]// | |
| ||||| | | ||||| | ||
^vfs.dev.write[<device>,<type>,<mode>] ^^^^^ | ^vfs.dev.write[<device>,<type>,<mode>] ^^^^^ | ||
- | ^ |Disk write statistics. |Integer - with ''type'' in //sectors//, //operations//, //bytes//\\ \\ Float - with ''type'' in //sps//, //ops//, //bps//\\ \\ //Note//: Since 3.0.25, if using an update interval of three hours or more<sup>**[[#footnotes|2]]**</sup>, will always return '0' |**device** - disk device (default is //all// <sup>**[[#footnotes|3]]**</sup>) \\ **type** - possible values: //sectors//, //operations//, //bytes//, //sps//, //ops//, //bps//\\ Not all type parameters are supported per each platform (see [[:manual/appendix/items/supported_by_platform|Items supported per platform]] for details). This parameter must be specified, since defaults differ under various OSes.\\ //sps//, //ops//, //bps// stand for: sectors, operations, bytes per second, respectively.\\ **mode** - possible values: //avg1// (one-minute average, default), //avg5//, //avg15//.\\ This parameter is supported only with ''type'' in: sps, ops, bps. |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.\\ \\ Default values of 'type' parameter for different OSes:\\ AIX - operations\\ FreeBSD - bps\\ Linux - sps\\ OpenBSD - operations\\ Solaris - bytes\\ \\ Example:\\ => vfs.dev.write[,operations]\\ \\ //sps//, //ops// and //bps// on supported platforms used to be limited to 8 devices (7 individual and one //all//). Since Zabbix 2.0.1 this limit is 1024 (1023 individual and one for //all//).\\ \\ Old naming: //io[*]// | | + | ^ |Disk write statistics. |Integer - with ''type'' in //sectors//, //operations//, //bytes//\\ \\ Float - with ''type'' in //sps//, //ops//, //bps//\\ \\ //Note//: Since 3.0.25, if using an update interval of three hours or more<sup>**[[#footnotes|2]]**</sup>, will always return '0' |**device** - disk device (default is //all// <sup>**[[#footnotes|3]]**</sup>) \\ **type** - possible values: //sectors//, //operations//, //bytes//, //sps//, //ops//, //bps//\\ Note that 'type' parameter support and defaults depend on the platform. See [[:manual/appendix/items/supported_by_platform|platform-specific]] details.\\ //sps//, //ops//, //bps// stand for: sectors, operations, bytes per second, respectively.\\ **mode** - possible values: //avg1// (one-minute average, default), //avg5//, //avg15//.\\ This parameter is supported only with ''type'' in: sps, ops, bps. |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.\\ \\ Default values of 'type' parameter for different OSes:\\ AIX - operations\\ FreeBSD - bps\\ Linux - sps\\ OpenBSD - operations\\ Solaris - bytes\\ \\ Example:\\ => vfs.dev.write[,operations]\\ \\ //sps//, //ops// and //bps// on supported platforms used to be limited to 8 devices (7 individual and one //all//). Since Zabbix 2.0.1 this limit is 1024 (1023 individual and one for //all//).\\ \\ Old naming: //io[*]// | |
| ||||| | | ||||| | ||
^vfs.file.cksum[file] ^^^^^ | ^vfs.file.cksum[file] ^^^^^ | ||
Line 220: | Line 220: | ||
| ||||| | | ||||| | ||
^vm.memory.size[<mode>] ^^^^^ | ^vm.memory.size[<mode>] ^^^^^ | ||
- | ^ |Memory size in bytes or in percentage from total. |Integer - for bytes\\ \\ Float - for percentage |**mode** - possible values: \\ //total// (default), //active//, //anon//, //buffers//, //cached//, //exec//, //file//, //free//, //inactive//, //pinned//, //shared//, //wired//, //used//, //pused// (used, percentage), //available//, //pavailable// (available, percentage) |This item accepts three categories of parameters:\\ \\ 1) //total// - total amount of memory;\\ 2) platform-specific memory types: //active//, //anon//, //buffers//, //cached//, //exec//, //file//, //free//, //inactive//, //pinned//, //shared//, //wired//;\\ 3) user-level estimates on how much memory is used and available: //used//, //pused//, //available//, //pavailable//.\\ \\ See a more detailed description of vm.memory.size [[manual:appendix:items:vm.memory.size_params|parameters]].\\ \\ Old naming: //vm.memory.buffers//, //vm.memory.cached//, //vm.memory.free//, //vm.memory.shared//, //vm.memory.total// | | + | ^ |Memory size in bytes or in percentage from total. |Integer - for bytes\\ \\ Float - for percentage |**mode** - possible values: \\ //total// (default), //active//, //anon//, //buffers//, //cached//, //exec//, //file//, //free//, //inactive//, //pinned//, //shared//, //wired//, //used//, //pused// (used, percentage), //available//, //pavailable// (available, percentage)\\ See also [[:manual/appendix/items/supported_by_platform|platform-specific]] support and [[manual:appendix:items:vm.memory.size_params|additional details]] for this parameter. |This item accepts three categories of parameters:\\ \\ 1) //total// - total amount of memory;\\ 2) platform-specific memory types: //active//, //anon//, //buffers//, //cached//, //exec//, //file//, //free//, //inactive//, //pinned//, //shared//, //wired//;\\ 3) user-level estimates on how much memory is used and available: //used//, //pused//, //available//, //pavailable//. | |
| ||||| | | ||||| | ||
^web.page.get[host,<path>,<port>] ^^^^^ | ^web.page.get[host,<path>,<port>] ^^^^^ |