Это перевод страницы документации с английского языка. Помогите нам сделать его лучше.
Table of Contents

8 Известные проблемы

Template nesting issue in Zabbix 6.4.0rc1

Zabbix 6.4.0rc1 (rc1 = Release Candidate 1) does not support template nesting (restored in 6.4.0rc2). If you have upgraded to Zabbix 6.4.0rc1, a DB patch will convert all nested templates into a flat template structure. This means that all entities (items, triggers, etc.) from nested templates will be transferred to the template that contained these nested templates. The support for template nesting has been fully restored in Zabbix 6.4.0rc2. However, if you have already upgraded to Zabbix 6.4.0rc1, the previously existing template structure will not be recovered. :::

Запуск прокси с MySQL 8.0.0-8.0.17

zabbix_proxy на версиях MySQL 8.0.0-8.0.17 завершается со следующей ошибкой "access denied":

[Z3001] connection to database 'zabbix' failed: [1227] Access denied; you need (at least one of) the SUPER, SYSTEM_VARIABLES_ADMIN or SESSION_VARIABLES_ADMIN privilege(s) for this operation

Такое поведение связано с тем, что MySQL 8.0.0 начал применять специальные права доступа к установке переменных сессий. Однако, в 8.0.18 версии такой подход отменен: Начиная с MySQL 8.0.18, установка переменной сессий с этой системной переменной более не является запрещенной операцией.

Временное решение основывается на предоставлении дополнительных привилегий zabbix пользователю:

Для версий MySQL 8.0.14 - 8.0.17:

grant SESSION_VARIABLES_ADMIN on *.* to 'zabbix'@'localhost';

Для версий MySQL 8.0.0 - 8.0.13:

grant SYSTEM_VARIABLES_ADMIN on *.* to 'zabbix'@'localhost';

Timescale DB: высокое потребление памяти при большом количестве секций

Версии PostgreSQL 9.6-12 используют слишком много памяти при обновлении таблиц с большим количеством секций (смотрите отчет о проблеме). Эта проблема проявляет себя, когда Zabbix выполняет обновление динамики изменений на системах с TimescaleDB, в случае если таблицы динамики изменений разбиты на относительно маленькие фрагменты (например, по 1 дню). Это приводит к тому, что в таблицах динамики изменений присутствуют сотни фрагментов при настройках очистки истории по умолчанию - состояние, при котором PostgreSQL скорее всего может исчерпать всю оперативную память.

Эта проблемы решена, начиная с Zabbix 5.0.1 для новых инсталляций с TimescaleDB, но если TimescaleDB был сконфигурирован с Zabbix до этого момента, пожалуйста обратитесь к ZBX-16347 за информацией по процессу миграции.

Timescale DB 2.5.0: политика сжатия может дать сбой на таблицах, которые содержат целые числа

Эта проблема проявляет себя при использовании TimescaleDB 2.5.0. Она была решена, начиная с TimescaleDB 2.5.1.

Для получения более подробной информации, пожалуйста обратитесь к TimescaleDB Issue #3773.

Upgrade

SQL mode setting for successful upgrade

The sql_mode setting in MySQL/MariaDB must have the "STRICT_TRANS_TABLES" mode set. If it is absent, the Zabbix database upgrade will fail (see also ZBX-19435).

Обновление с MariaDB 10.2.1 и старше

Обновление Zabbix может завершится с ошибкой, если таблицы базы данных были созданы с MariaDB версии 10.2.1 и старше, так как в этих версиях по умолчанию используется компактный формат строк. Такая проблема исправляется изменением формата строк на динамический формат (смотрите также ZBX-17690).

TLS подключение к базе данных с MariaDB

При использовании MariaDB подключение TLS к базе данных не поддерживается с опцией 'verify_ca' для параметра DBTLSConnect.

Возможные взаимные блокировки с MySQL/MariaDB

При работе под высокой нагрузкой и использовании более одного процесса LLD worker, возможно возникновение взаимных блокировок (deadlocks), вызванных ошибкой InnoDB, относящейся к стратегии блокировок строк (см. upstream bug). Ошибка была исправлена в MySQL, начиная с версии 8.0.29, но не в MariaDB. Для более подробной информации, обратитесь к ZBX-21506.

