.TH VISITORS "1" "April 2005" "Visitors 0.7" .SH "نام (NAME)" visitors \- تحلیل‌گر سریع لاگ کارساز وب .SH "خلاصه دستور (SYNOPSIS)" .B visitors [\fIoptions\fR] \fI\fR [\fI\fR ...] .SH "توضیحات (DESCRIPTION)" .PP .I Visitors آمارهای دسترسی را از فایل‌های لاگ وب مشخص‌شده تولید می‌کند. گزارش‌های حاصل شامل مجموعه‌ای از اطلاعات و آمارهای مفید هستند: .IP \[bu] 2 صفحه‌های درخواست‌شده .IP \[bu] تصویرهای درخواست‌شده .IP \[bu] ارجاع‌دهنده‌ها بر اساس تعداد بازدیدها و قدمت .IP \[bu] بازدیدکنندگان یکتا در هر روز .IP \[bu] تعداد نمایش صفحه در هر بازدید .IP \[bu] صفحه‌های بررسی‌شده توسط خزنده‌ی Google (و تاریخ آخرین دسترسی گوگل به هر صفحه) .IP \[bu] صفحه‌های بررسی‌شده توسط خزنده‌ی AdSense (و تاریخ آخرین دسترسی ادسنس به هر صفحه) .IP \[bu] درصد بازدیدهای ناشی از جستجوهای Google برای هر روز .IP \[bu] الگوهای ناوبری کاربران (ردپاهای وب) .IP \[bu] عبارت‌های کلیدی استفاده‌شده در جستجوهای Google .IP \[bu] زبان‌های انسانی استفاده‌شده در جستجوهای Google .IP \[bu] عامل‌های کاربر (User agents) .IP \[bu] توزیع روزهای هفته و ساعت‌های دسترسی .IP \[bu] نقشه‌ی دوبُعدی ترکیبی روزهای هفته/ساعت‌ها .IP \[bu] نقشه‌ی دوبُعدی ترکیبی ماه/روز .IP \[bu] تحلیل بصری مسیر با Graphviz .IP \[bu] محبوبیت سیستم‌عامل‌ها، مرورگرها و دامنه‌ها .IP \[bu] وضوح صفحه‌نمایش و عمق رنگ بازدیدکنندگان .IP \[bu] خطاهای 404 .PP نیازی نیست فایل‌های لاگ وب از قالب سفت‌وسختی پیروی کنند، به‌جز اینکه: تاریخ حتماً باید بین نویسه‌های [ و ] قرار گیرد، نام میزبان کلاینت باید نخستین مدخل در لاگ باشد، و ارجاع‌دهنده‌ها و درخواست‌ها باید میان نویسه‌های نقل‌قول دوگانه قرار داشته باشند. فایل‌های لاگ پیش‌فرض Apache بدون مشکل کار خواهند کرد. می‌توان از Visitors برای فایل‌های لاگ IIS نیز استفاده کرد؛ به‌این‌صورت‌که آن‌ها را با استفاده از ابزار iis2apache.pl که همراه Visitors توزیع می‌شود تبدیل کنید (این ابزار همان ابزاری است که می‌توانید در http://www.jammed.com/~jwa/hacks بیابید و تحت پروانه‌ی GPL توزیع شده است). توجه داشته باشید که برای استفاده از ورودی استاندارد می‌توان به‌جای نام فایل لاگ از نویسه‌ی \- استفاده کرد. .PP .SS "گزینه‌های موجود:" .TP 8 .BI "\-A \-\-all" فعال‌سازی تمام گزارش‌های اختیاری. این گزینه معادل .B -GKUWRDOB است. توجه داشته باشید که .B --trails به‌طور ضمنی در این گزینه گنجانده نشده است، زیرا به .B --prefix نیز نیاز دارد. برای جزئیات بیشتر مستندات گزینه‌ی .B --trails را ببینید. .PP .TP 8 .BI "\-T \-\-trails" فعال‌سازی ویژگی ردپاهای وب (Web Trails). این گزارش متداول‌ترین جابه‌جایی‌ها میان صفحه‌های وب‌سایت شما را نشان می‌دهد. این گزینه برای کارکرد به گزینه‌ی .B --prefix نیاز دارد. .PP .TP 8 .BI "\-G \-\-google" فعال‌سازی دو گزارش درباره‌ی صفحه‌هایی که توسط خزنده‌های وب Google و Adsense دسترسی یافته‌اند. صفحه‌ها بر اساس آخرین باری که خزنده‌ی وب گوگل آن‌ها را درخواست کرده است مرتب می‌شوند. نخستین صفحه‌ی نمایش‌داده‌شده، جدیدترین صفحه‌ای است که مورد دسترسی قرار گرفته است. .PP .TP 8 .BI "\-K \-\-google\-keyphrases" فعال‌سازی گزارشی که عبارت‌های کلیدی رایج جستجو برای یافتن وب‌سایت شما از طریق Google را نمایش می‌دهد. .PP .TP 8 .BI "\-Z \-\-google\-keyphrases-age" فعال‌سازی گزارشی که جدیدترین عبارت‌های کلیدی استفاده‌شده برای یافتن وب‌سایت شما از طریق Google را نمایش می‌دهد. .PP .TP 8 .BI "\-H \-\-google\-human-language" فعال‌سازی گزارشی که زبان‌های انسانی متداول استفاده‌شده در جستجو از طریق Google را نمایش می‌دهد. این ویژگی از متغیر 'hl' در URL ارجاع‌دهنده‌ی گوگل استفاده می‌کند. .PP .TP 8 .BI "\-U \-\-user\-agents" نمایش اطلاعات درباره‌ی عامل‌های کاربر (user agents) متداول. .PP .TP 8 .BI "\-W \-\-weekday\-hour\-map" فعال‌سازی تولید یک نقشه‌ی دوبُعدی ترکیبی روزهای هفته/ساعت‌ها که اطلاعات ترافیک را در تمام ۱۶۸ ساعت مختلف یک هفته‌ی ۷ روزه نشان می‌دهد. رنگ‌های روشن‌تر به معنای ترافیک بیشتر هستند. این نقشه برای آگاهی از بهترین زمان در طول هفته جهت خاموشی برای تعمیر و نگهداری، شناخت جامعه‌ی هدف سایت، بررسی اینکه کاربران از محل کار یا خانه به سایت دسترسی دارند و مواردی از این دست ایده‌آل است. نقشه به‌صورت HTML خالص درون گزارش تولید می‌شود. .PP .TP 8 .BI "\-M \-\-month\-day\-map" فعال‌سازی تولید یک نقشه‌ی دوبُعدی ترکیبی ماه/روز که اطلاعات ترافیک را در تمام ۳۶۵ روز سال نمایش می‌دهد. رنگ‌های روشن‌تر به معنای ترافیک بیشتر هستند. این نقشه برای بررسی سریع روندهای ترافیکی و روزهایی با ترافیک به‌ویژه بالا یا پایین مفید است. نقشه به‌صورت HTML خالص درون گزارش تولید می‌شود. .PP .TP 8 .BI "\-R \-\-referers\-age" نمایش ارجاع‌دهنده‌ها مرتب‌شده بر اساس قدمت. «قدمت» یک ارجاع‌دهنده، تاریخی است که برای نخستین بار ثبت شده است. در گزارش، ارجاع‌دهنده‌های جدیدتر در بالا قرار دارند. این گزارش برای بررسی پیوندهای خارجی جدید کاربرد دارد. .PP .TP 8 .BI "\-D \-\-domains" فعال‌سازی تولید اطلاعات درباره‌ی محبوبیت دامنه‌های سطح‌بالا (TLD). این اطلاعات ممکن است برای حدس زدن میزان بازدیدها از کشورهای گوناگون مفید باشد. توجه داشته باشید که Visitors آدرس‌های IP عددی را در صورتی که از قبل در فایل لاگ تحلیل (resolve) نشده باشند، تحلیل نمی‌کند. تمام آدرس‌های IP تحلیل‌نشده در این گزارش ذیل مدخل Unresolved IP نمایش داده می‌شوند. .PP .TP 8 .BI "\-O \-\-operating\-systems" فعال‌سازی گزارش محبوبیت سیستم‌عامل‌ها، مرتب‌شده بر اساس تعداد دسترسی‌ها. تمام سیستم‌عامل‌های متداول در گزارش فهرست شده‌اند، در حالی که سیستم‌عامل‌های ناشناخته در مدخل unknown جمع خواهند شد. .PP .TP 8 .BI "\-B \-\-browsers" فعال‌سازی گزارش محبوبیت مرورگرها، مرتب‌شده بر اساس تعداد دسترسی‌ها. تمام مرورگرهای متداول در گزارش فهرست شده‌اند، در حالی که مرورگرهای ناشناخته در مدخل unknown جمع خواهند شد. مرورگرها بر اساس خانواده (برای نمونه Internet Explorer، Opera و غیره) فهرست می‌شوند و نه بر اساس نسخه‌ی دقیق آن‌ها. .PP .TP 8 .BI "\-X \-\-error404" فعال‌سازی تولید گزارش اسناد مفقود (خطای 404). این گزارش فایل‌های درخواست‌شده اما ناموجود را به ترتیب تعداد درخواست‌ها نشان می‌دهد. این گزارش برای کشف مواردی که فایلی بر اثر اشتباه در وب‌سایت وجود ندارد مفید است، اما در اغلب موارد درخواست‌های نامتعارفی را مشاهده خواهید کرد که توسط کاربران، کرم‌های اینترنتی و پویش‌های امنیتی فرستاده شده‌اند. .PP .TP 8 .BI "\-Y \-\-pageviews" فعال‌سازی تولید گزارشی که درصد (تقریبی) صفحه‌های دیده‌شده در هر بازدید یکتا را نشان می‌دهد. هدف این گزارش درک الگوی استفاده از سایت و میزان علاقه‌مندی بازدیدکنندگان است. برای نمونه، در سایتی که صفحه‌های متعدد با محتوای جذاب ارائه می‌دهد، درصدی از بازدیدکنندگان که در هر بازدید فقط یک صفحه را مشاهده می‌کنند، احتمالاً به دنبال چیز دیگری بوده‌اند. .PP .TP 8 .BI "\-S \-\-robots" فعال‌سازی تولید گزارشی که عامل‌های کاربر کلاینت‌های درخواست‌کننده‌ی فایل robots.txt را نمایش می‌دهد (به‌استثنای درخواست‌های MSIE Crawler). نتیجه، فهرستی از روبات‌ها و خزنده‌های وب است که به وب‌سایت شما دسترسی داشته‌اند و بر اساس تعداد درخواست‌های robots.txt مرتب شده‌اند. .PP .TP 8 .BI "\-\-screen\-info" فعال‌سازی گزارش‌های وضوح صفحه‌نمایش و عمق رنگ. توجه داشته باشید که برای کارکرد این گزارش باید کد جاوااسکریپت موجود در فایل README بسته‌ی tarball برنامه‌ی visitors را در صفحه‌های HTML خود قرار دهید. .PP .TP 8 .BI "\-\-stream" فعال‌سازی حالت جریانی (برای اطلاعات بیشتر به بخش .B STREAM MODE DETAILS مراجعه کنید). به‌طور خلاصه: در حالت جریانی، .I Visitors ابتدا تمام فایل‌های لاگ مشخص‌شده را (یا هیچ‌کدام، که در این حالت نیز معتبر است) طبق روال معمول پردازش کرده و گزارش را تولید می‌کند. سپس حالت جریانی فعال شده و .I Visitors خواندن جریانی پیوسته از لاگ‌های وب را از ورودی استاندارد آغاز می‌کند و با دسترسی به داده‌های جدید، آمار را به‌صورت افزایشی به‌روزرسانی می‌نماید. در صورت رسیدن داده‌های تازه، بر اساس گزینه‌ی .B --update-every گزارش جدیدی به‌صورت دوره‌ای تولید می‌شود (پیش‌فرض این است که آمار هر ده دقیقه یک‌بار به‌روز شود). همچنین با استفاده از گزینه‌ی .B --reset-every می‌توان از .I Visitors خواست تا پس از گذشت مدتی مشخص، آمار را بازنشانی کند. این قابلیت امکان تهیه‌ی یک نمای لحظه‌ای (snapshot) از وقایع پنج دقیقه‌ی گذشته، ساعت، روز یا هفته‌ی اخیر را فراهم می‌سازد. توجه داشته باشید که .B --stream نیازمند گزینه‌ی .B --output-file است، زیرا .I Visitors باید برای هر به‌روزرسانی فایل گزارش را بازنویسی کند، بنابراین نمی‌تواند خروجی را طبق روال معمول به خروجی استاندارد بفرستد. چنانچه قصد استفاده از حالت جریانی را دارید، گزینه‌ی .B --tail را نیز بررسی کنید..PP .TP 8 .BI "\-\-update\-every" " seconds" به‌طور پیش‌فرض در «حالت جریان» (Stream Mode) آمارها هر ۱۰ دقیقه به‌روزرسانی می‌شوند. این گزینه دوره زمانی متفاوتی را بر حسب ثانیه مشخص می‌کند. .PP .TP 8 .BI "\-\-reset\-every" " seconds" به‌طور پیش‌فرض در «حالت جریان»، آمارها هرگز بازنشانی نمی‌شوند، بلکه به‌صورت پیوسته و افزایشی به‌روزرسانی می‌گردند. این گزینه مشخص می‌کند که آمار پس از مقدار زمان تعیین‌شده بر حسب ثانیه بازنشانی شود. این ویژگی برای داشتن یک تصویر لحظه‌ای (snapshot) از میزان استفاده از وب‌سایت مفید است. .PP .TP 8 .BI "\-f \-\-output\-file" " file" نوشتن خروجی در .I file به جای stdout. .PP .TP 8 .BI "\-m \-\-max\-lines" " number" تنظیم حداکثر تعداد ورودی‌هایی که باید در گزارش‌هایی مانند ارجاع‌دهنده‌ها (referers)، عبارت‌های کلیدی و غیره نمایش داده شوند. این گزینه حداکثر تعداد ورودی‌ها را برای تمام گزارش‌ها به صورت یکجا تنظیم می‌کند. .PP .TP 8 .BI "\-r \-\-max\-referers" " number" تنظیم حداکثر تعداد ورودی‌ها در گزارش ارجاع‌دهنده‌ها. .PP .TP 8 .BI "\-p \-\-max\-pages" " number" تنظیم حداکثر تعداد ورودی‌ها در گزارش صفحه‌های بازدیدشده. .PP .TP 8 .BI "\-i \-\-max\-images" " number" تنظیم حداکثر تعداد ورودی‌ها در گزارش تصاویر بازدیدشده. .PP .TP 8 .BI "\-x \-\-max\-error404" " number" تنظیم حداکثر تعداد ورودی‌ها در گزارش اسناد ناموجود (خطای ۴۰۴). .PP .TP 8 .BI "\-u \-\-max\-useragents" " number" تنظیم حداکثر تعداد ورودی‌ها در گزارش عامل‌های کاربر (user agents). .PP .TP 8 .BI "\-t \-\-max\-trails" " number" تنظیم حداکثر تعداد ورودی‌ها در گزارش مسیرهای وب (web trails). .PP .TP 8 .BI "\-g \-\-max\-googled" " number" تنظیم حداکثر تعداد ورودی‌ها در گزارش صفحه‌های خزش‌شده (توسط ربات گوگل). .PP .TP 8 .BI " \-\-max\-adsensed" " number" تنظیم حداکثر تعداد ورودی‌ها در گزارش صفحه‌های خزش‌شده (توسط ربات ادسنس). .PP .TP 8 .BI "\-k \-\-max\-google\-keyphrases" " number" تنظیم حداکثر تعداد ورودی‌ها در گزارش عبارت‌های کلیدی گوگل. .PP .TP 8 .BI "\-a \-\-max\-referers\-age" " number" تنظیم حداکثر تعداد ورودی‌ها در گزارش ارجاع‌دهنده‌ها بر پایه تاریخ. .PP .TP 8 .BI "\-d \-\-max\-domains" " number" تنظیم حداکثر تعداد ورودی‌ها در گزارش دامنه‌ها. .PP .TP 8 .BI "\-P \-\-prefix" " string" پیشوندها برای visitors مشخص می‌کنند که یک پیوند چگونه باید باشد تا به عنوان پیوند داخلی وب‌سایت شما دسته‌بندی شود. این گزینه برای .B --trails الزامی است و همچنین اثر مطلوب جلوگیری از نمایش پیوندهای داخلی در گزارش ارجاع‌دهنده‌ها را دارد. اگر در حال تجزیه‌وتحلیل آمار برای http://www.your.site.com هستید، کافی است استفاده کنید از: .B --prefix http://www.your.site.com اگر وب‌سایت شما با چندین نام میزبان (hostname) در دسترس است، باید همه آن‌ها را مشخص کنید، مانند مثال زیر: .br .B --prefix http://www.your.site.com --prefix http://your.site.com .PP .TP 8 .BI "\-o \-\-output" " html|text" پیمانه خروجی. می‌توانید از text یا html استفاده کنید. پیش‌فرض html است. .PP .TP 8 .BI "\-V \-\-graphviz" این گزینه حالت Graphviz را فعال می‌کند: .I Visitors فایل لاگ را تجزیه‌وتحلیل کرده و گرافی ایجاد می‌کند که الگوهای دسترسی وب‌سایت شما را توصیف می‌کند. اطلاعات استفاده‌شده برای ایجاد گراف همانند گزارش مسیرهای وب است (که می‌توانید با --trails آن را فعال کنید)، اما به صورت یک گراف، می‌تواند برای سایت‌های پیچیده‌تر خواناتر باشد. مثالی از نحوه استفاده از این ویژگی: % visitors access.log --prefix http://www.hping.org \\ --graphviz > graph.dot % dot /tmp/graph.dot -Tpng > graph.png در سیستم‌های دبیان، دستور .B dot در بسته .B graphviz قرار دارد. گراف تولیدشده دارای یال‌هایی با رنگ‌های مختلف خواهد بود، از آبی تا قرمز برای مشخص کردن سطح محبوبیت کم تا زیاد یک جابه‌جایی معین از یک صفحه به صفحه دیگر وب‌سایت. این گزینه برای کار کردن درست همانند گزینه .B --trails به یک یا چند گزینه .B --prefix نیاز دارد. .PP .TP 8 .BI "\-V \-\-graphviz-ignorenode-google" گره google را در گراف تولیدشده قرار نده. تنها همراه با .B --trails مفید است. .PP .TP 8 .BI "\-V \-\-graphviz-ignorenode-external" گره ارجاع‌دهنده خارجی را در گراف تولیدشده قرار نده. تنها همراه با .B --trails مفید است. .PP .TP 8 .BI "\-V \-\-graphviz-ignorenode-noreferer" گره نشان‌دهنده درخواست‌های بدون ارجاع‌دهنده را در گراف تولیدشده قرار نده. تنها همراه با .B --trails مفید است. .PP .TP 8 .BI "\-\-tail" هنگامی که این گزینه مشخص شود، .I Visitors دستور یونیکس tail -f --max-unchanged-stats=1 -q را شبیه‌سازی خواهد کرد. می‌توانید نام فایل‌های لاگ را برای پایش تغییرات مشخص کنید؛ به محض اضافه شدن داده‌های جدید در هر یک از فایل‌های مشخص‌شده، visitors داده‌های جدید را به خروجی استاندارد ارسال می‌کند. این گزینه در ترکیب با حالت جریان (--stream) مفید است. فایل‌ها می‌توانند بازچرخانی (log-rotate) شوند زیرا .I Visitors در «حالت Tail» همواره تلاش می‌کند فایل را برای بررسی تغییرات دوباره باز کند. .PP .TP 8 .BI "\-\-time\-delta" " delta" اگر سرور وب شما در منطقه زمانی متفاوتی نسبت به اکثر بازدیدکنندگان یا خودتان قرار دارد، متوجه جابه‌جایی در گزارش‌ها در رابطه با زمان و روزهای هفته خواهید شد. به‌طور پیش‌فرض، .I Visitors خروجی را با استفاده از locale میزبان تولید می‌کند. می‌توانید از گزینه .B --time-delta برای تنظیم خروجی استفاده کنید. مقادیر مثبت به اندازه تعداد ساعت داده‌شده به سمت راست (به سوی آینده) و مقادیر منفی به سمت چپ (به سوی گذشته) منتقل می‌شوند. در آینده ممکن است این گزینه از تعیین مستقیم منطقه زمانی خروجی پشتیبانی کند. .PP .TP 8 .BI "\-\-filter\-spam" پالایش هرزنامه ارجاع‌دهنده (referer spam) با استفاده از پالایه مبتنی بر کلمات کلیدی (برای اطلاعات بیشتر درباره کلمات کلیدی blacklist.h را ببینید). اگر نمی‌دانید هرزنامه ارجاع‌دهنده چیست، این صفحه ویکی‌پدیا را بررسی کنید: http://en.wikipedia.org/wiki/Referer_spam .PP .TP 8 .BI "\-\-ignore\-404" هنگامی که این گزینه فعال باشد، خطوط لاگ حاوی خطای ۴۰۴ تنها برای تولید گزارش خطاهای ۴۰۴ استفاده می‌شوند و در سایر گزارش‌ها به کار نمی‌روند. .PP .TP 8 .BI "\-\-grep" " pattern" تنها پردازش خطوط لاگی که با الگوی مشخص‌شده مطابقت دارند. الگوها با استفاده از تطبیق سبک glob (روشی که توسط شل یونیکس استفاده می‌شود) مطابقت داده می‌شوند: .RS .IP \fB*\fR 10 با هر دنباله‌ای از نویسه‌ها در \fIstring\fR، از جمله یک رشته تهی، مطابقت دارد. .IP \fB?\fR 10 با هر تک‌نویسه‌ای در \fIstring\fR مطابقت دارد. .IP \fB[\fIchars\fB]\fR 10 با هر نویسه‌ای در مجموعه ارائه‌شده توسط \fIchars\fR مطابقت دارد. اگر دنباله‌ای به شکل \fIx\fB\-\fIy\fR در \fIchars\fR ظاهر شود، هر نویسه‌ای بین \fIx\fR و \fIy\fR، شامل هر دو، مطابقت خواهد داشت. .IP \fB\e\fIx\fR 10 با تک‌نویسه \fIx\fR مطابقت دارد. این امکان روشی برای اجتناب از تفسیر ویژه نویسه‌های \fB*?[]\e\fR در \fIpattern\fR فراهم می‌کند. .RE به‌طور پیش‌فرض، تطبیق به صورت حساس به حروف بزرگ و کوچک انجام می‌شود، اما تطبیق غیرحساس به حروف را می‌توان با افزودن پیشوند رشته \fBcs:\fR به الگو اعمال کرد؛ بنابراین برای مثال الگوی \fBcs:firefox\fR با تمام خطوط لاگ حاوی رشته firefox، FireFox، FIREFOX و غیره مطابقت خواهد داشت. .PP .TP 8 .BI "\-\-exclude" " pattern" دقیقاً مانند \fB--grep\fR کار می‌کند، اما تنها خطوطی پردازش می‌شوند که با الگوی مشخص‌شده مطابقت \fBندارند\fR. توجه داشته باشید که --grep و --exclude می‌توانند چندین بار استفاده شوند و به صورت متوالی پردازش می‌شوند. برای مثال \fBvisitors --grep firefox --exclude download\fR تنها خطوطی را پردازش می‌کند که شامل رشته firefox هستند اما رشته download را ندارند..PP .TP 8 .BI "\-\-debug" نمایش اطلاعات تکمیلی هنگام بروز خطاها. برای مثال در صورت یافت شدن، خطوط نامعتبر روی خطای استاندارد (standard error) چاپ می‌شوند. عمدتاً برای توسعه‌دهندگان و گزارش خطا سودمند است. .PP .TP 8 .BI "\-h \-\-help" نمایش اطلاعات نحوه استفاده و حق نشر. .PP .TP 8 .BI "\-v \-\-version" نمایش نسخه برنامه. .SH "مثال‌ها (EXAMPLES)" ساده‌ترین شیوه استفاده، جهت به‌کارگیری تعاملی هنگامی که می‌خواهید یک لاگ وب را بررسی کنید (برای نمونه از طریق ssh در کارساز وب خود)، فقط این دستور را اجرا کنید: % visitors access.log | less این دستور خروجی متنی صرف و خوانا برای انسان تولید خواهد کرد. برای ایجاد آمار وب در قالب html با اطلاعات بسیار بیشتر، می‌توانید در عوض از این دستور استفاده کنید: % visitors --output text -A -m 30 access.log -o html > report.html اگر اطلاعاتی درباره الگوهای استفاده از وبگاه خود می‌خواهید، باید پیشوند url وبگاه خود را وارد کرده و گزینه .B --trails را مشخص کنید. مثال بعدی یک گزارش HTML همراه با اطلاعات الگوهای استفاده تولید می‌کند. % visitors -A -m 30 access.log --trails \\ --prefix http://www.hping.org > report.html توجه داشته باشید که مشخص کردن چندین نام فایل، یا ارائه ورودی با استفاده از ورودی استاندارد (standard input) مانند دو مثال زیر امکان‌پذیر است: % visitors /var/log/apache/access.log.* .br % zcat access.log.*.gz | visitors - .SH "جزئیات حالت جریان (STREAM MODE DETAILS)" .PP شیوه معمول برای اجرای .I Visitors مشخص کردن گزینه‌هایی برای کنترل تولید گزارش و نام فایل‌های لاگ است. برای نمونه، جهت تولید گزارش از دو فایل لاگ دسترسی Apache می‌توانید بنویسید: % visitors -A access.log.1 access.log.2 > report.html برنامه .I Visitors فایل‌های لاگ را تحلیل کرده و گزارش را به خروجی خواهد فرستاد. گاهی اوقات به‌روزرسانی مداوم آمار وب، تقریباً به صورت بلادرنگ (real time) هم‌زمان با در دسترس قرار گرفتن داده‌های تازه، می‌تواند جذاب‌تر باشد. برای ارائه این ویژگی، .I Visitors حالتی با عنوان Stream Mode را پیاده‌سازی می‌کند که جریانی از لاگ‌ها را از ورودی استاندارد می‌خواند. خط فرمان زیر نحوه استفاده از آن را نشان می‌دهد (اما برای اطلاعات بیشتر مستندات گزینه --stream را بررسی کنید). % tail -f /var/log/apache/access.log | \\ visitors --stream -A --update-every 60 \\ --output-file /tmp/report.html برنامه .I Visitors هم‌زمان با در دسترس قرار گرفتن لاگ‌های تازه، آمار را به صورت افزایشی به‌روزرسانی کرده و گزارش html را هر ۶۰ ثانیه یک‌بار به‌روز می‌کند. همان‌طور که می‌بینید در این حالت لازم است نام فایل گزارش با استفاده از گزینه .B --output-file مشخص شود، زیرا .I Visitors برای به‌روزرسانی گزارش نیازمند بازنویسی (overwrite) روی آن است. توجه داشته باشید که به جای دستور tail در مثال بالا، امکان استفاده از .I Visitors در حالت Tail Mode (یک شبیه‌سازی برای برنامه tail) نیز وجود دارد: % visitors --tail /var/log/apache/access.log | \\ visitors --stream -A --update-every 60 \\ --output-file /tmp/report.html با استفاده از گزینه .B --reset-every می‌توان آماری بلادرنگ درباره N ثانیه گذشته از ترافیک وب تولید کرد؛ جایی که مقدار N قابل تنظیم بوده و می‌تواند از چند ثانیه تا یک هفته یا بیشتر باشد. مثال زیر آماری تولید می‌کند که هر ۳۰ ثانیه یک‌بار درباره ترافیک یک ساعت گذشته به‌روزرسانی می‌شود: % visitors --tail /var/log/apache/access.log | \\ visitors --stream -A --update-every 30 --reset-every 3600 \\ --output-file /tmp/report.html .SH "نویسندگان (AUTHORS)" .PP برنامه .I Visitors توسط Salvatore Sanfilippo نوشته شده است. .SH "کپی‌رایت و تکثیر (COPYING)" حق نشر .if t \(co .if n (C) 2004,2005 Salvatore Sanfilippo . .PP برنامه .I Visitors تحت پروانه همگانی عمومی گنو (GNU General Public License) توزیع شده است. .PP این صفحه راهنما (بر اساس مستندات اصلی HTML) توسط Romain Francoise برای سیستم Debian GNU/Linux نوشته شده است، اما ممکن است توسط دیگران نیز استفاده شود. Salvatore Sanfilippo این صفحه راهنما را از نگارش Visitors 0.5 به‌روزرسانی کرد؛ این صفحه راهنما اکنون بخشی از بسته tarball برنامه Visitors است.