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脚本设置以下管家参数：

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

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

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前端管理→数据管家中的历史、趋势与审计日志压缩模块进行配置。