10 Upgrade-notities voor 6.4.0

Deze notities zijn bedoeld voor het upgraden van Zabbix 6.2.x naar Zabbix 6.4.0.

Alle notities zijn gegroepeerd in:

• Wijzigingen met brekende impact - wijzigingen die bestaande installaties kunnen beïnvloeden en andere cruciale informatie met betrekking tot het upgradeproces.
• Overig - alle overige informatie die de wijzigingen in de Zabbix-functionaliteit beschrijft.

Zie ook:

• Upgrade-procedure voor alle relevante informatie over het upgraden van versies vóór Zabbix 6.2.0;
• Upgraden van een HA-cluster voor instructies over het upgraden van servers in een high-availability (HA) cluster.

Upgradeproces

Om een succesvolle Zabbix-serverupgrade op MySQL/MariaDB te voltooien, moet u mogelijk GLOBAL log_bin_trust_function_creators = 1 instellen in MySQL als binair loggen is ingeschakeld, er zijn geen supergebruikersrechten en log_bin_trust_function_creators = 1 is niet ingesteld in het MySQL-configuratiebestand.

Om de variabele in te stellen met behulp van de MySQL-console, voert u het volgende uit:

mysql> SET GLOBAL log_bin_trust_function_creators = 1;

Zodra de upgrade succesvol is voltooid, kan deze optie worden uitgeschakeld:

mysql> SET GLOBAL log_bin_trust_function_creators = 0;

Brekende veranderingen

MySQL-versie

MySQL-versies lager dan 8.0.30 worden niet langer ondersteund. De minimaal vereiste MySQL-versie is verhoogd van 8.0.0 naar 8.0.30.

libssh-versie

De minimaal vereiste libssh-versie is verhoogd van 0.6.0 naar 0.9.0.

SLES-versies

Voor SUSE Linux Enterprise Server (SLES) 15 is de minimaal ondersteunde service pack-versie nu SP4.

SLES 12 met SP4 en nieuwer worden ook nog steeds ondersteund, maar vanwege de oudere libssh bibliotheek is de ondersteuning voor SSH-controles voor deze OS-versie stopgezet.

Update geoptimaliseerde proxyconfiguratie

Een incrementele update van de proxyconfiguratie is geïntroduceerd in de nieuwe versie.

Als gevolg hiervan is de parameter ConfigFrequency voor actieve proxies nu verouderd; in plaats daarvan moet de parameter ProxyConfigFrequency worden gebruikt op zowel de server (voor passieve proxies) als de proxy (voor actieve proxies). Let op dat als zowel ProxyConfigFrequency als ConfigFrequency worden gebruikt, de proxy een fout zal loggen en zal worden afgesloten.

De standaardwaarde van ProxyConfigFrequency is verlaagd van 3600 naar 10 seconden. Ook is de standaardwaarde van CacheUpdateFrequency op de server verlaagd van 60 naar 10 seconden.

De server gebruikt nu de configuratiecache om proxyconfiguratiewijzigingen bij te houden met behulp van revisienummers, dus de hoeveelheid gecachete gegevens zal toenemen en het kan nodig zijn om de grootte van de configuratiecache te vergroten.

Merk op dat de serverconfiguratie gesynchroniseerd moet worden voordat eventuele wijzigingen naar de proxy worden gesynchroniseerd. Dus als een gebruiker enkele wijzigingen aanbrengt en deze naar de proxy wil synchroniseren, moet de serverconfiguratiecache eerst worden herladen.

Andere

Geautomatiseerde database-upgrade op proxies met SQLite

Bij de eerste start na een upgrade zal Zabbix-proxy met SQLite3 nu automatisch het bestaande oudere versie van het databasebestand dumpen en een nieuw bestand aanmaken voor de huidige versie. Historische gegevens die zijn opgeslagen in het SQLite-databasebestand worden niet behouden. Eerder moest het SQLite-databasebestand handmatig worden opnieuw aangemaakt.

Als de Zabbix-proxyversie ouder is dan de versie van het databasebestand, zal de proxy een fout loggen en worden afgesloten.

CSRF-tokens

Voor verbeterde beveiliging tegen CSRF (Cross Site Request Forgery) aanvallen, gebruikt de Zabbix-frontend nu willekeurig gegenereerde CSRF-tokens in plaats van statische sessiegebaseerde tokens. Als uw installatie een IDS/IPS gebruikt die controleert op specifieke tokennamen, kan het nodig zijn om de configuratie bij te werken om de nieuwe tokennaam _csrf_token te herkennen om valse positieve detecties te voorkomen.

Preprocessingewerkers op basis van threads

