11 Note sull'aggiornamento alla versione 7.4.0

Queste note sono destinate all'aggiornamento da Zabbix 7.2.x a Zabbix 7.4.0.

Tutte le note sono raggruppate in:

  • Modifiche incompatibili - modifiche che potrebbero compromettere le installazioni esistenti e altre informazioni critiche relative al processo di aggiornamento
  • Altro - tutte le informazioni rimanenti che descrivono le modifiche alle funzionalità di Zabbix

Vedere anche:

Processo di aggiornamento

Per completare correttamente l'aggiornamento del server Zabbix su MySQL/MariaDB, potrebbe essere necessario impostare GLOBAL log_bin_trust_function_creators = 1 in MySQL se la registrazione binaria è abilitata, non si dispone dei privilegi di superutente e log_bin_trust_function_creators = 1 non è impostato nel file di configurazione di MySQL.

Per impostare la variabile utilizzando la console MySQL, eseguire:

mysql> SET GLOBAL log_bin_trust_function_creators = 1;

Una volta completato correttamente l'aggiornamento, questa opzione può essere disabilitata:

mysql> SET GLOBAL log_bin_trust_function_creators = 0;

Modifiche incompatibili

Libreria PCRE rimossa

La libreria PCRE (o PCRE1) è stata rimossa.
Zabbix viene ora compilato con PCRE2.

Gestione dei propri media

Per impostazione predefinita, ora tutti gli utenti possono gestire i propri media.

