itzg/kube-metrics-exporter

kube-metrics-exporter 镜像文档

镜像概述

kube-metrics-exporter是一个用于访问Kubernetes metrics API并将Pod指标导出为Prometheus兼容格式的工具镜像。它能够从Kubernetes集群的metrics API收集Pod相关性能指标，并通过HTTP端点暴露，供Prometheus抓取和监控。

核心功能和特性

• Kubernetes metrics API集成：直接与Kubernetes metrics API交互，获取集群中Pod的实时性能指标
• Prometheus兼容输出：以Prometheus标准格式暴露指标，支持直接被Prometheus抓取
• 灵活的指标过滤：可通过配置筛选特定命名空间或标签的Pod指标
• 轻量级部署：容器化设计，资源占用低，易于在Kubernetes集群中部署

使用场景和适用范围

• Kubernetes集群Pod性能监控
• Prometheus监控体系中Pod指标采集
• 需要自定义Pod指标导出的场景
• 中小型Kubernetes集群的指标收集解决方案

使用方法和配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name kube-metrics-exporter \
  -p 8080:8080 \
  -e KUBERNETES_SERVICE_HOST=kube-apiserver.example.com \
  -e KUBERNETES_SERVICE_PORT=6443 \
  -e LISTEN_PORT=8080 \
  itzg/kube-metrics-exporter

Docker Compose配置

yaml
version: '3'
services:
  kube-metrics-exporter:
    image: itzg/kube-metrics-exporter
    ports:
      - "8080:8080"
    environment:
      - KUBERNETES_SERVICE_HOST=kube-apiserver.example.com
      - KUBERNETES_SERVICE_PORT=6443
      - LISTEN_PORT=8080
      - NAMESPACE=default  # 可选，指定要监控的命名空间
      - POD_LABELS=app=my-app  # 可选，按标签筛选Pod
    restart: always

环境变量配置

Kubernetes内部署

在Kubernetes集群中部署时，建议使用ServiceAccount并赋予适当权限以访问metrics API。详细部署说明请参考https://github.com/itzg/kube-metrics-exporter%E3%80%82

指标访问

启动后，可通过 http://<容器IP>:<LISTEN_PORT>/<METRICS_PATH> 访问Prometheus格式的指标，例如：http://localhost:8080/metrics。