Zabbix Documentation 2.2

3.04.04.24.4 (current)| In development:5.0 (devel)| Unsupported:1.82.02.22.43.23.4Guidelines

User Tools

Site Tools


manual:config:items:item

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
Last revision Both sides next revision
manual:config:items:item [2018/10/26 10:42]
martins-v unsupported items are reported as having a NOT SUPPORTED state
manual:config:items:item [2019/06/20 13:11]
martins-v value mapping works not only with integers
Line 25: Line 25:
 |//Data type// ​ |Data type is used for integer items in order to specify the expected data type:\\ **Boolean** - textual representation translated into either 0 or 1. Thus, '​TRUE'​ is stored as 1 and '​FALSE'​ is stored as 0. All values are matched in a case-insensitive way. Currently recognized values are, for:\\ //TRUE// - true, t, yes, y, on, up, running, enabled, available\\ //FALSE// - false, f, no, n, off, down, unused, disabled, unavailable\\ Additionally,​ any non-zero numeric value is considered to be TRUE and zero is considered to be FALSE. \\ **Octal** - data in octal format\\ **Decimal** - data in decimal format\\ **Hexadecimal** - data in hexadecimal format\\ Zabbix will automatically perform the conversion to numeric.\\ The conversion is done by Zabbix server (even when a host is monitored by Zabbix proxy). ​ | |//Data type// ​ |Data type is used for integer items in order to specify the expected data type:\\ **Boolean** - textual representation translated into either 0 or 1. Thus, '​TRUE'​ is stored as 1 and '​FALSE'​ is stored as 0. All values are matched in a case-insensitive way. Currently recognized values are, for:\\ //TRUE// - true, t, yes, y, on, up, running, enabled, available\\ //FALSE// - false, f, no, n, off, down, unused, disabled, unavailable\\ Additionally,​ any non-zero numeric value is considered to be TRUE and zero is considered to be FALSE. \\ **Octal** - data in octal format\\ **Decimal** - data in decimal format\\ **Hexadecimal** - data in hexadecimal format\\ Zabbix will automatically perform the conversion to numeric.\\ The conversion is done by Zabbix server (even when a host is monitored by Zabbix proxy). ​ |
 |//​Units// ​ |If a unit symbol is set, Zabbix will add post processing to the received value and display it with the set unit postfix.\\ By default, if the raw value exceeds 1000, it is divided by 1000 and displayed accordingly. For example, if you set //bps// and receive a value of 881764, it will be displayed as 881.76 Kbps. \\ Special processing is used for **B** (byte), **Bps** (bytes per second) units, which are divided by 1024. Thus, if units are set to **B** or **Bps** Zabbix will display:\\ 1 as 1B/1Bps\\ 1024 as 1KB/1KBps\\ 1536 as 1.5KB/​1.5KBps\\ Special processing is used if the following time-related units are used:\\ **unixtime** - translated to "​yyyy.mm.dd hh:​mm:​ss"​. To translate correctly, the received value must be a //Numeric (unsigned)//​ type of information.\\ **uptime** - translated to "​hh:​mm:​ss"​ or "N days, hh:​mm:​ss"​\\ For example, if you receive the value as 881764 (seconds), it will be displayed as "10 days, 04:​56:​04"​\\ **s** - translated to "yyy mmm ddd hhh mmm sss ms"; parameter is treated as number of seconds.\\ For example, if you receive the value as 881764 (seconds), it will be displayed as "10d 4h 56m"\\ Only 3 upper major units are shown, like "1m 15d 5h" or "2h 4m 46s". If there are no days to display, only two levels are displayed - "1m 5h" (no minutes, seconds or milliseconds are shown). Will be translated to "< 1 ms" if the value is less than 0.001.\\ See also the [[#​unit_blacklist|unit blacklist]]. ​ | |//​Units// ​ |If a unit symbol is set, Zabbix will add post processing to the received value and display it with the set unit postfix.\\ By default, if the raw value exceeds 1000, it is divided by 1000 and displayed accordingly. For example, if you set //bps// and receive a value of 881764, it will be displayed as 881.76 Kbps. \\ Special processing is used for **B** (byte), **Bps** (bytes per second) units, which are divided by 1024. Thus, if units are set to **B** or **Bps** Zabbix will display:\\ 1 as 1B/1Bps\\ 1024 as 1KB/1KBps\\ 1536 as 1.5KB/​1.5KBps\\ Special processing is used if the following time-related units are used:\\ **unixtime** - translated to "​yyyy.mm.dd hh:​mm:​ss"​. To translate correctly, the received value must be a //Numeric (unsigned)//​ type of information.\\ **uptime** - translated to "​hh:​mm:​ss"​ or "N days, hh:​mm:​ss"​\\ For example, if you receive the value as 881764 (seconds), it will be displayed as "10 days, 04:​56:​04"​\\ **s** - translated to "yyy mmm ddd hhh mmm sss ms"; parameter is treated as number of seconds.\\ For example, if you receive the value as 881764 (seconds), it will be displayed as "10d 4h 56m"\\ Only 3 upper major units are shown, like "1m 15d 5h" or "2h 4m 46s". If there are no days to display, only two levels are displayed - "1m 5h" (no minutes, seconds or milliseconds are shown). Will be translated to "< 1 ms" if the value is less than 0.001.\\ See also the [[#​unit_blacklist|unit blacklist]]. ​ |
