设备管理
如何高效管理分布式设备，确保设备稳定运行?
典型场景:
- 需要实时监控设备运行状态，及时发现设备问题
- 需要远程查看设备画面，了解设备运行情况
- 需要远程控制设备，进行重启或配置更新
- 需要管理设备资源，优化设备使用
设备管理就是为了解决这些问题而设计的。通过 Agent 客户端程序，平台可以实时监控设备运行状态、资源使用情况，接入视频流实现远程可视化监控，并提供远程接管功能。
快速上手:注册第一个设备
第 1 步:注册设备
- 进入设备管理页面，点击"机器人设备注册"按钮
- 填写设备信息:
- 设备唯一编号:用于标识设备(必填)
- 备注说明:记录设备用途、位置等信息(可选)
- 所属机器人:将设备关联到特定机器人(可选)
- 项目:将设备分配到特定项目(可选)
- 点击"注册设备"完成注册
注册成功后，系 统会为该设备生成唯一的 Agent ID，用于后续的 Agent 安装和身份识别。
第 2 步:安装 Agent
- 在设备列表中选择需要安装 Agent 的设备
- 点击"安装 Agent"按钮，打开安装对话框
- 复制安装命令到目标设备终端执行
- 系统会自动检测操作系统并完成安装
- 安装完成后，Agent 会自动启动并开始上报设备信息
支持的平台:
- macOS (Intel 和 Apple Silicon)
- Linux (X64 和 ARM64)
- Windows (X64)
第 3 步:查看设备状态
- 在设备列表中查看设备状态
- 点击设备名称进入设备详情页面
- 查看实时监控数据和资源趋势
- 查看视频流(如果已配置)
设备注册与检测
如何注册设备?
注册流程:
- 点击"机器人设备注册"按钮
- 填写设备唯一编号(必填)
- 填写备注说明(可选)
- 选择所属机器人和项目(可选)
- 点击"注册设备"完成注册
注册后:
- 设备会出现在设备列表中
- 系统会生成唯一的 Agent ID
- 可以进行后续的 Agent 安装和监控操作
如何检测设备状态?
检测机制:
- 系统每 5 分钟自动检查一次设备状态
- 通过 Agent 上报信息判断设备在线状态
- 显示最后检查时间，便于了解设备状态更新情况
- 对于长时间未上报的设备，系统会标记为离线状态
设备状态:
- 未安装:设备尚未安装 Agent，显示安装指导
- 已安装:Agent 已安装并运行，显示最后上报时间
- 离线:Agent 已安装但长时间未上报，可能设备离线或 Agent 异常
Agent 客户端安装
如何 安装 Agent?
安装方式:
- 命令行安装:一键式命令行安装，适用于 Linux 和 macOS
- 可执行文件下载:手动下载并运行可执行文件
安装步骤:
- 在设备管理页面选择需要安装 Agent 的设备
- 点击"安装 Agent"按钮
- 复制安装命令到目标设备终端执行
- 系统会自动检测操作系统并完成安装
- 安装完成后，Agent 会自动启动并开始上报设备信息
环境变量: 安装命令会自动设置必要的环境变量:
EMBODIFLOW_AGENT_ID:设备的唯一 Agent IDEMBODIFLOW_SERVER_URL:平台服务器地址EMBODIFLOW_INTERVAL:数据上报间隔(默认 300 秒，即 5 分钟)
如何查看安装状态?
安装状态:
- 未安装:设备尚未安装 Agent，显示安装指导
- 已安装:Agent 已安装并运行，显示最后上报时间
- 离线:Agent 已安装但长时间未上报，可能设备离线或 Agent 异常
对于未安装或离线状态的设备，系统会提供相应的操作建议和故障排查指导。
设备列表管理
如何查看设备列表?
列表功能:
- 多项目筛选:按项目筛选设备，支持"全部项目"和具体项目
- 搜索功能:按设备名称快速搜索设备
- 状态筛选:按在线状态、Agent 安装状态等筛选
- 批量操作:支持批量选择设备进行操作
设备信息:
- 设备名称和所属项目
- 系统信息和设备 IP
- CPU 使用率和内存使用率
- 在线时间
如何进行批量操作?
批量操作:
- 批量删除:删除选中的设备(需确认)
- 批量下发采集任务:为选中的设备批量分配采集任务
- 批量安装 Agent:为多个设备批量安装 Agent
设备详情页面
如何查看设备详情?
详细信息:
- 实时监控卡片:CPU 使用率和温度、内存使用情况、磁盘使用情况、网络连接状态
- 资源趋势图表:支持切换"资源趋势"和"温度与负载"两个视图，可查看 4 小时、1 天、7 天的历史数据
- 系统信息:完整的系统配置信息、设备运行时间、网络配置信息
操作功能:
- 编辑设备信息:修改设备名称、备注等信息
- 安装 Agent:为设备安装或重新安装 Agent
- 远程控制:执行重启、SSH、配置管理等操作
- 视频监控:查看设备实时视频流
资源监控
如何监控设备资源?
实时监控: Agent 客户端会定期收集设备的系统资源使用情况，每 5 分钟自动上报一次:
- CPU 监控:CPU 使用率、CPU 温度、CPU 核心数和使用情况、CPU 负载趋势
- 内存监控:内存使用率、已用内存、总内存容量、内存使用趋势
- 磁盘监控:磁盘使用率、已用磁盘空间、可用磁盘空间、磁盘读写速度
- 网络监控:活跃 TCP 连接数、网络流量统计、网络接口状态
资源趋势分析: 系统提供资源使用趋势图表，支持查看不同时间范围的数据:
- 4 小时:查看最近 4 小时的资源使用趋势
- 1 天:查看最近 1 天的资源使用情况
- 7 天:查看最近一周的资源使用趋势
趋势图以折线图形式展示 CPU、内存、磁盘的使用率变化，帮助:
- 识别资源使用峰值和低谷
- 发现异常的资源使用模式
- 预测资源需求，提前规划
- 优化设备配置和资源分配
如何查看系统信息?
系统信息:
- 操作系统:操作系统类型和版本
- Hostname:设备主机名
- 内核版本:系统内核版本信息
- 运行时间:设备连续运行时间
- 设备 IP:设备的网络 IP 地址(支持多 IP 显示)
这些信息帮助管理员快速了解设备的基本配置和运行状态。
视频流接入与监控
如何接入视频流?
视频流功能: Agent 客户端支持将设备上的视频流推送到平台，实现远程可视化监控:
- 实时查看机器人设备的相机视角
- 监控设备运行环境和状态
- 远程观察数据采集过程
- 及时发现设备异常情况
视频流特性:
- 支持多路视频流同时接入
- 低延迟实时传输
- 自适应码率调整
- 断线自动重连
如何查看视频流?
视频监控界面:
- 实时播放器:显示设备实时视频流，支持全屏播放
- 连接状态:显示视频流连接状态(已连接/未连接)
- 刷新功能:支持手动刷新视频流连接
- 播放控制:支持播放、暂停、音量控制等基本操作
当设备未连接到视频服务时，系统会显示提示信息，并提供刷新按钮重新连接。
远程接管功能
如何进行远程控制?
远程控制操作:
- 设备重启:支持远程重启设备，无需物理接触。重启前会进行安全检查，防止误操作。重启后自动恢复 Agent 连接和监控。
- SSH 连接:提供 SSH 远程登录功能，支持通过平台直接 SSH 连接到设备，便于进行高级配置和故障排查。
- 配置管理:远程查看和修改设备配置，支持配置文件的上传和下载，配置变更历史记录。
远程接管场景
使用场景:
- 设备故障处理:当设备出现异常时，可以远程重启或进行诊断
- 配置更新:远程更新设备配置，无需现场操作
- 数据采集监控:通过视频流实时监控采集过程，确保数据质量
- 设备维护:远程执行维护操作，提高维护效率
操作权限控制
权限管理:
- 只有管理员、项目经理、采集员可以使用远程接管功能
- 不同角色具有不同的操作权限
- 所有远程操 作都会记录在操作日志中
- 支持操作审批流程(可选)
常见问题
设备显示离线怎么办?
排查步骤:
- 检查设备网络连接是否正常
- 检查 Agent 是否正常运行
- 检查 Agent 配置是否正确
- 尝试重新安装 Agent
如何重新安装 Agent?
重新安装:
- 在设备详情页面点击"安装 Agent"
- 复制安装命令到目标设备执行
- 等待安装完成并验证连接
视频流无法连接怎么办?
排查步骤:
- 检查设备上的视频服务是否正常运行
- 检查网络连接是否正常
- 尝试刷新视频流连接
- 查看设备日志了解详细错误信息
适用角色
管理员
你可以:
- 统一注册设备
- 监控运行健康度
- 审计远程操作
- 在出现异常时优先触发远程接管或故障排查
项目经理
你可以:
- 按项目维度查看设备资源
- 协调采集任务分配
- 跟踪资源使用趋势
- 结合视频流确认采集质量
采集员
你可以:
- 实时查看分配设备的状态与画面
- 及时反馈异常
- 在需要时申请远程协助(如重启或配置更新)
相关功能
完成设备管理后，你可能还需要: