10 Uwagi dotyczące aktualizacji do wersji 7.4.0

Te uwagi dotyczą aktualizacji z Zabbix 7.2.x do Zabbix 7.4.0.

Wszystkie uwagi są pogrupowane w:

  • Zmiany powodujące niezgodność - zmiany, które mogą spowodować awarię istniejących instalacji, oraz inne istotne informacje związane z procesem aktualizacji
  • Inne - wszystkie pozostałe informacje opisujące zmiany w funkcjonalności Zabbix

Zobacz także:

  • Procedura aktualizacji zawierająca wszystkie istotne informacje dotyczące aktualizacji z wersji wcześniejszych niż Zabbix 7.4.0;
  • Aktualizacja klastra HA z instrukcjami dotyczącymi aktualizacji serwerów w klastrze wysokiej dostępności (HA).

Proces aktualizacji

Aby pomyślnie zakończyć aktualizację serwera Zabbix na MySQL/MariaDB, może być konieczne ustawienie GLOBAL log_bin_trust_function_creators = 1 w MySQL, jeśli włączone jest binarne logowanie, nie ma uprawnień superużytkownika, a log_bin_trust_function_creators = 1 nie jest ustawione w pliku konfiguracyjnym MySQL.

Aby ustawić tę zmienną za pomocą konsoli MySQL, uruchom:

mysql> SET GLOBAL log_bin_trust_function_creators = 1;

Po pomyślnym zakończeniu aktualizacji tę opcję można wyłączyć:

mysql> SET GLOBAL log_bin_trust_function_creators = 0;

Przełomowe zmiany

Biblioteka PCRE została wycofana

Biblioteka PCRE (lub PCRE1) została wycofana. Zabbix jest teraz kompilowany z użyciem PCRE2.

Zarządzanie własnymi mediami użytkownika

Domyślnie wszyscy użytkownicy mogą teraz zarządzać własnymi mediami.

Uprawnienia użytkowników do zmiany szczegółów mediów dla siebie mogą być przyznawane (lub odbierane) na podstawie ich roli użytkownika (zobacz opcję Tworzenie i edycja własnych mediów).

Dodatkowo uprawnienia użytkowników Super admin do zmiany szczegółów mediów innych osób mogą być również przyznawane/odbierane na podstawie ich roli użytkownika (zobacz opcję Tworzenie i edycja mediów użytkownika).

W przypadku aktualizacji ze starszych wersji obie opcje będą włączone dla wszystkich ról, dla których włączono Domyślny dostęp do nowych akcji. Należy pamiętać, że jeśli Domyślny dostęp do nowych akcji nie jest włączony, administratorzy i superadministratorzy mogą utracić możliwość edycji mediów po aktualizacji.

Escapowanie ukośników odwrotnych w parametrach funkcji historii

Prawidłowe escapowanie ukośników odwrotnych zostało dodane w parametrach tekstowych funkcji historii od Zabbix 7.0.0.

Ponieważ podczas aktualizacji z wersji Zabbix wcześniejszych niż 7.0 dodawane są dodatkowe ukośniki odwrotne, prowadzi to do dłuższych parametrów, co może skutkować nieprawidłowym działaniem funkcji wyzwalacza, jeśli długość parametru przekroczy maksymalny rozmiar danych wynoszący 255 znaków.

Aby uniknąć tego problemu, zaleca się ręczne przeniesienie długich parametrów do makr użytkownika przed aktualizacją.

W przypadku aktualizacji z wersji Zabbix wcześniejszych niż 7.0 dodano dodatkowe kontrole długości wynikowego parametru. Jeśli wynikowa długość przekracza maksymalny rozmiar, takie parametry nie są aktualizowane, a w logach jest wyświetlane ostrzeżenie z prośbą o ręczne poprawienie wymienionych parametrów.

Zobacz też problemy z aktualizacją związane z escapowaniem.

