10 Upgrade-Hinweise für 7.4.0

Diese Hinweise gelten für das Upgrade von Zabbix 7.2.x auf Zabbix 7.4.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 7.4.0;
  • Upgrading HA cluster für Anweisungen zum Upgrade von Servern in einem High Availability-(HA-)Cluster.

Upgrade-Prozess

Um ein erfolgreiches Upgrade des Zabbix-Servers auf MySQL/MariaDB abzuschließen, müssen Sie möglicherweise GLOBAL log_bin_trust_function_creators = 1 in MySQL setzen, wenn das binäre Logging aktiviert ist, keine Superuser-Rechte vorhanden sind und log_bin_trust_function_creators = 1 nicht in der MySQL-Konfigurationsdatei gesetzt ist.

Um die Variable über die MySQL-Konsole zu setzen, 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

Standardmäßig dürfen nun alle Benutzer ihre eigenen Medien verwalten.

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

Zusätzlich können die Berechtigungen von Superadmin-Benutzern zum Ändern von Mediendetails für andere ebenfalls basierend auf ihrer Benutzerrolle gewährt/entzogen werden (siehe Option Benutzermedien erstellen und bearbeiten).

Beim 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 Superadministratoren nach dem Upgrade möglicherweise die Möglichkeit verlieren, Medien zu bearbeiten, wenn Standardzugriff auf neue Aktionen nicht aktiviert ist.

Escaping von Backslashes in Parametern von History-Funktionen

Seit Zabbix 7.0.0 wird in String-Parametern von History-Funktionen eine korrekte Escaping-Behandlung von Backslashes vorgenommen.

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

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

Für Upgrades von Zabbix-Versionen vor 7.0 wurden zusätzliche Prüfungen für die resultierende Parameterlänge hinzugefügt. Wenn die resultierende Länge die maximale Größe überschreitet, werden solche Parameter nicht aktualisiert; gleichzeitig wird eine Warnung in den Protokollen ausgegeben, die Benutzer auffordert, die aufgeführten Parameter manuell zu korrigieren.

Siehe auch escaping-bezogene Upgrade-Probleme.

MSSQL Zabbix Agent 2-Plugin-Update

Die Vorlage MSSQL by Zabbix agent 2 wurde um Filter erweitert, mit denen erkannte Quorum-Mitglieder nach Namen ein- oder ausgeschlossen werden können. Außerdem wurde ein Service-Filter hinzugefügt, der das Filtern nach Clustername ermöglicht, um leere Cluster auszuschließen. Damit die Vorlage ohne Fehler 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;

Parameter für die Datenbankverbindung

DBPort und DBSocket schließen sich jetzt gegenseitig aus. Beim Angeben der Parameter für die Datenbankverbindung können Sie entweder DBPort oder DBSocket festlegen 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 der Datenpunkt wird nicht mehr unterstützt, wenn keine der OIDs oder OID-Instanzen vorhanden ist. Details zu nicht vorhandenen OIDs/Instanzen werden mit DebugLevel=5 protokolliert. Zuvor wurde in solchen Fällen ein leerer String zurückgegeben.

Entsprechend geben SNMP-discovery-Datenpunkte jetzt einen Fehler zurück und der Datenpunkt wird nicht mehr unterstützt, wenn keine der OIDs oder OID-Instanzen vorhanden ist. Zuvor wurde in solchen Fällen ein leeres Array zurückgegeben.

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

Verwaltung des History-Cache

In einigen Datenerfassungsszenarien können bestimmte Datenpunkte den History-Cache von Server/Proxy vorübergehend blockieren. Dadurch kann sich das Schreiben von Verlaufsdaten in die Datenbank verzögern und das System verlangsamen. Zur besseren Verwaltung des History-Cache wurden die folgenden Verbesserungen eingeführt:

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

Für eine langfristige Systemstabilität stellen Sie sicher, dass die Datenerfassung mit den verfügbaren Ressourcen im Einklang steht (Datenbankleistung, Cache-Größe, Erfassungsintervalle, Parameter für Protokolldatenpunkte usw.). Sie können den Zabbix History-Cache mit dem internen Datenpunkt zabbix[wcache] überwachen. Sie können außerdem die Größe des History-Cache für Zabbix Server/Proxy 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 Host-Gruppen in Karten

Informationen aus verschachtelten Host-Gruppen werden jetzt in Karten korrekt angezeigt, zum Beispiel:

  • Die Beschriftung der Host-Gruppe zeigt jetzt die Problemzusammenfassung aller Hosts in verschachtelten Host-Gruppen an;
  • Die Ansicht "Host group elements" zeigt jetzt für jede Host in den verschachtelten Host-Gruppen ein separates Kartenelement an;
  • Die Kartenbeschriftung zeigt jetzt die Zusammenfassung aller in verschachtelten Host-Gruppen enthaltenen Probleme 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):

Reduzierte Standardaufbewahrungsdauer für Benutzersitzungen

Die standardmäßige Aufbewahrungsdauer für Benutzersitzungsdaten wurde von 365 Tagen auf 31 Tage reduziert. Diese Änderung betrifft den Parameter hk_sessions, dessen Standardwert nun 31d statt 365d 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.