Table of Contents

8 Problemas conhecidos

Consulte também: Compilation issues.

Inicialização do Proxy com MySQL 8.0.0-8.0.17

O zabbix_proxy em versões do MySQL 8.0.0-8.0.17 falha com o seguinte erro de "acesso negado":

[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

Isso ocorre devido ao MySQL 8.0.0 começar a aplicar permissões especiais para definir variáveis de sessão. No entanto, na versão 8.0.18 o comportamento foi removido: A partir do MySQL 8.0.18, definir o valor desta variável do sistema não é mais uma operação restrita.

A solução alternativa é baseada na concessão de privilégios adicionais ao usuário zabbix :

Para versões do MySQL 8.0.14 - 8.0.17:

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

Para versões do MySQL 8.0.0 - 8.0.13:

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

Timescale DB: alto uso de memória com grande número de partições

As versões do PostgreSQL de 9.6 a 12 consomem muita memória ao atualizar tabelas com um grande número de partições consulte o relatório do problema). Este problema se manifesta quando o Zabbix atualiza tendências em sistemas com TimescaleDB se as tendências forem divididas em pedaços relativamente pequenos (por exemplo, 1 dia). Isso leva a centenas de pedaços presentes nas tabelas de tendências com as configurações de limpeza padrão - a condição em que o PostgreSQL provavelmente ficará sem memória.

O problema foi resolvido desde o Zabbix 5.0.1 para novas instalações com TimescaleDB, mas se TimescaleDB foi configurado com Zabbix antes disso, consulte ZBX-16347 para notas de imigração.

Timescale DB 2.5.0: a política de compressão pode falhar em tabelas que contêm números inteiros

Este problema se manifesta quando o TimescaleDB 2.5.0 é usado. Foi resolvido desde o TimescaleDB 2.5.1.

Para mais informações, consulte TimescaleDB Issue #3773.

Atualização

Configuração do modo SQL para uma configuração bem-sucedida

A configuração sql_mode no MySQL/MariaDB deve ter o modo "STRICT_TRANS_TABLES" definido. Se estiver ausente, a atualização do banco de dados do Zabbix falhará (consulte também ZBX-19435).

Atualização com MariaDB 10.2.1 e versões anteriores

