На странице

11 Примечания по обновлению до версии 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.

Управление собственными способами оповещения

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

Разрешения пользователей на изменение сведений о собственных способах оповещения можно предоставлять или отзывать на основе их роли пользователя (см. параметр Создание и редактирование собственных способов оповещения).

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

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

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

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

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

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

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

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

Обновление плагина MSSQL для агента Zabbix 2

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

Чтобы шаблон работал без ошибок, необходимо обновить плагин MSSQL для агента Zabbix 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 позволяет вручную очистить кэш истории для определенного элемента данных по его идентификатору.
  • Автоматическая очистка кэша: при отключении элемента данных он немедленно удаляется из кэша истории (за исключением его последнего значения, которое сохраняется для журналов). Аналогично, при отключении узла сети все его элементы данных удаляются из кэша истории (за исключением их последних значений).
  • Журналирование диагностики кэша: когда кэш истории заполнен, сервер/прокси 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 шаблоны необходимо обновить, чтобы они работали с Мастером узлов сети. Инструкции см. в разделе Обновление шаблонов.

Параллельная обработка проверок SNMPv1 и SNMPv2

Асинхронные проверки службы SNMPv1 и SNMPv2 теперь обрабатываются параллельно доступными рабочими процессами обнаружения.