Le autorizzazioni degli utenti per modificare i dettagli dei propri media possono essere concesse o revocate in base al loro ruolo utente (vedere l'opzione Crea e modifica i propri media).

Inoltre, le autorizzazioni degli utenti Super admin per modificare i dettagli dei media di altri utenti possono essere concesse o revocate in base al loro ruolo utente (vedere l'opzione Crea e modifica i media degli utenti).

Se si esegue l'upgrade da versioni precedenti, entrambe le opzioni saranno abilitate per tutti i ruoli per i quali è abilitata l'opzione Accesso predefinito alle nuove azioni. Tenere presente che, se Accesso predefinito alle nuove azioni non è abilitato, gli amministratori e i super amministratori potrebbero perdere la possibilità di modificare i media dopo l'upgrade.

Escape dei caratteri barra rovesciata nei parametri delle funzioni della cronologia

L'escape corretto delle barre rovesciate è stato aggiunto nei parametri stringa delle funzioni della cronologia a partire da Zabbix 7.0.0.

Poiché durante l'aggiornamento dalle versioni di Zabbix precedenti alla 7.0 vengono aggiunte ulteriori barre rovesciate, i parametri diventano più lunghi. Ciò può causare il malfunzionamento delle funzioni dei trigger se la lunghezza del parametro supera la dimensione massima dei dati di 255 caratteri.

Per evitare questo problema, si consiglia di spostare manualmente i parametri lunghi nelle macro utente prima dell'aggiornamento.

Per gli aggiornamenti dalle versioni di Zabbix precedenti alla 7.0 sono stati aggiunti ulteriori controlli sulla lunghezza risultante dei parametri. Se la lunghezza risultante supera la dimensione massima, tali parametri non vengono aggiornati e nei log viene visualizzato un avviso che chiede agli utenti di correggere manualmente i parametri elencati.

Vedere anche problemi di aggiornamento relativi all'escape.

Aggiornamento del plugin MSSQL Zabbix agent 2

Il template MSSQL by Zabbix agent 2 è stato aggiornato con filtri per includere o escludere i membri del quorum rilevati in base al nome, nonché con un filtro del servizio che consente di filtrare in base al nome del cluster per escludere i cluster vuoti.
Per fare in modo che il template funzioni senza errori, è necessario aggiornare il plugin MSSQL Zabbix agent 2 a una versione pari o superiore alla 7.4.0.

Versione minima richiesta di libssh2

La versione minima richiesta di libssh2 è stata aumentata da 1.0.0 a 1.8.0.

Prototipi di host sugli host scoperti

Se la configurazione corrente include prototipi di host che usano template contenenti altri prototipi di host, l'aggiornamento a Zabbix 7.4 farà sì che tutti gli host scoperti abbiano i prototipi di host definiti in quei template. Se questo comportamento non è desiderato, eliminare manualmente i prototipi di host dai template interessati prima dell'aggiornamento.

Per identificare gli host scoperti che riceveranno i prototipi di host durante l'aggiornamento, è possibile eseguire la seguente query SQL nel database Zabbix:

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;

Parametri di connessione al database

DBPort e DBSocket sono ora mutuamente esclusivi. Quando si specificano i parametri di connessione al database, è possibile definire DBPort o DBSocket, oppure lasciare entrambi non definiti per utilizzare i valori predefiniti.

Altro

item SNMP walk/discovery non supportati senza OID validi

Gli item SNMP walk, nel caso in cui nessuno degli OID o delle istanze OID esista, ora restituiscono un errore e l'item diventa non supportato.
I dettagli relativi all'OID/istanza inesistente vengono registrati con DebugLevel=5.
In precedenza, in questi casi restituivano una stringa vuota.

Analogamente, gli item SNMP di discovery, nel caso in cui nessuno degli OID o delle istanze OID esista, ora restituiscono un errore e l'item diventa non supportato.
In precedenza, in questi casi restituivano un array vuoto.

Si noti che una stringa vuota/un array vuoto viene ora restituito solo se l'OID/istanza esiste, ma non contiene dati.

Gestione della cache della cronologia

In alcuni scenari di raccolta dati, determinati item possono bloccare temporaneamente la cache della cronologia del server/proxy. Ciò può ritardare la scrittura dei dati della cronologia nel database e rallentare il sistema. Per facilitare la gestione della cache della cronologia, sono stati introdotti i seguenti miglioramenti:

  • Svuotamento manuale della cache: il nuovo comando runtime history_cache_clear=target per server/proxy Zabbix consente di svuotare manualmente la cache della cronologia per un item specifico tramite il relativo ID.
  • Svuotamento automatico della cache: quando si disabilita un item, questo viene rimosso immediatamente dalla cache della cronologia (ad eccezione del suo ultimo valore, che viene conservato per i log). Analogamente, quando si disabilita un host, tutti i suoi item vengono rimossi dalla cache della cronologia (ad eccezione dei relativi ultimi valori).
  • Registrazione diagnostica della cache: quando la cache della cronologia è piena, il server/proxy Zabbix ora registra le informazioni diagnostiche della cache della cronologia a partire da DebugLevel=3 (in precedenza DebugLevel=4). Il log contiene gli item con il maggior numero di valori nella cache della cronologia.

Per garantire la stabilità del sistema a lungo termine, assicurarsi che la raccolta dati sia bilanciata rispetto alle risorse disponibili (prestazioni del database, dimensione della cache, intervalli di raccolta, parametri degli item di tipo log e così via). È possibile monitorare la cache della cronologia di Zabbix utilizzando l'item interno zabbix[wcache]. È inoltre possibile valutare l'aumento delle dimensioni della cache della cronologia per il server/proxy Zabbix.

Sezione di menu separata per le notifiche utente

Per una migliore visibilità dei media utente, le notifiche utente hanno ora una propria sezione di menu in Impostazioni utente.

La nuova sezione Notifiche contiene due schede - Media e Notifiche frontend, che in precedenza facevano parte della sezione del profilo utente.

Informazioni corrette dai gruppi di host annidati nelle mappe

Le informazioni provenienti dai gruppi di host annidati vengono ora visualizzate correttamente nelle mappe, ad esempio:

  • L'etichetta del gruppo di host ora visualizza il riepilogo dei problemi di tutti gli host nei gruppi di host annidati;
  • La vista "Elementi del gruppo di host" ora visualizza un elemento della mappa separato per ogni host nei gruppi di host annidati;
  • L'etichetta della mappa ora visualizza il riepilogo di tutti i problemi contenuti nei gruppi di host annidati.

Tabella del database per le impostazioni convertita

La tabella settings ora sostituisce la tabella config per l'archiviazione dei parametri di configurazione globale. La nuova tabella utilizza un formato chiave-valore invece di memorizzare i parametri in una singola riga con una colonna per ciascun parametro. Per un esempio di come questo influisce sullo scambio dei dati, vedere Protocollo di scambio dati server-proxy (oggetto "settings").

Aumento delle dimensioni massime della cache per server e proxy

Le dimensioni massime della cache sono state aumentate da 2 GB a 16 GB per ritardare l'esaurimento della cache e mantenere il funzionamento durante problemi temporanei (ad esempio, problemi di configurazione, database o rete):

Periodo di archiviazione predefinito ridotto per le sessioni utente

Il periodo di archiviazione predefinito per i dati delle sessioni utente è stato ridotto da 365 giorni a 31 giorni. Questa modifica riguarda il parametro hk_sessions, che ora ha come valore predefinito 31d invece di 365d.

Versione minima supportata di Go

La versione minima supportata di Go è stata aumentata da 1.21 a 1.23.

Se in precedenza avete compilato Zabbix agent 2, i plugin caricabili di agent 2 o il servizio web dai sorgenti usando una versione di Go precedente alla 1.23, si consiglia di ricompilare questi componenti usando una versione di Go supportata per ricevere gli ultimi aggiornamenti di sicurezza e le correzioni dei bug. I componenti compilati con una versione precedente di Go continueranno a funzionare, ma per aggiornarli sarà necessario un ambiente Go più recente.

Aggiornamento del template per Host Wizard

Il nuovo Host Wizard introduce un'interfaccia guidata, passo dopo passo, per configurare il target di monitoraggio (dispositivo, applicazione, servizio, ecc.) in Zabbix. Semplifica la configurazione di host nuovi o esistenti accompagnando gli utenti attraverso passaggi chiave come la selezione di un template, l'installazione di Zabbix agent, l'aggiunta di interfacce host e altro ancora.

Dopo l'aggiornamento da una versione precedente di Zabbix, i template devono essere aggiornati per funzionare con Host Wizard. Per le istruzioni, vedere Template upgrade.

Elaborazione concorrente dei controlli SNMPv1 e SNMPv2

I controlli asincroni del servizio SNMPv1 e SNMPv2 vengono ora elaborati in parallelo dai worker di discovery disponibili.