8 Problemas conhecidos

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. :::

Verificações IPMI

As verificações IPMI não irão funcionar com a biblioteca padrão do Debian/Ubuntu. Para ajustar isso recompile a biblioteca OpenIPMI habilitando o OpenSSL, conforme discutido em ZBX-6139.

Verificações SSH

Algumas distribuições Linux como o Debian e Ubuntu não suportam chaves privadas criptografadas (com frase) se a biblioteca libssh2 for instalada a partir dos pacotes. Favor consultar ZBX-4850 para mais detalhes.

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).

Verificações ODBC

O Zabbix Server ou Zabbix Proxy que utilizar o MySQL como seu banco de dados poderá não funcionar corretamente com a biblioteca ODBC para MySQL devido a um BUG de envio de dados. Favor consultar ZBX-7665 para mais detalhes e alternativas disponíveis.

Templates

Template compatibility in dual-stack (IPv4/IPv6) environments

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.

Accidental installation of EPEL Zabbix packages

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.:

dnf remove zabbix-server-mysql

Block Zabbix packages from EPEL. Add the following line in the /etc/yum.conf file:

exclude=zabbix6.4*

Install Zabbix server again:

dnf install zabbix-server-mysql

Notice that official Zabbix packages have the word release in their version string:

6.4.10-release1.el8

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 packages

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:

rpm -Uvh https://repo.zabbix.com/zabbix/6.4/rhel/9/x86_64/zabbix-release-latest.el9.noarch.rpm

Then, update the repository information:

dnf update

For more information, see ZBX-24761.

Verificações HTTPS

Cenários web utilizando o protocolo HTTPS e as verificações de agente ​net.tcp.service[https...]​ e ​net.tcp.service.perf[https...]​ poderão falhar se o servidor de destino estiver configurado para não permitir o protocolo TLS em versão v1.0 ou anterior. ​ Consulte ZBX-9879 para maiores informações sobre alternativas disponíveis.

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.

Gráficos

Modificações no horário de verão (DST) poderão resultar em irregularidades ao apresentar as legendas do eixo X (duplicação de datas, datas ausentes, etc).

Intervalo do tipo Numeric (float) com PostgreSQL 11 ou anterior

PostgreSQL 11 e versões anteriores suportam valores de ponto flutuante apenas no intervalo aproximado de -1.34E-154 a 1.34E+154.

NetBSD 8.0 e mais recente

Vários processos do Zabbix podem quebrar aleatoriamente na inicialização nas versões NetBSD 8.X e 9.X. Isto se deve ao valor padrão de stack ser muito pequeno (4MB), o qual deve ser aumentado executando:

ulimit -s 10240

Para mais informações, por favor consulte o relatório de problema associado: 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.

Verificações IPMI

As verificações IPMI não funcionarão com o pacote de biblioteca padrão OpenIPMI no Debian anterior a 9 (stretch) e Ubuntu anterior a 16.04 (xenial). Para corrigir isto, recompile a biblioteca OpenIPMI com OpenSSL habilitado conforme discutido em ZBX-6139.

SSH checks

• Some Linux distributions like Debian, Ubuntu do not support encrypted private keys (with passphrase) if the libssh2 library is installed from packages. Please see ZBX-4850 for more details.

• When using libssh 0.9.x on CentOS 8 with OpenSSH 8 SSH checks may occasionally report "Cannot read data from SSH server". This is caused by a libssh issue (more detailed report). The error is expected to have been fixed by a stable libssh 0.9.5 release. See also ZBX-17756 for details.

• Using the pipe "|" in the SSH script may lead to a "Cannot read data from SSH server" error. In this case it is recommended to upgrade the libssh library version. See also ZBX-21337 for details.

Verificações ODBC

• O driver MySQL unixODBC não deve ser usado com Zabbix Server ou Zabbix Proxy compilados com biblioteca de conector MariaDB e vice-versa. Se possível é também melhor evitar usar o mesmo conector que o driver devido um bug de upstream. Configuração sugerida:

<!-- -->

