Documentation
Table of Contents
7 Calculated items
Overview
With calculated items you can create calculations on the basis of other items.
Thus, calculated items are a way of creating virtual data sources. The values will be periodically calculated based on an arithmetical expression. All calculations are done by the Zabbix server - nothing related to calculated items is performed on Zabbix agents or proxies.
The resulting data will be stored in the Zabbix database as for any other item - this means storing both history and trend values for fast graph generation. Calculated items may be used in trigger expressions, referenced by macros or other entities same as any other item type.
To use calculated items, choose the item type Calculated.
Configurable fields
The key is a unique item identifier (per host). You can create any key name using supported symbols.
Calculation definition should be entered in the Formula field. There is virtually no connection between the formula and the key. The key parameters are not used in formula in any way.
The correct syntax of a simple formula is:
Where:
| ARGUMENT | DEFINITION |
|---|---|
| func | One of the 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. |
| parameter(s) | Function parameter(s), if required. |
All items that are referenced from the calculated item formula must exist and be collecting data (exceptions in functions and unsupported items). Also, if you change the item key of a referenced item, you have to manually update any formulas using that key.
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.
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.
Unlike trigger expressions, Zabbix processes calculated items according to the item update interval, not upon receiving a new value.
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).
A calculated item may become unsupported in several cases:
- referenced item(s)
- is not found
- is disabled
- belongs to a disabled host
- is not supported (see exceptions in functions and unsupported items, Expressions with unsupported items and unknown values and Operators)
- no data to calculate a function
- division by zero
- incorrect syntax used
Support for calculated items was introduced in Zabbix 1.8.1.
Starting from Zabbix 3.2 calculated items in some cases may involve unsupported items as described in functions and unsupported items, Expressions with unsupported items and unknown values and Operators.
Usage examples
Example 1
Calculating percentage of free disk space on '/'.
Use of function last:
Zabbix will take the latest values for free and total disk spaces and calculate percentage according to the given formula.
Example 2
Calculating a 10-minute average of the number of values processed by Zabbix.
Use of function avg:
Note that extensive use of calculated items with long time periods may affect performance of Zabbix server.
Example 3
Calculating total bandwidth on eth0.
Sum of two functions:
Example 4
Calculating percentage of incoming traffic.
More complex expression:
Example 5
Using aggregated items correctly within a calculated item.
Take note of how double quotes are escaped within the quoted key: