[1С-Битрикс] Доверяй, но проверяй: контроль неотправленных писем в Битриксе с уведомлением админу

Автор Сообщение
news_bot ®

Стаж: 6 лет 9 месяцев
Сообщений: 27286

Создавать темы news_bot ® написал(а)
10-Июл-2020 07:32

Предыстория
Когда-то у меня возникла необходимость проверять наличие неотправленных сообщений в «1С-Битрикс: Управление сайтом» (далее Битрикс) и получать уведомления об этом. Проблемы с отправкой почты были крайне редкими, однако довольно неприятными событиями, т.к. обычно это были заказы, подтверждения регистрации и прочие важные письма.
Сложность была в том, что если используемый Битриксом метод отправки почты перестал работать(с большой вероятностью причина в этом), то этим же самым методом отправлять уведомление будет ненадёжно.
Погуглив, я не нашёл чего-то бесплатного и готового, однако встретил немало вопросов/ответов о неотправленных письмах из Битрикса — каким образом их найти, какими могут быть причины их появления и т.п. Поэтому счёл нужным поделиться своим решением.
Задача
  • Получить реквизиты для соединения с БД из конфига сайта Битрикса
  • Соединиться с БД
  • Проверить количество неотправленных писем
  • Сравнить количество с предельно допустимым
  • Принять решение об отправке уведомления

Реализация
На вход shell-скрипту будут поступать 3 параметра:
  • Путь к конфигу сайта Битрикса (path_to_bxdb_config)
  • Текст запроса к БД (single_num_value_query)
  • Предельно допустимая величина (max_num_value)

Для корректной работы запрос к БД должен возвращать одиночное числовое значение.

Код скрипта check_bx_db_value.sh

SPL
#!/bin/bash
#
# Site: https://github.com/AlexeyGogolev/check-bx-db-value
#
mysql="$(which mysql)" # получение пути к mysql
php="$(which php)" # получение пути к php
declare -A CLParams # массив значений параметров КС
declare -a CLParams_keys # массив ключей для массива параметров КС
declare -A DBSettings # массив значений переменных конфига
declare -a DBSettings_keys # массив ключей для массива значений переменных конфига
DBSettings_keys=(DBLogin DBPassword DBName)
CLParams_keys=(path_to_bxdb_config single_num_value_query max_num_value)
param_num=0 # счетчик параметров КС
# получение параметров КС
for key in "${CLParams_keys[@]}" ; do
    ((param_num++))
    CLParams[$key]=${!param_num}    # ${!param_num} здесь генери-т $1 $2...
done
# если нет последнего параметра, показываем справку
if  [ -z "${CLParams[${CLParams_keys[$param_num-1]}]}" ] ; then
    printf "Script compares result returned by <${CLParams_keys[1]}> to given <${CLParams_keys[2]}>.\nIf the result more than the given value, then exit with code 1, else exit 0.\n"
    printf "Usage: \n\t$(basename ${BASH_SOURCE[0]}) " ; for key in "${CLParams_keys[@]}" ; do printf "<$key> "; done ; printf "\n"
    printf "Example: \n\t$(basename ${BASH_SOURCE[0]}) "/www/ab.cd/bitrix/php_interface/dbconn.php" "select count(id) from b_event where SUCCESS_EXEC<>'Y'" 5\n"
    exit 10
fi
# выход если конфиг пустой или его нет
if ! [ -s "${CLParams[path_to_bxdb_config]}" ] ; then
    printf "File ${CLParams[path_to_bxdb_config]} doesn't exist or empty.\n"
    exit 20
fi
# выход если параметр запроса к БД содержит команду из "запретного списка"
echo ${CLParams[single_num_value_query]} | grep -i -q -E 'delete|update|insert|drop' && printf "query \n${CLParams[single_num_value_query]}\nisn't allowed\n" && exit 30
# получение значений переменных из php-config -n -- без php.ini , -r -- выполнить код без тэгов <?...?>
for key in "${DBSettings_keys[@]}" ; do
    DBSettings[$key]="$($php -n -r 'include("'${CLParams[path_to_bxdb_config]}'"); print $'$key';')"