PostgreSQL, SQLite or Oracle connector → MariaDB or MySQL unixODBC driver
MariaDB connector → MariaDB unixODBC driver
MySQL connector → MySQL unixODBC driver

Por favor consulte ZBX-7665 para mais informações e correções disponíveis.

• Dados XML consultados a partir de Microsoft SQL Server podem ficar truncados de várias formas nos sistemas Linux and UNIX.

<!-- -->

• Tem sido observado que o uso de verificações ODBC no CentOS 8 para monitoramento de banco de dados Oracle utilizando Oracle Instant Client para Linux 11.2.0.4.0 provoca quebra do Zabbix Server. Este problema pode ser resolvido pela atualização do Oracle Instant Client para 12.1.0.2.0, 12.2.0.1.0, 18.5.0.0.0 ou 19. Veja também ZBX-18402.

Parâmetro método de requisição incorreto nos itens

O parâmetro método de requisição, usado apenas em verificações HTTP, pode estar incorretamente configurado como '1', um valor não-padrão para todos os itens, como resultado da atualização a partir de uma versão pré-4.0 do Zabbix. Para detalhes em como corrigir esta situação, consulte ZBX-19308.

Monitoramento Web e agente HTTP

O Zabbix Server causa vazamento de memória (memory leak) no CentOS 6, CentOS 7 e possivelmente outras distribuições Linux relacionadas devido a um bug de upstream quando a opção "SSL verify peer" está habilitada nos cenários web ou agente HTTP. Por favor consulte ZBX-10486 para mais informações e correções disponíveis.

Verificações simples

Há um bug nas versões de fping anteriores a v3.10 que gerencia incorretamente pacote de resposta duplicados. Isto pode causar resultados inesperados para itens icmpping, icmppingloss e icmppingsec. É recomendado utilizar a versão mais recente do fping disponível. Por favor consulte ZBX-11726 para mais detalhes.

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.

Verificações SNMP

Se o sistema operacional OpenBSD é utilizado, um bug de corrompimento de memória (use-after-free) na biblioteca Net-SNMP até a versão 5.7.3 pode causar quebra do Zabbix Server se o parâmetro SourceIP estiver configurado no arquivo de configuração do Server. Como contingência, por favor não configure o parâmetro SourceIP. O mesmo problema se aplica também ao Linux, mas ele não causa a parada do Zabbix Server. Um pacote de correção local para o net-snmp no OpenBSD foi aplicado e será publicado com o OpenBSD 6.3.

Picos nos dados SNMP

Picos nos dados SNMP têm sido observados e podem estar relacionados a certos fatores físicos como picos de tensão na rede. Consulte ZBX-14318 para mais detalhes.

SNMP traps

O pacote "net-snmp-perl", necessário para SNMP traps, foi removido no RHEL/CentOS 8.0-8.2; readicionado no RHEL 8.3.

Então se você estiver usando o RHEL 8.0-8.2, a melhor solução é atualizar para RHEL 8.3; ou você pode utilizar um pacote do EPEL.

Por favor veja também o ZBX-17192 para mais informações.

Problema com processos de alerta no CentOS/RHEL 7

Problemas com instâncias do processo de alerta do Zabbix Server foram encontrados no CentOS/RHEL 7. Por favor consulte ZBX-10461 para detalhes.

Upgrading Zabbix agent 2 (6.0.5 or older)

When upgrading Zabbix agent 2 (version 6.0.5 or older) from packages, a plugin-related file conflict error may occur. To fix the error, back up your agent 2 configuration (if necessary), uninstall agent 2 and install it anew.

On RHEL-based systems, run:

dnf remove zabbix-agent2
dnf install zabbix-agent2

On Debian-based systems, run:

apt remove zabbix-agent2
apt install zabbix-agent2

For more information, see ZBX-23250.

Variação de idiomas (locales) no Frontend

