4. 缓存命中率指标：命中率计算公式、关键监控指标与 Prometheus 采集方式

缓存命中率是衡量 ConfigMap 缓存效率的核心指标。当命中率骤降时，意味着大量请求穿透缓存直接访问底层存储（如 etcd 或 API Server），导致延迟上升、负载激增。本节从计算公式、关键指标和采集方式三个维度建立完整的监控体系。

4.1 命中率计算公式

缓存命中率定义为 缓存成功响应的请求数 占总请求数的百分比。在 ConfigMap 缓存场景中，标准公式如下：

命中率（Hit Ratio） = cache_hits / (cache_hits + cache_misses) × 100%

其中：

• cache_hits：缓存中存在目标 ConfigMap 且未过期，直接返回的次数。
• cache_misses：缓存中不存在或已过期，需回源到 API Server 获取的次数。

4.2 关键监控指标

除命中率外，还需监控以下三个核心指标，形成完整的缓存健康视图：

4.3 缓存命中率与关键指标的关系图

下图展示了命中率、命中/未命中计数与缓存大小之间的动态关系，以及它们如何共同反映缓存健康状态：

4.4 Prometheus 采集方式

在 Kubernetes 环境中，通常通过 Prometheus 客户端库 在缓存中间件（如 kubelet 的 ConfigMap 缓存、自定义 sidecar 缓存）中暴露指标，再由 Prometheus Server 拉取。以下是标准采集方案：

4.4.1 指标暴露示例（Go 语言）

import (
    "github.com/prometheus/client_golang/prometheus"
    "github.com/prometheus/client_golang/prometheus/promhttp"
)

var (
    cacheHits = prometheus.NewCounterVec(
        prometheus.CounterOpts{
            Name: "configmap_cache_hits_total",
            Help: "Total number of ConfigMap cache hits.",
        },
        []string{"namespace", "configmap_name"},
    )
    cacheMisses = prometheus.NewCounterVec(
        prometheus.CounterOpts{
            Name: "configmap_cache_misses_total",
            Help: "Total number of ConfigMap cache misses.",
        },
        []string{"namespace", "configmap_name"},
    )
    cacheSize = prometheus.NewGaugeVec(
        prometheus.GaugeOpts{
            Name: "configmap_cache_size_bytes",
            Help: "Current size of ConfigMap cache in bytes.",
        },
        []string{"namespace"},
    )
)

func init() {
    prometheus.MustRegister(cacheHits, cacheMisses, cacheSize)
}

// 在缓存命中/未命中时调用：
// cacheHits.WithLabelValues("default", "app-config").Inc()
// cacheMisses.WithLabelValues("default", "app-config").Inc()
// cacheSize.WithLabelValues("default").Set(currentBytes)

4.4.2 Prometheus 采集配置

scrape_configs:
  - job_name: 'configmap-cache'
    kubernetes_sd_configs:
      - role: pod
    relabel_configs:
      - source_labels: [__meta_kubernetes_pod_annotation_prometheus_io_scrape]
        action: keep
        regex: true
      - source_labels: [__meta_kubernetes_pod_annotation_prometheus_io_path]
        action: replace
        target_label: __metrics_path__
        regex: (.+)
      - source_labels: [__address__, __meta_kubernetes_pod_annotation_prometheus_io_port]
        action: replace
        regex: ([^:]+)(?::\d+)?;(\d+)
        replacement: $1:$2
        target_label: __address__

4.4.3 常用 PromQL 查询

4.5 缓存指标采集架构图

下图展示了从缓存组件到 Prometheus 的完整指标采集链路：