Zabbix es compatible con TimescaleDB, una solución de base de datos basada en PostgreSQL que particiona automáticamente los datos en fragmentos basados en el tiempo para admitir un rendimiento más rápido a gran escala.
Actualmente, Zabbix proxy no es compatible con TimescaleDB.
Las instrucciones en esta página pueden utilizarse para los siguientes escenarios:
Pre-requisitos: Extensión TimescaleDB de una versión compatible instalada en el servidor de base de datos. Para instrucciones de instalación, consulte la documentación de Timescale).
Habilite la extensión TimescaleDB para la base de datos específica ejecutando:
La ejecución de este comando requiere privilegios de administrador de base de datos.
Si utiliza un esquema de base de datos distinto de 'public', debe agregar una cláusula SCHEMA al comando anterior. Por ejemplo:
echo "CREATE EXTENSION IF NOT EXISTS timescaledb SCHEMA yourschema CASCADE;" | sudo -u postgres psql zabbix
Luego ejecute el script postgresql/timescaledb/schema.sql
. Para nuevas instalaciones, el script debe ejecutarse después de que la base de datos PostgreSQL regular haya sido creada con el esquema/datos iniciales (consulte creación de base de datos).
Por favor, ignore los mensajes de advertencia que informan que no se siguen las mejores prácticas al ejecutar el script schema.sql
en TimescaleDB versión 2.9.0 y superiores. Independientemente de esta advertencia, la configuración se completará correctamente.
La migración de los datos existentes de histórico, tendencias y registro de auditoría puede tomar mucho tiempo. El servidor y la interfaz de Zabbix deben estar detenidos durante el período de migración.
El script schema.sql
establece los siguientes parámetros de limpieza automática:
Para utilizar la limpieza automática particionada para histórico y tendencias, ambas opciones deben estar habilitadas. También es posible habilitar la anulación individualmente, ya sea solo para histórico o solo para tendencias.
Para PostgreSQL y TimescaleDB, el script postgresql/timescaledb/schema.sql
establece dos parámetros adicionales:
Para eliminar correctamente los datos comprimidos mediante el housekeeper, deben estar habilitadas tanto las opciones Anular periodo de histórico de la métrica como Anular periodo de tendencias de la métrica. Si la anulación está deshabilitada y las tablas tienen fragmentos comprimidos, el housekeeper no eliminará datos de estas tablas y se mostrarán advertencias sobre una configuración incorrecta en las secciones Housekeeping e Información del sistema.
Todos estos parámetros pueden modificarse en Administración → Mantenimiento después de la instalación.
Es posible que desee ejecutar la herramienta timescaledb-tune proporcionada por TimescaleDB para optimizar los parámetros de configuración de PostgreSQL en su postgresql.conf
.
Al actualizar Zabbix a una versión que contiene nuevas tablas hiper de TimescaleDB, el servidor Zabbix no configura automáticamente esas tablas hiper (por ejemplo, al actualizar de Zabbix 6.4 a 8.0, ya que las versiones 7.0.0 y 7.0.2 han introducido nuevas tablas hiper).
Para configurar las nuevas tablas hiper de TimescaleDB, siga estos pasos:
postgresql/timescaledb/schema.sql
; esto configurará las nuevas tablas hiper de TimescaleDB. Tenga en cuenta que, desde Zabbix 7.0.0, la ubicación y el nombre del script han cambiado de postgresql/timescaledb.sql
a postgresql/timescaledb/schema.sql
.Por favor, ignore los mensajes de advertencia que informan que no se siguen las mejores prácticas al ejecutar el script schema.sql
en TimescaleDB versión 2.9.0 y superiores. Independientemente de esta advertencia, la configuración se completará correctamente.
Se admite la compresión nativa de TimescaleDB para todas las tablas de Zabbix que son hypertables de TimescaleDB. Durante la actualización o migración a TimescaleDB, la compresión inicial de las tablas grandes puede llevar mucho tiempo.
Tenga en cuenta que la compresión es compatible bajo la licencia Timescale Community "timescale" y no es compatible bajo la licencia Apache 2.0 "apache". Si Zabbix detecta que la compresión no es compatible, se escribe un mensaje de advertencia en el registro del servidor Zabbix y los usuarios no pueden habilitar la compresión en la interfaz web.
Se recomienda a los usuarios familiarizarse con la compresión en la documentación de Timescale antes de utilizar la compresión.
Tenga en cuenta que existen ciertas limitaciones impuestas por la compresión, específicamente:
Los ajustes de compresión pueden modificarse en el bloque Compresión de histórico, tendencias y registro de auditoría en la sección Administración → Limpieza de la interfaz web de Zabbix.
Parámetro | Por defecto | Comentarios |
---|---|---|
Habilitar compresión | Habilitado | Marcar o desmarcar la casilla no activa/desactiva la compresión inmediatamente. Debido a que la compresión es gestionada por el Housekeeper, los cambios tendrán efecto en hasta 2 veces las horas de HousekeepingFrequency (establecido en zabbix_server.conf)Después de deshabilitar la compresión, los nuevos fragmentos que entren en el período de compresión no se comprimirán. Sin embargo, todos los datos previamente comprimidos permanecerán comprimidos. Para descomprimir fragmentos previamente comprimidos, siga las instrucciones en la documentación de Timescale. Al actualizar desde versiones anteriores de Zabbix con soporte para TimescaleDB, la compresión no se habilitará por defecto. |
Comprimir registros anteriores a | 7d | Este parámetro no puede ser inferior a 7 días. Debido a la inmutabilidad de los fragmentos comprimidos, todos los datos atrasados (por ejemplo, datos retrasados por un proxy) que sean anteriores a este valor serán descartados. |
Para un mejor rendimiento en la actualización de tendencias, puede que desee reducir el "chunk_time_interval" para las tablas trends
y trends_uint
de 30 días a 7 días o menos, dependiendo de cuántas métricas utilicen tendencias. El propósito de este ajuste es cumplir con las mejores prácticas de TimescaleDB y garantizar que el tamaño del fragmento permanezca dentro de los recursos disponibles del sistema.