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>