配置项目级 HAMi 配额指标

HAMi 使用命名空间标签 quotanamespace 暴露配额使用情况。如果监控面板或告警需要项目级使用情况,请添加一条记录规则,将 HAMi 调度器指标与 kube_namespace_labels 关联,并记录 QuotaUsedByProject。

此记录规则用于监控和报告。HAMi 调度或配额强制执行不需要此规则。仅当平台使用的监控或监控面板软件包使用 QuotaUsedByProject 时才应用此规则。

开始之前

  • 目标 Prometheus 或 VictoriaMetrics 实例会抓取 HAMi 调度器指标。
  • 同一监控实例会抓取来自 kube-state-metrics 的 kube_namespace_labels。
  • 你有权在业务集群中创建监控规则。

VictoriaMetrics 兼容监控

当监控堆栈暴露 vmcluster 标签时,请使用该标签:

apiVersion: monitoring.coreos.com/v1
kind: PrometheusRule
metadata:
  name: hami-project-quota
  namespace: kube-system
  labels:
    app.kubernetes.io/component: hami-scheduler
    prometheus: kube-prometheus
spec:
  groups:
    - name: quotaused-project-quotaname.rules
      interval: 30s
      rules:
        - record: QuotaUsedByProject
          expr: |
            sum by (quotaName, project, vmcluster) (
              QuotaUsed
              * on(quotanamespace, vmcluster) group_left(project)
                label_replace(kube_namespace_labels, "quotanamespace", "$1", "namespace", "(.*)")
            )
          labels:
            description: QuotaUsed metric aggregated by project and quotaname

在业务集群中应用该规则:

kubectl apply -f hami-project-quota-prometheusrule.yaml

Prometheus 监控

当监控堆栈不暴露 vmcluster 时,请使用此变体:

apiVersion: monitoring.coreos.com/v1
kind: PrometheusRule
metadata:
  name: hami-project-quota
  namespace: kube-system
  labels:
    app.kubernetes.io/component: hami-scheduler
    prometheus: kube-prometheus
spec:
  groups:
    - name: quotaused-project-quotaname.rules
      interval: 30s
      rules:
        - record: QuotaUsedByProject
          expr: |
            sum by (quotaName, project) (
              QuotaUsed
              * on(quotanamespace) group_left(project)
                label_replace(kube_namespace_labels, "quotanamespace", "$1", "namespace", "(.*)")
            )
          labels:
            description: QuotaUsed metric aggregated by project and quotaname

应用该规则并验证记录的序列:

kubectl apply -f hami-project-quota-prometheusrule.yaml

从同一监控后端查询 QuotaUsedByProject。如果序列为空,请首先检查调度器是否暴露 QuotaUsed,kube_namespace_labels 是否包含预期的 project 标签,以及这两个指标是否由同一后端抓取。

ACP 配额元数据另有说明

使 HAMi 资源可在 ACP 项目和命名空间配额页面中进行选择的 ConfigMap 属于平台元数据,而不是记录规则。有关这些 ConfigMap 及其资源键字段,请参阅

ACP 加速器资源配额

。