На странице

10 Примечания к обновлению до 7.4.0

Эти примечания предназначены для обновления с Zabbix 7.2.x до Zabbix 7.4.0.

Все примечания сгруппированы в:

  • Критические изменения - изменения, которые могут нарушить работу существующих установок, и другая важная информация, связанная с процессом обновления
  • Другое - вся остальная информация, описывающая изменения в функциональности Zabbix

См. также:

Процесс обновления

Чтобы успешно завершить обновление сервера Zabbix на MySQL/MariaDB, может потребоваться установить GLOBAL log_bin_trust_function_creators = 1 в MySQL, если включено двоичное журналирование, отсутствуют привилегии суперпользователя и log_bin_trust_function_creators = 1 не задан в файле конфигурации MySQL.

Чтобы задать переменную с помощью консоли MySQL, выполните:

mysql> SET GLOBAL log_bin_trust_function_creators = 1;

После успешного завершения обновления эту опцию можно отключить:

mysql> SET GLOBAL log_bin_trust_function_creators = 0;

Критические изменения

Библиотека PCRE удалена

Библиотека PCRE (или PCRE1) была удалена. Теперь Zabbix собирается с PCRE2.

Управление собственными медиа пользователей

По умолчанию всем пользователям теперь разрешено управлять своими собственными медиа.

Права пользователя на изменение сведений о своих медиа могут быть предоставлены (или отозваны) в зависимости от его роли пользователя (см. параметр Создание и изменение собственных медиа).

Кроме того, права пользователя Super admin на изменение сведений о медиа других пользователей также могут быть предоставлены/отозваны в зависимости от его роли пользователя (см. параметр Создание и изменение медиа пользователя).

При обновлении с более старых версий оба параметра будут включены для всех ролей, у которых включен параметр Доступ по умолчанию к новым действиям. Обратите внимание: если параметр Доступ по умолчанию к новым действиям не включен, администраторы и супер-администраторы могут потерять возможность редактировать медиа после обновления.

Экранирование обратных слэшей в параметрах функций истории

Начиная с Zabbix 7.0.0, в строковых параметрах функций истории было добавлено корректное экранирование обратных слэшей.

Поскольку при обновлении с версий Zabbix до 7.0 в параметры добавляются дополнительные обратные слэши, это приводит к увеличению длины параметров, что может вызвать сбой функций триггера, если длина параметра превышает максимальный размер данных в 255 символов.

Чтобы избежать этой проблемы, рекомендуется вручную перенести длинные параметры в пользовательские макросы до обновления.

Для обновлений с версий Zabbix до 7.0 были добавлены дополнительные проверки итоговой длины параметра. Если итоговая длина превышает максимальный размер, такие параметры не обновляются, а в журналах выводится предупреждение с просьбой исправить перечисленные параметры вручную.

См. также проблемы обновления, связанные с экранированием.

Обновление плагина MSSQL Zabbix agent 2

Шаблон MSSQL by Zabbix agent 2 был обновлен: в него добавлены фильтры для включения или исключения обнаруженных членов кворума по имени, а также фильтр службы, который позволяет фильтровать по имени кластера, чтобы исключать пустые кластеры. Чтобы шаблон работал без ошибок, плагин MSSQL Zabbix agent 2 должен быть обновлен до версии 7.4.0 или выше.

Минимальная требуемая версия libssh2

Минимальная требуемая версия libssh2 была повышена с 1.0.0 до 1.8.0.

Прототипы узлов сети на обнаруженных узлах сети

Если ваша текущая конфигурация включает прототипы узлов сети, которые используют шаблоны, содержащие другие прототипы узлов сети, при обновлении до Zabbix 7.4 все обнаруженные узлы сети получат прототипы узлов сети, определенные в этих шаблонах. Если такое поведение не требуется, вручную удалите прототипы узлов сети из соответствующих шаблонов перед обновлением.

Чтобы определить обнаруженные узлы сети, которые получат прототипы узлов сети во время обновления, вы можете выполнить следующий SQL-запрос в вашей базе данных 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;

Параметры подключения к базе данных

DBPort и DBSocket теперь взаимоисключающие. При указании параметров подключения к базе данных вы можете задать либо DBPort, либо DBSocket, либо оставить оба параметра не определенными, чтобы использовать значения по умолчанию.

Другое

Неподдерживаемые элементы SNMP walk/discovery без действительных OID

Элементы SNMP walk, если ни один из OID или экземпляров OID не существует, теперь возвращают ошибку, и элемент становится неподдерживаемым. Сведения о несуществующем OID/экземпляре записываются в журнал с DebugLevel=5. Ранее в таких случаях возвращалась пустая строка.