-|//Use custom multiplier// ​ |If you enable this option, all received values will be multiplied by the integer or floating-point value set in the value field.\\ Use this option to convert values received in KB, MBps, etc into B, Bps. Otherwise Zabbix cannot correctly set [[manual:​config:​triggers:​suffixes|prefixes]] (K, M, G etc).\\ Starting with Zabbix 2.2, using scientific notation is also supported. E.g. 1e+70. ​ | +|//Use custom multiplier// ​ |If you enable this option, all received values will be multiplied by the integer or floating-point value set in the value field.\\ Use this option to convert values received in KB, MBps, etc into B, Bps. Otherwise Zabbix cannot correctly set [[manual:​config:​triggers:​suffixes|prefixes]] (K, M, G etc).\\ //Note// that if the item type of information is //Numeric (unsigned)//,​ incoming values with a fractional part will be trimmed (i.e. '​0.9'​ will become '​0'​) before the custom multiplier is applied.\\ Starting with Zabbix 2.2, using scientific notation is also supported. E.g. 1e+70. ​ | 
-|//Update interval (in sec)// ​ |Retrieve a new value for this item every N seconds. Maximum allowed update interval is 86400 seconds (1 day).\\ //Note//: If set to '0', the item will not be polled. However, if a flexible interval also exists with a non-zero value, the item will be polled during the flexible interval duration.|+|//Update interval (in sec)// ​ |Retrieve a new value for this item every N seconds. Maximum allowed update interval is 86400 seconds (1 day).\\ //Note//: If set to %%"%%0%%"%%, the item will not be polled. However, if a flexible interval also exists with a non-zero value, the item will be polled during the flexible interval duration.|
 |//Flexible intervals// ​ |You can create exceptions to //Update interval//. For example:\\ Interval: **10**, Period: **1-5,​09:​00-18:​00** - will check the item every 10 seconds during working hours.\\ Interval: **0**, Period: **1-7,​00:​00-7:​00** - will disable checking the item at night.\\ Interval: **0**, Period: **7-7,​00:​00-24:​00** - will disable checking the item on Sundays.\\ To check an item once per day at a specific time (say, 12:00), set the default //Update interval// to '​0',​ but specify **60** in the flexible interval and a period like **1-7,​12:​00-12:​01**\\ Up to seven flexible intervals can be defined. If multiple flexible intervals overlap, the smallest //​Interval//​ value is used for the overlapping period. Note that if the smallest value of overlapping flexible intervals is '​0',​ no polling will take place.\\ Outside the flexible intervals the default update interval is used.\\ See the page about setting [[manual:​appendix:​time_period|time periods]] for description of the //Period// format.\\ Note that if the flexible interval equals the length of the period, the item will be checked exactly once. If the flexible interval is greater than the period, the item might be checked once or it might not be checked at all (thus such configuration is not advisable). If the flexible interval is less than the period, the item will be checked at least once.\\ If the flexible interval is set to '​0',​ the item is not polled during the flexible interval period and resumes polling according to the default //Update interval// once the period is over.\\ //Note//: Not available for Zabbix agent active items. ​ | |//Flexible intervals// ​ |You can create exceptions to //Update interval//. For example:\\ Interval: **10**, Period: **1-5,​09:​00-18:​00** - will check the item every 10 seconds during working hours.\\ Interval: **0**, Period: **1-7,​00:​00-7:​00** - will disable checking the item at night.\\ Interval: **0**, Period: **7-7,​00:​00-24:​00** - will disable checking the item on Sundays.\\ To check an item once per day at a specific time (say, 12:00), set the default //Update interval// to '​0',​ but specify **60** in the flexible interval and a period like **1-7,​12:​00-12:​01**\\ Up to seven flexible intervals can be defined. If multiple flexible intervals overlap, the smallest //​Interval//​ value is used for the overlapping period. Note that if the smallest value of overlapping flexible intervals is '​0',​ no polling will take place.\\ Outside the flexible intervals the default update interval is used.\\ See the page about setting [[manual:​appendix:​time_period|time periods]] for description of the //Period// format.\\ Note that if the flexible interval equals the length of the period, the item will be checked exactly once. If the flexible interval is greater than the period, the item might be checked once or it might not be checked at all (thus such configuration is not advisable). If the flexible interval is less than the period, the item will be checked at least once.\\ If the flexible interval is set to '​0',​ the item is not polled during the flexible interval period and resumes polling according to the default //Update interval// once the period is over.\\ //Note//: Not available for Zabbix agent active items. ​ |
