11 Notas de actualización a 7.4.0

Estas notas están destinadas a la actualización de Zabbix 7.2.x a Zabbix 7.4.0.

Todas las notas se agrupan en:

  • Cambios incompatibles: cambios que pueden interrumpir instalaciones existentes y otra información crítica relacionada con el proceso de actualización
  • Otros: toda la información restante que describe los cambios en la funcionalidad de Zabbix

Véase también:

Proceso de actualización

Para completar correctamente la actualización del server de Zabbix en MySQL/MariaDB, es posible que deba establecer GLOBAL log_bin_trust_function_creators = 1 en MySQL si el registro binario está habilitado, no dispone de privilegios de superusuario y log_bin_trust_function_creators = 1 no está establecido en el archivo de configuración de MySQL.

Para establecer la variable mediante la consola de MySQL, ejecute:

mysql> SET GLOBAL log_bin_trust_function_creators = 1;

Una vez completada correctamente la actualización, esta opción puede deshabilitarse:

mysql> SET GLOBAL log_bin_trust_function_creators = 0;

Cambios incompatibles

Biblioteca PCRE eliminada

La biblioteca PCRE (o PCRE1) ha sido eliminada.
Zabbix ahora se compila con PCRE2.

Gestión de los propios medios

Ahora, todos los usuarios pueden gestionar sus propios medios de forma predeterminada.

Los permisos de usuario para cambiar los detalles de sus propios medios se pueden conceder (o revocar) según su rol de usuario (consulte la opción Crear y editar los propios medios).

Además, los permisos de los usuarios Super admin para cambiar los detalles de los medios de otros usuarios también se pueden conceder o revocar según su rol de usuario (consulte la opción Crear y editar medios de usuario).

Si se actualiza desde versiones anteriores, ambas opciones estarán habilitadas para todos los roles que tengan habilitada la opción Acceso predeterminado a las nuevas acciones. Tenga en cuenta que, si Acceso predeterminado a las nuevas acciones no está habilitada, los administradores y superadministradores podrían perder la capacidad de editar medios después de la actualización.

Escapado de barras invertidas en los parámetros de las funciones de historial

Desde Zabbix 7.0.0 se ha añadido el escapado correcto de las barras invertidas en los parámetros de cadena de las funciones de historial.

Dado que durante la actualización desde versiones de Zabbix anteriores a la 7.0 se añaden barras invertidas adicionales, los parámetros se vuelven más largos, lo que puede provocar que las funciones de los trigger dejen de funcionar si la longitud del parámetro supera el tamaño máximo de datos de 255 caracteres.

Para evitar este problema, se recomienda mover manualmente los parámetros largos a macros de usuario antes de la actualización.

Se han añadido comprobaciones adicionales de la longitud resultante de los parámetros para las actualizaciones desde versiones de Zabbix anteriores a la 7.0. Si la longitud resultante supera el tamaño máximo, dichos parámetros no se actualizan y se muestra una advertencia en los registros en la que se solicita a los usuarios corregir manualmente los parámetros indicados.

Consulte también problemas de actualización relacionados con el escapado.

Actualización del plugin MSSQL Zabbix agent 2

El template MSSQL by Zabbix agent 2 se ha actualizado con filtros para incluir o excluir miembros de quórum descubiertos por nombre, así como con un filtro de servicio que permite filtrar por nombre de clúster para excluir clústeres vacíos.

Para que el template funcione sin errores, el plugin MSSQL Zabbix agent 2 debe actualizarse a una versión igual o superior a 7.4.0.

Versión mínima requerida de libssh2

La versión mínima requerida de libssh2 se ha incrementado de 1.0.0 a 1.8.0.

Prototipos de equipos en equipos descubiertos

Si su configuración actual incluye prototipos de equipos que utilizan plantillas que contienen otros prototipos de equipos, al actualizar a Zabbix 7.4 todos los equipos descubiertos tendrán los prototipos de equipos definidos en esas plantillas. Si este comportamiento no es el deseado, elimine manualmente los prototipos de equipos de las plantillas correspondientes antes de actualizar.

Para identificar los equipos descubiertos que recibirán prototipos de equipos durante la actualización, puede ejecutar la siguiente consulta SQL en su base de datos de 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 conexión de la base de datos

DBPort y DBSocket ahora son mutuamente excluyentes.
Al especificar los parámetros de conexión de la base de datos, puede definir DBPort o DBSocket, o dejar ambos sin definir para utilizar los valores predeterminados.

Otros

Items de walk/detección SNMP no compatibles sin OID válidos

Los items de SNMP walk, cuando no existe ninguno de los OID ni de las instancias de OID, ahora devuelven un error y el item pasa a no ser compatible.
Los detalles del OID o de la instancia inexistentes se registran con DebugLevel=5.
Anteriormente, en estos casos devolvían una cadena vacía.

De forma similar, los items de detección SNMP, cuando no existe ninguno de los OID ni de las instancias de OID, ahora devuelven un error y el item pasa a no ser compatible.
Anteriormente, en estos casos devolvían un array vacío.

