This is the documentation page for an unsupported version of Zabbix.
Is this not what you were looking for? Switch to the current version or choose one from the drop-down menu.
Table of Contents

5 Definitions


While many things in the frontend can be configured using the frontend itself, some customisations are currently only possible by editing a definitions file.

This file is located in /include of the Zabbix HTML document directory.


Parameters in this file that could be of interest to users:


Number of unsuccessful login attempts that is allowed to an existing system user before a login block in applied (see ZBX_LOGIN_BLOCK). By default 5 attempts. Once the set number of login attempts is tried unsuccessfully, each additional unsuccessful attempt results in a login block. Used with internal authentication only.


Number of seconds for blocking a user from accessing Zabbix frontend after a number of unsuccessful login attempts (see ZBX_LOGIN_ATTEMPTS). By default 30 seconds. Used with internal authentication only.


Default graph period, in seconds. One hour by default.


Minimum graph period, in seconds. One hour by default.


Maximum graph period, in seconds. Two years by default since 1.6.7, one year before that.


Default location of Y axis in simple graphs and default value for drop down box when adding items to custom graphs. Possible values: 0 - left, 1 - right.

Default: 0


Threshold value for roundoff constants. Values less than it will be rounded to ZBX_UNITS_ROUNDOFF_LOWER_LIMIT number of digits after comma, greater to ZBX_UNITS_ROUNDOFF_UPPER_LIMIT.

Default: 0.01


Number of digits after comma, when value is greater than roundoff threshold

Default: 2


Number of digits after comma, when value is less than roundoff threshold

Default: 6

  • ZBX_HISTORY_DATA_UPKEEP (available since 1.8.4)

Number of days, which will reflect on frontend choice when deciding which history or trends table to process for selected period on data graphing. When this define is:

  * less than zero - Zabbix takes item values for selected graph period configured in item "keep in history" field to make calculations;
         * equal to zero - Zabbix takes item values only from trends;
         * greater then zero - Zabbix overwrites item "keep in history" configured value with this define;

This define could be useful for partitioned history data storage.

Default: -1


Controls how many issues are shown in the dashboard's Last n issues widget. By default 20 issues are shown.

  • SCREEN_REFRESH_TIMEOUT (available since 2.0.4)

Used in screens and defines the timeout seconds for a screen element update. When the defined number of seconds after launching an update pass and the screen element has still not been updated, the screen element will be darkened.

Default: 30

  • SCREEN_REFRESH_RESPONSIVENESS (available since 2.0.4)

Used in screens and defines the number of seconds after which query skipping will be switched off. Otherwise, if a screen element is in update status all queries on update are skipped until a response is received. With this parameter in use, another update query might be sent after N seconds without having to wait for the response to the first one.

Default: 10