نام (NAME)

vinyltop - نمایش بی‌درنگ مدخل‌های لاگ Vinyl Cache

خلاصه دستور (SYNOPSIS)

vinyltop [-1] [-b] [-c] [-C] [-d] [-E] [-f] [-g <session|request|vxid|raw>] [-h] [-i <taglist>] [-I <[taglist:]regex>] [-L <limit>] [-n <workdir>] [-p <period>] [-Q <file>] [-q <query>] [-r <filename>] [-t <seconds|off>] [-T <seconds>] [-x <taglist>] [-X <[taglist:]regex>] [-V]

توضیحات (DESCRIPTION)

ابزار vinyltop لاگ‌های حافظهٔ مشترک vinyld(1) را خوانده و فهرستی پیوسته به‌روزشونده از پرتکرارترین مدخل‌های لاگ را ارائه می‌دهد. با پالایش مناسب با استفاده از گزینه‌های -I، -i، -X و -x، می‌توان از آن برای نمایش رتبه‌بندی اسناد درخواست‌شده، کلاینت‌ها، واسط‌های کاربر (User Agent) یا هر اطلاعات دیگری که در لاگ ثبت شده است استفاده کرد.

گزینه‌های زیر در دسترس هستند:

-1: به‌جای نمایش به‌روزشوندهٔ پیوسته، آمار را یک‌بار چاپ کرده و خارج می‌شود. این گزینه متضمن -d است.
-b: تنها تراکنش‌ها و رکوردهای لاگ ناشی از ارتباطات بخش پسین (backend) را نمایش می‌دهد.
-c: تنها تراکنش‌ها و رکوردهای لاگ ناشی از ارتباطات کلاینت را نمایش می‌دهد.
-C: تمام تطبیق‌های عبارات باقاعده و رشته‌ای را بدون در نظر گرفتن بزرگی و کوچکی حروف انجام می‌دهد.
-d: رکوردهای لاگ را از ابتدای لاگ پردازش می‌کند.
-E: تراکنش‌های ESI و سایر انواع زیردرخواست‌ها (sub-requests) را نمایش می‌دهد. این گزینه متضمن گزینهٔ -c بوده و شامل سایر تراکنش‌های کلاینت نیز می‌شود.
-f: مرتب‌سازی و گروه‌بندی را فقط بر اساس نخستین فیلد از هر مدخل لاگ انجام می‌دهد. برای مدخل‌های لاگ به قالب prefix: value این پیشوندِ بدون دونقطه است که مرتب و گروه‌بندی می‌شود. این ویژگی برای مواردی مانند نمایش مدخل‌های ReqStart، که در آن فیلد اول آدرس IP کلاینت است، کاربرد دارد.
-g <session|request|vxid|raw>: نحوهٔ گروه‌بندی رکوردهای لاگ. حالت پیش‌فرض گروه‌بندی بر اساس vxid است.
-h: راهنمای استفاده از برنامه را نمایش داده و خارج می‌شود.
-i <taglist>: رکوردهای لاگ دارای این برچسب‌ها را در خروجی می‌آورد. Taglist فهرستی از الگوهای انطباقی برچسب (tag globs) است که با کاما از هم جدا شده‌اند. می‌توان چندین گزینهٔ -i را تعیین کرد.
اگر گزینهٔ لحاظ کردن برچسب، نخستین گزینه در میان گزینه‌های انتخاب برچسب باشد، ابتدا همهٔ برچسب‌ها به‌صورت مستثنی علامت‌گذاری می‌شوند.
-I <[taglist:]regex>: لحاظ کردن از طریق تطبیق با عبارت باقاعده. تنها رکوردهایی را که با taglist و عبارت باقاعده همخوانی دارند خروجی می‌دهد. در صورت نبود taglist، بر روی همهٔ برچسب‌ها اعمال می‌شود. می‌توان چندین گزینهٔ -I را تعیین کرد.
اگر گزینهٔ لحاظ کردن برچسب، نخستین گزینه در میان گزینه‌های انتخاب برچسب باشد، ابتدا همهٔ برچسب‌ها به‌صورت مستثنی علامت‌گذاری می‌شوند.
-L <limit>: حد بالای تراکنش‌های ناقصِ نگه‌داری‌شده را پیش از آنکه قدیمی‌ترین تراکنش به‌اجبار کامل اعلام شود تعیین می‌کند. هنگام وقوع این رویداد، یک رکورد هشدار شبیه‌سازی می‌شود. این تنظیم سقفی بر میزان استفاده از حافظه توسط پرس‌وجوهای در حال اجرا قرار می‌دهد. مقدار پیش‌فرض ۱۰۰۰ تراکنش است.
-n <workdir>: دایرکتوری کاری vinyl مربوط به نمونه‌ای که باید به آن متصل شد را مشخص می‌کند. برای اطلاعات بیشتر و مقادیر پیش‌فرض به مستندات گزینهٔ -n در vinyld(1) مراجعه کنید.
-p <period>: تعداد ثانیه‌ها را برای اندازه‌گیری در آن بازه مشخص می‌کند؛ پیش‌فرض ۶۰ ثانیه است. عدد اول در فهرست، میانگین تعداد درخواست‌های دیده‌شده در طول این بازهٔ زمانی است. در صورت استفاده هم‌زمان از گزینهٔ -1، این گزینه بی‌تأثیر خواهد بود.
-Q <file>: فایل حاوی پرس‌وجوی VSL مورد استفاده را مشخص می‌کند. هنگام تعیین چندین گزینهٔ -Q یا -q، تمام پرس‌وجوها به‌گونه‌ای در نظر گرفته می‌شوند که گویی عملگر 'or' برای ترکیب آن‌ها به‌کار رفته است.
-q <query>: پرس‌وجوی VSL مورد استفاده را تعیین می‌کند. هنگام تعیین چندین گزینهٔ -q یا -Q، تمام پرس‌وجوها به‌گونه‌ای در نظر گرفته می‌شوند که گویی عملگر 'or' برای ترکیب آن‌ها به‌کار رفته است.
-r <filename>: لاگ را در قالب فایل باینری از این فایل می‌خواند. این فایل را می‌توان با vinyllog -w filename ایجاد کرد. اگر نام فایل - باشد، لاگ‌ها از ورودی استاندارد خوانده می‌شوند و نمی‌تواند به‌عنوان یک دیمن کار کند.
-t <seconds|off>: مهلت زمانی پیش از بازگرداندن خطا هنگام برقراری اتصال اولیه به VSM. در صورت تنظیم، اتصال VSM هر ۰.۵ ثانیه به مدت این تعداد ثانیه دوباره تلاش می‌شود. اگر صفر باشد، اتصال تنها یک‌بار تلاش شده و در صورت ناموفق بودن فوراً با شکست روبه‌رو می‌شود. اگر روی "off" تنظیم شود، اتصال با شکست مواجه نشده و به برنامه اجازه می‌دهد آغاز به کار کرده و بدون محدودیت زمانی منتظر راه‌اندازی نمونهٔ vinyld بماند. پیش‌فرض ۵ ثانیه است.
-T <seconds>: مهلت زمانی تراکنش را بر حسب ثانیه تنظیم می‌کند. این مقدار حداکثر زمان سپری‌شده به ثانیه بین یک برچسب Begin و برچسب End را مشخص می‌سازد. در صورت انقضای این مهلت، یک رکورد هشدار شبیه‌سازی شده و تراکنش به‌اجبار کامل اعلام می‌شود. پیش‌فرض ۱۲۰ ثانیه است.
-x <taglist>: رکوردهای لاگ دارای این برچسب‌ها را از خروجی مستثنی می‌کند. Taglist فهرستی از الگوهای انطباقی برچسب است که با کاما از هم جدا شده‌اند. می‌توان چندین گزینهٔ -x را تعیین کرد.
-X <[taglist:]regex>: مستثنی کردن از طریق تطبیق با عبارت باقاعده. رکوردهایی را که با taglist و عبارت باقاعده تطابق دارند در خروجی نمی‌آورد. در صورت نبود taglist، بر روی تمام برچسب‌ها اعمال می‌شود. می‌توان چندین گزینهٔ -X را تعیین کرد.
-V: اطلاعات نسخه را چاپ کرده و خارج می‌شود.
--optstring: پارامتر optstring را برای getopt(3) چاپ می‌کند تا به نوشتن اسکریپت‌های پوششی (wrapper) کمک کند.

مثال‌ها (EXAMPLES)

مثال زیر فهرستی پیوسته به‌روزشونده از پردرخواست‌ترین URLها را نمایش می‌دهد:

vinyltop -i ReqURL

مثال زیر فهرستی پیوسته به‌روزشونده از پراستفاده‌ترین User Agentها را نمایش می‌دهد:

vinyltop -C -I ReqHeader:User-Agent

همچنین ببینید (SEE ALSO)

تاریخچه (HISTORY)

ابزار vinyltop در ابتدا توسط Poul-Henning Kamp با همکاری Verdens Gang AS و Redpill-Linpro توسعه یافت و سپس به‌طور اساسی توسط Dag-Erling Smørgrav بازنویسی شد. این صفحهٔ راهنما توسط Dag-Erling Smørgrav نوشته شده و بعدها توسط Martin Blix Grydeland به‌روزرسانی شده است.

کپی‌رایت و تکثیر (COPYRIGHT)

این سند تحت همان مجوزی منتشر شده است که خود Vinyl Cache تحت آن قرار دارد. برای جزئیات به LICENSE مراجعه کنید.