PuppyIP 资源中心
网络与连接排错 10 分钟 发布于 2026-11-17

Nezha service_histories SQLite 占满磁盘:TSDB 切换前后的安全检查

Nezha 历史记录数据库变大时,先分别测量 SQLite、journal 和 Docker 日志;启用 TSDB 不等于旧数据库已迁移或回收。

Nezha SQLite service_histories TSDB Docker 日志 Linux 磁盘

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • Linux 磁盘占用可能来自 Nezha SQLite、SQLite journal 和 Docker JSON 日志,不能只看一个大数据库文件。
  • 启用 TSDB 后仍需核对当前版本的写入与读取状态;旧 SQLite 不会因此自动证明已迁移或可删除。
  • 备份和完整性检查要在了解数据库大小、写入状态和剩余空间后安排;大库 VACUUM 可能需要额外空间。
  • 只有确认业务不再读写旧历史、备份可恢复且版本文档支持后,才制定旧库保留或清理计划。

分清数据库增长与其他磁盘占用

Nezha 面板运行时间增长后,历史记录可能让 SQLite 数据库变大;journal 或 WAL 文件也可能在活跃写入时占用空间。若面板运行在 Docker 中,容器 JSON 日志同样会增长。因此看到磁盘不足或数据库写入失败时,先确认根分区及各目录的实际占用,不要直接删除 SQLite 文件、journal、整个容器目录或所有日志。

启用 TSDB 是改变历史数据存储路径的一项配置,不等于旧 SQLite 记录已自动搬迁、压缩或删除。不同 Dashboard 版本对初始化、兼容读取和旧数据保留的行为可能不同,必须按实际运行版本的官方说明核对。服务历史能够展示也不证明之后的新写入已落到预期后端。

只读检查分区、数据库和 Docker JSON 日志

先运行只读检查,分别统计根分区、Nezha 数据目录和 Docker 容器日志。将路径占位符替换成当前实际数据目录;如果 Docker 不使用 json-file 日志驱动,下面的查找结果可能为空。容器路径和文件名可能泄露部署信息,分享前应脱敏。

sqlite3 可用且数据库允许低负载读取时,再查看表清单或做完整性检查。完整性检查可能读遍大型数据库,应预留时间和磁盘 I/O;如果数据库正处于高负载写入,不要在生产高峰执行。

按来源查看磁盘占用

sh
df -h /
du -sh /PATH/TO/NEZHA-DATA /var/lib/docker/containers 2>/dev/null
find /var/lib/docker/containers -type f -name '*-json.log' -printf '%s %p\n' 2>/dev/null | sort -nr | head -n 20
stat -c '%s %n' /PATH/TO/NEZHA.sqlite* 2>/dev/null
在 Linux 主机运行只读统计;用真实数据目录替换占位符。输出可能包含容器标识和路径,公开前应脱敏。

可选的 SQLite 只读检查

sh
sqlite3 /PATH/TO/NEZHA.sqlite 'PRAGMA integrity_check;'
sqlite3 /PATH/TO/NEZHA.sqlite 'SELECT name FROM sqlite_master WHERE type="table" ORDER BY name;'
仅在 sqlite3 已安装、数据库路径确认且读取负载可接受时使用;这是只读查询,不会迁移或修复数据库。

核对 TSDB 是否真正接收新历史

切换存储前,确认当前 Nezha Dashboard 版本、配置文件来源、TSDB 后端地址、认证方式和持久化卷。按同一版本的官方说明完成配置,并保留原 SQLite 文件和配置备份。不要从旧教程复制环境变量或假定容器重建后绑定目录不变;配置名称和迁移流程可能随版本调整。

启用后检查 Dashboard 启动日志、TSDB 服务状态以及新产生的服务历史是否按预期可读。只看配置开关、容器启动或新建目录,不足以证明数据写入正常。若新增历史没有出现、查询报错或认证失败,先停止清理旧库,恢复已备份的配置并按原 SQLite 路径检查服务。

先备份与验证,再考虑 SQLite 压缩或清理

维护数据库前先用应用支持的方式生成一致性备份,并验证备份文件可读、大小合理且可在隔离副本上恢复。运行中的 SQLite 数据库可能伴随 journal/WAL 文件;盲目复制其中一个主文件不能保证得到完整快照。若应用提供受控备份或 SQLite 在线备份机制,按当前版本的正式说明操作。

VACUUM 会重建数据库,可能需要接近数据库大小的额外可用空间,并改变文件布局;它不是应急释放空间命令。删除旧历史、清理 journal 或移除旧数据库前,先确认保留要求、TSDB 新数据完整性、面板是否仍读旧库,以及回滚时是否能恢复原格式。空间不足以完成安全备份时,应先扩容或转移备份位置,不应冒险删除唯一副本。

将 Docker 日志作为独立占用来源处理

如果 Docker JSON 日志是主要占用,先确认具体容器和写入量,再查看 Docker 官方文档支持的日志轮转配置。修改日志驱动或轮转参数通常需要重建容器才生效;安排停机窗口,并保留 compose、容器参数和卷映射备份。不要用 docker system prune 或通配删除容器目录来代替轮转配置。

SQLite journal、应用历史和 Docker stdout/stderr 日志有不同生命周期。调整其中一项,不应覆盖其他数据的保留要求。变更后分别观察文件增长率、容器重启状态、Dashboard 历史查询和磁盘剩余空间;不要只凭一次 df 输出判定容量问题已解决。

完成标准和回退条件

只有确认 Dashboard 可正常写入并读取新历史、数据库完整性检查符合预期、Docker 服务和持久化卷健康、剩余空间稳定,才能关闭容量排查。TSDB 端可用不代表旧 SQLite 已失去用途;旧库的迁移范围和历史保留策略应按具体版本文档与业务要求核验。

若切换后查询失败或历史记录缺失,先停止对旧库的清理,按备份恢复原配置和存储挂载,再检查原 SQLite 服务。TSDB 初始化结果、Dashboard 版本行为和旧库可删除条件未确认时,保留旧数据并记录为待复核。

资料来源

常见问题

启用 TSDB 后可以马上删除 Nezha 的 SQLite 数据库吗?

不可以仅凭配置启用就删除。先确认当前版本的新历史写入、查询、迁移范围和备份恢复,并核对旧库是否仍被读取。

SQLite 文件旁边的 journal/WAL 能直接删除吗?

不能。它们可能参与活跃数据库事务。先确认数据库是否正在运行并按正式备份/维护流程处理,不要直接删文件释放空间。

数据库很大时可以运行 VACUUM 吗?

只有在有足够额外空间、完整备份和维护窗口时才评估。VACUUM 会重建文件,可能需要大量临时空间,不适合磁盘已满时盲目执行。

Docker 日志占空间,能否清空整个容器目录?

不要这样做。确认具体日志驱动和容器后,按 Docker 官方方式配置轮转并在维护窗口应用;不要删除容器数据卷或历史数据库。