| vinylhist(1) | General Commands Manual | vinylhist(1) |
نام (NAME)
vinylhist - هیستوگرام درخواست‌های Vinyl Cache
خلاصه دستور (SYNOPSIS)
vinylhist [-B <factor>] [-C] [-d] [-g <request|vxid>] [-h] [-L <limit>] [-n <workdir>] [-p <period>] [-P responsetime] [-P reqbodytime] [-P size] [-P Bereqtime] [-P Beresptime] [-P BerespBodytime] [-P Besize] [-P <[cbE:]tag:[prefix]:field_num[:min:max]>] [-Q <file>] [-q <query>] [-r <filename>] [-t <seconds|off>] [-T <seconds>] [-V]
توضیحات (DESCRIPTION)
ابزار vinylhist گزارش‌های حافظه اشتراکی vinyld(1) را می‌خواند و یک هیستوگرام به‌روزشونده مداوم را نمایش می‌دهد که توزیع N درخواست اخیر را بر اساس پردازش آن‌ها نشان می‌دهد. مقدار N و مقیاس عمودی در گوشه بالا سمت چپ نمایش داده می‌شوند. مقیاس افقی لگاریتمی است. موارد اصابت (Hits) با نویسه خط عمودی ("|") و موارد عدم اصابت (Misses) با نویسه هش ("#") علامت‌گذاری می‌شوند.
گزینه‌های زیر در دسترس هستند:
- -B <factor>
- ضریب تغییر سرعت زمان. به‌ویژه هنگام خواندن با [-r] از یک فایل vsl مفید است. مقدار 1= پردازش در زمان تقریباً واقعی، کمتر از 1 (<1) حرکت آهسته (slow-motion)، بیشتر از 1 (>1) دور تند (time-lapse) است (مگر در حالت خواندن از فایل، کاربردی ندارد). در زمان اجرا، کلید < سرعت را نصف و کلید > آن را دو برابر می‌کند.
- -C
- انجام تمام تطبیق‌های عبارات منظم و رشته‌ها بدون حساسیت به حروف بزرگ و کوچک.
- -d
- پردازش رکوردهای لاگ از ابتدای گزارش‌ها و خروج.
- -g <request|vxid>
- نحوه گروه‌بندی رکوردهای لاگ. حالت پیش‌فرض گروه‌بندی بر اساس vxid است.
- -h
- چاپ نحوه استفاده از برنامه و خروج.
- -L <limit>
- تعیین حد بالای تراکنش‌های ناقصِ نگه‌داری‌شده پیش از تکمیل اجباری قدیمی‌ترین تراکنش. هنگام رخ دادن این حالت، یک رکورد هشدار ایجاد می‌شود. این تنظیم مرز بالایی برای مصرف حافظه پرس‌وجوهای در حال اجرا اعمال می‌کند. مقدار پیش‌فرض ۱۰۰۰ تراکنش است.
- -n <workdir>
- مشخص کردن دایرکتوری کاری vinyl مربوط به نمونه مورد نظر برای اتصال. برای اطلاعات بیشتر و مقادیر پیش‌فرض به مستندات گزینه -n در vinyld(1) مراجعه کنید.
- -p <period>
- تعداد ثانیه‌ها بین هر بار تازه‌سازی صفحه را مشخص می‌کند. مقدار پیش‌فرض ۱ ثانیه است و در زمان اجرا با فشردن کلیدهای [0-9] (توان‌های ۲ بر حسب ثانیه) یا کلیدهای + و - (دو برابر یا نصف کردن سرعت) قابل تغییر است.
- -P responsetime
- پروفایل کلاینت از پیش تعریف‌شده: رسم نمودار زمان کل از آغاز پردازش درخواست (دریافت اولین بایت) تا آماده شدن برای تحویل پاسخ کلاینت (فیلد ۳ از برچسب VSL مربوط به SLT_Timestamp Process:).
- -P reqbodytime
- پروفایل کلاینت از پیش تعریف‌شده: رسم نمودار زمان خواندن بدنه درخواست (فیلد ۳ از برچسب VSL مربوط به SLT_Timestamp ReqBody:).
- -P size
- پروفایل کلاینت از پیش تعریف‌شده: رسم نمودار اندازه پاسخ‌ها (فیلد ۵ از برچسب VSL مربوط به SLT_ReqAcct).
- -P Bereqtime
- پروفایل بک‌اند از پیش تعریف‌شده: رسم نمودار زمان از آغاز پردازش بک‌اند تا ارسال کامل درخواست بک‌اند (فیلد ۳ از برچسب VSL مربوط به SLT_Timestamp Bereq:).
- -P Beresptime
- پروفایل بک‌اند از پیش تعریف‌شده: رسم نمودار زمان از آغاز پردازش بک‌اند تا دریافت کامل هدرهای پاسخ (فیلد ۳ از برچسب VSL مربوط به SLT_Timestamp Beresp:).
- -P BerespBodytime
- پروفایل بک‌اند از پیش تعریف‌شده: رسم نمودار زمان از آغاز پردازش بک‌اند تا دریافت بدنه پاسخ (فیلد ۳ از برچسب VSL مربوط به SLT_Timestamp BerespBody:).
- -P Besize
- پروفایل بک‌اند از پیش تعریف‌شده: رسم نمودار اندازه بدنه پاسخ بک‌اند (فیلد ۵ از برچسب VSL مربوط به SLT_BereqAcct).
- -P <[cbE:]tag:[prefix]:field_num[:min:max]>
- رسم نمودار بر اساس تعریف سفارشی ارائه‌شده که به این صورت تعریف می‌شود: یک فیلتر اختیاری کلاینت (c)، بک‌اند (b) یا (E)SI (پیش‌فرض کلاینت است)، برچسبی که به دنبال آن هستیم، پیشوندی برای جستجو (می‌تواند خالی باشد، اما باید با دونقطه ختم شود) و شماره فیلد مقداری که مد نظر است. min و max مرزهای نمودار در توان‌های ۱۰ هستند و مقادیر پیش‌فرض آن‌ها -6 و 3 است.
- -Q <file>
- فایل حاوی پرس‌وجوی VSL مورد استفاده را مشخص می‌کند. در صورت مشخص شدن چند گزینه -Q یا -q، تمام پرس‌وجوها به‌گونه‌ای در نظر گرفته می‌شوند که گویی با عملگر 'or' با یکدیگر ترکیب شده‌اند.
- -q <query>
- پرس‌وجوی VSL مورد استفاده را مشخص می‌کند. در صورت مشخص شدن چند گزینه -q یا -Q، تمام پرس‌وجوها به‌گونه‌ای در نظر گرفته می‌شوند که گویی با عملگر 'or' با یکدیگر ترکیب شده‌اند.
- -r <filename>
- خواندن لاگ با فرمت فایل دودویی (باینری) از این فایل. این فایل می‌تواند با vinyllog -w filename ایجاد شود. اگر نام فایل - باشد، لاگ‌ها از ورودی استاندارد خوانده می‌شوند و برنامه نمی‌تواند به‌صورت دیمن (daemon) اجرا شود.
- -t <seconds|off>
- مدت زمان انتظار (تایم‌اوت) پیش از بازگرداندن خطا در اتصال اولیه به VSM. در صورت تنظیم، اتصال VSM هر ۰٫۵ ثانیه به مدت این تعداد ثانیه مجدداً تلاش می‌شود. اگر صفر باشد، اتصال تنها یک بار تلاش شده و در صورت ناموفق بودن بلافاصله با خطا مواجه می‌شود. در صورت تنظیم روی "off"، اتصال شکست نخواهد خورد و به ابزار اجازه می‌دهد شروع به کار کرده و به طور نامحدود منتظر ظاهر شدن نمونه vinyld بماند. مقدار پیش‌فرض ۵ ثانیه است.
- -T <seconds>
- تنظیم مهلت زمانی (تایم‌اوت) تراکنش بر حسب ثانیه. این گزینه حداکثر ثانیه‌های سپری‌شده میان برچسب Begin و برچسب End را مشخص می‌کند. در صورت پایان مهلت زمانی، یک رکورد هشدار تولید شده و تراکنش به اجبار تکمیل می‌شود. مقدار پیش‌فرض ۱۲۰ ثانیه است.
- -V
- نمایش اطلاعات نسخه و خروج.
- --optstring
- چاپ پارامتر optstring برای تابع getopt(3) جهت کمک به نگارش اسکریپت‌های پوششی (wrapper).
همچنین ببینید (SEE ALSO)
تاریخچه (HISTORY)
ابزار vinylhist توسط Poul-Henning Kamp با همکاری Verdens Gang AS و Redpill-Linpro توسعه یافته است. این صفحه راهنما توسط Dag-Erling Smørgrav نوشته شده است.
حق نشر (COPYRIGHT)
این سند تحت همان مجوزی منتشر شده است که خود Vinyl Cache تحت آن منتشر می‌شود. برای جزئیات به LICENCE مراجعه کنید.
- Copyright (c) 2006 Verdens Gang AS
- Copyright (c) 2006-2015 Varnish Software AS