Tenga en cuenta que ahora solo se devuelve una cadena o un array vacío si el OID o la instancia existe, pero no contiene datos.

Gestión de la caché de historial

En algunos escenarios de recopilación de datos, determinados items pueden bloquear temporalmente la caché de historial del server/proxy. Esto puede retrasar la escritura de los datos históricos en la base de datos y ralentizar el sistema. Para facilitar la gestión de la caché de historial, se han introducido las siguientes mejoras:

  • Borrado manual de la caché: El nuevo comando de tiempo de ejecución history_cache_clear=target para el server/proxy de Zabbix permite borrar manualmente la caché de historial de un item específico mediante su ID.
  • Borrado automático de la caché: Al deshabilitar un item, este se elimina inmediatamente de la caché de historial (excepto su último valor, que se conserva para los logs). Del mismo modo, al deshabilitar un host, todos sus items se eliminan de la caché de historial (excepto sus últimos valores).
  • Registro de diagnósticos de la caché: Cuando la caché de historial está llena, el server/proxy de Zabbix ahora registra información de diagnóstico de la caché de historial a partir de DebugLevel=3 (anteriormente, DebugLevel=4). El registro contiene los items con más valores en la caché de historial.

Para garantizar la estabilidad del sistema a largo plazo, asegúrese de que la recopilación de datos esté equilibrada con los recursos disponibles (rendimiento de la base de datos, tamaño de la caché, intervalos de recopilación, parámetros de los items de log, etc.). Puede supervisar la caché de historial de Zabbix mediante el item interno zabbix[wcache]. También puede considerar aumentar el tamaño de la caché de historial para el server/proxy de Zabbix.

Sección de menú separada para notificaciones de usuario

Para una mejor visibilidad de los medios del usuario, las notificaciones de usuario ahora tienen su propia sección de menú en Configuración de usuario.

La nueva sección de Notificaciones contiene dos pestañas: Medios y Notificaciones de interfaz, que anteriormente formaban parte de la sección de perfil de usuario.

Información correcta de los grupos de hosts anidados en los mapas

La información de los grupos de hosts anidados ahora se muestra correctamente en los mapas, por ejemplo:

  • La etiqueta del grupo de hosts ahora muestra el resumen de problemas de todos los hosts de los grupos de hosts anidados;
  • La vista "Elementos del grupo de hosts" ahora muestra un elemento de mapa independiente para cada host de los grupos de hosts anidados;
  • La etiqueta del mapa ahora muestra el resumen de todos los problemas incluidos en los grupos de hosts anidados.

Tabla de base de datos para la configuración convertida

La tabla settings ahora reemplaza a la tabla config para almacenar los parámetros de configuración global. La nueva tabla utiliza un formato de clave-valor en lugar de almacenar los parámetros en una sola fila con una columna por parámetro. Para ver un ejemplo de cómo esto afecta al intercambio de datos, consulte el Protocolo de intercambio de datos servidor-proxy (objeto "settings").

Aumentados los tamaños máximos de caché para servidor y proxy

Los tamaños máximos de caché se han incrementado de 2 GB a 16 GB para retrasar el agotamiento de la caché y mantener la operación durante problemas temporales (por ejemplo, problemas de configuración, base de datos o red):

Período de almacenamiento predeterminado reducido para las sesiones de usuario

El período de almacenamiento predeterminado para los datos de las sesiones de usuario se ha reducido de 365 días a 31 días. Este cambio afecta al parámetro hk_sessions, cuyo valor predeterminado ahora es 31d en lugar de 365d.

Versión mínima de Go soportada

La versión mínima de Go soportada se ha elevado de la 1.21 a la 1.23.

Si anteriormente compiló el agent 2 de Zabbix, los plugins cargables del agent 2 o el servicio web desde el código fuente utilizando una versión de Go anterior a la 1.23, se recomienda recompilar estos componentes utilizando una versión de Go soportada para recibir las últimas actualizaciones de seguridad y correcciones de errores. Los componentes compilados con una versión anterior de Go seguirán funcionando, pero actualizarlos requerirá un entorno de Go más reciente.

Actualización de plantillas para el Asistente de Hosts

El nuevo Asistente de Hosts introduce una interfaz guiada, paso a paso, para configurar su objetivo de monitorización (dispositivo, aplicación, servicio, etc.) en Zabbix. Simplifica la configuración de hosts nuevos o existentes guiando a los usuarios a través de pasos clave como la selección de una plantilla, la instalación del agente Zabbix, la adición de interfaces de host y más.

Después de actualizar desde una versión anterior de Zabbix, las plantillas deben actualizarse para funcionar con el Asistente de Hosts. Para obtener instrucciones, consulte Actualización de plantillas.

Procesamiento concurrente de comprobaciones SNMPv1 y SNMPv2

Las comprobaciones de servicio asíncronas SNMPv1 y SNMPv2 ahora se procesan de forma concurrente por los workers de descubrimiento disponibles.