A atualização do Zabbix pode falhar se as tabelas do banco de dados forem criadas com o MariaDB 10.2.1 e anteriores, pois nessas versões o formato padrão de linha é compacto. Isso pode ser corrigido alterando o formato de linha para dinâmico (consulte também ZBX-17690.

Instalação acidental de pacotes do Zabbix do EPEL

Com o repositório EPEL instalado e habilitado, a instalação do Zabbix a partir de pacotes levará à instalação dos pacotes do Zabbix do EPEL em vez dos pacotes oficiais do Zabbix.

Neste caso, desinstale os pacotes do Zabbix do EPEL, por exemplo:

dnf remove zabbix-server-mysql

Bloqueie os pacotes do Zabbix do EPEL. Adicione a seguinte linha no arquivo /etc/yum.conf :

exclude=zabbix6.0*

Instale o servidor do Zabbix novamente:

dnf install zabbix-server-mysql

Observe que os pacotes oficiais do Zabbix têm a palavra release na sua string de versão.

6.0.25-release1.el8

Conexão TSL com o banco de dados usando MariaDB

A conexão TLS com o banco de dados não é suportada com a opção verify_ca option para o parâmetroparameter DBTLSConnect se o MariaDB não foi utilizado.

Possíveis deadlocks com MySQL/MariaDB

Ao executar sob carga elevada e com mais de um trabalhador LLD envolvido, é possível encontrar um deadlock causado por um erro do InnoDB relacionado à estratégia de bloqueio de linhas (consulte upstream bug). O erro foi corrigido no MySQL desde a versão 8.0.29, mas não no MariaDB. Para mais detalhes, consulte ZBX-21506.

Correlação global de eventos

Os eventos podem não ser correlacionados corretamente se o intervalo de tempo entre o primeiro e o segundo evento for muito pequeno, ou seja, meio segundo ou menos.

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

PostgreSQL 11 e versões anteriores apenas suportam valores de ponto flutuante 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.

Limitações de expressão regular no Zabbix Agent 2

O Zabbix agent 2 não suporta lookaheads e lookbehinds em expressões regulares devido às limitações da biblioteca padrão Go regexp.

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.

Verificações SSH

  • Algumas distribuições Linux como Debian, Ubuntu, não suportam chaves privadas criptografadas (com senha) se a biblioteca libssh2 for instalada a partir de pacotes. Para mais detalhes, consulte ZBX-4850 .

  • Ao usar o libssh 0.9.x em algumas distribuições Linux com OpenSSH 8, verificações SSH podem ocasionalmente relatar "Não é possível ler dados do servidor SSH". Isso é causado por um problema no libssh issue (relatório mais detalhado). O erro deverá ter sido corrigido por uma versão estável do libssh 0.9.5. Para mais detalhes, consulte também ZBX-17756.

  • O uso do caractere pipe "|" no script SSH pode levar a um erro "Não é possível ler dados do servidor SSH". Nesse caso, é recomendável atualizar a versão da biblioteca libssh. Para mais detalhes, consulte também ZBX-21337.

Verificações ODBC

  • O driver MySQL unixODBC não deve ser usado com servidor Zabbix ou proxy Zabbix compilados com biblioteca de conector MariaDB e vice-versa. Se possível, é melhor evitar usar o mesmo conector que o driver devido um bug de upstream. Configuração sugerida:
PostgreSQL, SQLite ou Oracle connector → MariaDB ou MySQL unixODBC driver
       MariaDB connector → MariaDB unixODBC driver
       MySQL connector → MySQL unixODBC driver

Para mais informações e correções disponíveis, consulte ZBX-7665.

  • 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. Para mais informações, consulte ZBX-18402.

Parâmetro do método de solicitação incorreto em itens

O parâmetro do método de solicitação, usado apenas em verificações HTTP, pode ser definido incorretamente como '1', um valor não padrão para todos os itens como resultado da atualização de uma versão do Zabbix anterior à 4.0. Para mais detalhes sobre como corrigir, consulte ZBX-19308.

Monitoramento Web e agente HTTP

O servidor do Zabbix 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. Para mais informações e correções disponíveis, consulte ZBX-10486.

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. Para mais detalhes, consulte ZBX-11726.

Erros com a execução do fping em contêineres sem raiz

Quando os contêineres estão sendo executados no modo sem raiz ou em um ambiente com restrições específicas, você pode enfrentar erros relacionados à execução do fping ao realizar verificações ICMP, como fping: Operation not permitted ou todos os pacotes para todos os recursos perdidos.

Para corrigir esse problema, adicione --cap-add=net_raw aos comandos "docker run" ou "podman run".

Além disso, a execução do fping em ambientes não raiz pode exigir modificação do sysctl, por exemplo:

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

onde "1995" é o GID do zabbix. Para mais detalhes, consulte ZBX-22833.

Verificações SNMP

Se o sistema operacional OpenBSD for utilizado, um bug de use-after-free na biblioteca Net-SNMP até a versão 5.7.3 pode causar uma falha no servidor Zabbix se o parâmetro SourceIP for definido no arquivo de configuração do servidor Zabbix. Como solução alternativa, por favor, não defina o parâmetro SourceIP. O mesmo problema se aplica também ao Linux, mas não causa a interrupção do funcionamento do servidor Zabbix. Um patch local para o pacote net-snmp no OpenBSD foi aplicado e será lançado 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. Para mais detalhes, consulte ZBX-14318.

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.

Para mais informações, consulte ZBX-17192.

Falha no processo de alerta no RHEL 7

Ocorrências de falhas no processo de alerta do servidor Zabbix foram encontradas no RHEL 7. Para mais detalhes, consulte ZBX-10461.

Atualizado o Zabbix agent 2 (6.0.5 ou anterior)

Ao atualizar o Zabbix agent 2 (versão 6.0.5 ou anterior) a partir de pacotes, pode ocorrer um erro de conflito de arquivo relacionado ao plugin. Para corrigir o erro, faça o backup da sua configuração do agente 2 (se necessário), desinstale o agente 2 e instale-o novamente.

Em sistemas baseados no On RHEL, execute:

dnf remove zabbix-agent2
       dnf install zabbix-agent2

Em sistemas baseados no Debian-based, execute:

apt remove zabbix-agent2
       apt install zabbix-agent2

Para mais informações, consulte ZBX-23250.

Invertendo as localidades do frontend

Observou-se que as localidades do frontend podem ser invertidas sem lógica aparente, ou seja, algumas páginas (ou partes das páginas) são exibidas em um idioma enquanto outras páginas (ou partes das páginas) em um idioma diferente. Tipicamente, o problema pode aparecer quando há vários usuários, alguns dos quais usam uma localidade, enquanto outros usam outra.

Uma solução conhecida para isso é desativar a multithreading no PHP e no Apache.

O problema está relacionado com a forma como a configuração da localidade funciona em PHP in PHP: as informações de localidade são mantidas por processo, não por thread. Assim, em um ambiente multi-thread, quando vários projetos são executados pelo mesmo processo do Apache, é possível que a localidade seja alterada em outro thread e que isso altere como os dados podem ser processados no thread do Zabbix.

Para mais informações, consulte os relatórios de problemas relacionados:

  • ZBX-10911 (Problema com inversão das localidades do frontend)
  • ZBX-16297 (Problema com processamento de números em gráficos usando a funçãobcdiv 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

Horário de verão

Alterações no Horário de Verão resultam em irregularidades ao exibir rótulos do eixo X (duplicação de datas, datas faltando, etc.).

Agregação de Soma

Ao usar agregação de soma sum aggregation em um gráfico para um período inferior a uma hora, os gráficos exibem valores incorretos (multiplicados) quando os dados vêm de tendências.

Sobreposição de Texto

Para alguns idiomas do frontend (por exemplo, japonês), as fontes locais podem causar sobreposição de texto na legenda do gráfico. Para evitar este problema, use a versão 2.3.0 (ou posterior) da extensão PHP GD.

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 (Para mais informações, consulte ZBX-10884.)

Consultas lentas do MySQL

O servidor Zabbix gera consultas SELECT queries in case of non-existing values for items. Este problema issue é conhecido por ocorrer nas versões MySQL 5.6/5.7 (para uma discussão mais detalhada, consulte ZBX-10652), e m casos específicos, também pode ocorrer em versões mais recentes do MySQL. Uma solução alternativa para isso é desativar o otimizador index_condition_pushdown ou prefer_ordering_index no MySQL. No entanto, observe que esta solução alternativa pode não corrigir todos os problemas relacionados a consultas lentas.

Sincronização lenta de configuração com Oracle

A sincronização de configuração pode ser lenta em instalações do Zabbix 6.0 com Oracle DB que possuem um grande número de itens e etapas de pré-processamento de itens. Isso é causado pela velocidade de processamento do motor de banco de dados Oracle para campos do tipo nclob.

Para melhorar o desempenho, você pode converter os tipos de campo de nclob para nvarchar2 aplicando manualmente o patch do banco de dadositems_nvarchar_prepare.sql. Observe que essa conversão reduzirá o limite máximo de tamanho do campo de 65535 bytes para 4000 bytes para parâmetros de pré-processamento de itens e parâmetros de itens, como Description, campo Script do item do script, campos Request body e Headers do item do agente HTTP, campo consulta SQL query do item do monitor de banco de dados. Consultas para determinar os nomes dos modelos que precisam ser excluídos antes de aplicar o patch são fornecidas no patch como um comentário. Alternativamente, seMAX_STRING_SIZE estiver configurado, você pode alterar nvarchar2(4000) para nvarchar2(32767) nas consultas do patch para definir o limite de tamanho do campo de 32767 bytes.

Para uma discussão mais detalhada, consulte ZBX-22363.

Login na API

Um grande número de sessões de usuário abertas pode ser criado ao utilizar scripts personalizados com o método user.login method sem user.logout.

Problemas no IPv6 em armadilhas SNMPv3

Devido a um bug no net-snmp, o endereço IPv6 pode não ser exibido corretamente ao usar SNMPv3 em armadilhas SNMP.ara mais detalhes e uma possível solução alternativa, consulte ZBX-14541.

Endereço IPv6 longo truncado em informações de login com falhas

Uma mensagem de tentativa de login falhada exibirá apenas os primeiros 39 caracteres de um endereço de IP armazenado, pois esse é o limite de caracteres no campo do banco de dados. Isso significa que endereços de IP IPv6 com mais de 39 caracteres serão exibidos 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. Isso 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.

Exportação/Importação YAML

Existem alguns problemas conhecidos com a YAML export/import:

  • Mensagens de erro não são traduzíveis;
  • SON válido com uma extensão de arquivo .yaml às vezes não pode ser importado;
  • Datas legíveis por humanos não citadas são automaticamente convertidas para carimbos de data/hora Unix.

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

Existem duas opções de solução alternativa 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 serviço web do Zabbix no Ubuntu 20

Embora na maioria dos casos, o serviço web do Zabbix possa ser executado com o 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.

Esse erro ocorre porque /var/lib/zabbix é usado como diretório home do usuário 'zabbix'.

Códigos de erros personalizados do MySQL

Se o Zabbix for utilizado com uma instalação do MySQL no Azure, uma mensagem de erro pouco clara [9002] Alguns erros ocorreram pode aparecer nos logs do Zabbix. Este texto genérico de erro é enviado para o servidor ou proxy do Zabbix pelo banco de dados. Para obter mais informações sobre a causa do erro, verifique os logs do Azure.

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

No Zabbix 6.0, o suporte para PCRE2 foi adicionado. Embora o PCRE ainda seja suportado, os pacotes de instalação do Zabbix para RHEL 7 e mais recentes, SLES (todas as versões), Debian 9 e mais recentes, Ubuntu 16.04 e mais recentes foram atualizados para usar o PCRE2. Embora forneça muitos benefícios, a mudança para o PCRE2 pode fazer com que certos padrões de expressões regulares PCRE existentes se tornem inválidos ou se comportem de maneira diferente. Em particular, isso afeta o padrão ^[\w-\.]. Para tornar essa expressão regular válida novamente sem afetar a semântica, mude a expressão para ^[-\w\.] . Isso acontece devido ao fato de que o PCRE2 trata o sinal de traço como um delimitador, criando uma faixa dentro de uma classe de caracteres. Os seguintes pacotes de instalação do Zabbix foram atualizados e agora usam PCRE2: RHEL 7 e mais recentes, SLES (todas as versões), Debian 9 e mais recentes, Ubuntu 16.04 e mais recentes.

Conversão incorreta de serviços no Zabbix 6.0.0-6.0.2

Na versão 6.0 do Zabbix, foram introduzidos novos algoritmos de cálculo de status de serviço mais flexíveis.

Após uma atualização do Zabbix <6.0 para o Zabbix 6.0.0, 6.0.1, 6.0.2, as regras de cálculo de status de serviço 'Mais crítico se todos os filhos tiverem problemas' e 'Mais crítico dos serviços filhos' serão trocadas. Os serviços criados no Zabbix 6.0.0 e posterior terão regras corretas de cálculo de status.

Ao atualizar de versões <6.0 para o Zabbix 6.0.3 ou posterior, o Zabbix atualizará corretamente as regras de cálculo de status de serviço. A atualização de 6.0.x para 6.0.3 não terá efeito nas regras de cálculo de status de serviço.

Erro no widget Geomap

Os mapas no widget Geomap podem não carregar corretamente se você tiver feito upgrade de uma versão mais antiga do Zabbix com o NGINX e não tiver mudado para o novo arquivo de configuração do NGINX durante a atualização.

Para corrigir o problema, você pode descartar o arquivo de configuração antigo, usar o arquivo de configuração do pacote 6.0 e reconfigurá-lo conforme descrito nas instruções (https://www.zabbix.com/download?zabbix=6.0&os_distribution=red_hat_enterprise_linux&os_version=8&db=mysql&ws=nginx)download instructions na seção e. Configure PHP para Zabbix frontend.

Alternativamente, você pode editar manualmente um arquivo de configuração existente do NGINX (tipicamente, /etc/zabbix/nginx.conf). Para fazer isso, abra o arquivo e localize o seguinte bloco:

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 para servidor e proxy do Zabbix

O utilitário logrotate está incluído apenas nos pacotes para zabbix-agent, zabbix-agent2 e zabbix-web-service, mas precisa ser instalado separadamente para o servidor e o proxy do Zabbix. A dependência do logrotate foi adicionada aos pacotes do servidor e do proxy para RHEL e SUSE a partir do Zabbix 6.4.4rc1.

Problemas no Zabbix 6.0.11

Erros de análise de JSONPath

Erros de análise de JSONPath ocorrem em caso de espaços em branco iniciais e array/object vazio. Esses erros foram corrigidos no Zabbix 6.0.12.

Avaliação de E/OU em filtros LLD

A avaliação de expressões AND/OR nos filtros/sobreposições de descoberta de baixo nível pode falhar nesta versão. Corrigido no Zabbix 6.0.12.

Arquivos ausentes no arquivo do agente do Windows

O arquivo ZIP de download do agente Zabbix para Windows está sem os arquivos zabbix_sender.h e zabbix_sender.lib nas versões 6.0.0-6.0.27, necessários para o zabbix zabbix_sender.dll.