ALT
S: | 7.9-alt0.2 |
5.1: | 6.9-alt0.b2008.11.30.M51.1 |
4.1: | 6.9-alt0.0.b2008.08.05.M41.1 |
4.0: | 6.9-alt0.b2008.11.30.M40.1 |
3.0: | 6.4-alt1 |
Upstream: | 6.7 |
::
: awstats
Gear Bugs and FR Repocop
AWStats в ALTLinux
==================
Для минимальной настройки AWStats достаточно:
* Создать конфигурационный файл/файлы в /etc/awstats/. Проще всего
это сделать скопировав входящий в пакет пример:
cp /usr/share/doc/awstats-6.95/awstats.model.conf /etc/awstats/awstats.<name>.conf
* в созданном файле необходимо как как минимум проверить/задать значения для:
LogFile=
LogFormat=
SiteDomain=
HostAliases=
Все опции конфигурационного хорошо документированы в комментариях. Полную
информацию о AWStats вы можете получить из html документации, доступной в пакете
awstats-docs.
Обратите внимание на то, что реально используемый формат Log-файлов зависит от
настроек сервера, генерирующего эти файлы. Например, для получения более полной
статистики web-сервера рекомендуется использовать combined формат Log-файлов,
что нужно указать в настройках самого web-сервера.
Обновление статистики
---------------------
cron
~~~~
По умолчанию статистика обновляется автоматически каждый час для всех
конфигурационных файлов, находящихся в /etc/awstats/, и сохраняется в каталоге
/var/lib/awstats/.
Обратите внимание на то, что по умолчанию скрипт обновления статистики
запускается от пользователя awstats, что в случае работы с Log-файлами Apache2
может потребовать, например, добавление этого пользователя в группу apache2 для
возможности чтения Log-файлов. Сделать это можно выполнив:
usermod -g awstats -G apache,apache2 awstats
CGI
~~~
Обновление статистики из браузера при использовании CGI (опция
AllowToUpdateStatsFromBrowser=1 в конфигурационном файле) не работает с
умолчательным значением DirData (/var/lib/awstats). Если вы желаете использовать
AllowToUpdateStatsFromBrowser=1, то необходимо переназначить DirData в каталог,
доступный для записи web-серверу.
вручную
~~~~~~~
Запуская поставляемые с AWStats скрипты, находящиеся в /usr/share/awstats/tools/
(а также основной скрипт awstats.pl в /usr/share/awstats/wwwroot/cgi-bin/),
можно обновлять статистику и генерировать отчёты самостоятельно.
Ротация
-------
Если по отношению к Log-файлам применяется процедура ротации, то во избежание
потери части статистики рекомендуется добавить скрипт обновления статистики в
prerotate:
Например, для Apache2 в файл /etc/logrotate.d/apache2 добавить:
prerotate
if [ -x /usr/share/awstats/tools/awstats_updateall.pl ]; then
su - -c "/usr/share/awstats/tools/awstats_updateall.pl now \
-confdir=/etc/awstats \
-awstatsprog=/usr/share/awstats/wwwroot/cgi-bin/awstats.pl > /dev/null" \
-s /bin/sh
awstats
fi
endscript
При этом в файле конфигурации awstats может быть полезно использовать параметр
EnableLockForUpdate=1, чтобы быть уверенным, что одновременно запускается только
один процесс обновления.
Просмотр статистики
-------------------
Просмотр автоматически cгенерированной статистики доступен по ссылке:
http://<www.myserver.mydomain>/awstats/awstats.pl?config=<mysite>
Обратите внимание, что для просмотра статистики необходима установка
дополнительного пакета для интеграции с web-сервером.
Обновление с версий ниже 0.95-alt1
----------------------------------
Начиная с версии 0.95-alt1 были изменены пути к некоторым ресурсам. Поэтому для
конфигурационных файлов, созданных для работы с более старыми версиями, может
потребоваться изменение некоторых параметров на новые значения:
DirIcons="/awstatsicons"
MiscTrackerUrl="/awstatsjs/awstats_misc_tracker.js"
StyleSheet="/awstatscss"
LoadPlugin="graphapplet /awstatsclasses"