From fb0fee0fbb00583eb5c0b5a8b53ebd9e3f4b276c Mon Sep 17 00:00:00 2001
From: Daniel Nelson <daniel.nelson@influxdb.com>
Date: Fri, 3 Apr 2020 10:09:24 -0700
Subject: [PATCH] Update permission docs on postfix input (#7255)

---
 plugins/inputs/postfix/README.md | 23 ++++++++++++++---------
 1 file changed, 14 insertions(+), 9 deletions(-)

diff --git a/plugins/inputs/postfix/README.md b/plugins/inputs/postfix/README.md
index a8d4a7537..2fdfacd9d 100644
--- a/plugins/inputs/postfix/README.md
+++ b/plugins/inputs/postfix/README.md
@@ -2,7 +2,10 @@
 
 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).
+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
 
@@ -13,12 +16,15 @@ For each of the active, hold, incoming, maildrop, and deferred queues (http://ww
   # queue_directory = "/var/spool/postfix"
 ```
 
-#### Permissions:
+#### 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.
 
+This can be setup either using standard unix permissions or with Posix ACLs,
+you will only need to use one method:
+
 Unix permissions:
 ```sh
 $ sudo chgrp -R telegraf /var/spool/postfix/{active,hold,incoming,deferred}
@@ -29,21 +35,20 @@ $ sudo chmod g+r /var/spool/postfix/maildrop
 
 Posix ACL:
 ```sh
-$ sudo setfacl -m g:telegraf:rX /var/spool/postfix/{,active,hold,incoming,deferred,maildrop}
-$ sudo setfacl -Rdm g:telegraf:rX /var/spool/postfix/{,active,hold,incoming,deferred,maildrop}
+$ sudo setfacl -Rm g:telegraf:rX /var/spool/postfix/
+$ sudo setfacl -dm g:telegraf:rX /var/spool/postfix/
 ```
 
-### Measurements & Fields:
+### Metrics
 
 - postfix_queue
+  - tags:
+    - queue
+  - fields:
     - length (integer)
     - size (integer, bytes)
     - age (integer, seconds)
 
-### Tags:
-
-- postfix_queue
-    - queue
 
 ### Example Output