Глобальная корреляция событий

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

Диапазон типа данных числовой (с дробной точкой) в PostgreSQL 11 и более старых версиях

PostgreSQL версии 11 и старше поддерживают значения с дробной точкой только в диапазоне приблизительно от -1.34E-154 до 1.34E+154.

NetBSD 8.0 и новее

Различные процессы Zabbix могут случайным образом аварийно завершать работу при запуске на NetBSD версий 8.X и 9.X. Такое поведение связано со слишком малым размером стека по умолчанию (4МБ), который необходимо увеличить, выполнив:

ulimit -s 10240

Для получения более подробной информации, пожалуйста, обратитесь к соответствующему отчету о проблеме: ZBX-18275.

Regular expression limitations in Zabbix agent 2

Zabbix agent 2 does not support lookaheads and lookbehinds in regular expressions due to the standard Go regexp library limitations.

IPMI проверки

IPMI проверки не будут работать со стандартным пакетом библиотеки OpenIPMI на Debian до 9 (stretch) версии и Ubuntu до 16.04 (xenial). Чтобы исправить проблему, пересоберите OpenIPMI библиотеку с включенным OpenSSL, как обсуждалось в ZBX-6139.

SSH проверки

  • Некоторые дистрибутивы Linux, такие как Debian и Ubuntu, не поддерживают шифрованные закрытые (private) ключи (с парольной фразой), если библиотека libssh2 установлена из пакетов. Пожалуйста, обратитесь к ZBX-4850 для получения более подробных сведений.

  • При использовании libssh 0.9.x на некоторых дистрибутивах Linux с OpenSSH 8 проверки SSH могут иногда сообщать "Cannot read data from SSH server". Такое поведение вызвано проблемой(более подробный отчёт) libssh. Ожидается, что эта ошибка исправлена в стабильном выпуске libssh 0.9.5. Смотрите также ZBX-17756 для получения подробной информации.

  • Использование вертикальной черты "|" в SSH скрипте может привести к ошибке "Cannot read data from SSH server". В этом случае рекомендуется обновить версию библиотеки libssh. Смотрите также ZBX-21337 для получения подробной информации.

ODBC проверки

  • Драйвер MySQL unixODBC лучше не использовать с Zabbix сервером или Zabbix прокси, скомпилированными с библиотекой MariaDB, и наоборот, по возможности лучше избегать использование того же коннектора, что и драйвер, по причине зарегистрированной проблемы. Предлагаемая установка:

    PostgreSQL, SQLite или Oracle коннекторы → MariaDB или MySQL unixODBC драйвер
    MariaDB коннектор → MariaDB unixODBC драйвер
    MySQL коннектор → MySQL unixODBC драйвер

Пожалуйста, обратитесь к ZBX-7665 для получения более подробных сведений и вариантов обходных решений.

  • Данные XML, запрошенные с Microsoft SQL Server, могут обрезаться различными способами на Linux и UNIX системах.

  • Было замечено, что использование ODBC проверок для мониторинга баз данных Oracle с использованием различных версий Oracle Instant Client for Linux приводит к аварийной остановке Zabbix сервера. Смотрите также ZBX-18402, ZBX-20803.

  • При использовании драйвера UnixODBC FreeTDS, нужно SQL-запрос предварить утверждением 'SET NOCOUNT ON' (например: SET NOCOUNT ON DECLARE @strsql NVARCHAR(max) SET @strsql = ....). В противном случае элемент данных с типом "Монитор баз данных" в Zabbix при получении информации завершится ошибкой "SQL query returned empty result".
    Обратитесь к ZBX-19917 для получения более подробной информации.

Некорректный параметр метода запроса в элементах данных

Параметр метода запроса, используемый только в HTTP проверках, может быть некорректным образом задан значением '1', значением не по умолчанию для всех элементов данных в результате обновления с версии pre-4.0 Zabbix. Для получения более подробных сведений по устранению данной ситуации смотрите ZBX-19308.

Веб-мониторинг и HTTP агент

