manual:config:items:itemtypes:zabbix_agent

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
manual:config:items:itemtypes:zabbix_agent [2015/12/11 09:05]
martins-v vfs.fs.size - reserved space of a file system is taken into account when using the 'free' mode
manual:config:items:itemtypes:zabbix_agent [2019/02/26 09:05] (current)
martins-v proc.mem can return integer/float
Line 45: Line 45:
 | ||||| | |||||
 ^logrt[file_regexp,<​regexp>,<​encoding>,<​maxlines>,<​mode>​] ​ ^^^^^ ^logrt[file_regexp,<​regexp>,<​encoding>,<​maxlines>,<​mode>​] ​ ^^^^^
-^ |Monitoring of log file with log rotation support. ​ |Log  |**file_regexp** - absolute path to file and regexp describing the file name pattern\\ **regexp** - regular expression describing the required content pattern\\ **encoding** - code page [[:​manual/​config/​items/​itemtypes/​zabbix_agent#​available_encodings|identifier]]\\ **maxlines** - maximum number of new lines per second the agent will send to Zabbix server or proxy. This parameter overrides the value of '​MaxLinesPerSecond'​ in [[manual:​appendix:​config:​zabbix_agentd|zabbix_agentd.conf]]\\ **mode** - possible values:\\ //all// (default), //skip// - skip processing of older data (affects only newly created items that have not returned any data yet).\\ The **mode** parameter is supported from version 2.0.  |The item must be configured as an [[manual:​appendix:​items:​activepassive#​active_checks|active check]].\\ \\ //​Examples//:​ \\ %%logrt["/​home/​zabbix/​logs/​^logfile[0-9]{1,​3}$",,,​100] - will match a file like "​logfile1"​ (will not match "​.logfile1"​)%%\\ %%logrt["/​home/​user/​^logfile_.*_[0-9]{1,​3}$","​pattern_to_match","​UTF-8",​100]%% - will collect data from files such "​logfile_abc_1"​ or "​logfile__001"​.\\ \\ Log rotation is based on the last modification time of files.\\ See a more [[log_items|detailed description]]. ​ |+^ |Monitoring of log file with log rotation support. ​ |Log  |**file_regexp** - absolute path to file and regexp describing the file name pattern\\ **regexp** - regular expression describing the required content pattern\\ **encoding** - code page [[:​manual/​config/​items/​itemtypes/​zabbix_agent#​available_encodings|identifier]]\\ **maxlines** - maximum number of new lines per second the agent will send to Zabbix server or proxy. This parameter overrides the value of '​MaxLinesPerSecond'​ in [[manual:​appendix:​config:​zabbix_agentd|zabbix_agentd.conf]]\\ **mode** - possible values:\\ //all// (default), //skip// - skip processing of older data (affects only newly created items that have not returned any data yet).\\ The **mode** parameter is supported from version 2.0.  |The item must be configured as an [[manual:​appendix:​items:​activepassive#​active_checks|active check]].\\ \\ //​Examples//:​ \\ %%logrt["/​home/​zabbix/​logs/​^logfile[0-9]{1,​3}$",,,​100] - will match a file like "​logfile1"​ (will not match "​.logfile1"​)%%\\ %%logrt["/​home/​user/​^logfile_.*_[0-9]{1,​3}$","​pattern_to_match","​UTF-8",​100]%% - %%will collect data from files such "​logfile_abc_1"​ or "​logfile__001"​.%%\\ \\ Log rotation is based on the last modification time of files.\\ See a more [[log_items|detailed description]]. ​ |
 | ||||| | |||||
-^net.dns[<​ip>,​zone,<​type>,<​timeout>,<​count>​] ​ ^^^^^ +^net.dns[<​ip>,​name,<​type>,<​timeout>,<​count>​] ​ ^^^^^ 
-^ |Checks if DNS service is up.  |0 - DNS is down (server did not respond or DNS resolution failed)\\ \\ 1 - DNS is up  |**ip** - IP address of DNS server (leave empty for the default DNS server, ignored on Windows)\\ **zone** - zone to test the DNS\\ **type** - record type to be queried (default is SOA)\\ **timeout** (ignored on Windows) - timeout for the request in seconds (default is 1 second)\\ **count** (ignored on Windows) - number of tries for the request (default is 2)  |//Example key//:\\ net.dns[8.8.8.8,​zabbix.com,​MX,​2,​1] \\ \\ The possible values for **type** are: \\ ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (except for Windows), HINFO, MINFO, TXT, SRV\\ \\ SRV record type is supported since Zabbix agent versions 1.8.6 (Unix) and 2.0.0 (Windows).\\ \\ Internationalized domain names are not supported, please use IDNA encoded names instead.\\ \\ Naming before Zabbix 2.0 (still supported): //​net.tcp.dns//​|+^ |Checks if DNS service is up.  |0 - DNS is down (server did not respond or DNS resolution failed)\\ \\ 1 - DNS is up  |**ip** - IP address of DNS server (leave empty for the default DNS server, ignored on Windows)\\ **name** - DNS name to query\\ **type** - record type to be queried (default is SOA)\\ **timeout** (ignored on Windows) - timeout for the request in seconds (default is 1 second)\\ **count** (ignored on Windows) - number of tries for the request (default is 2)  |//Example key//:\\ net.dns[8.8.8.8,​zabbix.com,​MX,​2,​1] \\ \\ The possible values for **type** are: \\ ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (except for Windows), HINFO, MINFO, TXT, SRV\\ \\ SRV record type is supported since Zabbix agent versions 1.8.6 (Unix) and 2.0.0 (Windows).\\ \\ Internationalized domain names are not supported, please use IDNA encoded names instead.\\ \\ Naming before Zabbix 2.0 (still supported): //​net.tcp.dns//​|
 | ||||| | |||||
-^net.dns.record[<​ip>,​zone,<​type>,<​timeout>,<​count>​] ​ ^^^^^ +^net.dns.record[<​ip>,​name,<​type>,<​timeout>,<​count>​] ​ ^^^^^ 
-^ |Performs a DNS query. ​ |Character string with the required type of information ​ |**ip** - IP address of DNS server (leave empty for the default DNS server, ignored on Windows)\\ **zone** - zone to test the DNS\\ **type** - record type to be queried (default is SOA)\\ **timeout** (ignored on Windows) - timeout for the request in seconds (default is 1 second)\\ **count** (ignored on Windows) - number of tries for the request (default is 2)  |//Example key//:\\ net.dns.record[8.8.8.8,​zabbix.com,​MX,​2,​1] \\ \\ The possible values for **type** are: \\ ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (except for Windows), HINFO, MINFO, TXT, SRV\\ \\ SRV record type is supported since Zabbix agent versions 1.8.6 (Unix) and 2.0.0 (Windows).\\ \\ Internationalized domain names are not supported, please use IDNA encoded names instead.\\ \\ Naming before Zabbix 2.0 (still supported): //​net.tcp.dns.query//​|+^ |Performs a DNS query. ​ |Character string with the required type of information ​ |**ip** - IP address of DNS server (leave empty for the default DNS server, ignored on Windows)\\ **name** - DNS name to query\\ **type** - record type to be queried (default is SOA)\\ **timeout** (ignored on Windows) - timeout for the request in seconds (default is 1 second)\\ **count** (ignored on Windows) - number of tries for the request (default is 2)  |//Example key//:\\ net.dns.record[8.8.8.8,​zabbix.com,​MX,​2,​1] \\ \\ The possible values for **type** are: \\ ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (except for Windows), HINFO, MINFO, TXT, SRV\\ \\ SRV record type is supported since Zabbix agent versions 1.8.6 (Unix) and 2.0.0 (Windows).\\ \\ Internationalized domain names are not supported, please use IDNA encoded names instead.\\ \\ Naming before Zabbix 2.0 (still supported): //​net.tcp.dns.query//​|
 | ||||| | |||||
 ^net.if.collisions[if] ​ ^^^^^ ^net.if.collisions[if] ​ ^^^^^
Line 84: Line 84:
 | ||||| | |||||
 ^proc.mem[<​name>,<​user>,<​mode>,<​cmdline>​] ​ ^^^^^ ^proc.mem[<​name>,<​user>,<​mode>,<​cmdline>​] ​ ^^^^^
-^ |Memory used by process in bytes. ​ |Integer ​ |**name** - process name (default is //all processes//​)\\ **user** - user name (default is //all users//)\\ **mode** - possible values:\\ //avg//, //max//, //min//, //sum// (default)\\ **cmdline** - filter by command line  |//Example keys//:\\ proc.mem[,​root] - memory used by all processes running under the "​root"​ user\\ proc.mem[zabbix_server,​zabbix] - memory used by all zabbix_server processes running under the zabbix user\\ proc.mem[,​oracle,​max,​oracleZABBIX] - memory used by the most memory-hungry process running under oracle having oracleZABBIX in its command line  |+^ |Memory used by process in bytes. ​ |Integer ​- with ''​mode''​ as //max//, //min//, //sum//\\ \\ Float - with ''​mode''​ as //​avg// ​ ​|**name** - process name (default is //all processes//​)\\ **user** - user name (default is //all users//)\\ **mode** - possible values:\\ //avg//, //max//, //min//, //sum// (default)\\ **cmdline** - filter by command line  |//Example keys//:\\ proc.mem[,​root] - memory used by all processes running under the "​root"​ user\\ proc.mem[zabbix_server,​zabbix] - memory used by all zabbix_server processes running under the zabbix user\\ proc.mem[,​oracle,​max,​oracleZABBIX] - memory used by the most memory-hungry process running under oracle having oracleZABBIX in its command line\\ \\ //Note//: When several processes use shared memory, the sum of memory used by processes may result in large, unrealistic values. ​ |
 | ||||| | |||||
 ^proc.num[<​name>,<​user>,<​state>,<​cmdline>​] ​ ^^^^^ ^proc.num[<​name>,<​user>,<​state>,<​cmdline>​] ​ ^^^^^
Line 126: Line 126:
 | ||||| | |||||
 ^system.localtime[<​type>​] ​ ^^^^^ ^system.localtime[<​type>​] ​ ^^^^^
-^ |System time.  |Integer - with ''​type''​ as //utc//\\ \\ String - with ''​type''​ as //​local// ​ |**utc** - (default) the time since the Epoch (00:00:00 UTC, January 1, 1970), measured in seconds.\\ **local** - the time in the '​yyyy-mm-dd,​hh:​mm:​ss.nnn,​+hh:​mm'​ format\\ Parameters for this item supported from version 2.0.  |  |+^ |System time.  |Integer - with ''​type''​ as //utc//\\ \\ String - with ''​type''​ as //​local// ​ |**utc** - (default) the time since the Epoch (00:00:00 UTC, January 1, 1970), measured in seconds.\\ **local** - the time in the '​yyyy-mm-dd,​hh:​mm:​ss.nnn,​+hh:​mm'​ format\\ Parameters for this item supported from version 2.0.  |Example:\\ system.localtime[local] - create an item using this key and then use it to display host time in the //Clock// [[:​manual/​config/​visualisation/​screens|screen element]]. ​ |
 | ||||| | |||||
 ^system.run[command,<​mode>​] ​ ^^^^^ ^system.run[command,<​mode>​] ​ ^^^^^
Line 150: Line 150:
 | ||||| | |||||
 ^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<​sup>​1</​sup> ​ |**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 key//:\\ system.swap.size[,​pfree] - free 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<​sup>​1</​sup> ​ |**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 key//:\\ 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//).\\ \\ Old naming: system.swap.free,​ system.swap.total |
 | ||||| | |||||
 ^system.uname ​ ^^^^^ ^system.uname ​ ^^^^^