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. :::
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:
Для версий MySQL 8.0.0 - 8.0.13:
Версии PostgreSQL 9.6-12 используют слишком много памяти при обновлении таблиц с большим количеством секций (смотрите отчет о проблеме). Эта проблема проявляет себя, когда Zabbix выполняет обновление динамики изменений на системах с TimescaleDB, в случае если таблицы динамики изменений разбиты на относительно маленькие фрагменты (например, по 1 дню). Это приводит к тому, что в таблицах динамики изменений присутствуют сотни фрагментов при настройках очистки истории по умолчанию - состояние, при котором PostgreSQL скорее всего может исчерпать всю оперативную память.
Эта проблемы решена, начиная с Zabbix 5.0.1 для новых инсталляций с TimescaleDB, но если TimescaleDB был сконфигурирован с Zabbix до этого момента, пожалуйста обратитесь к ZBX-16347 за информацией по процессу миграции.
Эта проблема проявляет себя при использовании TimescaleDB 2.5.0. Она была решена, начиная с TimescaleDB 2.5.1.
Для получения более подробной информации, пожалуйста обратитесь к TimescaleDB Issue #3773.
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).
Обновление Zabbix может завершится с ошибкой, если таблицы базы данных были созданы с MariaDB версии 10.2.1 и старше, так как в этих версиях по умолчанию используется компактный формат строк. Такая проблема исправляется изменением формата строк на динамический формат (смотрите также ZBX-17690).
In dual-stack environments (systems configured to support both IPv4 and IPv6), the hostname localhost
typically resolves to both IPv4 and IPv6 addresses. Due to the common prioritization of IPv6 over IPv4 by many operating systems and DNS resolvers, Zabbix templates may fail to work correctly if the service being monitored is configured to listen only on IPv4.
Services that are not configured to listen on IPv6 addresses may become inaccessible, leading to monitoring failures. Users might configure access correctly for IPv4 but still face connectivity issues due to the default behavior of prioritizing IPv6.
A workaround for this is to ensure that the services (Nginx, Apache, PostgreSQL, etc.) are configured to listen on both IPv4 and IPv6 addresses, and Zabbix server/agent is allowed access via IPv6. Additionally, in Zabbix templates and configurations, use localhost
explicitly instead of 127.0.0.1
to ensure compatibility with both IPv4 and IPv6.
For example, when monitoring PostgreSQL with the PostgreSQL by Zabbix agent 2 template, you may need to edit the pg_hba.conf
file to allow connections for the zbx_monitor
user. If the dual-stack environment prioritizes IPv6 (system resolves localhost to ::1
) and you configure localhost
but only add an IPv4 entry (127.0.0.1/32
), the connection will fail because there is no matching IPv6 entry.
The following pg_hba.conf
file example ensures that the zbx_monitor
user can connect to any database from the local machine using both IPv4 and IPv6 addresses with different authentication methods:
# TYPE DATABASE USER ADDRESS METHOD
host all zbx_monitor localhost trust
host all zbx_monitor 127.0.0.1/32 md5
host all zbx_monitor ::1/128 scram-sha-256
If necessary, you can also use the IPv4 address (127.0.0.1
) directly when configuring the PostgreSQL by Zabbix agent 2 template macro for the connection string.
With EPEL repository installed and enabled, installing Zabbix from packages will lead to EPEL Zabbix packages being installed rather than official Zabbix packages.
In this case uninstall Zabbix packages from EPEL, i.e.:
Block Zabbix packages from EPEL. Add the following line in the /etc/yum.conf
file:
Install Zabbix server again:
Notice that official Zabbix packages have the word release
in their version string:
When installing Zabbix from Red Hat Enterprise Linux packages on Red Hat Universal Base Image environments, ensure access to required repositories and dependencies. Zabbix packages depend on libOpenIPMI.so
and libOpenIPMIposix.so
libraries, which are not provided by any package in the default package manager repositories enabled on UBI systems and will result in installation failures.
The libOpenIPMI.so
and libOpenIPMIposix.so
libraries are available in the OpenIPMI-libs
package, which is provided by the redhat-#-for-<arch>-appstream-rpms
repository. Access to this repository is curated by subscriptions, which, in the case of UBI environments, get propagated by mounting repository configuration and secrets directories of the RHEL host into the container file-system namespace.
For more information, see ZBX-24291.
When upgrading Zabbix on Red Hat Enterprise Linux, you may encounter an expired signing key issue for packages on Zabbix repository. When a signing key expires, attempts to verify package signatures will result in an error indicating that the certificate or key is no longer valid. For example:
error: Verifying a signature using certificate D9AA84C2B617479C6E4FCF4D19F2475308EFA7DD (Zabbix LLC (Jul 2022) <[email protected]>):
1. Certificiate 19F2475308EFA7DD invalid: certificate is not alive
because: The primary key is not live
because: Expired on 2024-07-04T11:41:23Z
2. Key 19F2475308EFA7DD invalid: key is not alive
because: The primary key is not live
because: Expired on 2024-07-04T11:41:23Z
To resolve such issues, manually reinstall the latest zabbix-release
package for your specific variant of RHEL (replace the link below with the correct one from Zabbix repository).
For example, on RHEL 9, run:
Then, update the repository information:
For more information, see ZBX-24761.
При использовании MariaDB подключение TLS к базе данных не поддерживается с опцией 'verify_ca' для параметра DBTLSConnect.
При работе под высокой нагрузкой и использовании более одного процесса LLD worker, возможно возникновение взаимных блокировок (deadlocks), вызванных ошибкой InnoDB, относящейся к стратегии блокировок строк (см. upstream bug). Ошибка была исправлена в MySQL, начиная с версии 8.0.29, но не в MariaDB. Для более подробной информации, обратитесь к ZBX-21506.
События могут не коррелироваться должным образом, если промежуток времени между первым и вторым событием очень мал, то есть полсекунды и менее.
PostgreSQL версии 11 и старше поддерживают значения с дробной точкой только в диапазоне приблизительно от -1.34E-154 до 1.34E+154.
Различные процессы Zabbix могут случайным образом аварийно завершать работу при запуске на NetBSD версий 8.X и 9.X. Такое поведение связано со слишком малым размером стека по умолчанию (4МБ), который необходимо увеличить, выполнив:
Для получения более подробной информации, пожалуйста, обратитесь к соответствующему отчету о проблеме: ZBX-18275.
Zabbix agent 2 does not support lookaheads and lookbehinds in regular expressions due to the standard Go regexp library limitations.
IPMI проверки не будут работать со стандартным пакетом библиотеки OpenIPMI на Debian до 9 (stretch) версии и Ubuntu до 16.04 (xenial). Чтобы исправить проблему, пересоберите OpenIPMI библиотеку с включенным OpenSSL, как обсуждалось в ZBX-6139.
Некоторые дистрибутивы 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 для получения подробной информации.
Драйвер 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.
Zabbix сервер имеет утечку памяти на некоторых дистрибутивах Linux по причине ошибки в библиотеке при включенной опции "Проверка SSL узла" в веб-сценариях или HTTP агенте. Пожалуйста, обратитесь к ZBX-10486 для получения более подробной информации и возможных вариантов решения.
Имеется проблема в утилите fping версий до v3.10, которые некорректно обрабатывают дубликаты ответных echo пакетов. Такое поведение может вызывать неожиданные результаты в элементах данных icmpping, icmppingloss, icmppingsec. Рекомендуется использовать последнюю версию fping. Пожалуйста, обратитесь к ZBX-11726 для получения более подробной информации.
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.:
where "1995" is the zabbix GID. For more details, see ZBX-22833.
При использовании операционной системы OpenBSD, проблема использования памяти после освобождения памяти в библиотеке Net-SNMP вплоть до версии 5.7.3 может привести к аварийной остановке сервера Zabbix, если в файле конфигурации сервера Zabbix указан параметр SourceIP. Как временное решение, пожалуйста, не задавайте параметр SourceIP. Эта проблема также применима и к Linux, но она не приводит к остановке работы сервера Zabbix. К пакету net-snmp применен локальный патч на OpenBSD и будет выпущен с версией OpenBSD 6.3.
Наблюдались резкие скачки в SNMP данных, которые могут быть связаны с определенными физическими факторами, такими как скачки напряжения в сети. Смотрите ZBX-14318 для получения более подробной информации.
Пакет "net-snmp-perl", требуемый для SNMP трапов, удален в RHEL 8.0-8.2; добавлен повторно в RHEL 8.3.
Таким образом, если вы используете RHEL 8.0-8.2, лучшим решением будет обновление до RHEL 8.3.
Пожалуйста, также просмотрите ZBX-17192 для получения более подробной информации.
В RHEL 7 обнаружены случаи сбоя в процессах alerter сервера Zabbix. Пожалуйста, обратитесь к ZBX-10461 для получения более подробной информации.
При обновлении Zabbix агента 2 (версии 6.0.5 или старше) из пакетов может возникнуть ошибка конфликта файлов, связанных с плагином. Чтобы исправить ошибку, сделайте резервную копию конфигурации агента 2 (если необходимо), деинсталируйте агент 2 и установите заново.
На системах на базе RHEL выполните:
На системах на базе Debian выполните:
Для более подробной информации обратитесь к ZBX-23250[en].
Было замечено, что локали в веб-интерфейсе могут переключаться без какой-либо явной логики, то есть некоторые страницы (или части страниц) отображаются на одном языке, тогда как другие страницы (или части страниц) -- на другом. Обычно такая проблема может возникнуть, когда имеется несколько пользователей, некоторые из которых используют одну локаль, в то время как другие используют другую локаль.
Известный вариант решения такой проблемы - отключение многопоточности в PHP и Apache.
Эта проблема связана с тем, как локали работают в PHP: информация о локали сохраняется по каждому процессу, а не по потоку. Поэтому в многопоточной среде, где несколько проектов выполняются одним и тем же процессом Apache, имеется вероятность, что локаль меняется в другом потоке, что меняет способ обработки данных в потоке Zabbix.
Для получения более подробной информации смотрите соответствующие отчеты о проблеме:
bcdiv
из функций BC Math)Если "opcache" включен в конфигурации PHP 7.3, Zabbix веб-интерфейс может отображать пустой экран при первой загрузке. Это известная проблема PHP. Как вариант решения этой проблемы, пожалуйста, задайте параметр "opcache.optimization_level" значением 0x7FFFBFDF в конфигурации PHP (файл php.ini).
Переходы на Летнее время (DST) приводят к нарушению отображения подписей к оси X (дублирование данных, отсутствие данных и т.п.).
При использовании агрегирования в виде суммы в графике за период менее одного часа, графики отображают некорректные (размноженные) значения, когда данные поступают из динамики изменений.
Элементы данных log[]
и logrt[]
многократно перечитывают файл журнала с самого начала, если файловая система заполнена на 100% и файл журнала продолжает заполняться (смотрите ZBX-10884 для получения более подробной информации).
Zabbix сервер генерирует медленные SELECT запросы в случае несуществующих значений у элементов данных. Это обусловлено известной проблемой в MySQL версий 5.6/5.7. Решением такой проблемы является отключение параметра index_condition_pushdown оптимизатора в MySQL. Для обсуждения этой проблемы обратитесь к ZBX-10652.
В инсталяциях 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.
У пользователя может быть создано большое количество открытых сессий при использовании пользовательских скриптов с методом user.login
без последующего использования user.logout
.
По причине проблемы в net-snmp, в SNMP трапах IPv6 адреса могут некорректно отображаться при использовании SNMPv3. Для получения более подробной информации и возможных вариантах решения смотрите ZBX-14541.
Сообщение об ошибочном входе в систему отобразит только первые 39 символов сохранённого IP адреса, так как это ограничение длины поля базы данных. Это означает, что IP адреса IPv6 длиннее 39 символов будут отображаться не полностью.
Несуществующие записи DNS в параметре Server
в файле конфигурации Zabbix агента (zabbix_agentd.conf) могут повысить время ответа Zabbix агента на Windows. Такое случается по причине того, что демон Windows DNS кэширования не кэширует отрицательные ответы по IPv4 адресам. Однако, для IPv6 адресов отрицательные ответы кэшируются; таким образом, возможным вариантом решения будет отключение IPv4 на хосте.
Имеются несколько известных проблем, связанных с экспортом / импортом YAML:
Мастер установки веб-интерфейса не в состоянии сохранить файл конфигурации в SUSE с NGINX + php-fpm. Эта проблема вызвана настройкой в /usr/lib/systemd/system/php-fpm.service юните, который не позволяет Zabbix выполнять запись в /etc. (введено в PHP 7.4).
Доступно два варианта решения:
Хотя в большинстве случаев веб-сервис 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
.
Если Zabbix используется с MySQL инсталляцией в Azure, в журналах Zabbix может появиться расплывчатое сообщение об ошибке [9002] Some errors occurred. Этот общий текст ошибки отправляется Zabbix серверу или прокси со стороны базы данных. Для получения более подробных сведений о причине возникновения такой ошибки обратитесь к журналам Azure.
В 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 и новее.
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:
Then, replace this block with:
location ~ /(api\/|conf[^\.]|include|locale) {
deny all;
return 404;
}
location /vendor {
deny all;
return 404;
}
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.
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.
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.
As global variables are shared across different webhook calls, the following code will result in the tag value counter gradually increasing:
try
{
aa = aa + 1;
}
catch(e)
{
aa = 0;
}
result = {
'tags': {
'endpoint': aa
}
};
return JSON.stringify(result);
Using local variables instead of global ones is recommended to make sure that each script operates on its own data and that there are no collisions between simultaneous calls.