From bbadcca2948059a888ee6e2764f699c85f9b1555 Mon Sep 17 00:00:00 2001 From: ryan Date: Fri, 10 Jul 2026 11:15:12 +0800 Subject: [PATCH] =?UTF-8?q?###=20=F0=9F=9B=A0=20=E4=BF=AE=E5=A4=8D=20-=20?= =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E4=BA=86=E8=8A=82=E7=82=B9=E4=B8=8E=E4=BB=AA?= =?UTF-8?q?=E8=A1=A8=E7=9B=98=2024=20=E5=B0=8F=E6=97=B6=E5=AE=B9=E9=87=8F?= =?UTF-8?q?=E3=80=81=E7=BD=91=E7=BB=9C=E3=80=81=E7=A3=81=E7=9B=98=20IO=20?= =?UTF-8?q?=E8=B6=8B=E5=8A=BF=E5=9C=A8=E9=99=90=E6=B5=81=E6=9F=A5=E8=AF=A2?= =?UTF-8?q?=E4=B8=8B=E5=87=A0=E4=B9=8E=E4=B8=BA=E7=A9=BA=E7=9A=84=E9=97=AE?= =?UTF-8?q?=E9=A2=98=EF=BC=8C=E6=94=B9=E4=B8=BA=E5=B0=8F=E6=97=B6=E7=BA=A7?= =?UTF-8?q?=E8=81=9A=E5=90=88=E4=B8=8E=E8=AE=A1=E6=95=B0=E5=99=A8=E5=A2=9E?= =?UTF-8?q?=E9=87=8F=E7=BB=9F=E8=AE=A1=EF=BC=8C=E5=8E=86=E5=8F=B2=E6=97=B6?= =?UTF-8?q?=E6=AE=B5=E5=8F=AF=E6=AD=A3=E5=B8=B8=E5=B1=95=E7=A4=BA=E3=80=82?= =?UTF-8?q?=20-=20=E4=BF=AE=E5=A4=8D=E4=BA=86=E9=9D=99=E7=BD=AE=E5=9C=BA?= =?UTF-8?q?=E6=99=AF=E4=B8=8B=20ClickHouse=20CPU=20=E5=81=8F=E9=AB=98?= =?UTF-8?q?=E7=9A=84=E9=97=AE=E9=A2=98=EF=BC=8C=E5=8F=AF=E8=A7=82=E6=B5=8B?= =?UTF-8?q?=E4=B8=8E=E8=AE=BF=E9=97=AE=E6=97=A5=E5=BF=97=E5=86=99=E5=85=A5?= =?UTF-8?q?=E6=94=B9=E4=B8=BA=E6=89=B9=E9=87=8F=E5=87=91=E6=89=B9=E5=B9=B6?= =?UTF-8?q?=E9=99=90=E5=88=B6=E5=B0=8F=20part=20=E4=BA=A7=E7=94=9F?= =?UTF-8?q?=E3=80=82=20-=20=E4=BF=AE=E5=A4=8D=E4=BA=86=E6=95=B0=E6=8D=AE?= =?UTF-8?q?=E6=B8=85=E7=90=86=E6=8E=A5=E5=8F=A3=E5=B0=86=E3=80=8C=E7=89=A9?= =?UTF-8?q?=E5=8C=96=E8=A1=A8=20TTL=E3=80=8D=E8=AF=AF=E6=8A=A5=E4=B8=BA?= =?UTF-8?q?=E5=B7=B2=E5=88=A0=E9=99=A4=E8=A1=8C=E6=95=B0=E7=9A=84=E9=97=AE?= =?UTF-8?q?=E9=A2=98=EF=BC=8C=E7=9F=AD=E4=BA=8E=E8=A1=A8=20TTL=20=E7=9A=84?= =?UTF-8?q?=E4=BF=9D=E7=95=99=E5=A4=A9=E6=95=B0=E4=BC=9A=E8=A2=AB=E6=98=8E?= =?UTF-8?q?=E7=A1=AE=E6=8B=92=E7=BB=9D=E3=80=82=20-=20=E4=BF=AE=E5=A4=8D?= =?UTF-8?q?=E4=BA=86=E5=8F=AF=E8=A7=82=E6=B5=8B=E5=8E=BB=E9=87=8D=E5=9C=A8?= =?UTF-8?q?=E5=85=A5=E9=98=9F/=E5=88=B7=E7=9B=98=E5=A4=B1=E8=B4=A5?= =?UTF-8?q?=E5=90=8E=E4=BB=8D=E5=8D=A0=E7=94=A8=E9=94=AE=E3=80=81=E5=AF=BC?= =?UTF-8?q?=E8=87=B4=E6=95=85=E9=9A=9C=E7=AA=97=E5=8F=A3=E6=95=B0=E6=8D=AE?= =?UTF-8?q?=E6=9B=B4=E6=98=93=E4=B8=A2=E5=A4=B1=E7=9A=84=E9=97=AE=E9=A2=98?= =?UTF-8?q?=EF=BC=8C=E5=B9=B6=E5=9C=A8=20flush=20=E5=A4=B1=E8=B4=A5?= =?UTF-8?q?=E6=97=B6=E7=9F=AD=E9=87=8D=E8=AF=95=E4=B8=8E=E9=87=8A=E6=94=BE?= =?UTF-8?q?=E9=94=AE=E3=80=82=20-=20=E4=BF=AE=E5=A4=8D=E4=BA=86=20Dashboar?= =?UTF-8?q?d=E3=80=8C=E6=AF=8F=E8=8A=82=E7=82=B9=E6=9C=80=E6=96=B0?= =?UTF-8?q?=E6=8C=87=E6=A0=87=E3=80=8D=E8=A2=AB=E5=85=A8=E5=B1=80=20LIMIT?= =?UTF-8?q?=20=E6=88=AA=E6=96=AD=E5=AF=BC=E8=87=B4=E5=AE=89=E9=9D=99?= =?UTF-8?q?=E8=8A=82=E7=82=B9=E7=BC=BA=E5=A4=B1=E7=9A=84=E9=97=AE=E9=A2=98?= =?UTF-8?q?=EF=BC=8C=E6=94=B9=E4=B8=BA=E6=8C=89=E8=8A=82=E7=82=B9=E5=8F=96?= =?UTF-8?q?=E6=9C=80=E6=96=B0=E5=BF=AB=E7=85=A7=E3=80=82=20-=20=E4=BF=AE?= =?UTF-8?q?=E5=A4=8D=E4=BA=86=20Docker=20=E9=83=A8=E7=BD=B2=20ClickHouse?= =?UTF-8?q?=2025.x=20=E5=9B=A0=E5=90=8E=E5=8F=B0=E6=B1=A0=E4=B8=8E=20mutat?= =?UTF-8?q?ion=20=E7=A9=BA=E9=97=B2=E9=98=88=E5=80=BC=E4=B8=8D=E5=85=BC?= =?UTF-8?q?=E5=AE=B9=E8=80=8C=E6=97=A0=E6=B3=95=E5=90=AF=E5=8A=A8=E7=9A=84?= =?UTF-8?q?=E9=97=AE=E9=A2=98=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ### ⚡️ 优化与改进 - 为容量与 OpenResty 指标增加小时预聚合表，读路径优先 rollup，降低 24 小时趋势查询压力。 - 审计日志写入增加最长等待刷盘，管理端可观测状态接口暴露 batch writer 队列深度、丢弃与 flush 错误指标。 - 小规格场景下调 ClickHouse 客户端连接池默认值，并调整 async_insert 合并超时与流量小时表 TTL。 - 流量独立访客在小时汇总中改为窗口峰值估计，并修正界面文案，避免被误解为全局真实 UV。 ### 💄 其他/体验 - 同步环境变量与配置模板中的 ClickHouse 说明；部署文档改为将 performance.xml 下载到 ./config/clickhouse 后挂载，且不挂载 listen 配置。 --- docs/changelog/index.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/changelog/index.md b/docs/changelog/index.md index 3c5324a4..d5feebc9 100644 --- a/docs/changelog/index.md +++ b/docs/changelog/index.md @@ -18,10 +18,12 @@ sidebar: false ## [unreleased] +## [v3.1.2] - 2026-07-10 + ### 修复 -- 修复节点/仪表盘 24 小时容量、网络、磁盘 IO 趋势在 ClickHouse 限流查询下几乎为空的问题：改为基于 `of_node_metric_snapshots` / `of_node_obs_openresty` 的小时级聚合构建趋势；主机与 OpenResty 累计计数器改为按小时 delta 统计。 -- 降低静置时 ClickHouse CPU：可观测/访问日志 batchwriter 启用 `MinBatchSize` 与 `MaxFlushWait`，减少心跳小 part 写入；Docker `performance.xml` 将 `background_pool_size` 等后台线程收紧到适配 3c 小规格。 +- 修复节点/仪表盘 24 小时容量、网络、磁盘 IO 趋势在 ClickHouse 限流查询下几乎为空的问题：改为基于小时级聚合与计数器 delta 统计，避免仅依赖最近有限条原始快照导致历史时段全空。 +- 降低静置时 ClickHouse CPU：可观测/访问日志 batchwriter 启用 `MinBatchSize` 与 `MaxFlushWait`，减少心跳小 part 写入；Docker `performance.xml` 收紧小规格后台 merge 池。 - ClickHouse 清理语义：按保留天数仅 `MATERIALIZE` 表 DDL TTL，`deleted_count` 不再伪报删除；短于表 TTL 的保留请求被拒绝。 - 可观测 dedup 仅在入队成功后保留，flush 失败释放键并短重试；审计 writer 增加 `MaxFlushWait`；`/admin/status/clickhouse` 暴露 batch writer 队列深度/丢弃/flush 错误。 - model 层通过 hooks 写入 CH，去除对 `chwriter` 的直接依赖。 @@ -29,6 +31,10 @@ sidebar: false - 小规格默认连接池下调；`async_insert_busy_timeout` 调至 2s；`of_node_traffic_hourly` 增加 30 天 TTL，UV 改为峰值窗口估计并修正前端文案。 - Docker ClickHouse：`performance.xml` 下调 merge free-entry 阈值以兼容小 `background_pool`（避免 25.x 启动 Code 36）。 +### 文档 + +- 同步 `.env.example` 与 `config.example.yaml`；ClickHouse 服务端配置改为 curl `performance.xml` 到 `./config/clickhouse` 后整目录挂载至 `config.d`（不要放入 listen 配置）。 + ## [v3.1.1] - 2026-07-06 ### 修改