11 Hinweise zum Upgrade auf 7.4.0

Diese Hinweise gelten für das Upgrade von Zabbix 7.2.x auf Zabbix 7.4.0.

Alle Hinweise sind gruppiert in:

  • Breaking Changes – Änderungen, die bestehende Installationen beeinträchtigen können, sowie andere wichtige Informationen zum Upgradeprozess
  • Sonstiges – alle übrigen Informationen zu den Änderungen der Zabbix-Funktionalität

Siehe auch:

  • Upgradeverfahren für alle relevanten Informationen zum Upgrade von Versionen vor Zabbix 7.4.0;
  • Upgrade eines HA-Clusters für Anweisungen zum Upgrade von Servern in einem Hochverfügbarkeitscluster (HA).

Upgrade-Prozess

Um ein erfolgreiches Upgrade des Zabbix Servers unter MySQL/MariaDB abzuschließen, müssen Sie möglicherweise GLOBAL log_bin_trust_function_creators = 1 in MySQL festlegen, wenn die binäre Protokollierung aktiviert ist, keine Superuser-Berechtigungen vorhanden sind und log_bin_trust_function_creators = 1 nicht in der MySQL-Konfigurationsdatei festgelegt ist.

Um die Variable über die MySQL-Konsole festzulegen, führen Sie Folgendes aus:

mysql> SET GLOBAL log_bin_trust_function_creators = 1;

Nachdem das Upgrade erfolgreich abgeschlossen wurde, kann diese Option deaktiviert werden:

mysql> SET GLOBAL log_bin_trust_function_creators = 0;

Inkompatible Änderungen

PCRE-Bibliothek entfernt

Die PCRE-Bibliothek (oder PCRE1) wurde entfernt.
Zabbix wird jetzt mit PCRE2 kompiliert.

Verwalten eigener Benutzermedien

Alle Benutzer dürfen ihre eigenen Medien jetzt standardmäßig verwalten.

Benutzerberechtigungen zum Ändern von Mediendetails für sich selbst können basierend auf ihrer Benutzerrolle gewährt oder entzogen werden (siehe die Option Eigene Medien erstellen und bearbeiten).

Zusätzlich können Super-Admin-Benutzerberechtigungen zum Ändern von Mediendetails für andere Benutzer ebenfalls basierend auf ihrer Benutzerrolle gewährt oder entzogen werden (siehe die Option Benutzermedien erstellen und bearbeiten).

Bei einem Upgrade von älteren Versionen werden beide Optionen für alle Rollen aktiviert, bei denen Standardzugriff auf neue Aktionen aktiviert ist. Beachten Sie, dass Administratoren und Super-Administratoren möglicherweise die Möglichkeit verlieren, Medien nach dem Upgrade zu bearbeiten, wenn Standardzugriff auf neue Aktionen nicht aktiviert ist.

Maskierung von Backslashes in Parametern von Verlaufsfunktionen

Seit Zabbix 7.0.0 werden Backslashes in Zeichenfolgenparametern von Verlaufsfunktionen ordnungsgemäß maskiert.

Da beim Upgrade von Zabbix-Versionen vor 7.0 zusätzliche Backslashes hinzugefügt werden, führt dies zu längeren Parametern. Wenn die Parameterlänge die maximale Datengröße von 255 Zeichen überschreitet, kann dies zu fehlerhaften Auslöserfunktionen führen.

Um dieses Problem zu vermeiden, wird empfohlen, lange Parameter vor dem Upgrade manuell in Benutzermakros zu verschieben.

Für Upgrades von Zabbix-Versionen vor 7.0 wurden zusätzliche Prüfungen der resultierenden Parameterlänge hinzugefügt. Wenn die resultierende Länge die maximale Größe überschreitet, werden solche Parameter nicht aktualisiert. Gleichzeitig wird eine Warnung in die Logs geschrieben, in der Benutzer aufgefordert werden, die aufgeführten Parameter manuell zu korrigieren.

Siehe auch Upgrade-Probleme im Zusammenhang mit der Maskierung.

Aktualisierung des MSSQL-Plugins für den Zabbix Agent 2

Die Vorlage MSSQL by Zabbix agent 2 wurde um Filter erweitert, mit denen erkannte Quorummitglieder nach Namen ein- oder ausgeschlossen werden können. Außerdem wurde ein Servicefilter hinzugefügt, der das Filtern nach Clusternamen ermöglicht, um leere Cluster auszuschließen.

