blackflysolutions/postfix-exporter

Prometheus Postfix Exporter

镜像概述和主要用途

Prometheus Postfix Exporter是针对Postfix邮件服务器的Prometheus指标导出工具。该导出器通过连接/var/spool下的UNIX socket提取邮件队列中消息的大小和年龄的直方图指标，并通过正则表达式匹配解析Postfix日志条目来计数事件。日志条目可从systemd journal、Docker日志或日志文件中获取。

核心功能和特性

• 邮件队列指标：提供邮件队列中消息大小和年龄的直方图指标
• 多日志源支持：支持从systemd journal、Docker日志或日志文件解析事件
• 可配置监听：自定义Web接口监听地址和指标暴露路径
• 容器化支持：可监控Docker容器内运行的Postfix服务
• 日志轮转兼容：支持日志文件轮转，运行中轮转日志不影响监控
• 构建灵活性：可选择构建时禁用systemd功能以减少依赖

使用场景和适用范围

• 监控Postfix邮件服务器的邮件队列状态及性能
• 跟踪邮件发送、接收、延迟等事件指标
• 适用于物理机、虚拟机或Docker容器中部署的Postfix服务
• 集成到Prometheus监控系统，实现指标收集、告警和可视化

使用方法和配置说明

启动选项

启动postfix_exporter时可使用以下选项：

事件来源配置

Docker日志

通过--docker.enable标志可监控运行在Docker容器中的Postfix服务器。默认容器ID为postfix，可通过--docker.container.id自定义。

默认连接本地Docker，可通过环境变量（如DOCKER_HOST）自定义连接配置，具体参考https://pkg.go.dev/github.com/docker/docker/client?tab=doc#NewEnvClient%E3%80%82

日志文件

日志文件采用尾部跟踪方式处理，运行中轮转日志文件不影响监控。日志文件路径通过--postfix.logfile_path指定。

systemd Journal

通过--systemd.enable标志启用从systemd journal获取日志，此设置会覆盖日志文件配置。可通过--systemd.unit指定单元名称或--systemd.slice指定slice名称，也可通过--systemd.journal_path指定journal目录路径。

Docker部署示例

基本运行命令

bash
docker run -d \
  -p 9154:9154 \
  -v /var/spool/postfix/public/showq:/var/spool/postfix/public/showq \
  -v /var/log/mail.log:/var/log/mail.log \
  --name postfix-exporter \
  prom/postfix-exporter \
  --web.listen-address=:9154 \
  --postfix.logfile_path=/var/log/mail.log

监控Docker容器内的Postfix

bash
docker run -d \
  -p 9154:9154 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --name postfix-exporter \
  prom/postfix-exporter \
  --docker.enable=true \
  --docker.container.id=my-postfix-container

构建选项

默认构建包含systemd journal功能（默认禁用）。由于构建时需要systemd头文件，可使用nosystemd构建标签禁用systemd功能：

bash
go build -tags nosystemd