Postfix
Plugin: go.d.plugin Module: postfix
Overview
This collector retrieves statistics about the Postfix mail queue using the postqueue command-line tool.
It periodically executes the postqueue -p
command. The collection interval is set to 10 seconds by default, but this can be configurable.
This collector is supported on all platforms.
This collector only supports collecting metrics from a single instance of this integration.
Postfix has internal access controls for the mail queue. By default, all users can view the queue. If your system has stricter controls, grant the netdata
user access by adding it to authorized_mailq_users
in the /etc/postfix/main.cf
file. For more details, refer to the authorized_mailq_users
setting in the Postfix documentation.
Default Behavior
Auto-Detection
The collector executes postqueue -p
to get Postfix queue statistics.
Limits
The default configuration for this integration does not impose any limits on data collection.
Performance Impact
The default configuration for this integration is not expected to impose a significant performance impact on the system.
Metrics
Metrics grouped by scope.
The scope defines the instance that the metric belongs to. An instance is uniquely identified by a set of labels.
Per Postfix instance
These metrics refer to the entire monitored application.
This scope has no labels.
Metrics:
Metric | Dimensions | Unit |
---|---|---|
postfix.qemails | emails | emails |
postfix.qsize | size | KiB |
Alerts
There are no alerts configured by default for this integration.
Setup
You can configure the postfix collector in two ways:
Method | Best for | How to |
---|---|---|
UI | Fast setup without editing files | Go to Nodes → Configure this node → Collectors → Jobs, search for postfix, then click + to add a job. |
File | If you prefer configuring via file, or need to automate deployments (e.g., with Ansible) | Edit go.d/postfix.conf and add a job. |
UI configuration requires paid Netdata Cloud plan.
Prerequisites
No action required.
Configuration
Options
The following options can be defined globally: update_every.
Config options
Option | Description | Default | Required |
---|---|---|---|
update_every | Data collection frequency. | 10 | no |
binary_path | Path to the postqueue binary. If an absolute path is provided, the collector will use it directly; otherwise, it will search for the binary in directories specified in the PATH environment variable. | /usr/sbin/postqueue | yes |
timeout | Timeout for executing the binary, specified in seconds. | 2 | no |