-|//History storage period\\ (in days)// ​ |Number of days to keep detailed history in the database. Older data will be removed by the housekeeper.\\ Starting with Zabbix 2.2, this value can be overridden globally in //​Administration -> General -> [[manual:​web_interface:​frontend_sections:​administration:​general#​housekeeper|Housekeeper]]//​. If the global setting exists, a warning message is displayed:​\\ {{manual:​config:​override_item.png|}}\\ It is recommended to keep the recorded values for the smallest possible number of days to reduce the size of value history in the database. Instead of keeping long history of values, you can keep longer data of trends.\\ See also [[:​manual/​config/​items/​history_and_trends|History and trends]]. ​ | +|//History storage period\\ (in days)// ​ |Number of days to keep detailed history in the database. Older data will be removed by the housekeeper.\\ Starting with Zabbix 2.2, this value can be overridden globally in //​Administration -> General -> [[manual:​web_interface:​frontend_sections:​administration:​general#​housekeeper|Housekeeper]]//​. If the global setting exists, a warning message is displayed:​\\ {{manual:​config:​override_item.png|}}\\ It is recommended to keep the recorded values for the smallest possible number of days to reduce the size of value history in the database. Instead of keeping long history of values, you can keep longer data of trends.\\ If set to %%"​%%0%%"​%% no data is stored in the history table for the item. Host inventory data only are updated.\\ See also [[:​manual/​config/​items/​history_and_trends|History and trends]]. ​ | 
-|//Trend storage period\\ (in days)// ​ |Keep aggregated (hourly min, max, avg, count) detailed history for N days in the database. Older data will be removed by the housekeeper.\\ Starting with Zabbix 2.2, this value can be overridden globally in //​Administration -> General -> [[manual:​web_interface:​frontend_sections:​administration:​general#​housekeeper|Housekeeper]]//​. If the global setting exists, a warning message is displayed:​\\ {{manual:​config:​override_trends.png|}}\\ //Note:// Keeping trends is not available for non-numeric data - character, log and text.\\ See also [[:​manual/​config/​items/​history_and_trends|History and trends]]. ​ |+|//Trend storage period\\ (in days)// ​ |Keep aggregated (hourly min, max, avg, count) detailed history for N days in the database. Older data will be removed by the housekeeper.\\ Starting with Zabbix 2.2, this value can be overridden globally in //​Administration -> General -> [[manual:​web_interface:​frontend_sections:​administration:​general#​housekeeper|Housekeeper]]//​. If the global setting exists, a warning message is displayed:​\\ {{manual:​config:​override_trends.png|}}\\ //Note:// Keeping trends is not available for non-numeric data - character, log and text.\\ If set to %%"​%%0%%"​%% no trends are kept.\\ See also [[:​manual/​config/​items/​history_and_trends|History and trends]]. ​ |
 |//Store value// ​ |**As is**  - no pre-processing\\ **Delta (speed per second)** - evaluate value as (**value**-**prev_value**)/​(**time**-**prev_time**),​ where\\ //value// - current value\\ //​value_prev//​ - previously received value\\ //time// - current timestamp\\ //​prev_time//​ - timestamp of previous value\\ This setting is extremely useful to get speed per second for a constantly growing value.\\ If current value is smaller than the previous value, Zabbix discards that difference (stores nothing) and waits for another value. This helps to work correctly with, for instance, a wrapping (overflow) of 32-bit SNMP counters.\\ //Note//: As this calculation may produce floating point numbers, it is recommended to set the 'Type of information'​ to //Numeric (float)//, even if the incoming raw values are integers. This is especially relevant for small numbers where the decimal part matters. If the floating point values are large and may exceed the '​float'​ field length in which case the entire value may be lost, it is actually suggested to use //Numeric (unsigned)//​ and thus trim only the decimal part.\\ **Delta (simple change)** - evaluate as (**value**-**prev_value**),​ where\\ //value// - current value\\ //​value_prev//​ - previously received value\\ This setting can be useful to measure a constantly growing value. If the current value is smaller than the previous value, Zabbix discards that difference (stores nothing) and waits for another value. ​ | |//Store value// ​ |**As is**  - no pre-processing\\ **Delta (speed per second)** - evaluate value as (**value**-**prev_value**)/​(**time**-**prev_time**),​ where\\ //value// - current value\\ //​value_prev//​ - previously received value\\ //time// - current timestamp\\ //​prev_time//​ - timestamp of previous value\\ This setting is extremely useful to get speed per second for a constantly growing value.\\ If current value is smaller than the previous value, Zabbix discards that difference (stores nothing) and waits for another value. This helps to work correctly with, for instance, a wrapping (overflow) of 32-bit SNMP counters.\\ //Note//: As this calculation may produce floating point numbers, it is recommended to set the 'Type of information'​ to //Numeric (float)//, even if the incoming raw values are integers. This is especially relevant for small numbers where the decimal part matters. If the floating point values are large and may exceed the '​float'​ field length in which case the entire value may be lost, it is actually suggested to use //Numeric (unsigned)//​ and thus trim only the decimal part.\\ **Delta (simple change)** - evaluate as (**value**-**prev_value**),​ where\\ //value// - current value\\ //​value_prev//​ - previously received value\\ This setting can be useful to measure a constantly growing value. If the current value is smaller than the previous value, Zabbix discards that difference (stores nothing) and waits for another value. ​ |