Foi observado que as localizações (idiomas) do Frontend podem sofrer alteração sem lógica aparente, p.e. algumas páginas (ou partes delas) são mostradas em um idioma enquanto outras páginas (ou partes delas) são mostradas em um idioma diferente. Tipicamente o problema pode aparecer quanto há vários usuários, alguns dos quais utilizam um idioma, enquanto outros usam outro.

Uma contingência conhecida a este problema é desabilitar a função de multithreading no PHP e Apache.

O problema está relacionado a como as configurações de localização funcionam no PHP: informações de localização são mantidas por processo, não por thread. Assim, em um ambiente multi-thread, quando há vários projetos sendo executados pelo mesmo processo Apache, é possível que a localização seja modificada em outra thread e que isto afete como os dados podem ser processados na thread do Zabbix.

Para mais informações, por favor consulte os relatórios de problema relacionados:

• ZBX-10911 (Problema com troca de idiomas (locales) no Frontend)
• ZBX-16297 (Problema com processamento de número em gráficos usando a função bcdiv das funções BC Math)

Configuração opcache no PHP 7.3

Se "opcache" está habilitado na configuração do PHP 7.3, o Zabbix Frontend pode mostrar uma tela em branco quando carregado pela primeira vez. Este é um bug do PHP registrado. Para contornar este problema, por favor configure o parâmetro "opcache.optimization_level" para 0x7FFFBFDF no arquivo de configuração do PHP (arquivo php.ini).

Gráficos

Mudanças no horário de verão (DST) resultam em irregularidades ao apresentar as legendas do eixo X (duplicação de datas, datas ausentes, etc).

Monitoramento de arquivo de log

Os itens log[] e logrt[] releem repetidamente o arquivo de log desde o início se o sistema de arquivos estiver 100% ocupado e o arquivo de log estiver sendo anexado (veja ZBX-10884 para mais informações).

Consultas MySQL lentas

O Zabbix Server gera consultas de SELECT lentas no caso de valores de itens não existentes. Isto é causado por um problema conhecido nas versões MySQL 5.6/5.7. Uma contingência a este problema é desabilitar o otimizador index_condition_pushdown no MySQL. Para uma discussão mais extensa, consulte ZBX-10652.

Slow configuration sync with Oracle

Configuration sync might be slow in Zabbix 6.0 installations with Oracle DB that have high number of items and item preprocessing steps. This is caused by the Oracle database engine speed processing nclob type fields.

To improve performance, you can convert the field types from nclob to nvarchar2 by manually applying the database patch items_nvarchar_prepare.sql. Note that this conversion will reduce the maximum field size limit from 65535 bytes to 4000 bytes for item preprocessing parameters and item parameters such as Description, Script item's field Script, HTTP agent item's fields Request body and Headers, Database monitor item's field SQL query. Queries to determine template names that need to be deleted before applying the patch are provided in the patch as a comment. Alternatively, if MAX_STRING_SIZE is set you can change nvarchar2(4000) to nvarchar2(32767) in the patch queries to set the 32767 bytes field size limit.

For an extended discussion, see ZBX-22363.

Login na API

Um grande número de sessões de usuários abertas pode ser criado quando usando scripts customizados com o método user.login sem um user.logout em seguida.

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.

Problems com IPv6 em SNMPv3 traps

Devido um bug no net-snmp, endereços IPv6 podem não ser corretamente apresentados quando usando SNMPv3 nas SNMP traps. Para mais detalhes e uma possível contingência, consulte ZBX-14541.

Endereço IPv6 encurtado em falha de login

Uma tentiva de login falha mostrará apenas os primeiros 39 caracteres de um endereço IP armazenado pois este é o limite de caracteres no campo do banco de dados. Isto significa que endereços IPv6 com mais de 39 caracteres serão apresetados de forma incompleta.

Verificações do Zabbix Agent no Windows

Valores de DNS inexistentes configurados no parâmetro Server do arquivo de configuração do Zabbix Agent (zabbix_agentd.conf) podem elevar o tempo de resposta do Zabbix Agent no Windows. Isto ocorre porque o serviço de cache de DNS do Windows não armazena respostas negativas para endereços IPv4. No entando, para endereços IPv6 as respostas negativas são armazenadas, então uma possível contingência para este problema seja desabilitar o protocolo IPv4 na máquina.

