گزینه‌های موجود:

-A --all

فعال‌سازی تمام گزارش‌های اختیاری. این گزینه معادل -GKUWRDOB است. توجه داشته باشید که --trails به‌طور ضمنی در این گزینه گنجانده نشده است، زیرا به --prefix نیز نیاز دارد. برای جزئیات بیشتر مستندات گزینه‌ی --trails را ببینید.

-T --trails

فعال‌سازی ویژگی ردپاهای وب (Web Trails). این گزارش متداول‌ترین جابه‌جایی‌ها میان صفحه‌های وب‌سایت شما را نشان می‌دهد. این گزینه برای کارکرد به گزینه‌ی --prefix نیاز دارد.

-G --google

فعال‌سازی دو گزارش درباره‌ی صفحه‌هایی که توسط خزنده‌های وب Google و Adsense دسترسی یافته‌اند. صفحه‌ها بر اساس آخرین باری که خزنده‌ی وب گوگل آن‌ها را درخواست کرده است مرتب می‌شوند. نخستین صفحه‌ی نمایش‌داده‌شده، جدیدترین صفحه‌ای است که مورد دسترسی قرار گرفته است.

-K --google-keyphrases

فعال‌سازی گزارشی که عبارت‌های کلیدی رایج جستجو برای یافتن وب‌سایت شما از طریق Google را نمایش می‌دهد.

-Z --google-keyphrases-age

فعال‌سازی گزارشی که جدیدترین عبارت‌های کلیدی استفاده‌شده برای یافتن وب‌سایت شما از طریق Google را نمایش می‌دهد.

-H --google-human-language

فعال‌سازی گزارشی که زبان‌های انسانی متداول استفاده‌شده در جستجو از طریق Google را نمایش می‌دهد. این ویژگی از متغیر 'hl' در URL ارجاع‌دهنده‌ی گوگل استفاده می‌کند.

-U --user-agents

نمایش اطلاعات درباره‌ی عامل‌های کاربر (user agents) متداول.

-W --weekday-hour-map

فعال‌سازی تولید یک نقشه‌ی دوبُعدی ترکیبی روزهای هفته/ساعت‌ها که اطلاعات ترافیک را در تمام ۱۶۸ ساعت مختلف یک هفته‌ی ۷ روزه نشان می‌دهد. رنگ‌های روشن‌تر به معنای ترافیک بیشتر هستند. این نقشه برای آگاهی از بهترین زمان در طول هفته جهت خاموشی برای تعمیر و نگهداری، شناخت جامعه‌ی هدف سایت، بررسی اینکه کاربران از محل کار یا خانه به سایت دسترسی دارند و مواردی از این دست ایده‌آل است. نقشه به‌صورت HTML خالص درون گزارش تولید می‌شود.

-M --month-day-map

فعال‌سازی تولید یک نقشه‌ی دوبُعدی ترکیبی ماه/روز که اطلاعات ترافیک را در تمام ۳۶۵ روز سال نمایش می‌دهد. رنگ‌های روشن‌تر به معنای ترافیک بیشتر هستند. این نقشه برای بررسی سریع روندهای ترافیکی و روزهایی با ترافیک به‌ویژه بالا یا پایین مفید است. نقشه به‌صورت HTML خالص درون گزارش تولید می‌شود.

-R --referers-age

نمایش ارجاع‌دهنده‌ها مرتب‌شده بر اساس قدمت. «قدمت» یک ارجاع‌دهنده، تاریخی است که برای نخستین بار ثبت شده است. در گزارش، ارجاع‌دهنده‌های جدیدتر در بالا قرار دارند. این گزارش برای بررسی پیوندهای خارجی جدید کاربرد دارد.

-D --domains

فعال‌سازی تولید اطلاعات درباره‌ی محبوبیت دامنه‌های سطح‌بالا (TLD). این اطلاعات ممکن است برای حدس زدن میزان بازدیدها از کشورهای گوناگون مفید باشد. توجه داشته باشید که Visitors آدرس‌های IP عددی را در صورتی که از قبل در فایل لاگ تحلیل (resolve) نشده باشند، تحلیل نمی‌کند. تمام آدرس‌های IP تحلیل‌نشده در این گزارش ذیل مدخل Unresolved IP نمایش داده می‌شوند.

-O --operating-systems

فعال‌سازی گزارش محبوبیت سیستم‌عامل‌ها، مرتب‌شده بر اساس تعداد دسترسی‌ها. تمام سیستم‌عامل‌های متداول در گزارش فهرست شده‌اند، در حالی که سیستم‌عامل‌های ناشناخته در مدخل unknown جمع خواهند شد.

