Postfix Integration

Xitoring Postfix integration focuses on the most critical health indicator of a Postfix Mail Transfer Agent—the queue length. By continuously tracking the number of queued messages, Xitoring helps administrators detect delivery bottlenecks early and keep mail flowing smoothly.

Enable Postfix integration

Run the following command on the server that hosts Postfix:

xitogent integrate

Select Postfix when prompted. Xitogent creates /etc/xitogent/integrations/postfix_integration.conf and immediately starts collecting queue statistics.

Note The integration relies on the postqueue utility.

Setup Triggers for Postfix integration

A single, well‑chosen Trigger can offer robust protection against mail delays:

Queue size threshold
- Condition: queue_size > 300 for 5 min

Troubleshooting

Symptom	Resolution
No queue data	Confirm `postqueue` is executable by the Xitogent service and lives in the expected path. Check `/var/log/xitogent/xitogent.log` for permission or path errors.
Queue never clears	Use `postqueue -p` manually to inspect stuck messages, and review Postfix logs in `/var/log/mail.log` for delivery errors.

Next steps

Pair the Postfix queue metric with an SMTP check to correlate outbound connectivity issues.
Add a dashboard widget to visualize queue growth over time and proactively tune thresholds.