Aktualizacja wtyczki MSSQL Zabbix agent 2

Szablon MSSQL by Zabbix agent 2 został zaktualizowany o filtry umożliwiające uwzględnianie lub wykluczanie wykrytych członków quorum według nazwy, a także o filtr usługi, który pozwala filtrować według nazwy klastra, aby wykluczyć puste klastry. Aby szablon działał bez błędów, wtyczka MSSQL Zabbix agent 2 musi zostać zaktualizowana do wersji równej lub wyższej niż 7.4.0.

Minimalna wymagana wersja libssh2

Minimalna wymagana wersja libssh2 została podniesiona z 1.0.0 do 1.8.0.

Prototypy hostów na wykrytych hostach

Jeśli bieżąca konfiguracja zawiera prototypy hostów, które używają szablonów zawierających inne prototypy hostów, uaktualnienie do Zabbix 7.4 spowoduje, że wszystkie wykryte hosty będą miały prototypy hostów zdefiniowane w tych szablonach. Jeśli takie zachowanie nie jest zamierzone, przed uaktualnieniem należy ręcznie usunąć prototypy hostów z odpowiednich szablonów.

Aby zidentyfikować wykryte hosty, które otrzymają prototypy hostów podczas uaktualnienia, można uruchomić następujące zapytanie SQL w bazie danych 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;

Parametry połączenia z bazą danych

DBPort i DBSocket są teraz wzajemnie wykluczające się. Podczas określania parametrów połączenia z bazą danych można zdefiniować albo DBPort, albo DBSocket, albo pozostawić oba niezdefiniowane, aby użyć wartości domyślnych.

Inne

Nieobsługiwane pozycje SNMP walk/discovery bez prawidłowych OID

Pozycje SNMP walk, w przypadku gdy nie istnieją żadne OID ani instancje OID, teraz zwracają błąd, a pozycja staje się nieobsługiwana. Szczegóły nieistniejącego OID/instancji są rejestrowane przy DebugLevel=5. Wcześniej w takich przypadkach zwracany był pusty ciąg.

Podobnie pozycje SNMP discovery, w przypadku gdy nie istnieją żadne OID ani instancje OID, teraz zwracają błąd, a pozycja staje się nieobsługiwana. Wcześniej w takich przypadkach zwracana była pusta tablica.

Należy pamiętać, że pusty ciąg/tablica jest teraz zwracany tylko wtedy, gdy OID/instancja istnieje, ale nie ma dla niej danych.

Zarządzanie pamięcią podręczną historii

W niektórych scenariuszach zbierania danych określone pozycje mogą tymczasowo blokować pamięć podręczną historii serwera/proxy. Może to opóźnić zapisywanie danych historycznych do bazy danych i spowolnić działanie systemu. Aby ułatwić zarządzanie pamięcią podręczną historii, wprowadzono następujące ulepszenia:

  • Ręczne czyszczenie pamięci podręcznej: Nowe polecenie czasu działania history_cache_clear=target dla Zabbix serwer/proxy umożliwia ręczne wyczyszczenie pamięci podręcznej historii dla określonej pozycji na podstawie jej ID.
  • Automatyczne czyszczenie pamięci podręcznej: Gdy wyłączysz pozycję, jest ona natychmiast usuwana z pamięci podręcznej historii (z wyjątkiem jej ostatniej wartości, która jest zachowywana do logów). Podobnie, gdy wyłączysz host, wszystkie jego pozycje są usuwane z pamięci podręcznej historii (z wyjątkiem ich ostatnich wartości).
  • Logowanie diagnostyki pamięci podręcznej: Gdy pamięć podręczna historii jest pełna, Zabbix serwer/proxy zapisuje teraz informacje diagnostyczne dotyczące pamięci podręcznej historii od DebugLevel=3 (wcześniej DebugLevel=4). Log zawiera pozycje z największą liczbą wartości w pamięci podręcznej historii.

