Upgrade-Hinweise für Zabbix 8.0

Diese Hinweise gelten für das Upgrade von Zabbix 7.4.x auf Zabbix 8.0.0.

Alle Hinweise sind in folgende Kategorien unterteilt:

  • Breaking changes - Änderungen, die bestehende Installationen beeinträchtigen können, sowie andere wichtige Informationen zum Upgrade-Prozess
  • Other - alle übrigen Informationen, die die Änderungen an der Zabbix-Funktionalität beschreiben

Siehe auch:

  • Upgrade procedure für alle relevanten Informationen zum Upgrade von Versionen vor Zabbix 8.0.0;
  • Upgrading HA cluster für Anweisungen zum Upgrade von Servern in einem hochverfügbaren (HA) Cluster.

Inkompatible Änderungen

Datenbankversionen

Die mindestens erforderlichen Datenbankversionen wurden angehoben:

  • 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

Das Ceph-Plugin für Zabbix Agent 2 ist jetzt ein ladbares Plugin und erfordert zusätzliche Installationsschritte. Weitere Details finden Sie in der README des Ceph-Plugins.

Das tcp://-Schema ist im MongoDB-Plugin veraltet, wird jedoch aus Gründen der Abwärtskompatibilität mit vorhandenen Konfigurationen beibehalten.

Der Parameter Plugins.Oracle.CallTimeout in der Konfigurationsdatei des Oracle-Plugins hat keine Wirkung mehr. Die maximale Wartezeit wird jetzt durch den Datenpunkt-Timeout bestimmt.

Erforderliche Mindestversion von PHP

Die erforderliche Mindestversion von PHP wurde von 8.0.0 auf 8.2.0 angehoben.

Erweiterte UnsafeUserParameters-Liste

Das Zeichen % wurde zur Liste UnsafeUserParameters für Zabbix Agent und Zabbix Agent 2 hinzugefügt.

Verschobene Filterparameter

Im Rahmen der Funktion anpassbare Tabellen wurden einige Filterparameter vom Filter-Tab in die Spaltenoptionen verschoben. Wenn Sie Tabs für Favoritenfilter gespeichert haben, die einen der folgenden Filterparameter verwenden, werden diese zurückgesetzt und müssen nach dem Upgrade manuell neu konfiguriert werden:

  • Monitoring > Hosts: Unterdrückte Probleme anzeigen
  • Monitoring > Neueste Daten: Tags anzeigen, Tagname, Tag-Anzeigepriorität, Details anzeigen
  • Monitoring > Probleme: Tags anzeigen, Tagname, Tag-Anzeigepriorität, Betriebsdaten anzeigen, Kompakte Ansicht, Details anzeigen, Zeitachse anzeigen, Ganze Zeile hervorheben

JavaScript-Vorverarbeitung: integrierte Objektmethoden sind jetzt schreibgeschützt

In Vorverarbeitung-Skripten sind integrierte JavaScript-Objektmethoden jetzt schreibgeschützt. Wenn Sie bereits integrierte Methoden auf JavaScript-Prototypen in Skripten zur Datenpunkt-Vorverarbeitung geändert haben, können Probleme auftreten, da das Ändern integrierter Prototyp-Methoden nicht mehr zulässig ist.

MySQL database character set and collation

If the Zabbix MySQL database was created with the utf8mb3 character set and utf8mb3_bin collation, it is strongly recommended to convert it to utf8mb4 character set and utf8mb4_bin collation before upgrading Zabbix, as described in Repairing Zabbix database character set and collation.

Sonstiges

Veraltete Makros entfernt

Die Unterstützung für die folgenden integrierten Makros wurde nun eingestellt:

Entfernt Stattdessen verwenden
{ACK.DATE} {EVENT.UPDATE.DATE}
{ACK.MESSAGE} {EVENT.UPDATE.MESSAGE}
{ACK.TIME} {EVENT.UPDATE.TIME}
{EVENT.ACK.HISTORY} {EVENT.UPDATE.HISTORY}
{HOSTNAME<1-9>} {HOST.HOST}
{IPADDRESS<1-9>} {HOST.IP}
{PROFILE.*} {INVENTORY.*}
{TRIGGER.COMMENT} {TRIGGER.DESCRIPTION}
{TRIGGER.KEY} {ITEM.KEY}
{STATUS} {TRIGGER.STATUS}
{USER.ALIAS} {USER.USERNAME}