-B --browsers

فعال‌سازی گزارش محبوبیت مرورگرها، مرتب‌شده بر اساس تعداد دسترسی‌ها. تمام مرورگرهای متداول در گزارش فهرست شده‌اند، در حالی که مرورگرهای ناشناخته در مدخل unknown جمع خواهند شد. مرورگرها بر اساس خانواده (برای نمونه Internet Explorer، Opera و غیره) فهرست می‌شوند و نه بر اساس نسخه‌ی دقیق آن‌ها.

-X --error404

فعال‌سازی تولید گزارش اسناد مفقود (خطای 404). این گزارش فایل‌های درخواست‌شده اما ناموجود را به ترتیب تعداد درخواست‌ها نشان می‌دهد. این گزارش برای کشف مواردی که فایلی بر اثر اشتباه در وب‌سایت وجود ندارد مفید است، اما در اغلب موارد درخواست‌های نامتعارفی را مشاهده خواهید کرد که توسط کاربران، کرم‌های اینترنتی و پویش‌های امنیتی فرستاده شده‌اند.

-Y --pageviews

فعال‌سازی تولید گزارشی که درصد (تقریبی) صفحه‌های دیده‌شده در هر بازدید یکتا را نشان می‌دهد. هدف این گزارش درک الگوی استفاده از سایت و میزان علاقه‌مندی بازدیدکنندگان است. برای نمونه، در سایتی که صفحه‌های متعدد با محتوای جذاب ارائه می‌دهد، درصدی از بازدیدکنندگان که در هر بازدید فقط یک صفحه را مشاهده می‌کنند، احتمالاً به دنبال چیز دیگری بوده‌اند.

-S --robots

فعال‌سازی تولید گزارشی که عامل‌های کاربر کلاینت‌های درخواست‌کننده‌ی فایل robots.txt را نمایش می‌دهد (به‌استثنای درخواست‌های MSIE Crawler). نتیجه، فهرستی از روبات‌ها و خزنده‌های وب است که به وب‌سایت شما دسترسی داشته‌اند و بر اساس تعداد درخواست‌های robots.txt مرتب شده‌اند.

--screen-info

فعال‌سازی گزارش‌های وضوح صفحه‌نمایش و عمق رنگ. توجه داشته باشید که برای کارکرد این گزارش باید کد جاوااسکریپت موجود در فایل README بسته‌ی tarball برنامه‌ی visitors را در صفحه‌های HTML خود قرار دهید.

--stream

فعال‌سازی حالت جریانی (برای اطلاعات بیشتر به بخش STREAM MODE DETAILS مراجعه کنید). به‌طور خلاصه: در حالت جریانی، Visitors ابتدا تمام فایل‌های لاگ مشخص‌شده را (یا هیچ‌کدام، که در این حالت نیز معتبر است) طبق روال معمول پردازش کرده و گزارش را تولید می‌کند. سپس حالت جریانی فعال شده و Visitors خواندن جریانی پیوسته از لاگ‌های وب را از ورودی استاندارد آغاز می‌کند و با دسترسی به داده‌های جدید، آمار را به‌صورت افزایشی به‌روزرسانی می‌نماید. در صورت رسیدن داده‌های تازه، بر اساس گزینه‌ی --update-every گزارش جدیدی به‌صورت دوره‌ای تولید می‌شود (پیش‌فرض این است که آمار هر ده دقیقه یک‌بار به‌روز شود). همچنین با استفاده از گزینه‌ی --reset-every می‌توان از Visitors خواست تا پس از گذشت مدتی مشخص، آمار را بازنشانی کند. این قابلیت امکان تهیه‌ی یک نمای لحظه‌ای (snapshot) از وقایع پنج دقیقه‌ی گذشته، ساعت، روز یا هفته‌ی اخیر را فراهم می‌سازد. توجه داشته باشید که --stream نیازمند گزینه‌ی --output-file است، زیرا Visitors باید برای هر به‌روزرسانی فایل گزارش را بازنویسی کند، بنابراین نمی‌تواند خروجی را طبق روال معمول به خروجی استاندارد بفرستد. چنانچه قصد استفاده از حالت جریانی را دارید، گزینه‌ی --tail را نیز بررسی کنید..PP

--update-every seconds

به‌طور پیش‌فرض در «حالت جریان» (Stream Mode) آمارها هر ۱۰ دقیقه به‌روزرسانی می‌شوند. این گزینه دوره زمانی متفاوتی را بر حسب ثانیه مشخص می‌کند.

