11 Notas de atualização para a versão 7.4.0

Estas notas são destinadas à atualização do Zabbix 7.2.x para o Zabbix 7.4.0.

Todas as notas estão agrupadas em:

  • Alterações incompatíveis - alterações que podem interromper instalações existentes e outras informações críticas relacionadas ao processo de atualização
  • Outros - todas as demais informações que descrevem as alterações na funcionalidade do Zabbix

Consulte também:

Processo de atualização

Para concluir com êxito a atualização do Zabbix server no MySQL/MariaDB, pode ser necessário definir GLOBAL log_bin_trust_function_creators = 1 no MySQL caso o registro binário esteja habilitado, não haja privilégios de superusuário e log_bin_trust_function_creators = 1 não esteja definido no arquivo de configuração do MySQL.

Para definir a variável usando o console do MySQL, execute:

mysql> SET GLOBAL log_bin_trust_function_creators = 1;

Após a conclusão bem-sucedida da atualização, essa opção poderá ser desabilitada:

mysql> SET GLOBAL log_bin_trust_function_creators = 0;

Mudanças incompatíveis

Biblioteca PCRE removida

A biblioteca PCRE (ou PCRE1) foi removida. Agora, o Zabbix é compilado com PCRE2.

Gerenciamento da própria mídia

Agora, por padrão, todos os usuários podem gerenciar sua própria mídia.

As permissões dos usuários para alterar os detalhes da própria mídia podem ser concedidas (ou revogadas) com base na sua função de usuário (consulte a opção Criar e editar a própria mídia).

Além disso, as permissões de usuários Super admin para alterar os detalhes da mídia de outros usuários também podem ser concedidas/revogadas com base na sua função de usuário (consulte a opção Criar e editar a mídia dos usuários).

Ao atualizar a partir de versões anteriores, ambas as opções serão habilitadas para todas as funções que tiverem a opção Acesso padrão a novas ações habilitada. Observe que, se Acesso padrão a novas ações não estiver habilitado, administradores e super administradores podem perder a capacidade de editar mídias após a atualização.

Escape de barras invertidas nos parâmetros das funções de histórico

O escape adequado de barras invertidas foi adicionado aos parâmetros de string das funções de histórico desde o Zabbix 7.0.0.

Como barras invertidas adicionais são adicionadas durante a atualização de versões do Zabbix anteriores à 7.0, isso resulta em parâmetros mais longos, o que pode causar falhas nas funções de trigger se o tamanho do parâmetro exceder o tamanho máximo de dados de 255 caracteres.

Para evitar esse problema, recomenda-se mover manualmente os parâmetros longos para macros de usuário antes da atualização.

Foram adicionadas verificações adicionais do tamanho resultante dos parâmetros para atualizações de versões do Zabbix anteriores à 7.0. Se o tamanho resultante exceder o tamanho máximo, esses parâmetros não serão atualizados, e um aviso será registrado solicitando que os usuários corrijam manualmente os parâmetros listados.

Consulte também problemas de atualização relacionados ao escape.

Atualização do plugin MSSQL Zabbix agent 2

O template MSSQL by Zabbix agent 2 foi atualizado com filtros para incluir ou excluir membros de quorum descobertos por nome, bem como um filtro de serviço que permite filtrar por nome do cluster para excluir clusters vazios.

Para que o template funcione sem erros, o MSSQL Zabbix agent 2 plugin deve ser atualizado para uma versão igual ou superior à 7.4.0.

Versão mínima do libssh2 necessária

A versão mínima do libssh2 necessária foi aumentada de 1.0.0 para 1.8.0.

Protótipos de host em hosts descobertos

Se sua configuração atual inclui protótipos de host que usam templates contendo outros protótipos de host, a atualização para o Zabbix 7.4 fará com que todos os hosts descobertos tenham os protótipos de host definidos nesses templates. Se esse comportamento não for desejado, exclua manualmente os protótipos de host dos templates relevantes antes de atualizar.

Para identificar os hosts descobertos que receberão protótipos de host durante a atualização, você pode executar a seguinte consulta SQL em seu banco de dados Zabbix:

SELECT h.hostid,ht.templateid
FROM hosts_templates ht
JOIN hosts h ON ht.hostid=h.hostid
WHERE h.flags=4
  AND EXISTS (
    SELECT NULL
    FROM items i,host_discovery hd
    WHERE i.hostid=ht.templateid
    AND hd.parent_itemid=i.itemid
    )
ORDER BY hostid;

Parâmetros de conexão com o banco de dados

DBPort e DBSocket agora são mutuamente exclusivos. Ao especificar os parâmetros de conexão com o banco de dados, você pode definir DBPort ou DBSocket, ou deixar ambos indefinidos para usar os valores padrão.

Outros

Itens de walk/discovery SNMP não suportados sem OIDs válidos

Os itens de walk SNMP, caso nenhum dos OIDs ou instâncias de OID exista, agora retornam um erro e o item se torna não suportado.
Os detalhes dos OIDs/instâncias inexistentes são registrados com DebugLevel=5.
Anteriormente, nesses casos, eles retornavam uma string vazia.

