Intégration de Postfix

Installer l' agent d'infrastructure

Pour utiliser l'intégration Postfix, vous devez également installer l'agent d'infrastructure sur le même hôte. L'agent infrastructure monitore l'hôte lui-même, tandis que l'intégration que vous installerez à l'étape suivante étend votre monitoring avec des données spécifiques à Postfix.

Exporter les données Postfix

Exportez vos métriques Postfix avec pflogsumm. L'agent Postfix utilisepflogsumm comme analyseur log , qui traduit en données métriques sur votre activité Postfix. Cela vous donne suffisamment de détails pour anticiper les incidents potentiels liés à l’administration du courrier électronique.

Suivez ces étapes pour utiliser pflogsumm.

1. Exécutez les commandes suivantes pour télécharger et extraire pflogsumm:

   bash

   Copier

   $
   wget https://jimsun.linxnet.com/downloads/pflogsumm-1.1.3.tar.gz

   bash

   Copier

   $
   tar xvf pflogsumm-1.1.3.tar.gz

2. Accédez au dossier pflogsumm .

   bash

   Copier

   $
   cd pflogsumm-*.*.*

3. Copiez le fichier pflogsumm.pl dans le chemin /usr/local/bin/pflogsumm :

   bash

   Copier

   $
   sudo cp pflogsumm.pl  /usr/local/bin/pflogsumm

4. Exécutez les commandes pflogsumm suivantes pour exporter les métriques Postfix :

   bash

   Copier

   $
   cat /var/log/mail.log | pflogsumm
   $
   cat /var/log/mail.log | pflogsumm -d today

Configurer NRI-Flex pour Postfix

Flex, notre outil monitoring indépendant des applications, est fourni avec l'agent New Relic Infrastructure. Suivez ces étapes pour créer un fichier de configuration flexible pour vos données Postfix :

1. Créez un fichier nommé postfix-flex-config.yml:

   bash

   Copier

   $
   touch /etc/newrelic-infra/integrations.d/postfix-flex-config.yml

