6 TimescaleDB 安装配置

概述

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

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

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

配置

前提条件：数据库服务器上已安装supported version的TimescaleDB扩展。安装说明请参阅Timescale 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脚本设置以下管家参数：

• 覆盖监控项历史数据保留周期
• 覆盖监控项趋势数据保留周期

要为历史和趋势数据启用分区管家功能，必须同时启用这两个选项。也可以单独为历史数据或趋势数据启用覆盖功能。

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

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

要成功通过housekeeper删除压缩数据，必须启用覆盖监控项历史数据保留周期
和覆盖监控项趋势数据保留周期选项。
如果覆盖功能被禁用且表中存在压缩数据块，housekeeper将不会从这些表中删除数据，
并且在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日志中记录警告信息，且用户无法在前端启用压缩功能。

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

• 不允许修改压缩块（插入、删除、更新操作）
• 不允许对压缩表进行模式变更

压缩设置可通过Zabbix前端管理→数据管家中的历史数据、趋势数据和审计日志压缩模块进行配置。