哪吒监控 TSDB 时序数据库配置详解

哪吒监控（Nezha Monitoring）是一个开源的服务器监控工具，默认配置中 TSDB（时序数据库）部分是空的 tsdb: {}。本文介绍如何配置 TSDB 来存储历史监控数据。

什么是 TSDB

TSDB（Time Series Database）是时序数据库，用于存储按时间顺序排列的数据点。哪吒监控使用内置的 TSDB 来存储服务器的 CPU、内存、网络等历史监控数据，让你可以查看历史趋势图表。

配置文件位置

哪吒监控的配置文件位于：

/opt/nezha/dashboard/data/config.yaml

默认配置中 TSDB 部分是空的：

tsdb: {}

TSDB 配置参数详解

将 tsdb: {} 替换为以下配置：

tsdb:
  data_path: /opt/nezha/dashboard/data/tsdb
  retention_days: 30
  min_free_disk_space_gb: 1.0
  max_memory_mb: 256
  write_buffer_size: 1024
  write_buffer_flush_interval: 60

参数说明

• data_path：TSDB 数据存储路径，建议放在 dashboard 数据目录下
• retention_days：历史数据保留天数，默认 30 天，可根据磁盘空间调整
• min_free_disk_space_gb：最小保留磁盘空间（GB），当磁盘空间不足时会停止写入数据
• max_memory_mb：TSDB 最大内存使用（MB），防止占用过多系统资源
• write_buffer_size：写缓冲区大小，影响写入性能
• write_buffer_flush_interval：缓冲区自动刷新间隔（秒）

配置步骤

1. 编辑配置文件：

   sudo nano /opt/nezha/dashboard/data/config.yaml

2. 找到 tsdb: {} 行，替换为上述配置
3. 保存文件并重启哪吒面板

重启面板

独立安装方式

cd /opt/nezha
./nezha.sh
# 选择 3 (重启并更新面板)

Docker 安装方式

cd /opt/nezha/dashboard
docker compose down
docker compose up -d

验证配置

重启后，检查 TSDB 数据目录是否自动创建：

ls -la /opt/nezha/dashboard/data/tsdb/

如果目录存在且有数据文件生成，说明 TSDB 配置成功。

环境变量方式（Docker）

如果使用 Docker 部署，也可以通过环境变量配置 TSDB：

environment:
  - NZ_TSDB_DATA_PATH=/data/tsdb
  - NZ_TSDB_RETENTION_DAYS=30
  - NZ_TSDB_MIN_FREE_DISK_SPACE_GB=1.0
  - NZ_TSDB_MAX_MEMORY_MB=256

环境变量使用 NZ_ 前缀，将下划线转换为点，例如 NZ_TSDB_DATA_PATH 对应配置项 tsdb.data_path。

存储空间建议

根据监控服务器数量和保留天数，TSDB 数据大小会有所不同。建议：

• 1-5 台服务器，30 天数据：约 500MB - 2GB
• 5-20 台服务器，30 天数据：约 2GB - 8GB
• 建议预留至少 10GB 磁盘空间

总结

配置 TSDB 后，哪吒监控可以存储历史监控数据，让你查看服务器性能趋势。合理设置 retention_days 和 min_free_disk_space_gb 可以避免磁盘空间不足的问题。