vect0r/fluentd_exporter

Fluentd Exporter for Prometheus

简单服务，用于抓取Fluentd的指标端点并将其导出为Prometheus指标。

镜像概述

该镜像提供Fluentd的Prometheus导出器，能够从Fluentd的监控API获取运行指标，转换为Prometheus可抓取的格式，助力用户监控Fluentd的运行状态与性能。

核心功能

• 采集Fluentd关键指标：缓冲区队列长度、总队列大小、重试次数等
• 暴露HTTP端点（默认9309端口）供Prometheus抓取
• 支持配置采集地址、端口、日志格式及级别
• 提供Grafana仪表盘模板，便于可视化监控数据

使用场景

• 监控Fluentd服务的运行状态与性能
• 结合Prometheus和Grafana构建日志系统监控平台
• Docker环境中作为Fluentd日志驱动的辅助监控工具

配置说明

前置步骤（Fluentd配置）

需在Fluentd配置文件中添加monitor_agent插件：

<source>
  @type monitor_agent
  bind 0.0.0.0
  port 24220
</source>

配置后可通过curl http://host:24220/api/plugins.json访问指标数据。

命令行参数

支持以下参数：

• -telemetry.endpoint：指标暴露路径（默认"/metrics"）
• -insecure：忽略HTTPS证书（默认false）
• -log.format：日志格式与目标（默认"logger:stderr"）
• -log.level：日志级别（可选debug/info/warn/error/fatal，默认info）
• -scrape_uri：Fluentd指标URI（默认"http://localhost:24220/api/plugins.json%22%EF%BC%89
• -telemetry.address：指标暴露地址（默认":9309"）
• -version：打印版本信息

Docker部署示例

容器运行

bash
docker run -d -p 9309:9309 docker.xuanyuan.run/vect0r/fluentd_exporter -scrape_uri http://fluentd-host:24220/api/plugins.json

注意：修改-telemetry.address需同步调整端口映射。

Docker Compose示例

yaml
version: '3'
services:
  fluentd_exporter:
    image: docker.xuanyuan.run/vect0r/fluentd_exporter
    ports: ["9309:9309"]
    command: ["-scrape_uri", "http://fluentd:24220/api/plugins.json"]
    depends_on: [fluentd]
  fluentd:
    image: docker.xuanyuan.run/fluent/fluentd
    ports: ["24220:24220"]
    volumes: ["./fluentd.conf:/fluentd/etc/fluentd.conf"]

Grafana仪表盘

可导入模板：https://grafana.com/dashboards/3522%EF%BC%8C%E6%95%88%E6%9E%9C%E6%88%AA%E5%9B%BE%EF%BC%9A!grafana dashboard