cloveropen/prometheus-adapter

Prometheus Adapter 镜像文档（v0.10.0）

镜像概述

本镜像为registry.k8s.io/prometheus-adapter/prometheus-adapter:v0.10.0的转存版本，是Kubernetes自定义指标API的实现组件。它能够将Prometheus收集的监控指标转换为Kubernetes API可识别的自定义指标，使Kubernetes HPA（Horizontal Pod Autoscaler）等功能可以基于Prometheus指标实现动态扩缩容。

核心功能与特性

核心功能

• 指标转换：将Prometheus的时间序列指标转换为Kubernetes自定义指标API格式
• API兼容：实现Kubernetes自定义指标API（custom.metrics.k8s.io）和外部指标API（external.metrics.k8s.io）
• 灵活配置：支持通过配置文件定义指标转换规则，适配不同业务场景的指标需求

版本特性（v0.10.0）

• 支持Kubernetes 1.21+版本
• 优化指标查询性能，减少对Prometheus的请求压力
• 增强配置校验功能，提供更友好的错误提示
• 修复多个安全漏洞及稳定性问题

使用场景与适用范围

典型使用场景

• 基于Prometheus指标的HPA：通过自定义指标（如请求延迟、队列长度等）实现Pod自动扩缩容
• 指标暴露：向Kubernetes API暴露Prometheus指标，供其他组件（如Dashboard、监控系统）查询
• 多维度扩缩容：支持基于多个Prometheus指标组合进行扩缩容决策

适用范围

• Kubernetes集群（1.21及以上版本）
• 已部署Prometheus的监控环境
• 需要基于自定义业务指标进行自动扩缩容的应用

使用方法与配置说明

部署前提

• Kubernetes集群（1.21+）
• 已部署Prometheus并正常收集指标
• 具备集群管理员权限（用于部署API服务和RBAC配置）

配置说明

Prometheus Adapter主要通过配置文件定义指标转换规则，常见配置项包括：

部署示例

Kubernetes部署清单（deployment.yaml）

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: prometheus-adapter
  namespace: monitoring
spec:
  replicas: 1
  selector:
    matchLabels:
      name: prometheus-adapter
  template:
    metadata:
      labels:
        name: prometheus-adapter
    spec:
      serviceAccountName: prometheus-adapter
      containers:
      - name: prometheus-adapter
        image: registry.k8s.io/prometheus-adapter/prometheus-adapter:v0.10.0
        args:
        - --prometheus-url=http://prometheus-server.monitoring.svc:80
        - --config=/etc/adapter/config.yaml
        - --metrics-relist-interval=1m
        volumeMounts:
        - name: config-volume
          mountPath: /etc/adapter
      volumes:
      - name: config-volume
        configMap:
          name: prometheus-adapter-config

配置文件（configmap.yaml）

yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: prometheus-adapter-config
  namespace: monitoring
data:
  config.yaml: |
    rules:
    - seriesQuery: 'http_requests_total{namespace!="",pod!=""}'
      resources:
        overrides:
          namespace: {resource: "namespace"}
          pod: {resource: "pod"}
      name:
        matches: "^(.*)_total"
        as: "${1}_per_second"
      metricsQuery: sum(rate(<<.Series>>{<<.LabelMatchers>>}[5m])) by (<<.GroupBy>>)

RBAC配置（rbac.yaml）

yaml
apiVersion: v1
kind: ServiceAccount
metadata:
  name: prometheus-adapter
  namespace: monitoring
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: prometheus-adapter
rules:
- apiGroups: [""]
  resources: ["pods", "namespaces"]
  verbs: ["get", "list", "watch"]
- apiGroups: ["custom.metrics.k8s.io"]
  resources: ["*"]
  verbs: ["get", "list", "watch", "create", "update"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: prometheus-adapter
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: prometheus-adapter
subjects:
- kind: ServiceAccount
  name: prometheus-adapter
  namespace: monitoring

验证部署

部署完成后，可通过以下命令验证自定义指标是否正常暴露：

bash
kubectl get --raw "/apis/custom.metrics.k8s.io/v1beta1"

注意事项

• 确保Prometheus与Adapter之间网络通畅，Prometheus URL配置正确
• 指标转换规则需根据实际业务指标调整，避免查询性能问题
• 升级Kubernetes集群时，需确认Adapter版本兼容性（v0.10.0支持1.21+）
• 生产环境建议部署多个副本，提高可用性