5 Upgrade notes for Zabbix 8.0

These notes are for upgrading from Zabbix 7.4.x to Zabbix 8.0.0.

All notes are grouped into:

• Breaking changes - changes that may break existing installations and other critical information related to the upgrade process
• Other - all remaining information describing the changes in Zabbix functionality

See also:

• Upgrade procedure for all relevant information about upgrading from versions before Zabbix 8.0.0;
• Upgrading HA cluster for instructions on upgrading servers in a high-availability (HA) cluster.

Breaking changes

Database versions

The minimum required database versions have been raised:

• MySQL/Percona: 8.0.30 → 8.4.0
• MariaDB: 10.5.00 → 10.11.00
• PostgreSQL: 13.0 → 15.0
• TimescaleDB: 2.13.0 → 2.20.0

Plugins

The Ceph plugin for Zabbix agent 2 is now a loadable plugin and requires additional installation steps. See the Ceph plugin readme for details.

The tcp:// scheme is deprecated in the MongoDB plugin but is kept for backward compatibility with existing configurations.

Minimum required PHP version

The minimum required PHP version has been raised from 8.0.0 to 8.2.0.

Extended UnsafeUserParameters list

The % character has been added to the UnsafeUserParameters list for Zabbix agent and Zabbix agent 2.

Other

Deprecated macros dropped

The support for the following built-in macros has now been dropped:

• {ACK.DATE}
• {ACK.MESSAGE}
• {ACK.TIME}
• {EVENT.ACK.HISTORY}
• {HOSTNAME<1-9>}
• {IPADDRESS<1-9>}
• {PROFILE.*}
• {TRIGGER.COMMENT}
• {TRIGGER.KEY}
• {STATUS}
• {USER.ALIAS}

Removed JSON and XML validation from HTTP agent items

JSON and XML validation has been removed from the Request body field in HTTP agent items. The field no longer checks whether the value is valid XML or JSON, and selecting XML data as the Request body type no longer requires the libxml2 library.

Disabled links hidden in monitored hosts

Disabled Graphs, Dashboards, and Web links are no longer displayed in the list of monitored hosts.

JSON data type

Zabbix now supports JSON as a data type for item values. If you are using TimescaleDB, the new history_json hypertable (used to store JSON values) must be configured manually. If you are using Elasticsearch, the default value of the HistoryStorageTypes Zabbix server configuration parameter now includes json.