注册监控目标
监控目标概览
监控目标用于说明“某个监控集群正在监控哪些 TiDB 集群或主机”。
在监控集群详情页的 监控目标 标签页中,您可以查看当前已注册的目标对象。列表中通常会显示以下信息:
- 监控目标:目标对象名称,若为 TiDB 集群可直接跳转到对应集群页。
- 监控类型:当前目标是
TiDB 集群还是主机。 - 注册状态:包括 待注册、注册中、已注册 和 失败。
- 监控组件:当前目标使用的监控组件及其地址。
- 组件版本:监控组件版本。

添加监控目标
在监控目标页面右上角,点击 添加监控目标 按钮即可进入注册流程。
当前注册流程支持两类目标:
- TiDB 集群
- 主机
系统只会显示当前可注册的目标对象。
选择目标类型
进入弹窗后,页面会先展示当前监控集群名称和监控集群类型。随后,您需要依次选择:
- 目标类型
- 目标 TiDB 集群 或 目标主机
只有满足当前未注册筛选条件的对象才会出现在可选列表中。

选择监控组件
不同监控系统类型的配置方式不同:
Prometheus 监控系统
如果监控集群类型为 Prometheus,注册目标时需要额外选择一个现有的 Prometheus 节点,由该节点负责对目标对象实施监控。
VictoriaMetrics 监控系统
如果监控集群类型为 VictoriaMetrics,注册流程会根据目标类型提供不同方式:
- 注册 主机 时,可以在存在可用组件对的情况下直接选择已部署的
VM Agent + VM Alert组件,也可以重新部署一组新组件。 - 注册 TiDB 集群 时,系统会为该目标下发
VM Agent和VM Alert组件配置。
使用已部署组件或重新部署组件
当监控集群类型为 VictoriaMetrics 且目标类型为 主机 时,如果当前监控集群中存在可复用的 VM Agent + VM Alert 组件对,页面会显示 部署方式 选择:
- 选择已部署组件
- 重新部署组件
如果选择 选择已部署组件,只需从现有组件对列表中挑选一组即可。
如果选择 重新部署组件,则需要继续选择用于部署 VM Agent 和 VM Alert 的主机。
端口处理规则
对于需要重新部署组件的场景,端口处理方式与环境有关:
- 如果当前监控集群支持自动分配端口,系统通常会自动申请合适端口。
- 如果当前环境不支持自动分配,则页面会要求您手工填写 VM Agent 端口 和 VM Alert 端口。
校验并发起注册
点击确认后,系统不会立即提交注册结果,而是会先执行一次注册校验:
- 生成本次目标注册配置
- 调用注册预检查
- 轮询检查报告,确认校验是否通过
- 校验通过后,再正式发起监控目标注册
如果校验失败,请根据页面返回的失败信息修改目标对象、主机、端口或组件选择后重试。
校验通过并正式提交后,系统会提示正在添加监控目标。此时目标对象通常不会立刻变为已注册,而是会先经历:
- 待注册
- 注册中
- 已注册 或 失败
注销与重新注册
已注册的目标对象支持后续维护:
- 移除监控目标:在操作菜单中点击 移除监控目标,可将该目标从当前监控集群中注销。
- 查看监控目标拓扑:对于 TiDB 集群目标,可查看当前目标下各组件实例的监控覆盖情况。
- 更新监控拓扑:当某些实例未被正常覆盖时,可在监控目标拓扑弹窗中点击 更新监控拓扑,发起一次重新注册。
查看监控目标拓扑
对于 TiDB 集群目标,您可以打开 监控目标拓扑 弹窗,查看每个组件实例当前是否已被覆盖。该弹窗会按组件列出实例地址,并显示 是否已监控。
如果发现某些实例显示为未覆盖,可使用 更新监控拓扑 发起重新注册,以同步最新拓扑信息。
如果页面提示当前没有监控目标,请先完成一次目标注册,之后才能继续使用指标管理和告警规则功能。