Documentation
Table of Contents
7 Configuración de TimescaleDB
Descripción general
Zabbix es compatible con TimescaleDB, una solución de base de datos basada en PostgreSQL que divide automáticamente los datos en fragmentos basados en el tiempo para ofrecer un rendimiento más rápido a escala.
Actualmente, el proxy de Zabbix no es compatible con TimescaleDB.
Las instrucciones de esta página se pueden usar para los siguientes escenarios:
- Creación de una base de datos TimescaleDB o migración de tablas PostgreSQL existentes a TimescaleDB (consulte Configuración).
- Actualización de un esquema de base de datos TimescaleDB existente al actualizar Zabbix (consulte Actualización del esquema TimescaleDB).
Configuración
Pre-requisitos: Extensión TimescaleDB de una versión soportada instalada en el servidor de base de datos. Para instrucciones de instalación, consulte la documentación de TimescaleDB.
Antes de instalar TimescaleDB, instale una versión soportada de PostgreSQL desde el repositorio oficial de PostgreSQL.
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 diferente a 'public', debe añadir 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 llevar mucho tiempo. El servidor y el frontend de Zabbix deben estar detenidos durante el periodo de migración.
El script schema.sql establece los siguientes parámetros de limpieza automática:
- Anular el periodo de histórico de item
- Anular el periodo de tendencias de item
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:
- Habilitar compresión
- Comprimir registros con más de 7 días
Para eliminar correctamente los datos comprimidos mediante el housekeeper, se deben habilitar tanto las opciones Anular el período de historial de item como Anular el período de tendencias de item. Si la anulación está deshabilitada y las tablas tienen fragmentos comprimidos, el housekeeper no eliminará los datos de estas tablas y se mostrarán advertencias sobre la configuración incorrecta en las secciones Housekeeping e Información del sistema.
Todos estos parámetros se pueden cambiar 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.
Actualización del esquema de TimescaleDB
Al actualizar Zabbix a una versión que contiene nuevas hypertables de TimescaleDB, el servidor Zabbix no configura automáticamente esas hypertables (por ejemplo, al actualizar de Zabbix 6.4 a 7.4, ya que las versiones 7.0.0 y 7.0.2 han introducido nuevas hypertables).
Para configurar las nuevas hypertables de TimescaleDB, siga estos pasos:
- Inicie el servidor Zabbix; esto actualizará la base de datos existente.
- Compruebe en el archivo de registro del servidor que la actualización de la base de datos se ha completado; cuando haya finalizado, detenga el servidor Zabbix. Tenga en cuenta que el servidor registra una advertencia si intenta habilitar la compresión para una tabla que no es una hypertable.
- Ejecute el script
postgresql/timescaledb/schema.sql; esto configura las nuevas hypertables de TimescaleDB. Tenga en cuenta que, desde Zabbix 7.0.0, la ubicación y el nombre del script han cambiado depostgresql/timescaledb.sqlapostgresql/timescaledb/schema.sql.
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.
Compresión de TimescaleDB
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 el frontend.
Se recomienda a los usuarios familiarizarse con la compresión en la documentación de TimescaleDB antes de utilizar la compresión.
Tenga en cuenta que existen ciertas limitaciones impuestas por la compresión, específicamente:
- No se permiten modificaciones de fragmentos comprimidos (inserciones, eliminaciones, actualizaciones)
- No se permiten cambios de esquema para tablas comprimidas.
Los ajustes de compresión se pueden cambiar en el bloque Compresión de historial, tendencias y registro de auditoría en la sección Administración > Limpieza del frontend 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 TimescaleDB. 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 se descartarán. |
Para un mejor rendimiento de actualización de tendencias, puede 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ántos items 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.