This documentation is for a release that is no longer maintained
See documentation for the latest supported version 3 or the latest supported version 4.2.12. 在指标中添加集群 ID 标签
如果您管理多个 OpenShift Container Platform 集群,并使用远程写入功能将指标数据从这些集群发送到外部存储位置,您可以添加集群 ID 标签来识别来自不同集群的指标数据。然后,您可以查询这些标签来标识指标的源集群,并区分与其他集群发送的类似指标数据的数据。
这样,如果您为多个客户管理多个集群,并将指标数据发送到单个集中存储系统,您可以使用集群 ID 标签查询特定集群或客户的指标。
创建并使用集群 ID 标签涉及三个常规步骤:
- 配置远程写入存储的写重新标记设置。
- 将集群 ID 标签添加到指标。
- 查询这些标签以标识源集群或指标客户。
2.12.1. 为指标创建集群 ID 标签 复制链接链接已复制到粘贴板!
您可以为默认平台监控和用户工作负载监控创建集群 ID 标签。
对于默认平台监控,您可以在 openshift-monitoring
命名空间中为 cluster-monitoring-config
配置映射中的 write_relabel
设置中为指标添加集群 ID 标签。
对于用户工作负载监控,您可以编辑 openshift-user-workload-monitoring
命名空间中的 user-workload-monitoring-config
配置映射中的设置。
当 Prometheus 提取公开 namespace
标签的用户工作负载目标时,系统会将此标签存储为 exported_namespace
。此行为可确保最终命名空间标签值等于目标 pod 的命名空间。您不能将 PodMonitor
或 ServiceMonitor
对象的 honorLabels
字段的值设置为 true
来覆盖此默认配置。
先决条件
-
已安装 OpenShift CLI(
oc
)。 - 您已配置了远程写入存储。
如果要配置默认平台监控组件:
-
您可以使用具有
cluster-admin
集群角色的用户身份访问集群。 -
您已创建
cluster-monitoring-config
ConfigMap
对象。
-
您可以使用具有
如果您要配置用于监控用户定义的项目的组件:
-
您可以使用具有
cluster-admin
集群角色或具有openshift-user-workload-monitoring
项目中的user-workload-monitoring-config-edit
角色的用户访问集群。 -
您已创建了
user-workload-monitoring-config
ConfigMap
对象。
-
您可以使用具有
流程
编辑
openshift-monitoring
项目中的cluster-monitoring-config
ConfigMap
对象:oc -n openshift-monitoring edit configmap cluster-monitoring-config
$ oc -n openshift-monitoring edit configmap cluster-monitoring-config
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注意如果您为监控用户定义的项目的 Prometheus 实例配置集群 ID 标签,请在
openshift-user-workload-monitoring
命名空间中编辑user-workload-monitoring-config
配置映射。请注意,Prometheus 组件在这个配置映射中称为prometheus
,而非prometheusK8s
,它是cluster-monitoring-config
配置映射中使用的名称。在
data/config.yaml/prometheusK8s/remoteWrite
中的writeRelabelConfigs:
部分添加集群 ID 重新标记配置值:Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下示例演示了如何在默认平台监控中使用集群 ID 标签
cluster_id
转发指标:Copy to Clipboard Copied! Toggle word wrap Toggle overflow 保存文件以将更改应用到
ConfigMap
对象。受更新的配置影响的 pod 会自动重启。警告保存对监控
ConfigMap
对象的更改可能会重新部署相关项目中的 pod 和其他资源。保存更改还可能在该项目中重新启动正在运行的监控进程。