Damit die Vorlage fehlerfrei funktioniert, muss das MSSQL Zabbix agent 2 plugin auf eine Version gleich oder höher als 7.4.0 aktualisiert werden.

Mindest erforderliche libssh2-Version

Die mindestens erforderliche libssh2-Version wurde von 1.0.0 auf 1.8.0 angehoben.

Host-Prototypen auf entdeckten Hosts

Wenn Ihre aktuelle Konfiguration Host-Prototypen enthält, die Vorlagen mit anderen Host-Prototypen verwenden, führt ein Upgrade auf Zabbix 7.4 dazu, dass alle entdeckten Hosts die in diesen Vorlagen definierten Host-Prototypen erhalten. Wenn dieses Verhalten nicht beabsichtigt ist, löschen Sie bitte vor dem Upgrade die Host-Prototypen manuell aus den betreffenden Vorlagen.

Um entdeckte Hosts zu identifizieren, die während des Upgrades Host-Prototypen erhalten, können Sie die folgende SQL-Abfrage in Ihrer Zabbix-Datenbank ausführen:

SELECT h.hostid,ht.templateid
FROM hosts_templates ht
JOIN hosts h ON ht.hostid=h.hostid
WHERE h.flags=4
  AND EXISTS (
    SELECT NULL
    FROM items i,host_discovery hd
    WHERE i.hostid=ht.templateid
    AND hd.parent_itemid=i.itemid
    )
ORDER BY hostid;

Datenbankverbindungsparameter

DBPort und DBSocket schließen sich jetzt gegenseitig aus. Bei der Angabe von Datenbankverbindungsparametern können Sie entweder DBPort oder DBSocket definieren oder beide undefiniert lassen, um die Standardwerte zu verwenden.

Sonstiges

Nicht unterstützte SNMP-Walk-/Discovery-Datenpunkte ohne gültige OIDs

SNMP-Walk-Datenpunkte geben jetzt einen Fehler zurück und werden nicht unterstützt, wenn keine der OIDs oder OID-Instanzen vorhanden ist. Die Details zu den nicht vorhandenen OIDs/Instanzen werden mit DebugLevel=5 protokolliert. Bisher gaben sie in solchen Fällen eine leere Zeichenfolge zurück.

Ebenso geben SNMP-Discovery-Datenpunkte jetzt einen Fehler zurück und werden nicht unterstützt, wenn keine der OIDs oder OID-Instanzen vorhanden ist. Bisher gaben sie in solchen Fällen ein leeres Array zurück.

Beachten Sie, dass eine leere Zeichenfolge bzw. ein leeres Array jetzt nur zurückgegeben wird, wenn die OID/Instanz vorhanden ist, aber keine Daten dafür vorliegen.

Verwalten des Verlaufscaches

In einigen Szenarien der Datensammlung können bestimmte Datenpunkte den Verlaufscache des Servers/Proxys vorübergehend blockieren. Dies kann das Schreiben von Verlaufsdaten in die Datenbank verzögern und das System verlangsamen. Zur besseren Verwaltung des Verlaufscaches wurden folgende Verbesserungen eingeführt:

  • Manuelles Leeren des Caches: Der neue Laufzeitbefehl history_cache_clear=target für den Zabbix-Server/Proxy ermöglicht es, den Verlaufscache für einen bestimmten Datenpunkt anhand seiner ID manuell zu leeren.
  • Automatisches Leeren des Caches: Wenn Sie einen Datenpunkt deaktivieren, wird er sofort aus dem Verlaufscache entfernt (mit Ausnahme seines letzten Werts, der für Protokolle beibehalten wird). Ebenso werden beim Deaktivieren eines Hosts alle zugehörigen Datenpunkte aus dem Verlaufscache entfernt (mit Ausnahme ihrer letzten Werte).
  • Protokollierung von Cache-Diagnoseinformationen: Wenn der Verlaufscache voll ist, protokolliert der Zabbix-Server/Proxy jetzt Diagnoseinformationen zum Verlaufscache ab DebugLevel=3 (zuvor DebugLevel=4). Das Protokoll enthält die Datenpunkte mit den meisten Werten im Verlaufscache.

