6 TimescaleDB 安装配置

概述

Zabbix 支持 TimescaleDB，这是一个基于 PostgreSQL 的数据库解决方案，可将数据自动按时间分片，以在大规模数据场景下提供更快的性能。

本页面的说明适用于以下场景：

• 创建 TimescaleDB 数据库或将现有的 PostgreSQL 表迁移至 TimescaleDB（参见 配置）。
• 在升级 Zabbix 时升级现有的 TimescaleDB 数据库模式（参见 升级 TimescaleDB 模式）。

配置

前提条件: 数据库服务器上已安装supported version的TimescaleDB扩展。 有关安装说明，请参阅TimescaleDB documentation。

为指定数据库启用TimescaleDB扩展，执行以下命令：

echo "CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;" | sudo -u postgres psql zabbix

执行此命令需要数据库管理员权限。

然后 run postgresql/timescaledb/schema.sql 脚本. 对于新安装的环境，必须在常规PostgreSQL数据库创建并初始化模式/数据后执行run脚本（参见database creation）。

cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb/schema.sql | sudo -u zabbix psql zabbix

现有历史数据、趋势数据及审计日志数据的迁移可能耗时较长 Zabbix server和前端在迁移期间必须保持关闭状态

schema.sql脚本设置了以下housekeeping参数:

• 覆盖 监控项 历史记录周期
• 覆盖 监控项 趋势周期

要使用针对历史和趋势的分区化数据清理功能，必须同时启用这两个选项。 也可以单独仅为历史数据或仅为趋势数据启用覆盖功能.

postgresql/timescaledb/schema.sql脚本设置了两个额外参数:

• 启用压缩
• 压缩超过7天的记录

要成功通过管家清理压缩数据，必须同时启用覆盖监控项历史周期和覆盖监控项趋势周期选项。 若覆盖功能被禁用且表存在压缩块，管家将不会从这些表中删除数据，同时会在Housekeeping和System information部分显示配置错误的警告信息。

所有参数均可在安装后通过管理 > Housekeeping进行修改.

升级TimescaleDB架构

当将Zabbix升级至包含新TimescaleDB超表的version版本时，Zabbix server不会自动配置这些超表（例如从Zabbix 6.4升级到7.0.3时，因为7.0.0和7.0.2版本引入了新的超表）。

要配置新的TimescaleDB超表，请按以下步骤操作：

1. 启动Zabbix server；这将升级现有数据库。
2. 检查服务器日志file确认数据库升级完成；完成后停止Zabbix server。 注意：若服务器尝试对非超表启用压缩，会记录警告日志。
3. 运行postgresql/timescaledb/schema.sql脚本；这将配置新的TimescaleDB超表。 注意：从Zabbix 7.0.0开始，脚本位置和名称已从postgresql/timescaledb.sql变更为postgresql/timescaledb/schema.sql。

TimescaleDB压缩

所有作为TimescaleDB超表的Zabbix表均支持原生TimescaleDB压缩功能。 在升级或迁移至TimescaleDB过程中，对大表的初始压缩可能耗费大量时间。

请注意压缩功能仅在"timescale" Timescale社区许可下支持，在"apache" Apache 2.0许可下不受支持。 若Zabbix检测到系统不支持压缩功能，将在Zabbix server日志中记录警告信息，且前端界面将禁用压缩选项。

需注意压缩功能存在以下限制：

• 禁止修改压缩块数据（插入/删除/更新操作）
• 禁止对压缩表进行结构变更

压缩参数可通过前端界面管理>数据管家中的历史数据、趋势数据及审计日志压缩模块进行配置。