فعال‌سازی و سفارشی‌سازی آمار وب‌سایت (Website Statistics) در DirectAdmin

مقدمه

در کنترل‌پنل DirectAdmin، ابزارهای مختلفی برای مشاهده و تحلیل آمار بازدیدکنندگان وب‌سایت در دسترس است. به‌صورت پیش‌فرض، DirectAdmin از نرم‌افزار Webalizer برای تولید گزارش‌های آماری استفاده می‌کند. با این حال، می‌توان آن را با نرم‌افزار قدرتمندتر AWStats جایگزین یا تکمیل کرد.

AWStats و Webalizer هر دو قابلیت تولید گزارش‌های تحلیلی در مورد تعداد بازدیدکنندگان، صفحات مشاهده‌شده، حجم پهنای‌باند مصرفی، ربات‌ها، مرورگرها، سیستم‌عامل‌ها و کشورها را دارند. تفاوت اصلی این است که AWStats گزارش‌های دقیق‌تر و جزئی‌تری نسبت به Webalizer ارائه می‌دهد.

فعال‌سازی AWStats در DirectAdmin

نکته مهم

فعال‌سازی AWStats یک گزینه سراسری (global) است و برای همه دامنه‌ها اعمال می‌شود. امکان فعال‌سازی یا غیرفعال‌سازی مجزا برای هر دامنه به‌صورت پیش‌فرض وجود ندارد.

مراحل نصب و فعال‌سازی

برای نصب و فعال‌سازی AWStats باید دستورهای زیر را اجرا کنید:

da build set awstats yes
da build awstats

این دستورات چند عملیات مهم انجام می‌دهند:

1. دانلود و نصب AWStats به همراه فایل‌های پیکربندی آن.
2. اضافه کردن مقدار awstats=1 به فایل پیکربندی directadmin.conf.
3. غیرفعال کردن Webalizer با قرار دادن webalizer=0 در همان فایل (البته امکان فعال‌سازی همزمان وجود دارد).

نکته فنی درباره لاگ‌ها

• به دلیل شیوه‌ای که لاگ‌های Apache در فایل‌های پیکربندی AWStats تعریف می‌شوند، فرآیند چرخش (rotation) لاگ‌ها کمی متفاوت خواهد بود.
• قبل از اجرای عملیات آمارگیری (tally)، لاگ‌ها به .log.1 تغییر نام داده نمی‌شوند، بلکه در همان مسیر پردازش می‌شوند.
• به همین دلیل سیگنال HUP به پردازشگر اصلی Apache ارسال نمی‌شود و لاگ‌ها صرفاً truncated می‌شوند.
• این تغییر معمولاً مشکلی ایجاد نمی‌کند، چون Apache پس از پایان tally ریستارت می‌شود.

مسیر ذخیره‌سازی گزارش‌ها و داده‌ها

فایل‌های HTML تولیدشده توسط AWStats در مسیر زیر ذخیره می‌شوند:

/home/user/domains/domain.com/awstats

فایل‌های پیکربندی و داده‌های آماری (tally data) در مسیر زیر نگهداری می‌شوند:

/home/user/domains/domain.com/awstats/.data

مزایا

• قرار گرفتن داده‌ها در مسیر خانۀ کاربر (/home/user) باعث می‌شود هنگام انتقال حساب کاربری به سرور دیگر، گزارش‌های آماری نیز منتقل شوند.
• این ساختار نسبت به پلاگین‌های جانبی AWStats امنیت بیشتری دارد، زیرا فایل‌ها به مالکیت root هستند و مجوزهای دسترسی حداقلی دارند. این موضوع خطر تغییر غیرمجاز توسط سایر کاربران را از بین می‌برد.

ویژگی‌های AWStats در DirectAdmin

• هر زیر دامنه (Subdomain) صفحه آماری جداگانه خواهد داشت.
• DirectAdmin داده‌های AWStats را برای محاسبه پهنای‌باند هر زیردامنه پردازش می‌کند (مشابه Webalizer).
• لینک ../stats در صفحه آمار دامنه به پوشه ../awstats هدایت خواهد شد.
• کاربران می‌توانند AWStats را از طریق GUI یا فایل user.conf غیرفعال کنند: awstats=0

سفارشی‌سازی خروجی (Webalizer)

به‌طور پیش‌فرض، DirectAdmin هیچ فایل پیکربندی اختصاصی برای Webalizer تعریف نمی‌کند و از تنظیمات پیش‌فرض آن استفاده می‌شود. اما شما می‌توانید فایل پیکربندی اختصاصی بسازید.

مراحل سفارشی‌سازی

ایجاد فایل:

/usr/local/directadmin/data/templates/custom/webalizer.conf

افزودن تنظیمات دلخواه (مثال: فعال‌سازی Reverse DNS Lookup):

DNSCache /var/lib/webalizer/|DOMAIN|.dns_cache.db DNSChildren 10

اعمال دسترسی و مالکیت:

chown root:root /var/lib/webalizer chmod 1777 /var/lib/webalizer

اجرای دستی (Webalizer)

بدون فایل سفارشی:

