Sha256: 03dbbc131dc26b0f1a8b07c4e76ccf601a9e02d38a1d50261e05b8c64b6b2627

Contents?: true

Size: 1.28 KB

Versions: 6

Compression:

Stored size: 1.28 KB

Contents

This is a simple exporter for various statistics relating to a Postfix
server.


# Features

* Examines mail queue periodically and exports `postfix_mail_queue_size`;

* Reads syslog entries as they happen, and exports disposition status
  counters (`postfix_disposition`) per DSN, as well as delay summaries per
  DSN;

* Drinks from the syslog stream directly.


# Deployment

The default way of rolling out this exporter is as a Docker container.  For
that, you'll want to setup a volume for the postfix queue (making it
available in the container as `/var/spool/postfix`), and some env
vars.  You can also run it directly (via the gem), with the same env vars,
and with the expectation that `/var/spool/postfix` is in the usual place.


## Environment Variables

* `SYSLOG_SOCKET` -- where to read raw syslog events from.  If you're
  running Postfix in an isolated container, you can probably hook up
  `/dev/log` directly between containers with a bit of shenanigans,
  otherwise configure your syslog daemon to write out a copy of all `mail`
  facility messages to a custom socket.  Alternately, if you use logstash,
  take a look at the [`syslogstash`
  gem](https://rubygems.org/gems/syslogstash) and
  [container](https://hub.docker.com/r/discourse/syslogstash/), and go forth
  and sin no more.

Version data entries

6 entries across 6 versions & 1 rubygems

Version Path
postfix-exporter-2.0.3 README.md
postfix-exporter-2.0.2 README.md
postfix-exporter-2.0.1 README.md
postfix-exporter-1.0.2 README.md
postfix-exporter-1.0.1 README.md
postfix-exporter-1.0.0 README.md