22 lines
1.4 KiB
Markdown
22 lines
1.4 KiB
Markdown
# 磁盘发现与显示
|
|
|
|
## 使用
|
|
|
|
在 Console → 系统配置 → 选择设备 → 磁盘设置中点击“扫描磁盘”，显式发现新增磁盘。打开页面、普通刷新和重启不执行新增磁盘发现。扫描失败保留已有清单；不执行挂载、格式化或分区操作。
|
|
|
|
已知磁盘容量每周刷新，CPU、内存与网络按自身周期采集。摘要显示实际采集时间；缺失指标不补零，采集失败不据此确认告警恢复。
|
|
|
|
显示名称、同组顺序与隐藏偏好统一保存到 Console，首页与配置页共用；Agent 已有名称和隐藏定义作为默认值。隐藏只影响显示，不停止采集或删除历史。
|
|
|
|
## Agent 行为
|
|
|
|
认证接口 `PUT /api/v1/storage/scan` 读取块设备和挂载点，持久化清单到对应配置旁的 `.storage.json`。监控服务读取清单；新增磁盘须再次手动扫描。根分区指标保留兼容，服务重启可复用容量缓存，整机重启后的容量初始化不自动发现新磁盘。
|
|
|
|
UUID 优先作为标识，其次为设备序列号和分区编号，再退回路径并标记 `stable_identity=false`。重复挂载及 loop/swap 等伪设备不展示；未挂载设备不伪造使用率。配置过的磁盘在扫描未发现时保留为断开状态。
|
|
|
|
磁盘扫描不执行 SMART 或自检；SMART 能力以本项目的独立说明为准。
|
|
|
|
## 相关说明
|
|
|
|
[中文首页](../README.zh-CN.md) · [文档目录](README.md)
|