# 1 General

#### Overview

The *Administration → General* section contains a number of screens for
setting frontend-related defaults and customizing Zabbix.

The dropdown to the right allows you to switch between different
configuration screens.

![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_dropdown.png){width="600"}

##### - GUI

This screen provides customization of several frontend-related defaults.

![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_gui_new.png)

Configuration parameters:

|Parameter|Description|
|---------|-----------|
|*Default theme*|Default theme for users who have not set a specific one in their profiles.|
|*Dropdown first entry*|Whether first entry in element selection dropdowns should be *All* or *None*.<br>With *remember selected* checked, the last selected element in the dropdown will be remembered (instead of the default) when navigating to another page.|
|*Limit for search and filter results*|Maximum amount of elements (rows) that will be displayed in a web-interface list, like, for example, in *Configuration → Hosts*.<br>*Note*: If set to, for example, '50', only the first 50 elements will be displayed in all affected frontend lists. If some list contains more than fifty elements, the indication of that will be the '+' sign in *"Displaying 1 to 50 of **50+** found"*. Also, if filtering is used and still there are more than 50 matches, only the first 50 will be displayed.|
|*Max count of elements<br>to show inside table cell*|For entries that are displayed in a single table cell, no more than configured here will be shown.|
|*Enable event acknowledgement*|This parameter defines if event acknowledgments are activated in Zabbix interface.|
|*Show warning if Zabbix server is down*|This parameter enables a warning message to be displayed in the browser window if Zabbix server cannot be reached (may be down). The message remains visible even if the user scrolls down the page. If the mouse is moved over it, the message is temporarily hidden to reveal the contents below.<br>This parameter is supported since Zabbix 2.0.1.|

##### - Housekeeper

The housekeeper is a periodical process, executed by Zabbix server. The
process removes outdated information and information deleted by user.

![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_housekeeper.png)

In this section housekeeping tasks can be enabled or disabled on a
per-task basis separately for: events and alerts/IT services/audit/user
sessions/history/trends. If housekeeping is enabled, it is possible to
set for how many days data records will be kept before being removed by
the housekeeper.

Deleting an item/trigger will also delete problems generated by that
item/trigger.

Also, an event will only be deleted by the housekeeper if it is not
associated with a problem in any way. This means that if an event is
either a problem or recovery event, it will not be deleted until the
related problem record is removed. The housekeeper will delete problems
first and events after, to avoid potential problems with stale events or
problem records.

For history and trends an additional option is available: *Override item
history period* and *Override item trends period*. This option allows to
globally set for how many days item history/trends will be kept, in this
case overriding the values set for individual items in *Keep
history/Keep trends* fields in [item
configuration](/fr/manual/config/items/item).

It is possible to override the history/trend storage period even if
internal housekeeping is disabled. Thus, when using an external
housekeeper, the history storage period could be set using the history
*Data storage period* field.

[Time suffixes](/manual/appendix/suffixes) are supported in the period
fields, e.g. 1d (one day), 1w (one week). Minimum is 1 day (1 hour for
history), maximum 25 years.

*Reset defaults* button allows to revert any changes made.

##### - Images

The Images section displays all the images available in Zabbix. Images
are stored in the database.

![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_images.png){width="600"}

The *Type* dropdown allows you to switch between icon and background
images:

-   Icons are used to display [network
    map](/fr/manual/config/visualisation/maps/map) elements
-   Backgrounds are used as background images of network maps

**Adding image**

You can add your own image by clicking on the *Create icon* or *Create
background* button in the top right corner.

![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_img_upload.png)

Image attributes:

|Parameter|Description|
|---------|-----------|
|*Name*|Unique name of an image.|
|*Upload*|Select the file (PNG, JPEG) from a local system to be uploaded to Zabbix.|