Exportar/importar YAML

Há alguns problemas conhecidos com exportação/importação de YAML:

• Mensagens de erro não são traduzíveis;
• JSON válido com uma extensão de arquivo .yaml algumas vezes não pode ser importado;
• Formatos de data amigáveis não quotados (aspas) são automaticamente convertidos para formato Unix.

Assitente de instalação no SUSE com NGINX e php-fpm

O assistente de instalação do Frontend não pode salvar o arquivo de configuração no SUSE com NGINX + php-fpm. Isto é causado por uma configuração no serviço /usr/lib/systemd/system/php-fpm.service, que impede o Zabbix de gravar em /etc. (introduzido no PHP 7.4).

Há dois contornos disponíveis:

• Configure a opção ProtectSystem para 'true' em vez de 'full' na unidade systemd do php-fpm.
• Salve manualmente o arquivo /etc/zabbix/web/zabbix.conf.php.

Chromium para web service do Zabbix no Ubuntu 20

Apesar de em muitos casos o Zabbix Web Server poder rodar com Chromium, no Ubuntu 20.04 o uso do Chromium causa o seguinte erro:

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.
----------------------------
Impossível buscar dados: chrome falhou ao iniciar:cmd_run.go:994:
ATENÇÃO: impossível criar diretório de dados do usuário: impossível criar
"/var/lib/zabbix/snap/chromium/1564": mkdir /var/lib/zabbix: permissão negada
Desculpe, diretórios de usuário fora de /home não são suportados atualmente. Consulte https://forum.snapcraft.io/t/11209 para detalhes.

Este erro ocorre porque /var/lib/zabbix é usado como diretório home para o usuário 'zabbix'.

Códigos de erro MySQL customizados

Se o Zabbix é usado com instalação do MySQL no Azure, uma mensagem de erro pouco clara [9002] Some errors occurred pode aparecer nos logs do Zabbix. Este erro genérico é enviado ao Zabbix Server ou Proxy pelo banco de dados. Para obter mais informações sobre a causa do erro, consulte os logs do Azure.

Expressões regulares inválidas após mudança para PCRE2

No Zabbix 6.0 foi adicionado suporte a PCRE2. Mesmo que o PCRE ainda seja suportado, alguns pacotes de instalação do Zabbix (conforme listagem abaixo) foram atualizados para usar PCRE2. Enquanto entrega muitos benefícios, a mudança para PCRE2 pode incorrer em padrões de regexp PCRE existentes se tornarem inválidos ou se comportarem de forma diferente.

Em particular, isto afeta o padrão \^[\w-\.]. Para tornar esta regexp válida novamente sem afetar a semântica, altere a expressão para \^[-\w\.] . Isto ocorre devido ao fato do PCRE2 tratar o sinal de traço como delimitador, criando um intervalo dentro de uma classe de caracter.

Os seguintes pacotes de instalação do Zabbix foram atualizados e agora utilizam PCRE2:

• RHEL/CentOS 7 e mais recente,
• SLES (todas as versões),
• Debian 9 e mais recente,
• Ubuntu 16.04 e mais recente.

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.

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.

Limits of filtering with utf8mb4 collations

Filters (e.g., in Data collection → Maintenance) may not function correctly when applied to entities containing certain Unicode characters (e.g., ȼ, ɇ). This issue arises due to how the default utf8mb4_bin collation for MySQL or MariaDB databases handles sorting and comparison of Unicode characters.

To address this limitation, users can change the collation of database columns to alternatives such as utf8mb4_0900_bin, utf8mb4_0900_ai_ci, or utf8mb4_unicode_520_ci. Note, however, that changing the collation may cause unexpected behavior in the handling of empty spaces, as well as sorting and filtering for other characters.

For more information on changing collations, see MySQL documentation or MariaDB documentation. For details on collation differences, see Unicode Character Sets in MySQL documentation.