--reset-every seconds

به‌طور پیش‌فرض در «حالت جریان»، آمارها هرگز بازنشانی نمی‌شوند، بلکه به‌صورت پیوسته و افزایشی به‌روزرسانی می‌گردند. این گزینه مشخص می‌کند که آمار پس از مقدار زمان تعیین‌شده بر حسب ثانیه بازنشانی شود. این ویژگی برای داشتن یک تصویر لحظه‌ای (snapshot) از میزان استفاده از وب‌سایت مفید است.

-f --output-file file

نوشتن خروجی در file به جای stdout.

-m --max-lines number

تنظیم حداکثر تعداد ورودی‌هایی که باید در گزارش‌هایی مانند ارجاع‌دهنده‌ها (referers)، عبارت‌های کلیدی و غیره نمایش داده شوند. این گزینه حداکثر تعداد ورودی‌ها را برای تمام گزارش‌ها به صورت یکجا تنظیم می‌کند.

-r --max-referers number

تنظیم حداکثر تعداد ورودی‌ها در گزارش ارجاع‌دهنده‌ها.

-p --max-pages number

تنظیم حداکثر تعداد ورودی‌ها در گزارش صفحه‌های بازدیدشده.

-i --max-images number

تنظیم حداکثر تعداد ورودی‌ها در گزارش تصاویر بازدیدشده.

-x --max-error404 number

تنظیم حداکثر تعداد ورودی‌ها در گزارش اسناد ناموجود (خطای ۴۰۴).

-u --max-useragents number

تنظیم حداکثر تعداد ورودی‌ها در گزارش عامل‌های کاربر (user agents).

-t --max-trails number

تنظیم حداکثر تعداد ورودی‌ها در گزارش مسیرهای وب (web trails).

-g --max-googled number

تنظیم حداکثر تعداد ورودی‌ها در گزارش صفحه‌های خزش‌شده (توسط ربات گوگل).

--max-adsensed number

تنظیم حداکثر تعداد ورودی‌ها در گزارش صفحه‌های خزش‌شده (توسط ربات ادسنس).

-k --max-google-keyphrases number

تنظیم حداکثر تعداد ورودی‌ها در گزارش عبارت‌های کلیدی گوگل.

-a --max-referers-age number

تنظیم حداکثر تعداد ورودی‌ها در گزارش ارجاع‌دهنده‌ها بر پایه تاریخ.

-d --max-domains number

تنظیم حداکثر تعداد ورودی‌ها در گزارش دامنه‌ها.

-P --prefix string

پیشوندها برای visitors مشخص می‌کنند که یک پیوند چگونه باید باشد تا به عنوان پیوند داخلی وب‌سایت شما دسته‌بندی شود. این گزینه برای --trails الزامی است و همچنین اثر مطلوب جلوگیری از نمایش پیوندهای داخلی در گزارش ارجاع‌دهنده‌ها را دارد. اگر در حال تجزیه‌وتحلیل آمار برای http://www.your.site.com هستید، کافی است استفاده کنید از: --prefix http://www.your.site.com

اگر وب‌سایت شما با چندین نام میزبان (hostname) در دسترس است، باید همه آن‌ها را مشخص کنید، مانند مثال زیر:
--prefix http://www.your.site.com --prefix http://your.site.com

-o --output html|text

پیمانه خروجی. می‌توانید از text یا html استفاده کنید. پیش‌فرض html است.

-V --graphviz

این گزینه حالت Graphviz را فعال می‌کند: Visitors فایل لاگ را تجزیه‌وتحلیل کرده و گرافی ایجاد می‌کند که الگوهای دسترسی وب‌سایت شما را توصیف می‌کند. اطلاعات استفاده‌شده برای ایجاد گراف همانند گزارش مسیرهای وب است (که می‌توانید با --trails آن را فعال کنید)، اما به صورت یک گراف، می‌تواند برای سایت‌های پیچیده‌تر خواناتر باشد. مثالی از نحوه استفاده از این ویژگی:

% visitors access.log --prefix http://www.hping.org \
--graphviz > graph.dot

% dot /tmp/graph.dot -Tpng > graph.png

در سیستم‌های دبیان، دستور dot در بسته graphviz قرار دارد. گراف تولیدشده دارای یال‌هایی با رنگ‌های مختلف خواهد بود، از آبی تا قرمز برای مشخص کردن سطح محبوبیت کم تا زیاد یک جابه‌جایی معین از یک صفحه به صفحه دیگر وب‌سایت. این گزینه برای کار کردن درست همانند گزینه --trails به یک یا چند گزینه --prefix نیاز دارد.