Omdat de voorbewerking van itemwaarden is herschreven om threads voor voorbewerking te gebruiken, is er nu een nieuwe bibliotheek vereist voor Zabbix server/proxy - libevent_pthreads.

Niet-verplichte velden in gebruikersconfiguratie

De gebruikersgroep- en gebruikersrolvelden zijn niet langer verplicht in de gebruikersconfiguratie. Echter, als een interne Zabbix-gebruiker wordt aangemaakt zonder een gebruikersrol, zal de gebruiker niet kunnen inloggen op Zabbix met interne authenticatie.

Onmiddellijke vernieuwing van actieve controles

Voorheen ontving de Zabbix-agent (in actieve modus) eens in de twee minuten (standaard) een volledige kopie van de configuratie van de Zabbix-server of Zabbix-proxy. Door de introductie van incrementele configuratiesynchronisatie wordt de volledige configuratie niet langer verzonden wanneer er geen wijzigingen zijn in host- of globale reguliere expressies. Hierdoor is het standaardsynchronisatie-interval teruggebracht naar 5 seconden.

Het 'RefreshActiveChecks'-parameter, ondersteund in het Zabbix-agent configuratiebestand, heeft een standaardwaarde van 5 seconden (voorheen 120). Dit kan de verbindingen frequenter maken en het netwerkgebruik verhogen, vooral als versleuteling wordt gebruikt.

Het JSON-protocol voor actieve agentcontroles is bijgewerkt om config_revision en session-ID op te nemen. Zie voor meer informatie Passieve en actieve agentcontroles.

Gebruikersmacro's hebben ook invloed op de incrementele configuratiesynchronisatie. Het is raadzaam om hostmacro's te gebruiken in plaats van globale macro's, omdat het toevoegen, bijwerken of verwijderen van globale macro's een incrementele configuratie-update forceert voor alle hosts.

Ondersteuning voor Heartbeat is verouderd

Vanaf Zabbix 6.4 is de heartbeat sender verwijderd uit de proxy, en daarom wordt het Zabbix proxy-item zabbix [process,heartbeat sender] niet ondersteund en is het verwijderd uit sjablonen. De parameter HeartbeatFrequency is verouderd.

Autoregistratieheartbeat voor Zabbix-server

De heartbeat voor actieve agent-autoregistratie voor de Zabbix-server is ingesteld op 120 seconden (hetzelfde als voor de Zabbix-proxy). Dus als een ontdekte host wordt verwijderd, wordt de autoregistratie opnieuw uitgevoerd na 120 seconden.

Oude numerieke (float) waardevorm is verouderd

Sinds Zabbix 5.0 is het numerieke (float) gegevenstype omgezet naar het nieuwe formaat om precisie van ongeveer 15 cijfers te ondersteunen en de uitgebreide waardebereik van ongeveer -1.79E+308 tot 1.79E+308.

Nu is het oude numerieke type, dat is uitgeschakeld maar nog steeds ondersteund, verouderd en wordt het verwijderd in een toekomstige versie.

Als uw installatie niet is bijgewerkt naar de numerieke waarden met een uitgebreide reeks, zal Systeeminformatie in de frontend een waarschuwing weergeven: "Database-geschiedenistabellen bijgewerkt: Nee. Ondersteuning voor het oude numerieke type is verouderd. Upgrade naar numerieke waarden van een uitgebreid bereik is vereist". In dit geval zie de instructies voor het inschakelen van het uitgebreide bereik van numerieke waarden.

Datum verwijderd uit export

Het element date is verwijderd uit het exportformaat bij het exporteren van objecten (hosts, sjablonen, enzovoort).

Sjabloonversiebeheer

Om het beheer en de upgrade van sjablonen te verbeteren, is sjabloonversiebeheer geïntroduceerd.

In Gegevensverzameling → Sjablonen kunt u nu de sjabloonaanbieder en -versie zien, en sjablonen filteren op basis van de aanbieder en/of versie.

Bijwerken van bijgewerkte sjablonen

Houd er rekening mee dat sjablonen handmatig moeten worden bijgewerkt als u een upgrade uitvoert vanaf eerdere versies. Dit kan worden gedaan door de bijgewerkte sjablonen te importeren. U kunt de bijgewerkte sjablonen vinden in de zabbix/templates map van de gedownloade nieuwste Zabbix-versie. Terwijl u in Gegevensverzameling → Sjablonen bent, kunt u ze importeren vanuit deze map.

Het is ook mogelijk om sjablonen direct te downloaden vanuit het Zabbix-git-repository.

Aanpassen van aangepaste sjabloonaanbieder en versie

Voor bestaande aangepaste sjablonen kan ook de sjabloonaanbieder en -versie worden aangepast via de Sjabloon-API.