Мониторинг Postfix в Zabbix

В данной статье я расскажу о том, как настроить мониторинг почтового сервера Postfix с помощью Zabbix. В сети много советов и готовых инструкций, и моя в этом плане не будет какой-то уникальной. Попробую более подробно раскрыть тему и дать несколько своих советов и рекомендаций.

Введение

Данная статья по мониторингу будет написана на примере настроенного почтового сервера из другой моей статьи - Настройка Postfix + Dovecot + Postfixadmin + Roundcube + DKIM на Debian. В целом руководство будет универсальное, так как службы, конфигурация и формат логов Postfix одинаковы на всех системах. С небольшой адаптацией названий логов, приложений и путей эта статья будет актуальна и для других систем.

В основе всех примеров мониторинга Postfix лежит набор перловых скриптов pflogsumm для сбора статистики о письмах из лог-файла. У меня уже были несколько вариантов этой же статьи. Перед очередным обновлением я ещё раз бегло поискал в интернете и на сайте самого Zabbix какие-то другие реализации, но не нашёл их. В итоге решил больше не поддерживать свои костыли, а взять то, что предлагает Zabbix в своём репозитории со сторонними шаблонами от сообщества: Applications/Mail_servers/template_postfix. С эти решением больше шансов, что кто-то его будет поддерживать в актуальном состоянии.

Вся настройка мониторинга свелась к тому, чтобы адаптировать предложенный шаблон, набор скриптов и конфигураций под окружение Debian, на базе которой построен мой почтовый сервер.

Подготовка сервера к мониторингу

Установим несколько необходимых для дальнейшей работы пакетов:

# apt install logtail pflogsumm sudo rsyslog

Основное тут - pflogsumm. Именно этот перловый скрипт будет анализировать почтовый лог-файл и собирать про нему статистику, которая потом будет передаваться в Zabbix. Проверим, чтобы он корректно работал:

Не забудьте указать свой путь к почтовому логу. Обычно он в deb системах /var/log/mail.log, а в rpm - /var/log/maillog. Это при условии, что используются текстовые логи на базе rsyslog или другого syslog сервера. В современных системах его нужно будет установить отдельно (мы сделали это выше), так как по умолчанию все логи ведутся в systemd (systemctl logs).

Настройка zabbix-agent на почтовом сервере

Можно переходить к настройке непосредственно мониторинга. Первым делом установим агент Zabbix. Нам некритично использовать саму свежую версию агента, поэтому можно поставить его из базового репозитория Debian:

# apt install zabbix-agent2

Я не буду останавливаться на вопросе добавления сервера в мониторинг Zabbix. Подразумеваю, что раз вы используете Zabbix, то уже умеете добавлять в него новые узлы. Далее в инструкции буду считать, что почтовый сервер уже добавлен на сервер мониторинга и нормально с ним взаимодействует.

Скачиваем из репозитория с шаблоном некоторые файлы, которые нам понадобятся для настройки мониторинга. Я на всякий случай приведу их содержание в уже отредактированном виде.

• /etc/zabbix/zabbix_agent2.d/template_app_postfix.conf

UserParameter=postfix.logsummary,sudo /usr/sbin/logtail /var/log/mail.log /tmp/zabbix-postfix-log.offset | /usr/sbin/pflogsumm -h 0 -u 0 --deferral-detail=0 --smtpd-warning-detail=0 --no_no_msg_size --verbose-msg-detail
UserParameter=postfix.spool,sudo /etc/zabbix/scripts/postfix_get_spool.sh
UserParameter=postfix.queue,sudo /usr/sbin/postqueue -j
UserParameter=postfix.version,/usr/sbin/postconf mail_version | sed 's/.* = //'

• /etc/zabbix/scripts/postfix_get_spool.sh

#!/bin/bash

postfix_config=/etc/postfix/main.cf
basedir=$(grep -e ^queue_directory $postfix_config | sed 's/.\+=[[:space:]]\?\(.\+\)/\1/')
[[ $basedir ]] || basedir=/var/spool/postfix
queuedirs="deferred active maildrop incoming corrupt hold"

idx=0
echo -n '{'
for dir in $queuedirs; do
    [[ $idx != 0 ]] && echo -n ","
    echo -n "\"$dir\":"
    if [ -r $basedir/$dir ]; then
        echo -n $(find "$basedir/$dir" -type f | wc -l)
    else
        echo -n "-1"
    fi
    idx+=1
done
echo -n '}'

• /etc/sudoers.d/zabbix_postfix

User_Alias ZABBIX = zabbix
Cmnd_Alias LOGTAIL_MAILLOG = /usr/sbin/logtail /var/log/mail.log /tmp/zabbix-postfix-log.offset
Cmnd_Alias GET_SPOOL_SCRIPT = /etc/zabbix/scripts/postfix_get_spool.sh
Cmnd_Alias POSTQUEUE = /usr/sbin/postqueue -j
ZABBIX ALL= NOPASSWD: LOGTAIL_MAILLOG, GET_SPOOL_SCRIPT, POSTQUEUE

После того, как разложите файлы по директориям, проверьте, чтобы у скрипта postfix_get_spool.sh были права на исполнение:

# chmod +x /etc/zabbix/scripts/postfix_get_spool.sh

После этого перезапустите zabbix-agent:

# systemctl restart zabbix-agent2

На почтовом сервере всё настроили, перемещаемся на Zabbix Server.

Настройка мониторинга Postfix

Скачиваем из репозитория файл с шаблоном template_Postfix_by_Zabbix_agent_active.yaml. Вам нужно скачать непосредственно исходный файл в виде raw файла.

После этого переходите на Zabbix Server в раздел Сбор данных ⇨ Шаблоны и импортируйте скачанный шаблон.

После импорта в шаблоне можно сразу же изменить некоторые макросы:

А вот триггеры, к которым они относятся:

Описание макросов есть в репозитории, но я всё же поясню каждый.

• {$POSTFIX.ACTIVE.MAX}, {$POSTFIX.DEFERRED.MAX} и {$POSTFIX.HOLD.MAX} - количество  различных сообщений в очереди отправки. На это значение настроены триггеры, которые срабатывают при превышении. Это одни из самых важных метрик, так как резкий рост очереди сообщений почти всегда означает, что на сервере есть какие-то проблемы, если вы перед этим не делали сами массовых рассылок. При ровной нагрузке на сервер очередь примерно одинаковая. Рост очереди может может быть вызван взломом одного из ящиков и несанкционированной массовой рассылкой с него, попаданием сервера в какие-то чёрные списки, проблем с настройками, которые приводят к отказу других серверов принимать вашу почту. Например, не так давно у одного из обслуживаемых серверов изменился IP адрес. Заменили все DNS записи, а про PTR запись забыли. В результате некоторые сервера стали отклонять от него почту, и она болталась в очереди. По мониторингу заметил эту проблему, стал разбираться и нашёл причину. Данные макросы подбираются под каждый конкретный сервер в зависимости от интенсивности отправки и специфики его работы. Сначала посмотрите, какие у вас средние значения метрик, для которых есть триггеры с этими макросами, а потом настройте их.
• {$POSTFIX.BOUNCE.MAX} и {$POSTFIX.REJECTED.MAX} - количество писем в статусе bounce и rejected на основе анализа лог-файла с помощью pflogsumm. Макрос {$POSTFIX.TRIGGER.PERIOD} определяет за какой период будут рассчитываться допустимые значения определённых выше макросов. Как и в предыдущих макросах, эти значения нужно вычислять экспериментальным путём во время отладки мониторинга. Выставьте какой-то период и посмотрите средние значения bounce и rejected. А потом уже установите пороги в макросах в x3-x5 от средних значений.
• {$POSTFIX_USER} - пользователь, от которого работает почтовый сервер. По умолчанию обычно это postfix.

Шаблон импортировали, с макросами разобрались. Теперь подключаем шаблон к хосту с почтовым сервером и наблюдаем за поступлением данных.

В шаблоне очень много всевозможных метрик, связанных с процессами почтового сервера и потреблением ресурсов. Если у вас не супернагруженный сервер, эти метрики вам вряд ли понадобятся. Можете их отключить. Основное, как по мне, это анализ лог файла, очереди и все метрики, что от них зависят. В шаблоне это базовые айтемы postfix.logsummary и postfix.queue.

В шаблоне присутствуют несколько графиков и панель. Панель выглядит информативно, но адаптирована под большие мониторы. У меня с разрешением 2К некоторые элементы перекрывают друг друга и смотрятся неаккуратно:

Но в целом панель собрана хорошо. Если сработает какой-то триггер по bounce, rejected или очереди, с помощью панели можно будет быстро оценить состояние сервера.

Единственное, чего мне не хватает в этом шаблоне - триггера на доставленные письма. Если доставленных писем внезапно стало очень много, то это тоже подозрительно. Я в своих шаблонах обычно делал такой триггер с порогом в x5 от среднего числа писем за прошлый час. Сюда нетрудно его добавить, если вам будет нужна эта метрика. Ключ postfix.mail.delivered собирает эти значения.

Заключение

Если вам интересна тема мониторинга Postfix с помощью Zabbix, и вы хотите в ней разобраться получше, можете посмотреть мою прошлую статью по этой теме. Я сохранил её в виде отдельного файла. Не стал публиковать тут же на сайте, чтобы не было разного материала на одну и ту же тему. В той статье больше практики в виде скриптов и теории в виде самодельного шаблона, айтемов и триггеров к нему с подробным описанием каждого. Я там сам собирал шаблон и добавлял в него триггеры по своему усмотрению, которые считал наиболее актуальными для почтового сервера. Плюс, я там собираю сводную статистику по полученным и отправленным письмам за сутки. Возможно вам будут нужны эти данные.

Странно, что команда Zabbix до сих пор не сделала свой шаблон для Postfix. Это самый популярный почтовый сервер в экосистеме Linux. Мне кажется, он наравне с другими службами, типа Apache или Nginx заслуживает своего шаблона. Альтернативой предложенному шаблону может служить Prometheus exporter for Postfix. Он есть в репозитории Debian. Из него легко передать метрики в Zabbix через встроенную предобработку метрик Prometheus.