概要

フル名
docker.io/apecloud/kafka-exporter
Registry
docker.io
名前空間
apecloud
リポジトリ
kafka-exporter
キャッシュ Tag 数
1
最終同期
07/06/2026, 06:49 PM
関連トピック

概要

Kafka 集群 Prometheus 指标导出器,抓取 broker/topic/partition 滞后与吞吐,供 Grafana 大盘与 Alertmanager 告警规则使用。

詳細

apecloud/kafka-exporter 通过 Kafka Admin API 周期性拉取集群元数据与 consumer lag,在 /metrics 暴露 Prometheus 格式时间序列。无状态 sidecar 或独立 Deployment 均可,只需网络可达 broker bootstrap 地址。与 JMX Exporter 相比配置更简单但指标面不同;生产应限制 scrape 来源、为 SASL/SSL 集群配置相应 env,并与 kube-prometheus-stack 集成。

快速启动

docker run -d --name kafka-exporter \
  -p 9308:9308 \
  -e KAFKA_BROKERS=kafka:9092 \
  docker.io/apecloud/kafka-exporter:latest

推荐实践

docker run -d --name kafka-exporter \
  --restart unless-stopped \
  -p 9308:9308 \
  -e KAFKA_BROKERS=kafka-0:9092,kafka-1:9092 \
  -e KAFKA_VERSION=3.6.0 \
  -e LOG_LEVEL=info \
  docker.io/apecloud/kafka-exporter:1.7.0

核心参数说明

  • -p 9308:9308 — Prometheus scrape 端口
  • -e KAFKA_BROKERS — bootstrap 地址列表
  • -e KAFKA_VERSION — 协议版本与 broker 对齐
  • -e LOG_LEVEL — 排查连接问题时调高
  • --restart unless-stopped — 监控组件持续在线
  • 无状态 — 无需持久卷

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: kafka-exporter
spec:
  replicas: 1
  selector:
    matchLabels:
      app: kafka-exporter
  template:
    metadata:
      labels:
        app: kafka-exporter
    spec:
      containers:
        - name: kafka-exporter
          image: docker.io/apecloud/kafka-exporter:1.7.0
          ports:
            - containerPort: 9308
          env:
            - name: KAFKA_BROKERS
              value: kafka.messaging.svc:9092
---
apiVersion: v1
kind: Service
metadata:
  name: kafka-exporter
  labels:
    app: kafka-exporter
spec:
  selector:
    app: kafka-exporter
  ports:
    - port: 9308
      targetPort: 9308

ServiceMonitor 抓取 9308;SASL 密码经 Secret 注入 env,与 Kafka 同 namespace 降低网络策略复杂度。

Tagアーキテクチャプッシュ日時サイズDigest同期期望操作
docker.io/apecloud/kafka-exporter
:1.6.0-debian-11-r67
linux/amd64linux/arm64
2024/05/22 21:3536.4 MBsha256:6a8e2aab0742