Ce check surveille la taille de toutes les files d’attente Postfix.
Configuration
Installation
Le check Postfix est inclus dans le paquet de l’Agent Datadog : vous n’avez donc rien d’autre à installer sur vos serveurs Postfix.
Configuration
Ce check peut être configuré de façon à le faire utiliser la commande find, ce qui nécessite d’accorder un accès sudo à l’utilisateur dd-agent pour qu’il puisse obtenir le nombre de messages dans les files d’attente d’e-mails de types incoming, active et deferred.
Vous pouvez également configurer l’agent de façon à le faire utiliser une commande postqueue -p intégrée afin d’obtenir le nombre de messages dans les files d’attente d’e-mails de types active, hold et deferred. La commande postqueue est exécutée avec les droits de groupe setgid sans que sudo soit nécessaire.
AVERTISSEMENT : l’utilisation de la commande postqueue pour surveiller les files d’attente d’e-mails ne permet pas d’obtenir le nombre de messages dans la file d’attente incoming.
init_config:## @param postfix_user - string - required## The user running dd-agent must have passwordless sudo access for the find## command to run the postfix check. Here's an example:## example /etc/sudoers entry:## dd-agent ALL=(postfix) NOPASSWD:/usr/bin/find /var/spool/postfix/incoming -type f#### Redhat/CentOS/Amazon Linux flavours need to add:## Defaults:dd-agent !requiretty#postfix_user:postfixinstances:## @param directory - string - optional - default: /var/spool/postfix## Path to the postfix directory. The directory option is required if `postqueue: false` is set. For more ## information see https://docs.datadoghq.com/integrations/postfix/#using-sudo.#- directory:/var/spool/postfix## @param queues - list of string - required## List of queues to monitor.#queues:- incoming- active- deferred
Pour chaque file d’attente d’e-mails dans queues, l’Agent effectue un fork() du find sur son répertoire. Comme il utilise sudo pour effectuer cette action avec les privilèges de l’utilisateur Postfix, vous devez ajouter les lignes suivantes à /etc/sudoers pour l’utilisateur de l’Agent, dd-agent, en supposant que Postfix s’exécute en tant que postfix :
dd-agent ALL=(postfix) NOPASSWD:/usr/bin/find /var/spool/postfix/incoming -type f
dd-agent ALL=(postfix) NOPASSWD:/usr/bin/find /var/spool/postfix/active -type f
dd-agent ALL=(postfix) NOPASSWD:/usr/bin/find /var/spool/postfix/deferred -type f
init_config:## @param postqueue - boolean - optional - default: false## Set `postqueue: true` to gather mail queue counts using `postqueue -p`## without the use of sudo. Postqueue binary is ran with set-group ID privileges,## so that it can connect to Postfix daemon processes.## Only `tags` keys are used from `instances` definition.## Postfix has internal access controls that limit activities on the mail queue.## By default, Postfix allows `anyone` to view the queue. On production systems## where the Postfix installation may be configured with stricter access controls,## you may need to grant the dd-agent user access to view the mail queue.#### postconf -e "authorized_mailq_users = dd-agent"#### http://www.postfix.org/postqueue.1.html#### authorized_mailq_users (static:anyone)## List of users who are authorized to view the queue.#postqueue:trueinstances:## @param config_directory - string - optional## The config_directory option only applies when `postqueue: true`.## The config_directory is the location of the Postfix configuration directory## where main.cf lives.#- config_directory:/etc/postfix## @param queues - list of string - required## List of queues to monitor.#queues:- incoming- active- deferred
Pour chaque config_directory dans instances, l’Agent effectue un fork de postqueue -c pour le répertoire de configuration de Postfix. Postfix offre des contrôles d’accès internes qui limitent les opérations pouvant être effectuées sur la file d’attente d’e-mails. L’option par défaut anyone de Postfix permet à tout le monde de consulter la file d’attente. Sur les systèmes de production sur lesquels une installation Postfix peut être configurée avec des contrôles d’accès plus stricts, vous devrez peut-être accorder à l’utilisateur dd-agent un accès en lecture à la file d’attente d’e-mails. Consultez la documentation Postfix sur la commande postqueue (en anglais) pour en savoir plus.
postconf -e "authorized_mailq_users = dd-agent"
Liste des utilisateurs autorisés à consulter la file d’attente :
Postfix envoie des logs au daemon syslog, qui enregistre alors les logs dans le système de fichiers. La convention de nommage et les destinations des fichiers log sont configurables :
La collecte de logs est désactivée par défaut dans l’Agent Datadog. Vous devez l’activer dans datadog.yaml :
logs_enabled:true
Ajoutez le bloc de configuration suivant à votre fichier postfix.d/conf.yaml. Modifiez les valeurs des paramètres path et service en fonction de votre environnement. Consultez le fichier d’exemple postfix.d/conf.yaml pour découvrir toutes les options de configuration disponibles.
The number of messages in a given mail queue, tagged by queue name (e.g. 'queue:incoming') and directory (e.g. 'instance:/var/spool/postfix/incoming'). Shown as email
