设备
管理、监控和控制你的 IoT 设备集群。
设备列表
导航到设备 → 设备查看租户中所有已注册的设备。
列表显示：
- 名称 / 序列号 — 人类可读的名称和硬件序列号
- 分组 — 设备组成员关系
- 状态 —
在线/离线 - 固件 — 上报的固件/操作系统版本
- IP 地址 — Agent 上报的最新 IP
- 最后在线 — 最后一次心跳时间戳
过滤
使用过滤栏按以下条件筛选设备：
- 状态 — 在线 / 离线 / 全部
- 分组 — 选择一个设备组
- 最后在线 — 24 小时内 / 7 天内 / 从未上线
注册设备（认领令牌）
设备使用一次性认领令牌自注册：
- 在设备列表工具栏中点击生成认领令牌。
- 可选择在认领时将设备分配到一个分组。
- 设置 TTL（令牌有效时长）。
- 复制生成的令牌 — 它不会再次显示。
在设备上运行：
bash
umoo-agent --claim-token <TOKEN> --server <UMOO_GRPC_ADDR>Agent 发送令牌和证书签名请求（CSR）。后端验证令牌，使用平台 CA 签署 CSR，并返回设备证书。Agent 随后转换到同步状态并开始正常运行。
设备详情
点击任何设备行打开详情面板。标签页：
详情标签
- 硬件信息（操作系统、CPU、内存）
- Agent 上报的网络接口
- 设备元数据（分组、序列号、创建日期）
影子标签
显示期望状态和上报状态的 JSON 树。
- 期望状态 — 后端希望设备执行的操作
- 上报状态 — Agent 最后上报的状态
要更新期望状态，点击设置期望状态，输入 JSON 并保存。
终端标签
通过 WebSocket 打开到设备的完整浏览器终端会话。需要启用 terminal 插件且设备在线。
详见终端。
监控标签
实时遥测面板（CPU、内存、磁盘、网络、Agent 健康状况）。需要启用 telemetry 插件。
面板通过 Prometheus 查询实时更新。
事件标签
显示此设备相关的事件日志（注册、状态变更、发布事件、自定义插件事件）。
日志标签
实时流式传输设备日志。需要启用并配置 logs 插件。
设备组
导航到设备 → 分组管理设备组。
分组用于：
- 将发布目标定位到子集
- 应用共享的插件配置
- 过滤设备列表视图
创建分组
- 点击 + 创建分组。
- 输入名称和可选的描述。
- 点击创建。
添加设备到分组
打开分组详情，点击设备标签，然后点击添加设备。从未分组的设备中选择。
插件配置覆盖
每个分组可以覆盖租户级别的插件默认值。打开分组详情，点击插件标签，配置每个插件的设置。留空字段将继承租户默认值。
设备状态
| 状态 | 含义 |
|---|---|
在线 | Agent 已连接，心跳正常 |
离线 | 在配置的超时时间内没有心跳 |
待认领 | 已发出认领令牌，Agent 尚未连接 |
编辑设备
点击设备行的 ⋮ 菜单 → 编辑。可以更新：
- 显示名称
- 序列号
- 分组分配