2. Mettre à jour le fichier postfix-flex-config.yml. Nous vous recommandons de travailler à partir de notre exemple de configuration ci-dessous :

   --- 
     integrations:
       - name: nri-flex
         config:
           name: postfixFlex
           apis:
             #check if Postfix service is up.
             - event_type: PostfixUp
               commands:
                 - run: echo "value:$(systemctl status postfix | grep 'Active':' active' | wc -l)"
                   split_by: ':'
   
             #check if Postfix service is down.
             - event_type: PostfixDown
               commands:
                 - run: echo "value:$(systemctl status postfix | grep 'Active':' active' | wc -l)"
                   split_by: ':'
   
             #Read the grand totals messages by using the below script.
             - event_type: PostfixGrandTotals
               commands:
                 - run: cat /var/log/mail.log | pflogsumm | grep -A 21 'Grand Totals'
                   split: horizontal
                   set_header: [metricValue, message]
                   regex_match: true
                   split_by: \s+(\d+\w*)\s+(.*)
   
             #Read the number of messages delivered & received in bytes.
             - event_type: PostfixMessageBytes
               commands:
                 - run: cat /var/log/mail.log | pflogsumm | grep -A 1 'bytes received'
                   split: horizontal
                   set_header: [metricValue, messageBytes]
                   regex_match: true
                   split_by: \s+(\d+\w*)\s+(.*)
   
             #Read the number of messages held by the user.
             - event_type: PostfixHeldMessage
               commands:
                 - run: echo "value:$(cat /var/mail/<USER> | grep -c 'Subject:')"
                   split_by: ':'
   
             #Read the count of SASL authentication failure notifications.
             - event_type: PostfixSASLauthFailed
               commands:
                 - run: echo "value:$(cat /var/log/mail.log | grep 'status=deferred (SASL authentication failed' | wc -l)"
                   split_by: ':'
   
             #Read the count of bounced non-delivery notifications.
             - event_type: PostfixBounceNondeliveryNotification
               commands:
                 - run: echo "value:$(cat /var/log/mail.log | grep 'postfix/bounce' | wc -l)"
                   split_by: ':'
   
             #Read the number of messages passed through the email delivery process.
             - event_type: PostfixEmailDeliveryProcess
               commands:
                 - run: echo "PICKUPvalue:$(cat /var/log/mail.log | grep 'pickup' | wc -l)"
                   split_by: ':'
                 - run: echo "CLEANUPvalue:$(cat /var/log/mail.log | grep 'cleanup' | wc -l)"
                   split_by: ':'
   
             #Read the number of message inserted in mail queue.
             - event_type: PostfixMessageInsertedinMailQ
               commands:
                 - run: echo "Ivalue:$(cat /var/log/mail.log | grep 'queue active'| wc -l)"
                   split_by: ':'
   
             #Read the number of message handled by SMTP process.
             - event_type: PostfixMessageHandledBySMTP
               commands:
                 - run: echo "SENTmsg:$(cat /var/log/mail.log | grep 'status=sent' | grep "postfix/smtp" | wc -l)"
                   split_by: ':'
                 - run: echo "BOUNCEDmsg:$(cat /var/log/mail.log | grep 'status=bounced' | grep "postfix/smtp" | wc -l)"
                   split_by: ':'
                 - run: echo "DEFERREDmsg:$(cat /var/log/mail.log | grep 'status=deferred' | grep "postfix/smtp" | wc -l)"
                   split_by: ':'
   
             #Read the number of message removed from mail queue.
             - event_type: PostfixMessageRemovedFromMailQ
               commands:
                 - run: echo "Rvalue:$(cat /var/log/mail.log | grep 'removed'| wc -l)"
                   split_by: ':'
   
             #Read the number of SMTPD connection.
             - event_type: PostfixSMTPDconnection
               commands:
                 - run: echo "value:$(cat /var/log/mail.log | grep ' connect from' | wc -l)"
                   split_by: ':'
   
             #Read the number of SMTPD disconnection.
             - event_type: PostfixSMTPDdisconnection
               commands:
                 - run: echo "value:$(cat /var/log/mail.log | grep 'disconnect from' | wc -l)"
                   split_by: ':'
   
             #Read the number of SMTP connection.
             - event_type: PostfixSMTPconnection
               commands:
                 - run: echo "value:$(cat /var/log/mail.log | grep ' connect to' | wc -l)"
                   split_by: ':'
   
             #Read the number of SMTP disconnection.
             - event_type: PostfixSMTPdisconnection
               commands:
                 - run: echo "value:$(cat /var/log/mail.log | grep 'disconnect to' | wc -l)"
                   split_by: ':'
   
             #Read the number of connection timed out.
             - event_type: PostfixSMTPDtimedOut
               commands:
                 - run: echo "value:$(cat /var/log/mail.log | grep 'timeout after CONNECT' | wc -l)"
                   split_by: ':'
   
             #Read the number of connection lost.
             - event_type: PostfixSMTPDconnectionLost
               commands:
                 - run: echo "value:$(cat /var/log/mail.log | grep 'lost connection' | wc -l)"
                   split_by: ':'
   
             #Read the per-hour traffic report.
             - event_type: PostfixMessagePerHourReport
               commands:
                 - run: cat /var/log/mail.log | pflogsumm -d today | grep -i 'Per-Hour Traffic Summary' -A 27
                   split: horizontal
                   header_split_by: \s+(\w+)\s+(\w+)\s+(\w+)\s+(\w+)\s+(\w+)\s+(.*)
                   set_header:
                     [
                       time,
                       received.perhour,
                       delivered.perhour,
                       deferred.perhour,
                       bounced.perhour,
                       rejected.perhour,
                     ]
                   regex_match: true
                   split_by: \s+(\d+-\d+)\s+(\d+)\s+(\d+)\s+(\d+)\s+(\d+)\s+(\d+)
   
             #Read the per-day traffic summary.
             - event_type: PostfixMessageTrafficPerDay
               commands:
                 - run: cat /var/log/mail.log | pflogsumm --zero_fill | grep -C 12 'Per-Day Traffic Summary' -B 0 -A 8 | sed '/Per-Hour Traffic Daily Average/q'
                   split: horizontal
                   header_split_by: \s+(\w+)\s+(\w+)\s+(\w+)\s+(\w+)\s+(\w+)\s+(.*)
                   set_header:
                     [date, received, delivered, deferred, bounced, rejected]
                   regex_match: true
                   split_by: \s+(\w+\s+\d+\s+\d+)\s+(\d+)\s+(\d+)\s+(\d+)\s+(\d+)\s+(\d+)
   
             #Read the host/domain summary: message delivery & received.
             - event_type: PostfixHostSummary
               commands:
                 - run: cat /var/log/mail.log | pflogsumm | grep -i 'Host/Domain Summary':' Message Delivery' -A 8 | sed -n '2,9p'
                   split: horizontal
                   header_split_by: \s+(\w+\s+\w+)\s+(\w+)\s+(\w+)\s+(\w+\s+\w+)\s+(\w+\s+\w+)\s+(.*.)
                   set_header:
                     [sentCount, bytesDelivered, defers, avgDaily, maxDaily, host]
                   regex_match: true
                   split_by: \s+(\d+)\s+(\d+\w*)\s+(\d+)\s+(\d+.\d+\s+\w)\s+(\d+.\d+\s+\w)\s+(.*)
                 - run: cat /var/log/mail.log | pflogsumm | grep -A 15 'Host/Domain Summary':' Messages Received' | sed '/Senders by message count/q'
                   split: horizontal
                   header_split_by: \s+(\w+\s+\w+)\s+(\w+)\s+(.*.)
                   set_header: [msgCount, bytesReceived, hostDetail]
                   regex_match: true
                   split_by: \s+(\d+)\s+(\d+\w*)\s+(.*)
   
             #Read the senders & recipients with message count.
             - event_type: PostfixSenderRecipientMessageCount
               commands:
                 - run: cat /var/log/mail.log | pflogsumm | grep -C 11 'Senders by message count' -B 1 -A 9 | sed '/Recipients by message count/q'
                   split: horizontal
                   header_split_by: (.*.)
                   set_header: [sender.msgCount, senders]
                   regex_match: true
                   split_by: \s+(\d+)\s+(.*)
                 - run: cat /var/log/mail.log | pflogsumm | grep -C 11 'Recipients by message count' -B 1 -A 9 | sed '/Senders by message size/q'
                   split: horizontal
                   header_split_by: (.*.)
                   set_header: [recipient.msgCount, recipients]
                   regex_match: true
                   split_by: \s+(\d+)\s+(.*)
   
             #Read the daemon message details.
             - event_type: PostfixDaemonMessage
               commands:
                 - run: cat /var/log/mail.log | pflogsumm | grep -A 10 'Master daemon messages'
                   split: horizontal
                   set_header: [daemon.msgCount, daemonMessage]
                   regex_match: true
                   split_by: \s*(\d+)\s+(\w+.*.)
   
             #Read the message deferral details.
             - event_type: PostfixDeferralMessage
               commands:
                 - run: cat /var/log/mail.log | pflogsumm | grep -A 15 'message deferral detail' | sed '/message bounce detail (by relay)/q'
                   split: horizontal
                   header_split_by: (\s+\w+\s+.*)
                   set_header: [deferral.msgCount, deferralMessage]
                   regex_match: true
                   split_by: \s*(\d+)\s+(\w+.*.)
   
             #Read the warning message details.
             - event_type: PostfixWarningMessage
               commands:
                 - run: cat /var/log/mail.log | pflogsumm | grep -v 'mail_queue_enter' | grep -C 100 'Warnings' -B 1 -A 10 | sed '/Fatal Errors/q'
                   split: horizontal
                   header_split_by: \s+(\w+)\s+(.*)
                   set_header: [Warning.msgCount, warningMessage]
                   regex_match: true
                   split_by: \s*(\d+)\s\s\s(.*.)
   
             #Read the error message details.
             - event_type: PostfixErrorMessage
               commands:
                 - run: cat /var/log/mail.log | pflogsumm | grep -C 15 'Fatal Errors' -B 1 -A 10 | sed '/Panics/q'
                   split: horizontal
                   header_split_by: \s+(\w+)\s+(.*)
                   set_header: [Fatal.msgCount, fatalMessage]
                   regex_match: true
                   split_by: \s*(\d+)\s\s\s(.*.)
   
             #Read the message bounce details.
             - event_type: PostfixBounceMessage
               commands:
                 - run: cat /var/log/mail.log | pflogsumm | grep -A 10 'message bounce detail (by relay)' | sed '/message reject detail/q'
                   split: horizontal
                   header_split_by: \s+(\w+)\s+(.*)
                   set_header: [Bounce.msgCount, bounceMessage]
                   regex_match: true
                   split_by: \s*(\d+)\s\s\s(.*.)

   Copier

   Si vous préférez créer le vôtre, assurez-vous que votre fichier yaml suit le modèle ci-dessus. Modifiez l’attribut suivant selon vos besoins :

