[comment]: # ({131bd647-137ecc03}) # 10 Note di aggiornamento per 7.4.0 Queste note sono per l'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 restanti informazioni che descrivono le modifiche nelle funzionalità di Zabbix Vedi anche: - [Procedura di aggiornamento](/manual/installation/upgrade) per tutte le informazioni rilevanti sull'aggiornamento da versioni precedenti a Zabbix 7.4.0; - [Aggiornamento del cluster HA](/manual/concepts/server/ha#upgrading-ha-cluster) per le istruzioni sull'aggiornamento dei server in un cluster ad alta disponibilità (**high-availability**, HA). [comment]: # ({/131bd647-137ecc03}) [comment]: # ({5f77a7e6-6f14cd5e}) #### Processo di aggiornamento Per completare con successo l'aggiornamento di un server Zabbix su MySQL/MariaDB, potrebbe essere necessario impostare `GLOBAL log_bin_trust_function_creators = 1` in MySQL se la registrazione binaria è abilitata, non sono presenti privilegi di superutente e `log_bin_trust_function_creators = 1` non è impostato nel file di configurazione di MySQL. Per impostare la variabile usando la console MySQL, eseguire: mysql> SET GLOBAL log_bin_trust_function_creators = 1; Una volta completato con successo l'aggiornamento, questa opzione può essere disabilitata: mysql> SET GLOBAL log_bin_trust_function_creators = 0; [comment]: # ({/5f77a7e6-6f14cd5e}) [comment]: # ({b7a15027-2a68033f}) ## Modifiche incompatibili [comment]: # ({/b7a15027-2a68033f}) [comment]: # ({45607e9c-1ea0243a}) #### Libreria PCRE rimossa La libreria [PCRE](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (o PCRE1) è stata rimossa. Zabbix ora viene compilato con PCRE2. [comment]: # ({/45607e9c-1ea0243a}) [comment]: # ({8cfe7c52-96b60caa}) #### Gestione dei propri media utente Tutti gli utenti ora possono gestire i propri media per impostazione predefinita. I permessi utente per modificare i dettagli dei media per sé stessi possono essere concessi (o revocati) in base al proprio [ruolo utente](/manual/web_interface/frontend_sections/users/user_roles) (vedere l'opzione *Crea e modifica i propri media*). Inoltre, i permessi degli utenti Super admin per modificare i dettagli dei media di altri possono anche essere concessi/revocati in base al proprio [ruolo utente](/manual/web_interface/frontend_sections/users/user_roles) (vedere l'opzione *Crea e modifica i media utente*). Se si esegue l'aggiornamento da versioni precedenti, entrambe le opzioni saranno abilitate per tutti i ruoli che hanno abilitato *Accesso predefinito alle nuove azioni*. Si noti 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'aggiornamento. [comment]: # ({/8cfe7c52-96b60caa}) [comment]: # ({ba2821d9-f8845237}) #### Escape delle barre rovesciate nei parametri delle funzioni di history A partire da Zabbix 7.0.0 è stata aggiunta la corretta escape delle barre rovesciate nei parametri stringa delle funzioni di history. Poiché durante l'aggiornamento da versioni di Zabbix precedenti alla 7.0 vengono aggiunte ulteriori barre rovesciate, questo porta a parametri più lunghi che possono causare il malfunzionamento delle funzioni di 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 da versioni di Zabbix precedenti alla 7.0 sono stati aggiunti controlli supplementari sulla lunghezza del parametro risultante. Se la lunghezza risultante supera la dimensione massima, tali parametri **non vengono aggiornati** e viene registrato un avviso nei log che invita gli utenti a correggere manualmente i parametri elencati. Vedi anche [problemi di aggiornamento relativi all'escape](/manual/installation/known_issues/db_upgrade_escaping). [comment]: # ({/ba2821d9-f8845237}) [comment]: # ({dfa5ad6e-4da3169c}) #### Aggiornamento del plugin MSSQL di Zabbix agent 2 Il template [MSSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2) è stato aggiornato con filtri per includere o escludere i membri del quorum rilevati in base al nome, oltre a un filtro del servizio che consente di filtrare per nome del cluster per escludere i cluster vuoti. Per fare in modo che il template funzioni senza errori, il [plugin MSSQL di Zabbix agent 2](/manual/appendix/config/zabbix_agent2_plugins/mssql_plugin) deve essere aggiornato a una versione uguale o superiore a 7.4.0. [comment]: # ({/dfa5ad6e-4da3169c}) [comment]: # ({288ffaab-6d93d23d}) #### Versione minima richiesta di libssh2 La versione minima richiesta di libssh2 è stata aumentata da 1.0.0 a 1.8.0. [comment]: # ({/288ffaab-6d93d23d}) [comment]: # ({4feee55e-39aedc0b}) #### Prototipi di host sugli host scoperti Se la configurazione corrente include [prototipi di host](/manual/discovery/low_level_discovery/host_prototypes) 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: ```sql 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; ``` [comment]: # ({/4feee55e-39aedc0b}) [comment]: # ({3d7f2be9-fdf1e4ea}) #### Parametri di connessione al database [DBPort](/manual/appendix/config/zabbix_server#dbport) e [DBSocket](/manual/appendix/config/zabbix_server#dbsocket) sono ora mutuamente esclusivi. Quando si specificano i parametri di connessione al database, è possibile definire DBPort oppure DBSocket, oppure lasciare entrambi non definiti per usare i valori predefiniti. [comment]: # ({/3d7f2be9-fdf1e4ea}) [comment]: # ({d336b73c-57e1557d}) ## Altro [comment]: # ({/d336b73c-57e1557d}) [comment]: # ({c4d5276b-8f6c5f75}) #### Item SNMP walk/discovery non supportati senza OID validi Gli item SNMP [walk](/manual/config/items/itemtypes/snmp#step-3), nel caso in cui nessuno degli OID o delle istanze OID esista, ora restituiscono un errore e l'item diventa non supportato. I dettagli dell'OID/istanza inesistente vengono registrati con DebugLevel=5. In precedenza, in questi casi veniva restituita una stringa vuota. Allo stesso modo, gli item SNMP [discovery](/manual/discovery/low_level_discovery/examples/snmp_oids), 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 veniva restituito un array vuoto. Si noti che la stringa/array vuoto viene ora restituito solo se l'OID/istanza esiste, ma non sono disponibili dati per esso. [comment]: # ({/c4d5276b-8f6c5f75}) [comment]: # ({a484cf2f-b7bd639f}) #### Gestione della cache della history In alcuni scenari di raccolta dati, specifici item possono bloccare temporaneamente la cache della history del server/proxy. Questo può ritardare la scrittura dei dati di history nel database e rallentare il sistema. Per aiutare a gestire la cache della history, sono stati introdotti i seguenti miglioramenti: - **Pulizia manuale della cache:** il nuovo comando runtime history\_cache\_clear=target per Zabbix [server](/manual/concepts/server#runtime-control)/[proxy](/manual/concepts/proxy#runtime-control) consente di svuotare manualmente la cache della history per un item specifico tramite il suo ID. - **Pulizia automatica della cache:** quando disabiliti un item, questo viene rimosso immediatamente dalla cache della history (tranne il suo ultimo valore, che viene mantenuto per i log). Allo stesso modo, quando disabiliti un host, tutti i suoi item vengono rimossi dalla cache della history (tranne i loro ultimi valori). - **Logging diagnostico della cache:** quando la cache della history è piena, Zabbix server/proxy ora registra le informazioni diagnostiche della cache della history a partire da [DebugLevel=3](/manual/appendix/config/zabbix_server#debuglevel) (in precedenza DebugLevel=4). Il log contiene gli item con il maggior numero di valori nella cache della history. Per la stabilità del sistema a lungo termine, assicurati che la raccolta dati sia bilanciata con le risorse disponibili (prestazioni del database, dimensione della cache, intervalli di raccolta, parametri degli item di log, ecc.). Puoi monitorare la cache della history di Zabbix usando l'item interno [zabbix[wcache]](/manual/config/items/itemtypes/internal#wcache). Puoi anche considerare di aumentare la dimensione della cache della history per Zabbix [server](/manual/appendix/config/zabbix_server#historycachesize)/[proxy](/manual/appendix/config/zabbix_proxy#historycachesize). [comment]: # ({/a484cf2f-b7bd639f}) [comment]: # ({ef1d6149-1059e5ec}) #### 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](/manual/web_interface/user_profile) in *Impostazioni utente*. La nuova sezione Notifiche contiene due schede - *Media* e *Notifiche frontend*, che in precedenza facevano parte della sezione del profilo utente. [comment]: # ({/ef1d6149-1059e5ec}) [comment]: # ({35d6cac2-cd6bf45f}) #### Informazioni corrette dai gruppi host nidificati nelle mappe Le informazioni provenienti dai gruppi host nidificati ora vengono visualizzate correttamente nelle mappe, ad esempio: - L'etichetta del gruppo host ora mostra il riepilogo dei problemi di tutti gli host nei gruppi host nidificati; - La vista "Elementi del gruppo host" ora mostra un elemento della mappa separato per ciascun host nei gruppi host nidificati; - L'etichetta della mappa ora mostra il riepilogo di tutti i problemi contenuti nei gruppi host nidificati. [comment]: # ({/35d6cac2-cd6bf45f}) [comment]: # ({287fe3d7-3e5a1f4e}) #### Tabella del database per le impostazioni convertita La tabella `settings` ora sostituisce la tabella `config` per l'archiviazione dei parametri di [configurazione globale](/manual/web_interface/frontend_sections/administration/general). 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](/manual/appendix/protocols/server_proxy) (oggetto `"settings"`). [comment]: # ({/287fe3d7-3e5a1f4e}) [comment]: # ({c0320633-c04dac65}) #### 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): - server: il valore massimo per [HistoryCacheSize](/manual/appendix/config/zabbix_server#historycachesize), [HistoryIndexCacheSize](/manual/appendix/config/zabbix_server#historyindexcachesize) e [TrendCacheSize](/manual/appendix/config/zabbix_server#trendcachesize) è stato aumentato; - proxy: i valori massimi per [HistoryCacheSize](/manual/appendix/config/zabbix_proxy#historycachesize) e [HistoryIndexCacheSize](/manual/appendix/config/zabbix_proxy#historyindexcachesize) sono stati aumentati. [comment]: # ({/c0320633-c04dac65}) [comment]: # ({01a59c99-013b708e}) #### Periodo di conservazione predefinito ridotto per le sessioni utente Il [periodo di conservazione](/manual/web_interface/frontend_sections/administration/housekeeping#configuration) predefinito per i dati delle sessioni utente è stato ridotto da 365 giorni a 31 giorni. Questa modifica interessa il parametro [hk_sessions](/manual/api/reference/housekeeping/object), che ora ha come valore predefinito 31d invece di 365d. [comment]: # ({/01a59c99-013b708e}) [comment]: # ({6b2e934c-4ba32c29}) #### 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](/manual/concepts/agent2), i [plugin caricabili](/manual/extensions/plugins#loadable-plugins) di agent 2 o il [servizio web](/manual/concepts/web_service) dai sorgenti usando una versione di Go precedente alla 1.23, si consiglia di ricompilare questi componenti usando una [versione di Go supportata](/manual/installation/requirements#agent-2) 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](/manual/installation/upgrade/sources#agent-upgrade-process) sarà necessario un ambiente Go più recente. [comment]: # ({/6b2e934c-4ba32c29}) [comment]: # ({da32c242-45a80b88}) #### Aggiornamento del template per Host Wizard Il nuovo [Host Wizard](/manual/config/hosts/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](/manual/config/templates_out_of_the_box#template-upgrade). [comment]: # ({/da32c242-45a80b88})