Da mesma forma, os itens de discovery SNMP, caso nenhum dos OIDs ou instâncias de OID exista, agora retornam um erro e o item se torna não suportado.
Anteriormente, nesses casos, eles retornavam um array vazio.

Observe que uma string/array vazia agora é retornada somente se o OID/instância existir, mas não houver dados para ele.

Gerenciamento do cache de histórico

Em alguns cenários de coleta de dados, itens específicos podem bloquear temporariamente o cache de histórico do server/proxy. Isso pode atrasar a gravação dos dados de histórico no banco de dados e tornar o sistema mais lento. Para ajudar a gerenciar o cache de histórico, foram introduzidas as seguintes melhorias:

  • Limpeza manual do cache: o novo comando de runtime history_cache_clear=target para o server/proxy do Zabbix permite limpar manualmente o cache de histórico de um item específico pelo ID.
  • Limpeza automática do cache: quando você desativa um item, ele é imediatamente removido do cache de histórico (exceto pelo último valor, que é mantido para os logs). Da mesma forma, quando você desativa um host, todos os seus itens são removidos do cache de histórico (exceto pelos últimos valores).
  • Registro de diagnósticos do cache: quando o cache de histórico está cheio, o server/proxy do Zabbix agora registra informações de diagnóstico do cache de histórico a partir de DebugLevel=3 (anteriormente, DebugLevel=4). O log contém os itens com a maior quantidade de valores no cache de histórico.

Para garantir a estabilidade do sistema a longo prazo, certifique-se de que a coleta de dados esteja equilibrada com os recursos disponíveis (desempenho do banco de dados, tamanho do cache, intervalos de coleta, parâmetros de itens de log etc.). Você pode monitorar o cache de histórico do Zabbix usando o item interno zabbix[wcache]. Você também pode considerar aumentar o tamanho do cache de histórico do server/proxy do Zabbix.

Seção de menu separada para notificações do usuário

Para melhor visibilidade das mídias do usuário, as notificações do usuário agora têm sua própria seção de menu em Configurações do usuário.

A nova seção Notificações contém duas abas - Mídia e Notificações do frontend, que anteriormente faziam parte da seção de perfil do usuário.

Informações corretas de grupos de hosts aninhados nos mapas

As informações dos grupos de hosts aninhados agora são exibidas corretamente nos mapas, por exemplo:

  • O rótulo do grupo de hosts agora exibe o resumo dos problemas de todos os hosts nos grupos de hosts aninhados;
  • A visualização "Elementos de grupos de hosts" agora exibe um elemento de mapa separado para cada host nos grupos de hosts aninhados;
  • O rótulo do mapa agora exibe o resumo de todos os problemas contidos nos grupos de hosts aninhados.

Tabela de banco de dados para configurações convertidas

A tabela settings agora substitui a tabela config para armazenar parâmetros de configuração global. A nova tabela usa um formato de chave-valor em vez de armazenar parâmetros em uma única linha com uma coluna por parâmetro. Para um exemplo de como isso afeta a troca de dados, consulte Protocolo de troca de dados entre server e proxy (objeto "settings").

Tamanhos máximos de cache aumentados para server e proxy

Os tamanhos máximos de cache foram aumentados de 2 GB para 16 GB para retardar o esgotamento do cache e sustentar a operação durante problemas temporários (por exemplo, problemas de configuração, banco de dados ou rede):

Período de armazenamento padrão reduzido para sessões de usuário

O período de armazenamento padrão dos dados de sessão do usuário foi reduzido de 365 dias para 31 dias. Essa alteração afeta o parâmetro hk_sessions, que agora tem como padrão 31d em vez de 365d.

Versão mínima do Go suportada

A versão mínima do Go suportada foi aumentada de 1.21 para 1.23.

Se você compilou anteriormente o agent 2 do Zabbix, plugins carregáveis do agent 2 ou o web service a partir do código-fonte usando uma versão do Go mais antiga que 1.23, é recomendável recompilar esses componentes usando uma versão do Go suportada para receber as últimas atualizações de segurança e correções de bugs. Componentes compilados com uma versão mais antiga do Go continuarão funcionando, mas atualizá-los exigirá um ambiente Go mais recente.

Atualização de template para o Assistente de Host

O novo Assistente de Host apresenta uma interface guiada, passo a passo, para configurar seu alvo de monitoramento (dispositivo, aplicativo, serviço, etc.) no Zabbix. Ele simplifica a configuração de hosts novos ou existentes, guiando os usuários por etapas-chave, como seleção de template, instalação do agent Zabbix, adição de interfaces de host e muito mais.

Após a atualização a partir de uma versão anterior do Zabbix, os templates devem ser atualizados para funcionar com o Assistente de Host. Para instruções, consulte Atualização de template.

Processamento concorrente de verificações SNMPv1 e SNMPv2

As verificações assíncronas de serviço SNMPv1 e SNMPv2 agora são processadas de forma concorrente pelos workers de descoberta disponíveis.