Aby zapewnić długoterminową stabilność systemu, upewnij się, że zbieranie danych jest zrównoważone względem dostępnych zasobów (wydajność bazy danych, rozmiar pamięci podręcznej, interwały zbierania, parametry pozycji logów itp.). Możesz monitorować pamięć podręczną historii Zabbix za pomocą wewnętrznej pozycji zabbix[wcache]. Możesz również rozważyć zwiększenie rozmiaru pamięci podręcznej historii dla Zabbix serwer/proxy.

Osobna sekcja menu dla powiadomień użytkownika

Aby poprawić widoczność mediów użytkownika, powiadomienia użytkownika mają teraz własną sekcję menu w obszarze Ustawienia użytkownika.

Nowa sekcja Powiadomienia zawiera dwie karty - Media i Powiadomienia frontend, które wcześniej były częścią sekcji profilu użytkownika.

Prawidłowe informacje z zagnieżdżonych grup hostów na mapach

Informacje z zagnieżdżonych grup hostów są teraz poprawnie wyświetlane na mapach, na przykład:

  • Etykieta grupy hostów teraz wyświetla podsumowanie problemów ze wszystkich hostów w zagnieżdżonych grupach hostów;
  • Widok „Elementy grupy hostów” teraz wyświetla osobny element mapy dla każdego hosta w zagnieżdżonych grupach hostów;
  • Etykieta mapy teraz wyświetla podsumowanie wszystkich problemów zawartych w zagnieżdżonych grupach hostów.

Tabela bazy danych dla przekonwertowanych ustawień

Tabela settings zastępuje teraz tabelę config do przechowywania parametrów globalnej konfiguracji. Nowa tabela używa formatu klucz-wartość zamiast przechowywania parametrów w jednym wierszu z jedną kolumną na każdy parametr. Przykład tego, jak wpływa to na wymianę danych, można znaleźć w sekcji Protokół wymiany danych serwer-proxy (obiekt "settings").

Zwiększone maksymalne rozmiary pamięci podręcznej dla serwera i proxy

Maksymalne rozmiary pamięci podręcznej zostały zwiększone z 2 GB do 16 GB, aby opóźnić wyczerpanie cache i utrzymać działanie podczas tymczasowych problemów (np. z konfiguracją, bazą danych lub siecią):

Skrócony domyślny okres przechowywania sesji użytkowników

Domyślny okres przechowywania danych sesji użytkowników został skrócony z 365 dni do 31 dni. Zmiana ta dotyczy parametru hk_sessions, który teraz domyślnie ma wartość 31d zamiast 365d.

Minimalna obsługiwana wersja Go

Minimalna obsługiwana wersja Go została podniesiona z 1.21 do 1.23.

Jeśli wcześniej kompilowano Zabbix agent 2, ładowalne wtyczki agent 2 lub usługę webową ze źródeł przy użyciu wersji Go starszej niż 1.23, zaleca się ponowną kompilację tych komponentów przy użyciu obsługiwanej wersji Go, aby otrzymywać najnowsze aktualizacje zabezpieczeń i poprawki błędów. Komponenty skompilowane przy użyciu starszej wersji Go będą nadal działać, ale ich aktualizacja będzie wymagała nowszego środowiska Go.

Aktualizacja szablonu dla Host Wizard

Nowy Host Wizard wprowadza prowadzony, krok po kroku interfejs do konfigurowania monitorowanego obiektu docelowego (urządzenia, aplikacji, usługi itp.) w Zabbix. Upraszcza konfigurację nowych lub istniejących hostów, prowadząc użytkowników przez kluczowe kroki, takie jak wybór szablonu, instalacja Zabbix agent, dodawanie interfejsów hosta i inne.

Po uaktualnieniu z wcześniejszej wersji Zabbix szablony muszą zostać zaktualizowane, aby działały z Host Wizard. Instrukcje znajdują się w sekcji Aktualizacja szablonu.