节点中心
本章覆盖：节点管理 / 组别 / 配置与版本。 节点是平台采集与观测的基础单元,通常对应一台安装了 Edge Agent 的服务器,或一套部署在 Kubernetes 集群中的采集组件。节点中心用于集中管理这些节点及其分组、配置。
节点管理
功能简介
节点管理用于纳管平台下的全部采集节点:查看每个节点的在线状态、主机信息、资源占用与已装插件,新建(接入)节点、编辑节点信息、删除下线节点。它是运维人员日常掌握"哪些机器在采、采得健不健康"的核心入口。
进入路径
侧边栏 → 节点中心 → 节点管理(路径 /nodes)。
界面总览
页面顶部为搜索框与状态筛选、"新建节点"按钮,下方为节点列表表格。
界面元素说明
| 区域 / 字段 | 含义 |
|---|---|
| 搜索框 | 按节点名 / IP / 组别关键字过滤列表 |
| 状态筛选 | 按全部 / 在线 / 离线 / 待定 / 失败 切换列表 |
| 新建节点 按钮 | 打开新建节点向导(需写权限) |
| 节点名 | 节点名称,点击进入该节点详情 |
| IP | 节点主机地址 |
| 状态 | 节点当前状态(在线 / 离线 / 待定 / 失败),带状态色点 |
| 组别 | 节点所属组别 |
| 系统 / 架构 | 操作系统与 CPU 架构,例如 linux · amd64 |
| 类型 | 部署类型,K8s(集群)或 Linux(服务器) |
| 版本 | 节点上 Edge Agent 的版本号 |
| CPU / 内存 | 节点当前 CPU、内存使用率(进度条展示) |
| 插件 | 该节点已安装的插件数量 |
| 最后心跳 | 最近一次上报心跳的时间,从未上报显示"从未" |
| 操作 | 编辑 / 删除该节点(需写权限) |
操作步骤
新建(接入)节点
- 点击右上角"新建节点",打开两步向导,当前处于第 1 步"填写参数"。
- 选择"部署类型":Linux 服务器(二进制 + systemd 部署到服务器)或 K8s 集群(生成 manifest 部署进集群)。
- 填写"节点名称"(必填),例如
edge-bj-prod-09。 - 可选:在"所属组别"下拉框选择组别;填写"OTel 上报地址"(OTLP gRPC,例如
otel.edge.example.com:4317)。 - 可选:填写"CPU 限制(核)"与"内存限制"(边缘 Agent 的资源硬上限,留空使用全局默认,例如 CPU 填
1、内存填512M)。 - 点击"生成部署交付物",进入第 2 步"部署交付物"。
- 复制页面给出的"安装命令"与"注册 Token",在目标主机(K8s 类型则在可访问集群、装有 kubectl 的机器)上执行,自动完成安装与注册。
- 点击"完成"关闭向导;节点注册上报后即出现在列表中,状态转为在线。
查看节点详情
- 在列表中点击任一"节点名",进入该节点详情页。
- 详情页顶部展示节点的基础信息与运行状态(主机、系统 / 架构、版本、CPU / 内存、最后心跳等)。
- 通过详情页内的标签页可进一步查看该节点的"插件"(安装 / 卸载采集插件)与"配置版本"(该节点的配置下发历史,与"配置与版本"页同源)。
编辑 / 删除节点
- 在列表某行的"操作"列点击"编辑",在弹窗中修改节点信息后保存。
- 点击"删除",在确认气泡中确认"确认删除该节点？"后完成删除。
常见问题 / 注意事项
- "新建节点""编辑""删除"等写操作仅对拥有节点写权限的账号可见,无权限时相关按钮不显示。
- 注册 Token 有效期为 24 小时,且仅用于本次注册,请在有效期内在目标主机执行安装命令;过期后请重新生成。
- 新建后节点可能先显示为"待定",待 Edge Agent 首次上报心跳后自动转为"在线"。
- CPU / 内存进度条在节点"失败"状态下会以警示色显示,便于快速定位异常节点。
- 文档中涉及的上报地址、IP 均为示例占位(如
example.com),请以实际环境地址为准。
组别
功能简介
组别用于对节点进行逻辑分组管理,例如按机房、环境(生产 / 测试)、业务线划分。合理的分组能让节点列表、总览分布、配置下发等场景按组归类,提升大规模节点场景下的管理效率。
进入路径
侧边栏 → 节点中心 → 组别(路径 /groups)。
界面总览
页面为"组别管理"卡片,右上角为"新建组别"按钮,下方为组别列表。
界面元素说明
| 区域 / 字段 | 含义 |
|---|---|
| 新建组别 按钮 | 打开新建组别弹窗(需写权限) |
| 组别名称 | 组别的名称 |
| 节点数（在线/总数） | 该组下节点的在线数(绿色)与总数 |
| 操作 | 删除该组别(需写权限) |
操作步骤
- 点击右上角"新建组别",打开"新建组别"弹窗。
- 在输入框填写组别名称。
- 点击"创建"完成新建(也可在输入框回车提交);点击"取消"放弃。
- 如需删除,在列表对应行"操作"列点击"删除",在确认气泡"确认删除该组别？"中确认。
常见问题 / 注意事项
- 新建组别、删除组别仅对拥有节点写权限的账号可见。
- 组别名称为空时无法创建,请填写有效名称后再提交。
- 删除组别前请确认组内节点已妥善迁移或不再需要该分组归类,避免影响按组别的统计与筛选。
- "节点数(在线/总数)"随节点状态实时变化,可据此快速判断某组整体健康度。
配置与版本
功能简介
配置与版本用于查看和管理单个节点的采集配置历史。平台每次下发配置都会形成一个版本记录,你可以在这里回溯某节点的配置变更、对比任意两个版本的差异,并在需要时回滚到历史版本。它为配置的"可追溯、可回退"提供保障,是排查"改了配置后采集异常"类问题的关键工具。
进入路径
侧边栏 → 节点中心 → 配置与版本(路径 /config)。
界面总览
页面顶部为节点选择下拉框,选择节点后下方显示该节点的配置版本历史表格。
界面元素说明
| 区域 / 字段 | 含义 |
|---|---|
| 选择节点 下拉框 | 按组别分组列出全部节点,支持搜索,选中后加载其版本历史 |
| 对比所选 按钮 | 勾选两个版本后点击,查看两版本差异 |
| 版本 | 配置版本序号,形如 #3 |
| 变更摘要 | 本次配置变更的简要说明 |
| 操作人 | 产生该版本的操作人 |
| 时间 | 版本生成时间 |
| 操作 | 回滚到该版本(需配置下发权限) |
| 差异区 | 对比两版本后展示的差异内容 |
操作步骤
- 在页面顶部"选择节点"下拉框中选择(或搜索)一个节点。
- 下方表格加载该节点的配置版本历史,按版本序号列出变更摘要、操作人与时间。
- 对比差异:勾选表格中的两个版本,点击"对比所选",下方差异区展示两版本的内容差异(无差异时提示"(无差异)")。
- 回滚版本:在目标版本行的"操作"列点击"回滚",在确认气泡"回滚到 #N？"中确认,平台将把该节点配置恢复为所选版本。
常见问题 / 注意事项
- 本页仅对拥有配置查看权限的账号开放,无权限时显示"无权查看配置版本"。
- "对比所选"按钮需恰好勾选两个版本才可用,勾选数量不足或过多时按钮为禁用状态。
- "回滚"操作仅对拥有配置下发权限的账号可见;回滚会生成新的配置状态并下发到节点,请确认无误后再执行。
- 若未选择节点,页面提示"请先选择一个节点";该节点的版本历史同样可在"节点详情 → 配置版本"标签页查看。