done
# экспорт пароля mysql в переменную окружения (по соображениям безопасности)
export MYSQL_PWD=${DBSettings[DBPassword]}
# получение одиночного значения из БД: -N -- без названий колонок ; -B - (batch) - результаты без "бокса" вокруг значений; -e выполнить запрос
num_value=`${mysql} -u ${DBSettings[DBLogin]} -N -B -e "use ${DBSettings[DBName]}; ${CLParams[single_num_value_query]}"`
# отображение значений
echo "Result of the query (from DB ${DBSettings[DBName]}): ${num_value}, ${CLParams_keys[2]}: ${CLParams[max_num_value]}"
# сравнение значений
if [ $num_value -gt ${CLParams[max_num_value]} ]; then
    exit 1
fi


Пример вызова скрипта ab_cd_unsent_check.sh

SPL
#!/bin/bash
check_bx_db_value.sh \
«/www/ab.cd/bitrix/php_interface/dbconn.php» \
«select count(id) from b_event where SUCCESS_EXEC<>'Y'» \
2


Проверка результатов выполнения с кодами завершения скрипта

SPL
запускаем:
$ ./ab_cd_unsent_check.sh && echo "success" || echo "failure"

получаем:
Result of the query (from DB ab_cd): 0, max_num_value: 2
success

Добавим неотправленных сообщений и запустим снова.
$ ./ab_cd_unsent_check.sh && echo "success" || echo "failure"

а теперь:
Result of the query (from DB ab_cd): 4, max_num_value: 2
failure


Все работает как нужно! В первом случае значение в БД не превышает заданного, скрипт выдает код 0 по завершении. Во втором значение в БД превышает заданное, скрипт завершается с кодом ошибки.
Настройка конфигурации monit
В данной статье я приведу пример конфигурации monit для отправки сообщений на e-mail.
Подразумевается, что на машине уже установлен и настроен monit.
Для повышения надёжности, в конфиге monitrc следует указывать аккаунт на почтовом сервере, отличном от используемого Битриксом для отправки писем. Кроме того, путем настройки и запуска дополнительных скриптов в конфигурации monit можно выполнять отправку сообщений в мессенджеры и соцсети.

Пример конфигурации monit

SPL
check program ab_cd_unsent_check with path /home/bitrix/scripts/ab_cd_unsent_check.sh
every 2 cycles
    group mail
if status != 0 then alert

Файл конфигурации следует поместить в /etc/monit.d/.

Для упрощения демонстрации, в этом примере установлено 2 цикла (здесь 1 цикл = 30 сек).
Чтобы monit не отправлял ложные алерты, в реальных условиях, нужно ставить столько циклов, чтобы письма успевали уходить — подбирается опытным путём. Здесь следует учитывать среднее количество сообщений, генерируемых сайтом, и скорость(время) их обработки почтовым сервером.
Для проверки работы конфигурации в терминале выполняем:
# systemctl restart monit
# monit status

получаем:

Без неотправленных сообщений

SPL


С неотправленными сообщениями

SPL


Так выглядят уведомления от monit на почту:

Появились неотправленные сообщения!

SPL


Все сообщения отправлены (теперь всё норм.&#41;.

SPL


Отправка уведомлений из monit работает корректно.
Заключение
Надеюсь решение получилось достаточно универсальным и подойдёт для других задач.
Вот и всё! Исходники для статьи можно скачать здесь.
P.S. Кому не сложно прошу поделиться в комментариях — возникают ли у вас подобные задачи?
Если да, то каким образом они решаются?
===========
Источник:
habr.com
===========

Похожие новости: Теги для поиска: #_1sbitriks (1С-Битрикс), #_bitriks (битрикс), #_monitoring_sajta (мониторинг сайта), #_shell_scripting, #_php, #_mysql, #_monit, #_centos_7, #_1sbitriks (
1С-Битрикс
)
Профиль  ЛС 
Показать сообщения:     

Вы не можете начинать темы
Вы не можете отвечать на сообщения
Вы не можете редактировать свои сообщения
Вы не можете удалять свои сообщения
Вы не можете голосовать в опросах
Вы не можете прикреплять файлы к сообщениям
Вы не можете скачивать файлы

Текущее время: 22-Ноя 18:05
Часовой пояс: UTC + 5