Zabbix сервер имеет утечку памяти на некоторых дистрибутивах Linux по причине ошибки в библиотеке при включенной опции "Проверка SSL узла" в веб-сценариях или HTTP агенте. Пожалуйста, обратитесь к ZBX-10486 для получения более подробной информации и возможных вариантов решения.

Простые проверки

Имеется проблема в утилите fping версий до v3.10, которые некорректно обрабатывают дубликаты ответных echo пакетов. Такое поведение может вызывать неожиданные результаты в элементах данных icmpping, icmppingloss, icmppingsec. Рекомендуется использовать последнюю версию fping. Пожалуйста, обратитесь к ZBX-11726 для получения более подробной информации.

Errors with fping execution in rootless containers

When containers are running in rootless mode or in a specific-restrictions environment, you may face errors related to fping execution when performing ICMP checks, such as fping: Operation not permitted or all packets to all resources lost.

To fix this problem add --cap-add=net_raw to "docker run" or "podman run" commands.

Additionally fping execution in non-root environments may require sysctl modification, i.e.:

sudo sysctl -w "net.ipv4.ping_group_range=0 1995"

where "1995" is the zabbix GID. For more details, see ZBX-22833.

SNMP проверки

При использовании операционной системы OpenBSD, проблема использования памяти после освобождения памяти в библиотеке Net-SNMP вплоть до версии 5.7.3 может привести к аварийной остановке сервера Zabbix, если в файле конфигурации сервера Zabbix указан параметр SourceIP. Как временное решение, пожалуйста, не задавайте параметр SourceIP. Эта проблема также применима и к Linux, но она не приводит к остановке работы сервера Zabbix. К пакету net-snmp применен локальный патч на OpenBSD и будет выпущен с версией OpenBSD 6.3.

Резкие скачки в SNMP данных

Наблюдались резкие скачки в SNMP данных, которые могут быть связаны с определенными физическими факторами, такими как скачки напряжения в сети. Смотрите ZBX-14318 для получения более подробной информации.

SNMP трапы

Пакет "net-snmp-perl", требуемый для SNMP трапов, удален в RHEL 8.0-8.2; добавлен повторно в RHEL 8.3.

Таким образом, если вы используете RHEL 8.0-8.2, лучшим решением будет обновление до RHEL 8.3.

Пожалуйста, также просмотрите ZBX-17192 для получения более подробной информации.

Сбой в процессе alerter в RHEL 7

В RHEL 7 обнаружены случаи сбоя в процессах alerter сервера Zabbix. Пожалуйста, обратитесь к ZBX-10461 для получения более подробной информации.

Обновление Zabbix агента 2 (6.0.5 или более старого)

При обновлении Zabbix агента 2 (версии 6.0.5 или старше) из пакетов может возникнуть ошибка конфликта файлов, связанных с плагином. Чтобы исправить ошибку, сделайте резервную копию конфигурации агента 2 (если необходимо), деинсталируйте агент 2 и установите заново.

На системах на базе RHEL выполните:

dnf remove zabbix-agent2
       dnf install zabbix-agent2

На системах на базе Debian выполните:

apt remove zabbix-agent2
       apt install zabbix-agent2

Для более подробной информации обратитесь к ZBX-23250[en].

Переключение локалей в веб-интерфейсе

Было замечено, что локали в веб-интерфейсе могут переключаться без какой-либо явной логики, то есть некоторые страницы (или части страниц) отображаются на одном языке, тогда как другие страницы (или части страниц) -- на другом. Обычно такая проблема может возникнуть, когда имеется несколько пользователей, некоторые из которых используют одну локаль, в то время как другие используют другую локаль.

Известный вариант решения такой проблемы - отключение многопоточности в PHP и Apache.

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

Для получения более подробной информации смотрите соответствующие отчеты о проблеме:

  • ZBX-10911 (Проблема с переключением локалей в веб-интерфейсе)
  • ZBX-16297 (Проблема с обработкой чисел в графиках с использованием функции bcdiv из функций BC Math)

Конфигурация opcache в PHP 7.3

Если "opcache" включен в конфигурации PHP 7.3, Zabbix веб-интерфейс может отображать пустой экран при первой загрузке. Это известная проблема PHP. Как вариант решения этой проблемы, пожалуйста, задайте параметр "opcache.optimization_level" значением 0x7FFFBFDF в конфигурации PHP (файл php.ini).

