argussecurity/kafka

docker-kafka 镜像文档

镜像概述

本镜像基于 https://github.com/wurstmeister/kafka-docker 构建，添加了 Prometheus.io 的 https://github.com/prometheus/jmx_exporter%EF%BC%8C%E5%8F%AF%E4%BD%9C%E4%B8%BA javaagent 使用，实现将 Kafka 指标导出到 Prometheus 监控系统。

JMX Exporter 组件（jmx_prometheus_javaagent-0.5.jar）来自 Maven Central，因 Docker Hub 自动构建问题，已预先包含在镜像中。

核心功能与特性

• 继承 https://github.com/wurstmeister/kafka-docker 的全部功能，提供 Kafka 服务
• 集成 Prometheus JMX Exporter，支持将 Kafka JMX 指标转换为 Prometheus 可采集格式
• 内置默认指标采集配置文件（/usr/app/prometheus-config.yml），可直接使用或自定义
• 通过环境变量灵活配置 JMX Exporter 监听端口和配置文件路径

使用场景

适用于需要对 Kafka 集群进行监控，并希望将指标集成到 Prometheus + Grafana 监控体系的场景，例如：

• 生产环境 Kafka 集群性能监控
• Kafka 服务健康状态监控
• 自定义 Kafka 指标采集与告警

使用方法与配置说明

环境变量配置

使用时需通过 KAFKA_OPTS 环境变量配置 JMX Exporter 作为 javaagent，格式如下：

bash
KAFKA_OPTS=-javaagent:/usr/app/jmx_prometheus_javaagent.jar=<LISTEN_PORT>:<PATH_TO_CONFIG_FILE>

• <LISTEN_PORT>: JMX Exporter 监听的端口，用于 Prometheus 采集指标
• <PATH_TO_CONFIG_FILE>: JMX Exporter 配置文件路径，可使用内置默认配置 /usr/app/prometheus-config.yml

部署示例

Docker Run 命令

bash
docker run -p 9092:9092 -p 8080:8080 \
  -e "KAFKA_OPTS=-javaagent:/usr/app/jmx_prometheus_javaagent.jar=8080:/usr/app/prometheus-config.yml" \
  argussecurity/kafka:0.8.2.0

说明：

• -p 9092:9092: 映射 Kafka 服务端口
• -p 8080:8080: 映射 JMX Exporter 指标采集端口（需与 LISTEN_PORT 一致）
• KAFKA_OPTS: 配置 JMX Exporter 监听 8080 端口，使用默认配置文件

注意事项

• 若需要使用 wurstmeister/kafka 的特定标签而镜像中未提供，请提交 Pull Request，将触发构建流程。