监控集群关联
监控集群关联说明
除了在监控集群详情页中手工注册监控目标外，TEM 还支持在 创建 TiDB 集群 或 纳管 TiDB 集群 时，预先指定要关联的监控集群。
该功能在页面中显示为 监控集群关联。配置后可以：
- 先为目标 TiDB 集群选择一个已有监控系统
- 再根据监控系统类型配置对应的监控组件信息
- 在数据库集群创建或纳管完成后，自动下发监控目标注册配置
如果您已经在数据库集群流程中配置好监控关联，后续通常无需再到监控集群详情页重复手工添加同一个目标。
在创建集群时添加监控关联
在创建 TiDB 集群时，可在创建流程中的 监控集群关联 区域直接配置该能力。
注意
该功能只在常规创建流程中提供；对于
xlsb等导入类创建流程，不提供该入口。
关联配置通常包括：
- 选择一个已有监控集群
- 若所选监控为
Prometheus，选择一个 Prometheus 节点 - 若所选监控为
VictoriaMetrics，选择一台用于部署VM Agent和VM Alert的主机，以及它们对应的端口
创建流程中的使用方式
在数据库集群创建页中，该区域会作为独立配置块显示。尚未完成配置时，页面会显示 添加监控关联 入口；配置完成后，会以键值对形式展示：
- 已选监控集群
- Prometheus 节点，或
- VM Agent / VM Alert 共用主机的地址和端口
该区域没有单独的总开关，点击 添加监控关联 即可开始配置。
如需修改，可再次打开配置弹窗；如需取消，也可直接删除当前关联配置。
创建时提交的部署配置中，会携带对应的监控目标注册配置。
在纳管集群时添加监控关联
在纳管 TiDB 集群时，也可以在集群的凭证配置或关联配置区域中添加监控集群关联。
这一能力更适合以下场景：
- 希望已有 TiDB 集群在纳管后立即接入统一监控
- 希望避免纳管完成后再到监控系统详情页逐个手工注册
纳管流程中的使用方式
在数据库集群纳管页中，该区域会跟随每个待纳管集群一起显示。您可以按集群粒度分别配置监控关联，而不是对整批集群统一套用同一组配置。
页面支持：
- 添加监控关联
- 修改监控关联
- 删除监控关联
如果本次纳管包含多个集群，建议逐个检查每个集群是否都已补齐监控关联配置，避免出现部分集群纳管成功但未自动接入监控的情况。
关联项配置说明
关联时需要填写的内容与监控系统类型有关：
- 若监控系统类型为
Prometheus，核心是指定哪个Prometheus实例负责采集目标数据。 - 若监控系统类型为
VictoriaMetrics，核心是指定一台承载VM Agent与VM Alert的主机，以及它们的端口。
对于 VictoriaMetrics，系统会在可能的情况下自动分配默认端口，减少手工维护成本。
需要注意：
- 关联的监控集群必须已经存在于 TEM 中。
- 关联信息本质上是“注册监控目标”的预配置，不会替代监控集群本身的创建或纳管。
- 关联配置是否最终生效，仍需以监控集群详情页中的目标状态为准。
自动注册行为说明
数据库集群创建或纳管流程在提交时，会把监控关联信息转换成监控注册配置，并随部署请求一起发送。
因此，建议按如下方式使用：
- 如果您正在创建或纳管 TiDB 集群，优先使用 监控集群关联，实现一次性接入。
- 如果目标对象已经存在，或者后续才决定接入某个监控系统，再使用 注册监控目标 手工补充即可。
换句话说，监控集群关联 更适合“在数据库集群生命周期开始时就一并接入监控”，而 注册监控目标 更适合“在监控集群侧补录或后续维护目标对象”。
配置后的结果判断
完成数据库集群创建或纳管后，建议到目标监控集群详情页检查以下内容：
- 在 监控目标 标签页中确认目标对象是否已经出现
- 在 指标管理 和 告警规则 页面中确认是否已经可以选择该目标对象
如果关联已配置但目标仍未出现，可再回到监控集群侧手工执行一次 注册监控目标。
相关数据库集群文档可参考：