selina5288/prometheus-adapter

Prometheus Adapter 镜像文档

镜像概述

该镜像为Prometheus Adapter的Docker封装，对应上游镜像k8s.gcr.io/prometheus-adapter/prometheus-adapter。Prometheus Adapter是Kubernetes生态中的核心组件，主要功能是将Prometheus采集的监控指标转换为Kubernetes自定义指标API格式，使Kubernetes控制器（如Horizontal Pod Autoscaler/HPA）能够基于Prometheus指标进行动态资源调整。

核心功能与特性

• 指标转换：将Prometheus的PromQL查询结果转换为Kubernetes自定义指标API规范格式
• API适配：实现Kubernetes自定义指标API（custom.metrics.k8s.io）和外部指标API（external.metrics.k8s.io）
• 动态配置：支持通过配置文件定义指标转换规则，灵活适配不同监控场景
• 高兼容性：兼容Kubernetes 1.10+版本，支持Prometheus 2.0+
• 安全集成：支持与Kubernetes API Server的TLS认证，确保通信安全

使用场景与适用范围

• Kubernetes自动扩缩容：配合HPA基于Prometheus指标（如请求延迟、吞吐量、自定义业务指标）实现Pod动态扩缩容
• 自定义指标监控：为Kubernetes Dashboard、 kubectl top等工具提供Prometheus指标数据
• 资源优化：基于应用实际运行指标（如CPU使用率、内存占用以外的业务指标）优化资源分配
• 多集群监控：在联邦Prometheus环境中，为多集群提供统一的指标API接口

使用方法与配置说明

部署前提

• 已部署Kubernetes集群（1.10+）
• 已部署Prometheus并正常采集指标
• 具备集群管理员权限（需创建ClusterRole、ClusterRoleBinding等资源）

部署示例（Kubernetes）

Prometheus Adapter通常通过Deployment部署，以下为基本部署配置示例：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: prometheus-adapter
  namespace: monitoring
spec:
  replicas: 1
  selector:
    matchLabels:
      app: prometheus-adapter
  template:
    metadata:
      labels:
        app: prometheus-adapter
    spec:
      serviceAccountName: prometheus-adapter
      containers:
      - name: prometheus-adapter
        image: k8s.gcr.io/prometheus-adapter/prometheus-adapter:v0.10.0  # 替换为实际版本
        args:
        - --secure-port=6443
        - --tls-cert-file=/var/run/serving-cert/serving.crt
        - --tls-private-key-file=/var/run/serving-cert/serving.key
        - --metrics-relist-interval=1m
        - --prometheus-url=http://prometheus-server:80  # Prometheus服务地址
        - --config=/etc/adapter/config.yaml  # 指标转换配置文件路径
        ports:
        - containerPort: 6443
        volumeMounts:
        - name: config
          mountPath: /etc/adapter
        - name: serving-cert
          mountPath: /var/run/serving-cert
      volumes:
      - name: config
        configMap:
          name: prometheus-adapter-config
      - name: serving-cert
        secret:
          secretName: prometheus-adapter-serving-cert

核心配置参数

指标转换规则配置示例

配置文件（config.yaml）用于定义Prometheus指标到Kubernetes自定义指标的映射规则，示例：

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>>)'

验证部署

部署完成后，可通过以下命令验证自定义指标API是否可用：

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

若返回指标API资源列表，表明Prometheus Adapter部署成功。

注意事项

• 镜像版本需与Kubernetes集群版本兼容，建议参考https://github.com/kubernetes-sigs/prometheus-adapter#compatibility
• 指标转换规则需根据实际Prometheus指标格式调整，错误的规则可能导致指标无法正确暴露
• 高负载场景下建议部署多个副本，并配置PodDisruptionBudget确保可用性
• 生产环境需启用TLS认证，并限制API访问权限（通过RBAC配置）