::: noteclassic
Maximum size of the upload file is limited by value of
ZBX\_MAX\_IMAGE\_SIZE that is 1024x1024 bytes or 1 MB.\
\
The upload of an image may fail if the image size is close to 1 MB and
the `max_allowed_packet` MySQL configuration parameter is at a default
of 1MB. In this case, increase the
[max\_allowed\_packet](http://dev.mysql.com/doc/refman/5.5/en/server-system-variables.html#sysvar_max_allowed_packet)
parameter.
:::

##### - Icon mapping

This section allows to create the mapping of certain hosts with certain
icons. Host inventory field information is used to create the mapping.

The mappings can then be used in [network map
configuration](/fr/manual/config/visualisation/maps/map) to assign
appropriate icons to matching hosts automatically.

To create a new icon map, click on *Create icon map* in the top right
corner.

![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_iconmap.png){width="600"}

Configuration parameters:

|Parameter|Description|
|---------|-----------|
|*Name*|Unique name of icon map.|
|*Mappings*|A list of mappings. The order of mappings determines which one will have priority. You can move mappings up and down the list with drag-and-drop.|
|*Inventory field*|Host inventory field that will be looked into to seek a match.|
|*Expression*|Regular expression describing the match.|
|*Icon*|Icon to use if a match for the expression is found.|
|*Default*|Default icon to use.|

##### - Regular expressions

This section allows to create custom regular expressions that can be
used in several places in the frontend. See [Regular
expressions](/fr/manual/regular_expressions) section for details.

##### - Macros

This section allows to define system-wide macros.

![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_macros.png)

See [User macros](/fr/manual/config/macros/usermacros) section for more
details.

##### - Value mapping

This section allows to manage value maps that are useful for
human-readable representation of incoming data in Zabbix frontend.

![](../../../../../assets/en/manual/web_interface/value_maps.png){width="600"}

See [Value mapping](/fr/manual/config/items/mapping) section for more
details.

##### - Working time

Working time is system-wide parameter, which defines working time.
Working time is displayed as a white background in graphs, while
non-working time is displayed in grey.

![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_worktime.png)

See [Time period specification](/fr/manual/appendix/time_period) page
for description of the time format. [User
macros](/manual/config/macros/usermacros) are supported (since Zabbix
3.4.0).

##### - Trigger severities

This section allows to customize [trigger
severity](/fr/manual/config/triggers/severity) names and colors.

![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_severities.png){width="600"}

You can enter new names and color codes or click on the color to select
another from the provided palette.

See [Customising trigger
severities](/fr/manual/config/triggers/customseverities) page for more
information.

##### - Trigger displaying options

This section allows to customize how trigger status is displayed in the
frontend.

![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_trigger_display.png)

Checking "*Use custom event status colors*" checkbox enables
customization of the colors for acknowledged/unacknowledged events.
Unchecking this checkbox disables this customization, respectively.
Blinking isn't affected by this checkbox.

Also the time period for displaying OK triggers and for blinking upon
trigger status change can be customized. The maximum value is 86400
seconds (24 hours). [Time suffixes](/manual/appendix/suffixes) are
supported in the period fields, e.g. 5m, 2h, 1d.

##### - Other parameters

This section allows to configure several other frontend parameters.

![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_other.png)

|Parameter|Description|<|
|---------|-----------|-|
|*Refresh unsupported items*|Some items may become unsupported due to errors in user parameters or because of an item not being supported by agent. Zabbix can be configured to periodically make unsupported items active.<br>Zabbix server will activate unsupported item every N period set here (1 day maximum). If set to 0, the automatic activation will be disabled.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 60s, 5m, 2h, 1d.<br>The configured value also applies to how often Zabbix proxies reactivate unsupported items.|<|
|*Group for discovered hosts*|Hosts discovered by [network discovery](/fr/manual/discovery/network_discovery) and [agent auto-registration](/manual/discovery/auto_registration) will be automatically placed in the host group, selected here.|<|
|*Default host inventory mode*|Default [mode](/manual/config/hosts/inventory) for host inventory. It will be followed whenever a new host or host prototype is created by server or frontend, unless overriden during host discovery/auto registration by the //Set host inventory mode *operation. \| \|*User group for database down message//|User group for sending alarm message or 'None'.<br>Zabbix server depends on the availability of backend database. It cannot work without a database. If the database is down, selected users can be notified by Zabbix. Notifications will be sent to the user group set here using all configured user media entries. Zabbix server will not stop; it will wait until the database is back again to continue processing.<br>Notification consists of the following content:<br>`[MySQL\|PostgreSQL\|Oracle\|IBM DB2] database <DB Name> [on <DB Host>:<DB Port>] is not available: <error message depending on the type of DBMS (database)>`<br><DB Host> is not added to the message if it is defined as an empty value and <DB Port> is not added if it is the default value ("0"). The alert manager (a special Zabbix server process) tries to establish a new connection to the database every 10 seconds. If the database is still down the alert manager repeats sending alerts, but not more often than every 15 minutes.|
|*Log unmatched SNMP traps*|Log [SNMP trap](/fr/manual/config/items/itemtypes/snmptrap) if no corresponding SNMP interfaces have been found.|<|
