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

Запуск прокси с 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';

. #### Installation from packages

It has been observed that it is impossible to install a specific frontend version by running, e.g.:

yum install -v zabbix-web-mysql-scl-5.0.0

As a workaround to this issue, if you wish to install a specific frontend version, specify version for all components, e.g.:

yum install zabbix-web-mysql-scl-5.0.0 zabbix-apache-conf-scl-5.0.0 zabbix-web-5.0.0 zabbix-web-deps-scl-5.0.0

Zabbix packages for RHEL on Red Hat UBI environments

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.

Expired signing key for RHEL/CentOS packages

When upgrading Zabbix on Red Hat Enterprise Linux/CentOS, 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/CentOS (replace the link below with the correct one from Zabbix repository).

For example, on RHEL/CentOS 8, run:

rpm -Uvh https://repo.zabbix.com/zabbix/5.0/rhel/8/x86_64/zabbix-release-latest.el8.noarch.rpm

Then, update the repository information:

yum update

For more information, see ZBX-24761.

Timescale DB

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

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

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

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

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

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

Диапазон числовых типов данных с плавающей запятой в PostgreSQL 11 и ранее

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

Possible deadlocks with MySQL/MariaDB

When running under high load, and with more than one LLD worker involved, it is possible to run into a deadlock caused by an InnoDB error related to the row-locking strategy (see upstream bug). The error has been fixed in MySQL since 8.0.29, but not in MariaDB. For more details, see ZBX-21506.

Проверки IPMI checks

IPMI проверки

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

SSH проверки

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

ODBC проверки

Zabbix сервер или прокси, которые используют MySQL в качестве своей базы данных могут или не могут корректно работать с библиотекой MySQL ODBC в связи с общей проблемой. Пожалуйста, просмотрите ZBX-7665 для получения более подробной информации и возможных способах решения проблемы.

XML данные запрашиваемые с Microsoft SQL сервера могут быть обрезары до 2033 по причине проблемы в Microsoft.

HTTPS проверки

Веб-сценарии и HTTP агент использующие https протокол, Zabbix агент проверки net.tcp.service[https...] и net.tcp.service.perf[https...] могут завершиться неудачей, если целевой сервер настроен на запрет протокола TLS v1.0 или ниже. Пожалуйста, просмотрите ZBX-9879 для получения более подробной информации и возможных способах решения проблемы.

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

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

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

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

Скачки данных SNMP

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

Сбой процесса оповещения в Centos/RHEL 7

В Centos/RHEL 7 были обнаружены отдельные случаи сбоя процесса оповещения сервера Zabbix. Подробности см. в ZBX-10461.

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.

Компиляция Zabbix агента на HP-UX

Если вы установите библиотеку PCRE с популярного сайта пакетов HP-UX http://hpux.connect.org.uk, например из файла «pcre-8.42-ia64_64-11.31.depot», вы получите только 64-битовую версию библиотеки, установленной в каталоге /usr/local/lib/hpux64. В этом случае для успешной компиляции агента необходимо использовать настраиваемые параметры для скрипта "configure", например:

CFLAGS="+DD64" ./configure --enable-agent --with-libpcre-include=/usr/local/include --with-libpcre-lib=/usr/local/lib/hpux64

Изменение локалей веб-интерфейса

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

Известный обходной путь - отключить многопоточность в PHP и Apache.

Проблема связана с тем, как работает настройка локали in 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 (дублирование данных, пропущенная дата и так далее).

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

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

API

Параметр output работает некорректно с методом history.get.

API login

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

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

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

Обрезанный длинный IPv6 IP-адрес в информации о неудачной попытке входа

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

Permission checks for dashboards with graphs

If SVG graphs are used in Zabbix dashboards, Zabbix frontend may generate non-optimized API queries when checking user permissions to hosts and items. This is happening because such searches support wildcards and case-insensitive name matching.

To improve performance of SQL statements, manually apply the patch index_host_and_item_name_upper_field.sql provided in Zabbix 5.0.31 and newer.

For MySQL, run:

shell> mysql -uzabbix -p<password> zabbix < index_host_and_item_name_upper_field.sql

For PostgreSQL, run:

shell> cat index_host_and_item_name_upper_field.sql | sudo -u zabbix psql zabbix

For Oracle, run:

sqlplus> @index_host_and_item_name_upper_field.sql

Creation of deterministic triggers should be enabled for the time of patch application. On MySQL and MariaDB, this requires GLOBAL log_bin_trust_function_creators = 1 to be set if binary logging is enabled and there is no superuser privileges and log_bin_trust_function_creators = 1 is not set in MySQL configuration file. To set the variable using MySQL console, run:

mysql> SET GLOBAL log_bin_trust_function_creators = 1;

Once the patch has been successfully applied, log_bin_trust_function_creators can be disabled:

mysql> SET GLOBAL log_bin_trust_function_creators = 0;

Triggers are also created for PostgreSQL and Oracle database.

Non-existing item value retrieval with MySQL 5.6/5.7

Zabbix server generates slow select queries in case of non-existing values for items. This is caused by a known issue in MySQL 5.6/5.7 versions. A workaround to this is disabling the index_condition_pushdown optimizer in MySQL. For an extended discussion, see ZBX-10652.

Slow event info retrieval with older MySQL databases

Zabbix 5.0 installations with MySQL 5.X and 8.0.19 might run a slow query when retrieving problem/event information from the database. In particular, this affects the Problems by severity widget, event.get and problem.get API methods. To improve performance of SQL statements, apply the patch provided in ZBX-18080 (available for Zabbix 5.0.4 and newer).

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

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

Persistent filter settings from links

When opening a link to Zabbix frontend page that contains filter settings, including the time selector, the filter is automatically saved in the database for the user, replacing the previously saved filter and/or time selector settings for that page. These settings remain active until the user manually updates or resets them.

IPv6 address issue in SNMPv3 traps

Due to a net-snmp bug, IPv6 address may not be correctly displayed when using SNMPv3 in SNMP traps. For more details and a possible workaround, see ZBX-14541.

Trimmed long IPv6 IP address in failed login information

Failed login attempt message will display only the first 39 characters of a stored IP address as that's the character limit in the database field. That means that IPv6 IP addresses longer than 39 characters will be shown incompletely.

Zabbix agent checks on Windows

Non-existing DNS entries in a Server parameter of Zabbix agent configuration file (zabbix_agentd.conf) may increase Zabbix agent response time on Windows. This happens because Windows DNS caching daemon doesn't cache negative responses for IPv4 addresses. However, for IPv6 addresses negative responses are cached, so a possible workaround to this is disabling IPv4 on the host.

Setup wizard on SUSE with NGINX and php-fpm

Frontend setup wizard cannot save configuration file on SUSE with NGINX + php-fpm. This is caused by a setting in /usr/lib/systemd/system/php-fpm.service unit, which prevents Zabbix from writing to /etc. (introduced in PHP 7.4).

There are two workaround options available:

• Set the ProtectSystem option to 'true' instead of 'full' in the php-fpm systemd unit.
• Manually save /etc/zabbix/web/zabbix.conf.php file.

MySQL custom error codes

If Zabbix is used with MySQL installation on Azure, an unclear error message [9002] Some errors occurred may appear in Zabbix logs. This generic error text is sent to Zabbix server or proxy by the database. To get more information about the cause of the error, check Azure logs.

Use case with global variables shared across webhook calls

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.