PROMETHEUS-POSTFIX-EXPORTER(1)

NAME
prometheus-postfix-exporter - Prometheus exporter for Postfix mail servers.

SYNOPSIS
prometheus-postfix-exporter [options]

DESCRIPTION
This exporter provides histogram metrics for the size and age of messages stored in a Postfix mail queue. It extracts these metrics from Postfix by connecting to a Unix socket under /var/spool.

In addition to that, it counts events by parsing Postfix's log entries, using regular expression matching. The log entries are retrieved from the systemd journal or from a log file.

  EVENTS FROM LOGFILE
The log file is truncated when processed, so that the next iteration doesn't interpret the same lines twice. It is advisable to configure your syslogger to multiplex log entries to a second file:

  mail.* -/var/log/postfix_exporter_input.log

The path to the log file is specified with the -postfix.logfile_path flag.

  EVENTS FROM SYSTEMD
Retrieval from the systemd journal is enabled with the -systemd.enable flag. This overrides the log file setting. It is possible to specify the unit (with -systemd.unit) or slice (with -systemd.slice). Additionally, it is possible to read the journal from a directory with the -systemd.journal_path flag.

OPTIONS

-postfix.logfile_path string Logfile from which to read Postfix log entries. This file will be truncated by this exporter (default "/var/lib/prometheus/postfix-exporter/mail.log").

-postfix.showq_path string Path at which Postfix places its showq socket (default "/var/spool/postfix/public/showq").

-systemd.enable Read from the systemd journal instead of logfile.

-systemd.journal_path string Path to the systemd journal.

-systemd.slice string Name of the Postfix systemd slice. Overrides the systemd unit.

-systemd.unit string Name of the Postfix systemd unit (default "postfix@-.service").

-web.listen-address string Address to listen on for web interface and telemetry (default ":9154").

-web.telemetry-path string Path under which to expose metrics (default "/metrics").

SEE ALSO
postfix(1)

AUTHOR
Kumina bv <https://www.kumina.nl>