10 Notas de atualização para 7.4.0

Estas notas são para 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 quebrar instalações existentes e outras informações críticas relacionadas ao processo de atualização
• Outras - todas as demais informações que descrevem as mudanças na funcionalidade do Zabbix

Veja também:

• Procedimento de atualização para todas as informações relevantes sobre atualização de versões anteriores ao Zabbix 7.4.0;
• Atualizando cluster HA para instruções sobre atualização de servers em um cluster de alta disponibilidade (HA).

Processo de atualização

Para concluir uma atualização bem-sucedida do Zabbix server no MySQL/MariaDB, pode ser necessário definir GLOBAL log_bin_trust_function_creators = 1 no MySQL se o log binário estiver habilitado, não houver privilégios de superusuário e log_bin_trust_function_creators = 1 não estiver 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, esta opção pode 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. O Zabbix agora é compilado com PCRE2.

Gerenciando a própria mídia do usuário

Todos os usuários agora podem gerenciar sua própria mídia por padrão.

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

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

Se estiver atualizando a partir de versões mais antigas, ambas as opções serão ativadas para todas as funções que tiverem o Acesso padrão a novas ações ativado. Observe que, se o Acesso padrão a novas ações não estiver ativado, administradores e super administradores podem perder a capacidade de editar a mídia após a atualização.

Escape de barras invertidas nos parâmetros da função de histórico

O escape adequado de barras invertidas foi adicionado nos parâmetros de string da função 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 leva a parâmetros mais longos, o que pode resultar em funções de trigger quebradas se o comprimento do parâmetro exceder o tamanho máximo de dados de 255 caracteres.

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

Verificações adicionais para o comprimento resultante do parâmetro foram adicionadas para atualizações de versões do Zabbix anteriores à 7.0. Se o comprimento resultante exceder o tamanho máximo, tais parâmetros não são atualizados, enquanto um aviso é impresso nos logs pedindo aos usuários para corrigirem manualmente os parâmetros listados.

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

Atualização do plugin MSSQL Zabbix agent 2

O template MSSQL por Zabbix agent 2 foi atualizado com filtros para incluir ou excluir membros de quórum descobertos por nome, bem como um filtro de serviço que permite filtrar por nome de cluster para excluir clusters vazios. Para que o template funcione sem erros, o plugin MSSQL Zabbix agent 2 deve ser atualizado para a versão igual ou superior a 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 do banco de dados, você pode definir DBPort ou DBSocket, ou deixar ambos indefinidos para usar os valores padrão.

Outros

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

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

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

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

Gerenciando o 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 desacelerar o sistema. Para ajudar a gerenciar o cache de histórico, as seguintes melhorias foram introduzidas:

• Limpeza manual do cache: O novo comando em tempo de execução history_cache_clear=target para o server/proxy do Zabbix permite limpar manualmente o cache de histórico para um item específico pelo seu ID.
• Limpeza automática do cache: Quando você desativa um item, ele é imediatamente removido do cache de histórico (exceto pelo seu último valor, que é mantido para logs). Da mesma forma, quando você desativa um host, todos os seus itens são removidos do cache de histórico (exceto pelos seus últimos valores).
• Registro de diagnóstico 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 do DebugLevel=3 (anteriormente DebugLevel=4). O log contém os itens com mais valores no cache de histórico.

Para 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 para o 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 em mapas

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

• O rótulo do grupo de hosts agora exibe o resumo do problema de todos os hosts em grupos de hosts aninhados;
• A visualização "Elementos do grupo 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 em 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):

• server: os valores máximos para HistoryCacheSize, HistoryIndexCacheSize e TrendCacheSize foram aumentados;
• proxy: os valores máximos para HistoryCacheSize e HistoryIndexCacheSize foram aumentados.

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

O período de armazenamento padrão para dados de sessão de usuário foi reduzido de 365 dias para 31 dias. Essa alteração afeta o parâmetro hk_sessions, que agora tem o padrão de 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 serviço web 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.