-|//Show value// ​ |Apply value mapping to this item. Value mapping does not change received values, it is for displaying data only.\\ It works with integer ​items only.\\ For example, "​Windows service states"​.|+|//Show value// ​ |Apply value mapping to this item. Value mapping does not change received values, it is for displaying data only.\\ It works with //​Numeric(unsigned)//,​ //​Numeric(float)//​ and //​Character// ​items.\\ For example, "​Windows service states"​.|
 |//Log time format// ​ |Available for items of type **Log** only. Supported placeholders:​\\ ​    * **y**: //Year (1970-2038)//​\\ ​    * **M**: //Month (01-12)//​\\ ​    * **d**: //Day (01-31)//​\\ ​    * **h**: //Hour (00-23)//​\\ ​    * **m**: //Minute (00-59)//​\\ ​    * **s**: //Second (00-59)//​\\ ​    If left blank the timestamp will not be parsed.\\ For example, consider the following line from the Zabbix agent log file:\\ " 23480:​20100328:​154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)."​\\ It begins with six character positions for PID, followed by date, time, and the rest of the line.\\ Log time format for this line would be "​pppppp:​yyyyMMdd:​hhmmss"​.\\ Note that "​p"​ and ":"​ chars are just placeholders and can be anything but "​yMdhms"​. | |//Log time format// ​ |Available for items of type **Log** only. Supported placeholders:​\\ ​    * **y**: //Year (1970-2038)//​\\ ​    * **M**: //Month (01-12)//​\\ ​    * **d**: //Day (01-31)//​\\ ​    * **h**: //Hour (00-23)//​\\ ​    * **m**: //Minute (00-59)//​\\ ​    * **s**: //Second (00-59)//​\\ ​    If left blank the timestamp will not be parsed.\\ For example, consider the following line from the Zabbix agent log file:\\ " 23480:​20100328:​154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)."​\\ It begins with six character positions for PID, followed by date, time, and the rest of the line.\\ Log time format for this line would be "​pppppp:​yyyyMMdd:​hhmmss"​.\\ Note that "​p"​ and ":"​ chars are just placeholders and can be anything but "​yMdhms"​. |
 |//New application// ​ |Enter the name of a new application for the item.  | |//New application// ​ |Enter the name of a new application for the item.  |