Zabbix Documentation 2.0

3.04.04.4 (current)| In development:5.0 (devel)| Unsupported:1.82.02.22.43.23.44.2Guidelines

User Tools

Site Tools


manual:config:items:itemtypes:calculated

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:calculated [2015/01/19 10:10]
martins-v removing information that already exists with hosts, items, etc
manual:config:items:itemtypes:calculated [2016/11/21 05:54] (current)
martins-v If the calculation result is a float value it will be trimmed to an integer if the calculated item type of information is Numeric (unsigned)
Line 23: Line 23:
  
 ^ARGUMENT^DEFINITION^ ^ARGUMENT^DEFINITION^
-|**func** ​        |One of the [[manual:​appendix:​triggers:​functions|functions supported in trigger expressions]]: last, min, max, avg, count, etc|+|**func** ​        |One of the [[manual:​appendix:​triggers:​functions|functions]] supported in trigger expressions:​ last, min, max, avg, count, etc|
 |**key** ​    |The key of another item whose data you want to use. It may be defined as **key** or **hostname:​key**.\\ //Note:// Putting the whole key in double quotes ("​..."​) is strongly recommended to avoid incorrect parsing because of spaces or commas within the key.\\ If there are also quoted parameters within the key, those double quotes must be escaped by using the backslash (\). See **Example 5** below.| |**key** ​    |The key of another item whose data you want to use. It may be defined as **key** or **hostname:​key**.\\ //Note:// Putting the whole key in double quotes ("​..."​) is strongly recommended to avoid incorrect parsing because of spaces or commas within the key.\\ If there are also quoted parameters within the key, those double quotes must be escaped by using the backslash (\). See **Example 5** below.|
-|**parameter(s)** |Any additional parameters that may be required.|+|**parameter(s)** |Function parameter(s),​ if required.|
  
 <note tip>All items that are referenced from the calculated item formula must exist and be collecting data. Also, if you change the item key of a referenced item, you have to manually update any formulas using that key.</​note>​ <note tip>All items that are referenced from the calculated item formula must exist and be collecting data. Also, if you change the item key of a referenced item, you have to manually update any formulas using that key.</​note>​
  
-<note important>​[[manual:​config:​macros:​usermacros|User macros]] in the formula will be expanded if used to reference a parameter or a constant. User macros will NOT be expanded if used to reference ​a function, host name, item key or operator.</​note>​+<note important>​[[manual:​config:​macros:​usermacros|User macros]] in the formula will be expanded if used to reference a function ​parameter or a constant. User macros will NOT be expanded if referencing ​a function, host name, item key, item key parameter ​or operator.</​note>​
  
-A more complex formula may use a combination of functions, operators and brackets. You can use all functions and operators supported in trigger expressions. Note that the syntax is slightly different, however logic and operator precedence are exactly the same.+A more complex formula may use a combination of functions, operators and brackets. You can use all functions and [[:​manual/​config/​triggers/​expression#​operators|operators]] ​supported in trigger expressions. Note that the syntax is slightly different, however logic and operator precedence are exactly the same.
  
 Unlike trigger expressions,​ Zabbix processes calculated items according to the item update interval, not upon receiving a new value. Unlike trigger expressions,​ Zabbix processes calculated items according to the item update interval, not upon receiving a new value.
 +
 +<​note>​If the calculation result is a float value it will be trimmed to an integer if the calculated item type of information is //Numeric (unsigned)//​.</​note>​
  
 A calculated item may become unsupported in several cases: A calculated item may become unsupported in several cases:
Line 60: Line 62:
   avg("​Zabbix Server:​zabbix[wcache,​values]",​600)   avg("​Zabbix Server:​zabbix[wcache,​values]",​600)
  
-Note that extensive use of calculated items with long time periods may affect performance of the Zabbix ​Server.+Note that extensive use of calculated items with long time periods may affect performance of Zabbix ​server.
  
 == Example 3 == == Example 3 ==