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 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:
- Crear una base de datos TimescaleDB o migrar desde tablas PostgreSQL existentes a TimescaleDB (consulte Configuración).
- Actualizar un esquema de base de datos TimescaleDB existente al actualizar Zabbix (consulte Actualización del esquema de TimescaleDB).
Configuración
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:
- Anular el período de histórico de métricas
- Anular el período de tendencias de métricas
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, 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.
Actualización del esquema de TimescaleDB
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:
- Inicie el servidor Zabbix; esto actualizará la base de datos existente.
- Verifique en el archivo de registro del servidor que la actualización de la base de datos se haya completado; cuando se complete, 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 tabla hiper.
- Ejecute el script
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 depostgresql/timescaledb.sqlapostgresql/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.
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 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:
- No se permiten modificaciones de fragmentos comprimidos (inserciones, eliminaciones, actualizaciones)
- No se permiten cambios de esquema para tablas comprimidas.
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.