Аналогично, элементы SNMP discovery, если ни один из OID или экземпляров OID не существует, теперь возвращают ошибку, и элемент становится неподдерживаемым. Ранее в таких случаях возвращался пустой массив.

Обратите внимание, что пустая строка/массив теперь возвращается только если OID/экземпляр существует, но для него нет данных.

Управление кэшем истории

В некоторых сценариях сбора данных отдельные элементы данных могут временно блокировать кэш истории сервера/прокси. Это может задерживать запись данных истории в базу данных и замедлять работу системы. Чтобы упростить управление кэшем истории, были внедрены следующие улучшения:

  • Ручная очистка кэша: новая команда выполнения history_cache_clear=target для Zabbix сервер/прокси позволяет вручную очистить кэш истории для конкретного элемента данных по его ID.
  • Автоматическая очистка кэша: при отключении элемента данных он немедленно удаляется из кэша истории (за исключением его последнего значения, которое сохраняется для журналов). Аналогично, при отключении узла сети все его элементы данных удаляются из кэша истории (за исключением их последних значений).
  • Журналирование диагностики кэша: когда кэш истории заполнен, Zabbix сервер/прокси теперь записывает диагностическую информацию о кэше истории начиная с DebugLevel=3 (ранее DebugLevel=4). В журнале содержатся элементы данных с наибольшим количеством значений в кэше истории.

Для долгосрочной стабильности системы убедитесь, что сбор данных сбалансирован с доступными ресурсами (производительность базы данных, размер кэша, интервалы сбора, параметры элементов данных журнала и т. д.). Вы можете отслеживать кэш истории Zabbix с помощью внутреннего элемента данных zabbix[wcache]. Также можно рассмотреть увеличение размера кэша истории для Zabbix сервер/прокси.

Отдельный раздел меню для уведомлений пользователей

Для лучшей наглядности пользовательских способов доставки уведомлений теперь у уведомлений пользователей есть собственный раздел меню в Настройках пользователя.

Новый раздел Уведомления содержит две вкладки — Медиа и Уведомления веб-интерфейса, которые ранее входили в раздел профиля пользователя.

Корректная информация из вложенных групп узлов сети на картах

Информация из вложенных групп узлов сети теперь корректно отображается на картах, например:

  • Метка группы узлов сети теперь отображает краткое описание проблемы со всех узлов сети во вложенных группах узлов сети;
  • Представление "Элементы группы узлов сети" теперь отображает отдельный элемент карты для каждого узла сети во вложенных группах узлов сети;
  • Метка карты теперь отображает краткое описание всех проблем, содержащихся во вложенных группах узлов сети.

Таблица базы данных для преобразованных настроек

Таблица settings теперь заменяет таблицу config для хранения параметров глобальной конфигурации. Новая таблица использует формат ключ-значение вместо хранения параметров в одной строке с отдельным столбцом для каждого параметра. Пример того, как это влияет на обмен данными, см. в разделе Протокол обмена данными между сервером и прокси (объект "settings").

Увеличены максимальные размеры кэша для сервера и прокси

Максимальные размеры кэша были увеличены с 2 ГБ до 16 ГБ, чтобы отложить исчерпание кэша и обеспечить работу во время временных проблем (например, с конфигурацией, базой данных или сетью):

Сокращен период хранения сеансов пользователей по умолчанию

Период хранения данных сеансов пользователей по умолчанию был сокращен с 365 дней до 31 дня. Это изменение затрагивает параметр hk_sessions, для которого теперь по умолчанию используется значение 31d вместо 365d.

Минимально поддерживаемая версия Go

Минимально поддерживаемая версия Go была повышена с 1.21 до 1.23.

Если ранее вы собирали Zabbix агент 2, загружаемые плагины агент 2 или веб-службу из исходного кода с использованием версии Go старее 1.23, рекомендуется пересобрать эти компоненты с использованием поддерживаемой версии Go, чтобы получать последние обновления безопасности и исправления ошибок. Компоненты, собранные с более старой версией Go, продолжат работать, но для их обновления потребуется более новая среда Go.

Обновление шаблонов для мастера узлов сети

Новый Мастер узлов сети предоставляет пошаговый интерфейс с подсказками для настройки объекта мониторинга (устройства, приложения, службы и т. д.) в Zabbix. Он упрощает настройку новых или существующих узлов сети, проводя пользователей через ключевые шаги, такие как выбор шаблона, установка агента Zabbix, добавление интерфейсов узла сети и многое другое.

После обновления с более ранней версии Zabbix шаблоны необходимо обновить, чтобы они работали с Мастером узлов сети. Инструкции см. в разделе Обновление шаблонов.