Графики

Летнее время

Переходы на Летнее время (DST) приводят к нарушению отображения подписей к оси X (дублирование данных, отсутствие данных и т.п.).

Агрегирование в виде суммы

При использовании агрегирования в виде суммы в графике за период менее одного часа, графики отображают некорректные (размноженные) значения, когда данные поступают из динамики изменений.

Мониторинг файлов журналов

Элементы данных log[] и logrt[] многократно перечитывают файл журнала с самого начала, если файловая система заполнена на 100% и файл журнала продолжает заполняться (смотрите ZBX-10884 для получения более подробной информации).

Медленные запросы MySQL

Zabbix сервер генерирует медленные SELECT запросы в случае несуществующих значений у элементов данных. Это обусловлено известной проблемой в MySQL версий 5.6/5.7. Решением такой проблемы является отключение параметра index_condition_pushdown оптимизатора в MySQL. Для обсуждения этой проблемы обратитесь к ZBX-10652.

Медленная синхронизация конфигурации с Oracle

В инсталяциях Zabbix 6.0 с базой данных Oracle, имеющих большое количество элементов данных и шагов предобрабротки элементов данных, синхронизация конфигурации может быть медленной. Причиной этого является скорость обработки полей типа nclob механизмом СУБД Oracle.

Для улучшения производительности Вы можете сконвертировать типы полей из nclob в nvarchar2 путём применения вручную патча для базы данных items_nvarchar_prepare.sql. Обратите внимание, что такое преобразование сократит ограничение максимального размера поля с 65535 байт до 4000 байт для параметров предобработки элементов данных и параметров элементов данных - таких как Описание, поле Скрипт у элементов данных типа "Скрипт", поля Тело запроса и Заголовки у элементов данных типа "HTTP агент", поле SQL запрос у элемента данных типа "Монитор баз данных". Запросы для определения имён шаблонов, которые нужно удалить перед применением патча, представлены в патче в виде комментария. Как альтернатива, если выставлено MAX_STRING_SIZE, Вы можете поменять nvarchar2(4000) на nvarchar2(32767) в запросе патча, чтобы выставить ограничение размера поля 32767 байт.

Для подробного обсуждения смотрите ZBX-22363.

API login

У пользователя может быть создано большое количество открытых сессий при использовании пользовательских скриптов с методом user.login без последующего использования user.logout.

Проблема с IPv6 адресами в SNMPv3 трапах

По причине проблемы в net-snmp, в SNMP трапах IPv6 адреса могут некорректно отображаться при использовании SNMPv3. Для получения более подробной информации и возможных вариантах решения смотрите ZBX-14541.

Урезание длинных IP адресов IPv6 в информации о неуспешном входе в систему

Сообщение об ошибочном входе в систему отобразит только первые 39 символов сохранённого IP адреса, так как это ограничение длины поля базы данных. Это означает, что IP адреса IPv6 длиннее 39 символов будут отображаться не полностью.

Проверки Zabbix агент на Windows

Несуществующие записи DNS в параметре Server в файле конфигурации Zabbix агента (zabbix_agentd.conf) могут повысить время ответа Zabbix агента на Windows. Такое случается по причине того, что демон Windows DNS кэширования не кэширует отрицательные ответы по IPv4 адресам. Однако, для IPv6 адресов отрицательные ответы кэшируются; таким образом, возможным вариантом решения будет отключение IPv4 на хосте.

Экспорт / импорт YAML

Имеются несколько известных проблем, связанных с экспортом / импортом YAML:

  • Сообщения об ошибках не поддаются переводу;
  • Валидный JSON с расширением файла .yaml иногда не удается импортировать;
  • Не заключенные в кавычки привычные человеку даты автоматически конвертируются в штампы времени в формате Unix.

Мастер установки в SUSE с NGINX и php-fpm

Мастер установки веб-интерфейса не в состоянии сохранить файл конфигурации в SUSE с NGINX + php-fpm. Эта проблема вызвана настройкой в /usr/lib/systemd/system/php-fpm.service юните, который не позволяет Zabbix выполнять запись в /etc. (введено в PHP 7.4).