• EVENT_TYPE: Une table de base de données New Relic que vous pouvez interroger en utilisant NRQL.
• COMMAND:La commande utilisée pour imprimer les métriques sur le terminal.

Transférez votre log Postfix vers New Relic

Suivez ces étapes pour transférer le log Postfix vers New Relic :

1. Créez un fichier nommé logging.yml dans le répertoire de l’agent d’infrastructure :

   bash

   Copier

   $
   touch /etc/newrelic-infra/logging.d/logging.yml

2. Ajoutez le snippet suivant au fichier logging.yml :

   logs:
     - name: mail.log
       file: /var/log/mail.log
       attributes:
         logtype: postfix_maillog

   Copier

Redémarrer l' agent d'infrastructure

Utilisez les instructions de notre documentation sur l’agent d’infrastructure pour redémarrer votre agent d’infrastructure. Il s’agit d’une commande de base qui devrait fonctionner pour la plupart des gens :

$
sudo systemctl restart newrelic-infra.service

Rechercher et utiliser des données

Suivez ces étapes pour utiliser notre modèle dashboard prédéfini pour visualiser facilement vos données Postfix :

1. Allez à one.newrelic.com et cliquez sur + Integrations & Agents.

2. Cliquez sur l'onglet Dashboards .

3. Dans le champ de recherche, tapez Postfix.

4. Lorsque vous voyez notre dashboard pré-construit, cliquez dessus pour l'installer sur votre compte.

   Votre dashboard Postfix est un dashboard personnalisé. Accédez-y depuis l'UI Dashboards. Pour obtenir des documents sur l'utilisation et la modification du dashboard, consultez notre documentation dashboard .

   Pour en savoir plus sur la recherche et l’utilisation de vos données, consultez Comprendre les données d’intégration. Voici quelques exemples de requêtes NRQL pour les données Postfix :

   Afficher le statut de votre dernier enregistrement de message

   SELECT * 
   FROM PostfixGrandTotals

   Copier

   Afficher le statut de votre dernier enregistrement de message

   SELECT * 
   FROM PostfixMessagePerHourReport

   Copier

   Copier