v1.20.22 · Agent 指标准确性修复

修复 Agent 采集与 Dashboard 展示中会造成指标偏差的问题。

• 主机 CPU 与每核 CPU 使用相同采样区间；进程 CPU 改为最近两轮增量，内存统一采用总量减可用量。
• 磁盘按实际设备分别计算 I/O，去除整盘、分区及绑定挂载的重复统计；网络按网卡差分计算，支持 network_interfaces 白名单。
• Docker 使用有界并发采样，按官方 CLI 口径计算内存并读取实际重启次数；首样本、重启及失败均保留不可用状态。
• 当前数据不再被旧趋势覆盖；过期指标不参与实时汇总，趋势使用真实时间并保留极值、断开缺报区间。无效吞吐样本不会误恢复告警。
• 新增可空 network_json 历史元数据列，兼容旧 Agent 和既有历史；Windows PowerShell 5.1 更新脚本保持 UTF-8 BOM。

验证：服务端 140 项、前端 75 项通过，Agent Linux/Windows × amd64/arm64 编译通过。Linux 专项回归 41 项通过、2 项按环境跳过；候选采集器在实际服务器上与 /proc 完成三轮只读对照。

升级顺序：先通过总控在线更新升级 Dashboard/Server/Setup 和受管 controller-agent，再按需要更新独立 Agent。新口径从升级后的采样开始，旧历史不自动重算。网络累计值不是月度计费流量；修正接口范围后可能出现一次统计口径变化。

指标说明：https://xcmon.xciy.cn/guide/metric-accuracy

v1.20.21 · 修复旧环境在线更新与 Agent 安装

旧 Setup 容器使用 BusyBox 工具时，v1.20.20 更新器会在创建部署快照前因 realpath 参数不兼容而退出。v1.20.21 兼容旧运行环境，保留路径、符号链接和目录边界校验。

本版同时包含 v1.20.20 的 Agent 安装修复：兼容 Bash 4.2/4.3 空数组、终端粘贴回车与隐藏令牌输入，下载完整引导脚本并校验后才执行，HTTPS 错误提供明确提示。

验证：真实 Bash 4.2 安装/更新行为测试；真实 v1.20.19 和 v1.20.20 Setup 运行时的更新成功、失败回滚、符号链接拒绝与预备份复用测试。发布流程另校验双架构镜像、腾讯云公开拉取、Agent 文件摘要及完整离线包。

已有在线部署优先在“系统设置 → 系统更新”检查并更新到 v1.20.21。更新完成后刷新设备页面，重新生成一次性 Agent 接入令牌并复制新安装命令，等隐藏输入提示出现后粘贴令牌。

官网文档：https://xcmon.xciy.cn/monitored-agent
排障说明：https://xcmon.xciy.cn/faq

星辰监控 v1.20.20

修复旧版 Linux 和网页终端中的 Agent 安装失败，统一更新 Controller、Dashboard、Agent 及安装文档。

• 兼容 Bash 4.2/4.3 的严格变量检查，修复可选数组为空时的 unbound variable。
• Linux 安装命令先完整下载再执行，保留下载和安装退出码，兼容粘贴末尾 CR；空响应立即停止。
• 接入令牌隐藏输入支持末尾回车清理，缺少参数时给出中文恢复提示；TLS/NSS 错误按下载阶段说明。
• 发布前新增真实 Bash 4.2 安装与更新检查，并验证普通 Linux 用户的测试权限。

v1.20.19 总控可在控制台检查更新后直接在线升级。v1.20.18 及更早版本先按旧版迁移文档处理。升级完成后刷新控制台，重新复制 Agent 安装命令，并在提示出现后粘贴新的一次性接入令牌。

应用和基础镜像同步至腾讯云 ccr.ccs.tencentyun.com/xc_monitor，提供 Linux amd64/arm64 离线总控包及 Linux/Windows amd64/arm64 Agent。

Agent 安装指南 · 安装故障排查

星辰监控 v1.20.19

Linux 总控现在从目标稳定版本的 Setup 镜像取得更新包，校验版本、架构和 SHA256 后执行匹配版本的更新器与 Compose。已有部署不再需要 Git 工作目录。

在线升级增加磁盘预检、全程互斥锁、数据库备份及配置快照。健康检查失败或取消后恢复旧配置和实际运行镜像；恢复失败保留快照并阻止后续更新。数据库不会自动回退，备份保留供人工恢复。

切换腾讯云镜像源时，即使关闭总控自监控，也会保存正确的 Agent 镜像来源。Setup 取消任务会留出回滚时间，并准确保留回滚结果。

v1.20.18 及更早部署需要使用已校验的 v1.20.19 管理器和引导器完成首次迁移。迁移后可在控制台检查和触发更新，通过 Gitee 发现稳定版本，从腾讯云拉取对应镜像。

验证覆盖 Setup Go 测试、Linux/Windows 安装与更新测试、93 项原生 Linux 引导器用例，以及隔离 Docker 包提取、运行环境兼容性和锁继承检查。发行工作流在公开发布前进一步验证双架构镜像、Agent 制品和离线包。

星辰监控 v1.20.18

星辰监控 v1.20.18 完善 Dashboard 与 Agent 的安装、更新和腾讯云镜像发布流程。

更新内容

• 总控统一管理命令保留自定义安装目录、镜像来源和制品配置；同版本切换镜像源时也会实际重建服务。
• Linux/Windows Controller 安装等待所需服务健康，保留宿主 Agent 开关、名称和分组。
• 原生 Agent 安装和更新验证实际程序版本，固定版本源码回退检出对应标签。
• Windows Agent 重装保留同设备身份与未显式覆盖的配置；更新先备份，失败后停止新服务再恢复旧程序。
• 手动检查更新立即刷新发布源；发布清单切换期间，已选 Agent 版本可继续从受信缓存下载。
• 腾讯云六镜像按源 digest 复制并验证目标摘要及 amd64/arm64；离线包使用同批基础镜像。

安装与升级

已有 Linux 总控使用 sudo xingchen update；中国模式继续使用 Gitee 与腾讯云 TCR。升级前会备份 PostgreSQL，再切换镜像并检查健康。

已有 Agent 应使用 updater 的 update 或控制台灰度发布。Linux 重复执行 install 仍会按安装参数生成配置。

完全离线的新装与升级分别使用架构对应离线包内的 install-offline 和 upgrade-offline 入口，并先验证 SHA256。数据库迁移不会随镜像自动回滚。

完整变更：CHANGELOG
部署说明：部署与运维

星辰监控 v1.20.17

Full Changelog: v1.20.16...v1.20.17

星辰监控 v1.20.16

Full Changelog: v1.20.15...v1.20.16

星辰监控 v1.20.15

Full Changelog: v1.20.14...v1.20.15

星辰监控 v1.20.14

Full Changelog: v1.20.13...v1.20.14

星辰监控 v1.20.13

Full Changelog: v1.20.12...v1.20.13