TPmail тестовой вывод.

Почтовый пакет TPmail для Unix систем

Выбор языка

[анг]  [рус]


Начало

Документация

Поддержка

Новости

Ресурсы

Контакты


Модуль sma_stat. Описание и работа с ним.

Оглавление

Модуль sma_stat
Перечень возможностей sma_stat
Ключи модуля sma_stat
Конфигурационный файл для sma_stat
Примеры использования
Пример конфигурационного файла
Примеры отчетов



Модуль sma_stat предоставляет статистику почтового трафика в виде отчетов с использованием HTML или ASCII форматов. Программа sma_stat читает на входе журналы sendmail (обычно это maillog), а затем, используя заданный конфигурационный файл, строит файлы отчетов. Отчеты могут быть сделаны для нескольких серверов (можно объединить журналы sendmail для этих машин в один общий журнал). Можно использовать различные конфигурации при построении желаемых отчетов. При большом объеме трафика применение всех опций ведет к достаточно быстрому использованию дискового пространства. Например, при всех включенных опциях отчеты по обработке примерно 20 тысяч сообщений/соединений могут занять дисковое пространство до 100 Мегабайт.


Модуль sma_stat может предоставить следующую статистику о почтовом трафике:

- общие суммарные сведения за указанный период (количество сообщений/сообщений, объем почты и т.д.);
- общие суммарные сведения за неделю (количество сообщений/сообщений, объем почты и т.д.);
- cуммарные сведения за указанный период по узлам (relays);
- суммарные сведения за указанный период по получателям (recipients);
- детализированные сведения за указанный период по доменам (domains);
- детализированные сведения за указанный период по сообщениям (envelopes);
- детализированные сведения за указанный период по узлам (relays);
- детализированные сведения за указанный период по отказам приема (milter rejects);
- детализированные сведения за указанный период по отказам sendmail (ruleset rejects);
- дополнительные сведения за указанный период как неизвестные пользователи и так далее;
- поддержка ссылок на дополнительные отчеты как архив сообщений, статистика для анти-спам фильтра и ряд других специализированных отчетов;


Программа sma_stat поддерживает следующие опции командной строки
(они также описаны в стандартном руководстве man для sma_stat):


ОпцияНазначение
-hпечатать краткую помощь
-aформатировать вывод как ASCII текст (по умолчанию=HTML формат)
-gпечатать общую информацию
-uпечатать список необработанных сообщений sendmail
-zпечатать список неизвестных пользователей
-oпечатать список всех других сообщений sendmail
-nпечатать информацию по доменам (domains)
-mпечатать информацию по отказам приема (milter rejects)
-sпечатать информацию по отказам sendmail (ruleset rejects)
-eпечатать информацию по письмам/сообщениям (envelopes)
-iпечатать ссылочный файл
-rпечатать информацию по узлам (relays)
-tпечатать список TLS/SSL сообщений sendmail
-jпечатать список неактивных клиентов
-xпечатать суммарную информацию по получателям
-yпечатать суммарную информацию по узлам
-wпечатать общую статистику за неделю (суммарно)
-kпечатать статистику по письмам/отказам (ASCII текст)
-c configиспользовать данный файл как конфигурационный (по умолчанию=/usr/local/etc/sma_stat.conf)
-vпечатать шаги обработки
-pвключить временной хронометраж по шагам (профилирование)
-Pвыключить метод сортировки (mergesort)
-B outdirвыходной базовый каталог для всех отчетов (по умолчанию=текущий каталог)
-L logfileжурнальный файл (по умолчанию=/var/log/sma_stat.log)
-f infileвходной файл для обработки (format журнала для sendmail)
-G outfileвыходной файл общей информации (опция -g)
-N outfileвыходной файл информации по доменам (опция -n)
-R outfileвыходной файл информации по узлам (опция -r)
-E outfileвыходной файл информации по письмам/сообщениям (опция -e)
-M outfileвыходной файл информации по отказам приема milter rejects (опция -m)
-S outfileвыходной файл информации по отказам sendmail ruleset rejects (опция -s)
-O outfileвыходной файл всех других сообщений sendmail (опция -o)
-T outfileвыходной файл TLS/SSL сообщений sendmail (опция -t)
-J outfileвыходной файл сообщений всех неактивных клиентов (опция -j)
-U outfileвыходной файл необработанных сообщений sendmail (опция -u)
-X outfileвыходной файл суммарной информации по получателям (опция -x)
-Y outfileвыходной файл суммарной информации по узлам (опция -y)
-Z outfileвыходной файл всех неизвестных пользователей (опция -z)
-I outfileвыходной файл для всех ссылок на отчеты и другие файлы (опция -i) (по умолчанию=index.html)
-K outfileвыходной файл статистики по письмам/отказам (опция -k)
-d levelуровень отладочной печати (по умолчанию=0)
-Vпечатать версию


Конфигурационный файл для sma_stat практически идентичен опциям командной строки со следующими исключениями:
1) можно задать разбиение больших файлов HTML на более маленькие секции;
2) можно задать ссылки на отчеты из других программ;

За редким исключением рекомендуется использовать конфигурационный файл.

В составе модуля sma_stat есть готовые сценарии для построения отчетов статистики:
sma_stat_current.sh, sma_stat_daily.sh, weekly_mail_report.sh


Примеры использования.

Пример 1.
Построим только общую статистику в текстовом формате.
# /usr/local/bin/sma_stat -f /var/log/maillog -ag -G general.asc

Пример 2.
Построим всю статистику в HTML формате и разместим все отчеты на Веб сервере. Считаем, что все необходимые опции уже включены в конфигурационном файле.
# /usr/local/bin/sma_stat -B /usr/local/www/data/mailstat/current -f /var/log/maillog



Пример конфигурационного файла (входит в комплект поставки): sma_stat.conf.sample


Примеры отчетов.

Отчет за неделю: weekly_report.html
Начальная страница отчетов: index.html
Начальная страница общих суммарных сведений за сутки: general.html
Cтраница общих сведений по отказам за сутки: milter_rejects_by_reason_count.html
Cтраница распределения хостов-отправителей по странам за сутки (отсортировано по именам):
relay_domains_by_name_level_1.html
Cтраница принятых сообщений за сутки (отсортировано по числу сообщений): envelope_pairs_by_count.html
Cтраница отказов за сутки (отсортировано по именам): milter_rejects_by_recipient_name.html



Valid HTML 3.2! Авторское Право © 2006 Дмитрий Стефанков Last modified: $Date: 2009-06-16 15:38:40+04 $ Powered by FreeBSD. Powered by Apache. Powered by OpenSSL.