-V --graphviz-ignorenode-google

گره google را در گراف تولیدشده قرار نده. تنها همراه با --trails مفید است.

-V --graphviz-ignorenode-external

گره ارجاع‌دهنده خارجی را در گراف تولیدشده قرار نده. تنها همراه با --trails مفید است.

-V --graphviz-ignorenode-noreferer

گره نشان‌دهنده درخواست‌های بدون ارجاع‌دهنده را در گراف تولیدشده قرار نده. تنها همراه با --trails مفید است.

--tail

هنگامی که این گزینه مشخص شود، Visitors دستور یونیکس tail -f --max-unchanged-stats=1 -q را شبیه‌سازی خواهد کرد. می‌توانید نام فایل‌های لاگ را برای پایش تغییرات مشخص کنید؛ به محض اضافه شدن داده‌های جدید در هر یک از فایل‌های مشخص‌شده، visitors داده‌های جدید را به خروجی استاندارد ارسال می‌کند. این گزینه در ترکیب با حالت جریان (--stream) مفید است. فایل‌ها می‌توانند بازچرخانی (log-rotate) شوند زیرا Visitors در «حالت Tail» همواره تلاش می‌کند فایل را برای بررسی تغییرات دوباره باز کند.

--time-delta delta

اگر سرور وب شما در منطقه زمانی متفاوتی نسبت به اکثر بازدیدکنندگان یا خودتان قرار دارد، متوجه جابه‌جایی در گزارش‌ها در رابطه با زمان و روزهای هفته خواهید شد. به‌طور پیش‌فرض، Visitors خروجی را با استفاده از locale میزبان تولید می‌کند. می‌توانید از گزینه --time-delta برای تنظیم خروجی استفاده کنید. مقادیر مثبت به اندازه تعداد ساعت داده‌شده به سمت راست (به سوی آینده) و مقادیر منفی به سمت چپ (به سوی گذشته) منتقل می‌شوند. در آینده ممکن است این گزینه از تعیین مستقیم منطقه زمانی خروجی پشتیبانی کند.

--filter-spam

پالایش هرزنامه ارجاع‌دهنده (referer spam) با استفاده از پالایه مبتنی بر کلمات کلیدی (برای اطلاعات بیشتر درباره کلمات کلیدی blacklist.h را ببینید). اگر نمی‌دانید هرزنامه ارجاع‌دهنده چیست، این صفحه ویکی‌پدیا را بررسی کنید: http://en.wikipedia.org/wiki/Referer_spam

--ignore-404

هنگامی که این گزینه فعال باشد، خطوط لاگ حاوی خطای ۴۰۴ تنها برای تولید گزارش خطاهای ۴۰۴ استفاده می‌شوند و در سایر گزارش‌ها به کار نمی‌روند.

--grep pattern

تنها پردازش خطوط لاگی که با الگوی مشخص‌شده مطابقت دارند. الگوها با استفاده از تطبیق سبک glob (روشی که توسط شل یونیکس استفاده می‌شود) مطابقت داده می‌شوند:

به‌طور پیش‌فرض، تطبیق به صورت حساس به حروف بزرگ و کوچک انجام می‌شود، اما تطبیق غیرحساس به حروف را می‌توان با افزودن پیشوند رشته cs: به الگو اعمال کرد؛ بنابراین برای مثال الگوی cs:firefox با تمام خطوط لاگ حاوی رشته firefox، FireFox، FIREFOX و غیره مطابقت خواهد داشت.

--exclude pattern

دقیقاً مانند --grep کار می‌کند، اما تنها خطوطی پردازش می‌شوند که با الگوی مشخص‌شده مطابقت ندارند. توجه داشته باشید که --grep و --exclude می‌توانند چندین بار استفاده شوند و به صورت متوالی پردازش می‌شوند. برای مثال visitors --grep firefox --exclude download تنها خطوطی را پردازش می‌کند که شامل رشته firefox هستند اما رشته download را ندارند..PP

--debug

نمایش اطلاعات تکمیلی هنگام بروز خطاها. برای مثال در صورت یافت شدن، خطوط نامعتبر روی خطای استاندارد (standard error) چاپ می‌شوند. عمدتاً برای توسعه‌دهندگان و گزارش خطا سودمند است.

-h --help

نمایش اطلاعات نحوه استفاده و حق نشر.

-v --version

نمایش نسخه برنامه.