docs(postfix): add a note about `authorized_mailq_users` (#13515)
Ilya Mashchenko committed
Aug 13, 2022 at 21:49 UTC
253e4013065c822d7f7733fe863aadffa0a25916
1 file changed
+18
-9
collectors/python.d.plugin/postfix/README.md
+18
-9
@@ -6,22 +6,31 @@ sidebar_label: "Postfix"
6
7
# Postfix monitoring with Netdata
8
9
-Monitors MTA email queue statistics using postqueue tool.
9
+Monitors MTA email queue statistics using [postqueue](http://www.postfix.org/postqueue.1.html) tool.
10
11
-Execute `postqueue -p` to grab postfix queue.
11
+The collector executes `postqueue -p` to get Postfix queue statistics.
12
13
-It produces only two charts:
13
+## Requirements
14
15
-1. **Postfix Queue Emails**
15
+Postfix has internal access controls that limit activities on the mail queue. By default, all users are allowed to view
16
+the queue. If your system is configured with stricter access controls, you need to grant the `netdata` user access to
17
+view the mail queue. In order to do it, add `netdata` to `authorized_mailq_users` in the `/etc/postfix/main.cf` file.
18
17
- - emails
19
+See the `authorized_mailq_users` setting in
20
+the [Postfix documentation](https://www.postfix.org/postconf.5.html) for more details.
21
19
-2. **Postfix Queue Emails Size** in KB
22
+## Charts
23
21
- - size
24
+It produces only two charts:
25
23
-Configuration is not needed.
26
+1. **Postfix Queue Emails**
27
25
----
28
+ - emails
29
30
+2. **Postfix Queue Emails Size** in KB
31
32
+ - size
33
+
34
+## Configuration
35
+
36
+Configuration is not needed.