Veraltete Parameter für History-Speicheranbieter

Die folgenden Parameter sind jetzt veraltet:

  • Zabbix Server-Konfigurationsdatei: HistoryStorageDateIndex, HistoryStorageURL und HistoryStorageTypes. Bitte verwenden Sie stattdessen den neuen Parameter HistoryProviders.
  • Zabbix Frontend-Konfigurationsdatei: $HISTORY. Bitte verwenden Sie stattdessen den neuen Parameter $HISTORY_PROVIDERS.

Mit beiden neuen Parametern können Sie den History-Speicheranbieter auswählen: Elasticsearch, ClickHouse oder SQL (Standard). Beachten Sie, dass Sie diese neuen und veralteten Parameter nicht zusammen verwenden können.

JSON- und XML-Validierung aus HTTP-Agent-Datenpunkten entfernt

Die JSON- und XML-Validierung wurde aus dem Feld Request body in HTTP agent-Datenpunkten entfernt. Das Feld prüft nicht mehr, ob der Wert gültiges XML oder JSON ist, und die Auswahl von XML data als Request body type erfordert nicht länger die Bibliothek libxml2.

Deaktivierte Links Graphs, Dashboards und Web werden in der Liste der überwachten Hosts nicht mehr angezeigt.

JSON-Datentyp

Zabbix unterstützt jetzt JSON als Datentyp für Datenpunktwerte. Wenn Sie TimescaleDB verwenden, muss die neue history_json-Hypertabelle (zum Speichern von JSON-Werten verwendet) manuell konfiguriert werden. Wenn Sie Elasticsearch verwenden, enthält der Standardwert des Zabbix-Server-Konfigurationsparameters HistoryStorageTypes jetzt json.

Optionsfeld im Formular „Neuer Tag-Filter“ entfernt

Das Optionsfeld, bei dem beim Erstellen eines neuen Tag-Filters zwischen Alle Tags und Tag-Liste gewählt werden musste, wurde entfernt.

Datenpunkt-Werte als HTML mit iframes angezeigt

Datenpunkt-Daten im Widget Datenpunkt-Verlauf werden jetzt, wenn sie als HTML-formatierter Text angezeigt werden, in iframes isoliert.

Vorlagenkompatibilität mit dem Host-Assistenten

Alle sofort einsatzbereiten Vorlagen sind jetzt mit dem Host-Assistenten kompatibel. Informationen zum Upgrade finden Sie unter Upgrade von Vorlagen.

Automatische Größenanpassung für Konfigurationsfelder

Die meisten Konfigurationsfelder in der UI passen ihre Größe jetzt automatisch an ihren Inhalt an.

Ersetzte Frontend-Konfigurationsvariable

Die Variable $ALLOW_HTTP_AUTH wurde durch das Feature-Flag $ZBX_FEATURE_FLAGS['http_auth_enabled'] in der Frontend-Konfigurationsdatei (zabbix.conf.php) ersetzt.

Gleichzeitige Verarbeitung von SNMPv1- und SNMPv2-Prüfungen

Asynchrone Dienstprüfungen für SNMPv1 und SNMPv2 werden jetzt von den verfügbaren Discovery-Workern gleichzeitig verarbeitet.

Änderungen am Zabbix SELinux-Policy-Paket

Für Version 10 von AlmaLinux, CentOS Stream, RHEL, Rocky Linux und Oracle Linux hat das vorhandene Paket zabbix-selinux-policy nun eine Abhängigkeit entweder von zabbix-selinux-policy-main oder von selinux-policy-targeted-extra.
Wenn Sie bereits eine Installation von zabbix-selinux-policy haben, sind keine manuellen Änderungen erforderlich. Während des Paket-Upgrades wird zabbix-selinux-policy-main automatisch installiert. Wenn selinux-policy-targeted-extra bereits installiert ist, wird kein zusätzliches Paket installiert.

Umbenannter Status des Wartungszeitraums

Der Status des Wartungszeitraums wurde von Approaching in Upcoming umbenannt.

Veralteter Dashboard-Diashow-Parameter

Die Unterstützung für den Parameter slideshow=1 wird entfernt. Für den Parameter slideshow wurden neue Werte eingeführt, um die Diashow zu starten und zu stoppen:

  • slideshow=on - die Diashow starten
  • slideshow=off - die Diashow stoppen