README.md in postfix-exporter-2.0.3 vs README.md in postfix-exporter-2.1.0
- old
+ new
@@ -5,22 +5,37 @@
# 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;
+ counters (`postfix_delivery_delays_count`) per DSN, as well as delay summaries per
+ DSN (`postfix_delivery_delays{quantile="..."}`);
+* Total number of SMTP connections (`postfix_smtpd_connections_total`) and
+ currently-active connections (`postfix_smtpd_active_connections`);
+
+* Count how many delivery attempts were received
+ (`postfix_incoming_delivery_attempts_total`), split out by whether we
+ accepted or rejected the message (`status`) and the exact DSN provided to
+ the client (`dsn`);
+
+* Whether or not the Postfix `master` process is running (`postfix_up`);
+
* 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.
+
+If you configure the postfix-exporter to run in the same PID namespace as
+whatever it is that's running Postfix itself (either `--pid=host` or in the
+same NS namespace, a la k8s pods), then the `postfix_up` metric will be
+valid, otherwise it'll be random (but unlikely to be correct).
## Environment Variables
* `SYSLOG_SOCKET` -- where to read raw syslog events from. If you're