webalizer -p -n [DOMAIN] -o /home/[USER]/domains/[DOMAIN]/stats /var/log/httpd/domains/[DOMAIN].log

با فایل سفارشی:

webalizer -c /usr/local/directadmin/data/templates/custom/webalizer.conf -p -n [DOMAIN] -o /home/[USER]/domains/[DOMAIN]/stats /var/log/httpd/domains/[DOMAIN].log

روش پیشنهادی برای اجرای آمارگیری یک کاربر:

echo "action=tally&value=[USER]&type=user" >> /usr/local/directadmin/data/task.queue

مشاهده فایل دیتابیس (DNS Cache)

db_dump  /var/lib/webalizer/[DOMAIN].dns_cache.db

فعال‌سازی آمار کشورها در (AWStats)

روش سریع (DNSLookup)

ویرایش فایل پیکربندی دامنه:

/home/username/domains/domain.com/awstats/.data/awstats.domain.com.conf

مقدار زیر را تنظیم کنید:

DNSLookup=1

توجه: این روش ساده است اما باعث کند شدن پردازش آمار می‌شود، زیرا برای هر IP یک reverse lookup انجام می‌گیرد.

روش پیشرفته (GeoIP Plugin)

از سال 2019، MaxMind پشتیبانی از GeoIP v1 را متوقف کرده است، بنابراین باید از پلاگین GeoIP استفاده شود.

مراحل:

نصب کتابخانه

GeoIP: wget http://maxmind.com/download/geoip/api/c/GeoIP.tar.gz tar xvzf GeoIP.tar.gz cd GeoIP* ./configure make make install

نصب ماژول

Perl: cpan -i Geo::IP

ویرایش فایل پیکربندی AWStats دامنه و افزودن خط زیر:

LoadPlugin="geoip GEOIP_STANDARD /usr/local/share/GeoIP/GeoIP.dat"

مقدار DNSLookups=0 باقی بماند.

بازسازی گزارش‌های ماه‌های قبل در AWStats

اگر داده‌های ماه‌های گذشته در مسیر .data وجود داشته باشند، می‌توان گزارش‌های HTML آن‌ها را بازسازی کرد.

اسکریپت نمونه (old_awstats.sh):

#!/bin/sh
if [ "$#" -eq 0 ]; then
         echo "Usage:";
         echo "    $0 <MM> <YY>";
         exit 1;
fi

month=$1
short_year=$2
full_year=20${short_year}

for u in `ls /usr/local/directadmin/data/users`; do
{
         for d in `cat /usr/local/directadmin/data/users/$u/domains.list`; do
         {
                   echo "";
                   echo "$u: $d: $month $full_year";
                   DATA=/home/$u/domains/$d/awstats/.data/awstats${month}${full_year}.${d}.txt
                   if [ ! -s $DATA ]; then
                             echo "Cannot find $DATA for $month $full_year. Skipping.";
                             continue;
                   fi

                   /usr/bin/perl /usr/local/awstats/tools/awstats_buildstaticpages.pl \
                       -config=$d -configdir=/home/$u/domains/$d/awstats/.data -update \
                       -diricons=icon -awstatsprog=/usr/local/awstats/cgi-bin/awstats.pl \
                       -dir=/home/$u/domains/$d/awstats -builddate=${short_year}${month} \
                       -year=$full_year -month=$month

                   echo "";
         }
         done;
}
done;
exit 0;

دستورات تکمیلی

• ذخیره اسکریپت و اعطای دسترسی:
  chmod 755 old_awstats.sh
• اجرای اسکریپت (مثال: آوریل 2020):
  ./old_awstats.sh 04 20

رفع خطای AWStats در CageFS

اگر AWStats در محیط CageFS درست کار نکند و با خطا مواجه شوید (مثلاً فایل perl پیدا نشود):

Can't open perl script "/usr/local/awstats/tools/awstats_buildstaticpages.pl": No such file or directory

راه‌حل

فایل پیکربندی CageFS را ویرایش کنید:

/etc/cagefs/conf.d/directadmin.cfg

و مسیرهای زیر را اضافه کنید (مثال برای AWStats 7.7):

paths=/usr/local/awstats/, /usr/local/awstats-7.7/, /usr/local/awstats, /usr/local/php....

اجرای دستور:

/usr/sbin/cagefsctl --force-update

بررسی اینکه فایل‌ها کپی شده‌اند:

ls -la /usr/share/cagefs-skeleton/usr/local

جمع‌بندی

در DirectAdmin امکان استفاده از دو ابزار آمارگیری وب وجود دارد: Webalizer و AWStats.

• AWStats دقت و امنیت بیشتری دارد، امکان آمارگیری مجزا برای زیردامنه‌ها فراهم می‌کند و می‌تواند با پلاگین GeoIP کشور کاربران را شناسایی کند.
• Webalizer ساده‌تر است اما قابلیت سفارشی‌سازی دارد و با ساخت فایل پیکربندی می‌توان آن را توسعه داد.
• هر دو ابزار قابلیت بازسازی گزارش‌ها و تنظیم دستی دارند.
• در محیط‌های CageFS باید پیکربندی صحیح برای AWStats انجام شود تا بدون خطا اجرا شود.