Доступно два варианта решения:

  • Задать ProtectSystem опции значение 'true' вместо 'full' в php-fpm юните systemd.
  • Вручную сохранить /etc/zabbix/web/zabbix.conf.php файл.

Chromium для веб-сервиса Zabbix в Ubuntu 20

Хотя в большинстве случаев веб-сервис Zabbix может работать с Chromium, в Ubuntu 20.04 использование Chromium приводит к следующей ошибке:

Cannot fetch data: chrome failed to start:cmd_run.go:994:
       WARNING: cannot create user data directory: cannot create 
       "/var/lib/zabbix/snap/chromium/1564": mkdir /var/lib/zabbix: permission denied
       Sorry, home directories outside of /home are not currently supported. See https://forum.snapcraft.io/t/11209 for details.

Эта ошибка возникает из-за того, что в качестве домашней директории пользователя 'zabbix' используется /var/lib/zabbix.

Специальные коды ошибок MySQL

Если Zabbix используется с MySQL инсталляцией в Azure, в журналах Zabbix может появиться расплывчатое сообщение об ошибке [9002] Some errors occurred. Этот общий текст ошибки отправляется Zabbix серверу или прокси со стороны базы данных. Для получения более подробных сведений о причине возникновения такой ошибки обратитесь к журналам Azure.

Ошибочные регулярные выражения после переключения на PCRE2

В Zabbix 6.0 добавлена поддержка PCRE2. Хотя PCRE по-прежнему поддерживается, установочные пакеты Zabbix для RHEL 7 и новее, SLES (всех версий), Debian 9 и новее, Ubuntu 16.04 и новее были обновлены и теперь используют PCRE2. Несмотря на множество преимуществ, переход на PCRE2 может привести к тому, что существующие шаблоны регулярных выражений PCRE станут ошибочными или изменят свое поведение. В частности, это изменение затрагивает шаблон ^[\w-\.]. Чтобы сделать это регулярное выражение снова корректным, не затрагивая семантику, измените выражение на ^[-\w\.] . Такая проблема происходит из-за того, что PCRE2 рассматривает символ тире как разделитель, при этом создавая диапазон внутри класса символов. Обновлены следующие установочные пакеты Zabbix, теперь они используют PCRE2: RHEL 7 и новее, SLES (все версии), Debian 9 и новее, Ubuntu 16.04 и новее.

Geomap widget error

The maps in the Geomap widget may not load correctly, if you have upgraded from an older Zabbix version with NGINX and didn't switch to the new NGINX configuration file during the upgrade.

To fix the issue, you can discard the old configuration file, use the configuration file from the current version package and reconfigure it as described in the download instructions in section e. Configure PHP for Zabbix frontend.

Alternatively, you can manually edit an existing NGINX configuration file (typically, /etc/zabbix/nginx.conf). To do so, open the file and locate the following block:

location ~ /(api\/|conf[^\.]|include|locale|vendor) {
               deny            all;
               return          404;
       }

Then, replace this block with:

location ~ /(api\/|conf[^\.]|include|locale) {
               deny            all;
               return          404;
       }
       
       location /vendor {
               deny            all;
               return          404;
       }

Logrotate for Zabbix server and proxy

In Zabbix versions 6.4.3 and older, logrotate is only included into packages for zabbix-agent, zabbix-agent2 and zabbix-web-service, but needs to be installed separately for Zabbix server and proxy. The logrotate dependency has been added to the server and proxy packages for RHEL and SUSE starting from Zabbix 6.4.4rc1.

Missing files in Windows agent archive

The Windows Zabbix agent download ZIP file is missing zabbix_sender.h and zabbix_sender.lib files in versions 6.4.0-6.4.12, required for zabbix_sender.dll.

Server/proxy compatibility issue in 6.4.12

Zabbix server 6.4.12 and Zabbix proxy 6.4.12 are not compatible with other versions of proxy/server. If either server or proxy is 6.4.12, then both server and proxy must be 6.4.12.

This issue is fixed in 6.4.13 and later. However, while the following releases are compatible with 6.4.11 server/proxy (or sooner); they are still not compatible with 6.4.12 server/proxy.