telegraf/plugins/inputs/postfix
Patrick Hemmer cef6be8d7e Fix postfix input handling of multi-level queues (#4333) 2018-06-21 16:01:38 -07:00
..
README.md Add information about how to set permissions for postfix input (#3594) 2018-01-02 14:09:14 -08:00
postfix.go Fix postfix input handling of multi-level queues (#4333) 2018-06-21 16:01:38 -07:00
postfix_test.go Fix postfix input handling of multi-level queues (#4333) 2018-06-21 16:01:38 -07:00
stat_ctim.go Fix postfix plugin age to use ctime, not mtime (#3525) 2017-11-29 11:25:31 -08:00
stat_ctimespec.go Fix postfix plugin age to use ctime, not mtime (#3525) 2017-11-29 11:25:31 -08:00
stat_none.go Add time import 2017-11-29 17:05:13 -08:00

README.md

Postfix Input Plugin

The postfix plugin reports metrics on the postfix queues.

For each of the active, hold, incoming, maildrop, and deferred queues (http://www.postfix.org/QSHAPE_README.html#queues), it will report the queue length (number of items), size (bytes used by items), and age (age of oldest item in seconds).

Configuration

[[inputs.postfix]]
  ## Postfix queue directory. If not provided, telegraf will try to use
  ## 'postconf -h queue_directory' to determine it.
  # queue_directory = "/var/spool/postfix"

Permissions:

Telegraf will need read access to the files in the queue directory. You may need to alter the permissions of these directories to provide access to the telegraf user.

Unix permissions:

$ sudo chgrp -R telegraf /var/spool/postfix/{active,hold,incoming,deferred}
$ sudo chmod -R g+rXs /var/spool/postfix/{active,hold,incoming,deferred}
$ sudo usermod -a -G postdrop telegraf
$ sudo chmod g+r /var/spool/postfix/maildrop

Posix ACL:

$ sudo setfacl -Rdm u:telegraf:rX /var/spool/postfix/{active,hold,incoming,deferred,maildrop}

Measurements & Fields:

  • postfix_queue
    • length (integer)
    • size (integer, bytes)
    • age (integer, seconds)

Tags:

  • postfix_queue
    • queue

Example Output

postfix_queue,queue=active length=3,size=12345,age=9
postfix_queue,queue=hold length=0,size=0,age=0
postfix_queue,queue=maildrop length=1,size=2000,age=2
postfix_queue,queue=incoming length=1,size=1020,age=0
postfix_queue,queue=deferred length=400,size=76543210,age=3600