Complete Virtual Mail Server/awstats/ru

Введение
Even though postfix provides logs, having them graphically displayed and analyzed can give much more insight. is a popular log analyzer that can parse logs and setup proper results.

Установка
AWStats is a web-application but no longer relies on webapp-config. If it hasn't emerged already, it needs to be emerged.

Once installed, a config file needs to be created, either per domain, or one that handles all domains.

AWStats isn't installed via webapp-config, but rather a simple symlink is used.

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

Во-первых, awstats предполагает, что vhosts не используется. Например, если используется значение по умолчанию для apache журнала combined vhost, awstats не запуститься.

Предположим, что combined LogFormat настроен следующим образом:

Затем необходимо сделать следующие изменения:

Долее awstats должен знать о доменах и алиасах, чтобы отфильтровать их из журнала:

Также, awstats нужно хранить его базу данных где-то. Gentoo создает каталог для этого, но можно использовать любой другой. Убедитесь, что разрешения установлены так, чтобы пользователь apache мог записывать туда:

Любые другие изменения настроек не обязательны, но все же взгляните на них:

Журналирование
awstats needs to process the apache log file to build its database. Once confirmed that it is working manually it can be automated.

Ручная настройка
Сперва awstats должен быть запущен из консоли, чтобы обнаружить любые основные ошибки:

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

Cron
Если все работает отлично, то можно добавить это в :

Не забудьте сделать скрипт исполняемым, если это необходимо.

Logrotate
Awstats will process the log file every hour, but when logrotate rotates apache's log, some entries may be missing. This is easily solved however.

Apache
For awstats to be used from apache, the webhost needs to properly setup. In the alias section, the following needs to be added:

Наконец, awstats нуждается в правильных разрешениях, чтобы быть доступным:

After a restart of apache, awstats should be available via http://stats.example.com/awstats/awstats.pl?config=stats.example.com. If no config option is passed to awstats, it uses the current hostname, which means in this case could have been omitted.

Awstats for mail log
AWStats is known for being an apache log parser. However it can also be used to parse mail logs.

Конфигурация
After copying to  quite a few changes are required to turn awstats into a mail log parser.

With those changes in place, a manual run should work without any issues:

Журналирование
To scan the mail log every hour, the existing awstats script in can be appended with the following:

Also syslog is getting rotated and thus awstats needs to parse the mail log file before the mail log is being rotated:

If logging of apache files is not desired, or webmail resides on a different server, the webserver log parsing can be removed from cron jobs.