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>

0.1.2                                             January 2019                    PROMETHEUS-POSTFIX-EXPORTER(1)