Stellen Sie für eine langfristige Systemstabilität sicher, dass die Datensammlung auf die verfügbaren Ressourcen abgestimmt ist (Datenbankleistung, Cachegröße, Sammelintervalle, Parameter von Protokoll-Datenpunkten usw.). Sie können den Zabbix-Verlaufscache mithilfe des internen Datenpunkts zabbix[wcache] überwachen. Sie können auch in Betracht ziehen, die Größe des Verlaufscaches für den Zabbix-Server/Proxy zu erhöhen.

Separate Menüabschnitt für Benutzerbenachrichtigungen

Für eine bessere Sichtbarkeit der Benutzermedien haben Benutzerbenachrichtigungen jetzt einen eigenen Menüabschnitt unter Benutzereinstellungen.

Der neue Abschnitt Benachrichtigungen enthält zwei Registerkarten - Medien und Frontend-Benachrichtigungen, die zuvor Teil des Benutzerprofilabschnitts waren.

Korrekte Informationen aus verschachtelten Hostgruppen in Karten

Informationen aus verschachtelten Hostgruppen werden jetzt in Karten korrekt angezeigt, zum Beispiel:

  • Die Bezeichnung der Hostgruppe zeigt jetzt die Problemübersicht aller Hosts in verschachtelten Hostgruppen an;
  • Die Ansicht „Hostgruppenelemente“ zeigt jetzt für jeden Host in den verschachtelten Hostgruppen ein separates Kartenelement an;
  • Die Kartenbezeichnung zeigt jetzt eine Übersicht aller Probleme in verschachtelten Hostgruppen an.

Datenbanktabelle für konvertierte Einstellungen

Die Tabelle settings ersetzt nun die Tabelle config zum Speichern von Parametern der globalen Konfiguration. Die neue Tabelle verwendet ein Schlüssel-Wert-Format, anstatt Parameter in einer einzelnen Zeile mit einer Spalte pro Parameter zu speichern. Ein Beispiel dafür, wie sich dies auf den Datenaustausch auswirkt, finden Sie unter Server-Proxy-Datenaustauschprotokoll ("settings"-Objekt).

Erhöhte maximale Cache-Größen für Server und Proxy

Die maximalen Cache-Größen wurden von 2 GB auf 16 GB erhöht, um eine Erschöpfung des Caches zu verzögern und den Betrieb bei vorübergehenden Problemen aufrechtzuerhalten (z. B. Konfigurations-, Datenbank- oder Netzwerkprobleme):

Verkürzte standardmäßige Speicherdauer für Benutzersitzungen

Die standardmäßige Speicherdauer für Benutzersitzungsdaten wurde von 365 Tagen auf 31 Tage verkürzt. Diese Änderung betrifft den Parameter hk_sessions, der jetzt standardmäßig auf 31d statt auf 365d gesetzt ist.

Mindestunterstützte Go-Version

Die mindestens unterstützte Go-Version wurde von 1.21 auf 1.23 angehoben.

Wenn Sie zuvor Zabbix Agent 2, die ladbaren Plugins von Agent 2 loadable plugins oder den Webdienst aus dem Quellcode mit einer Go-Version älter als 1.23 erstellt haben, wird empfohlen, diese Komponenten mit einer unterstützten Go-Version neu zu erstellen, um die neuesten Sicherheitsupdates und Fehlerbehebungen zu erhalten. Mit einer älteren Go-Version erstellte Komponenten funktionieren weiterhin, aber für ein Upgrade ist eine neuere Go-Umgebung erforderlich.

Vorlagen-Upgrade für den Host Wizard

Der neue Host Wizard bietet eine geführte, schrittweise Oberfläche zum Einrichten Ihres Überwachungsziels (Gerät, Anwendung, Dienst usw.) in Zabbix. Er vereinfacht die Konfiguration neuer oder vorhandener Hosts, indem Benutzer durch wichtige Schritte wie die Auswahl einer Vorlage, die Installation des Zabbix Agent, das Hinzufügen von Host-Schnittstellen und mehr geführt werden.

Nach einem Upgrade von einer früheren Zabbix-Version müssen Vorlagen aktualisiert werden, damit sie mit dem Host Wizard funktionieren. Anweisungen finden Sie unter Vorlagen-Upgrade.

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.