نام (NAME)

vinylstat - آمارهای حافظه موقت Vinyl

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

vinylstat [-1] [-c] [-f <glob>] [-h] [-I <glob>] [-j] [-l] [-n <workdir>] [-r] [-t <seconds|off>] [-V] [-X <glob>] [-x]

توضیحات (DESCRIPTION)

ابزار vinylstat آمارهای حاصل از یک نمونهٔ در حال اجرای vinyld(1) را نمایش می‌دهد.

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

-1: به جای ارائه یک نمای مداوم به‌روزشونده، آمارها را در خروجی استاندارد (stdout) چاپ می‌کند. این حالت، رفتار پیش‌فرض در هنگام تغییر مسیر خروجی استاندارد است.
-c: نمایی تعاملی و مداوم به‌روزشونده را ارائه می‌دهد. این حالت، رفتار پیش‌فرض در زمانی است که خروجی استاندارد تغییر مسیر داده نشده باشد.
-f <glob>: الگوی تطبیق (glob) قدیمی برای پالایش فیلدها. برای گریز (escape) نویسه‌ها از بک‌اسلش استفاده کنید. اگر آرگومان با '^' آغاز شود، به عنوان یک الگوی خروج (انحصاری) در نظر گرفته می‌شود. می‌توان چندین آرگومان -f را مشخص کرد. الگوهای قدیمی فیلترسازی همراه با الگوهای شمول (آرگومان‌های -I) و الگوهای خروج (آرگومان‌های -X) به ترتیب و بر اساس نخستین تطابق اجرا می‌شوند.
-h: نمایش راهنمای استفاده از برنامه و خروج.
-I <glob>: الگوی تطبیق (glob) برای شمول فیلدها. برای گریز نویسه‌ها از بک‌اسلش استفاده کنید. می‌توان چندین آرگومان -I را مشخص کرد. الگوهای شمول همراه با الگوهای خروج (آرگومان‌های -X) و الگوهای قدیمی فیلترسازی (آرگومان‌های -f) به ترتیب و بر اساس نخستین تطابق پردازش می‌شوند.
-j: چاپ آمارها در stdout در قالب JSON.
-l: فهرست کردن فیلدهای موجود جهت استفاده همراه با گزینهٔ -f.
-n <workdir>: مشخص کردن دایرکتوری کاری vinyl مربوط به نمونه‌ای که باید به آن متصل شد. برای اطلاعات بیشتر و مقادیر پیش‌فرض، به مستندات گزینهٔ -n در vinyld(1) مراجعه کنید.
-r: تغییر وضعیت بین سنجه‌های (gauges) خام یا تعدیل‌شده؛ حالت تعدیل‌شده پیش‌فرض است.
-t <seconds|off>: مهلت زمانی (timeout) پیش از بازگرداندن خطا هنگام برقراری اتصال اولیه به VSM. در صورت تعیین، اتصال VSM هر ۰٫۵ ثانیه به مدت زمان مشخص‌شده تکرار می‌شود. اگر صفر باشد، تلاش برای اتصال تنها یک بار انجام شده و در صورت عدم موفقیت بلافاصله با شکست مواجه می‌شود. در صورت تنظیم روی "off"، اتصال ناموفق نخواهد شد و به ابزار اجازه می‌دهد شروع به کار کرده و به طور نامحدود تا زمان در دسترس قرار گرفتن نمونهٔ vinyld منتظر بماند. مقدار پیش‌فرض ۵ ثانیه است.
-V: چاپ اطلاعات نسخه و خروج.
-X <glob>: الگوی تطبیق (glob) برای مستثنی کردن فیلدها. برای گریز نویسه‌ها از بک‌اسلش استفاده کنید. می‌توان چندین آرگومان -X را مشخص کرد. الگوهای خروج همراه با الگوهای شمول (آرگومان‌های -I) و الگوهای قدیمی فیلترسازی (آرگومان‌های -f) به ترتیب و بر اساس نخستین تطابق پردازش می‌شوند.
-x: چاپ آمارها در stdout در قالب XML.
--optstring: چاپ پارامتر optstring برای getopt(3) به منظور کمک به نگارش اسکریپت‌های پوششی (wrapper).

حالت CURSES (CURSES MODE)

هنگامی که هیچ‌یک از گزینه‌های -1، -j یا -x مشخص نشده باشند، برنامه در حالت curses اجرا می‌شود. این حالت نمایی مداوم به‌روزشونده از مقادیر شمارنده‌ها را به همراه توضیحات آن‌ها نمایش می‌دهد.

ناحیه بالایی، اطلاعات مربوط به مدت زمان فعال بودن فرایند (uptime) را نمایش می‌دهد.

ناحیه میانی، فهرستی از مقادیر شمارنده‌ها را نمایش می‌دهد.

ناحیه پایینی، توضیحات مربوط به شمارندهٔ انتخاب‌شده فعلی را نمایش می‌دهد.

در زمان راه‌اندازی، تنها شمارنده‌های سطح INFO نمایش داده می‌شوند.

ستون‌ها (Columns)

ستون‌های زیر از چپ به راست نمایش داده می‌شوند:

Name: نام شمارنده.
Current: مقدار کنونی شمارنده.
Change: میانگین تغییر بر ثانیه در طول آخرین بازهٔ به‌روزرسانی.
Average: میانگین مقدار این شمارنده در طول زمان اجرای دیمن vinyld، یا یک نقطه (.) اگر شمارنده قابل میانگین‌گیری نباشد.
Avg_10: میانگین متحرک طی ۱۰ بازهٔ به‌روزرسانی اخیر.
Avg_100: میانگین متحرک طی ۱۰۰ بازهٔ به‌روزرسانی اخیر.
Avg_1000: میانگین متحرک طی ۱۰۰۰ بازهٔ به‌روزرسانی اخیر.

کلیدهای میان‌بر (Key bindings)

<h>: تغییر وضعیت نمایش صفحه راهنما.
<UP> یا <k>: پیمایش فهرست شمارنده‌ها به اندازه یک خط به بالا.
<DOWN> یا <j>: پیمایش فهرست شمارنده‌ها به اندازه یک خط به پایین.
<PAGEUP> یا <b> یا <CTRL-B>: پیمایش فهرست شمارنده‌ها به اندازه یک صفحه به بالا.
<PAGEDOWN> یا <SPACE> یا <CTRL-F>: پیمایش فهرست شمارنده‌ها به اندازه یک صفحه به پایین.
<HOME> یا <g>: انتقال به ابتدای فهرست شمارنده‌ها.
<END> یا <G>: انتقال به انتهای فهرست شمارنده‌ها.
<d>: تغییر وضعیت بین نمایش و پنهان‌سازی شمارنده‌های دیده‌نشده. شمارنده‌های دیده‌نشده مواردی هستند که در کل مدت زمان اجرای vinylstat صفر بوده‌اند. پیش‌فرض، پنهان کردن شمارنده‌های دیده‌نشده است.
<r>: تغییر وضعیت بین نمایش سنجه‌های خام و تعدیل‌شده. هنگامی که یک سنجه سریع‌تر از افزایشش کاهش یابد، ممکن است به صورت یک عدد صحیح بزرگ که باارزش‌ترین بیت آن ۱ است دیده شود. به طور پیش‌فرض این مقادیر روی صفر تنظیم می‌شوند.
<e>: تغییر وضعیت مقیاس‌بندی مقادیر.
<v>: افزایش سطح جزئیات. پیش‌فرض، تنها نمایش شمارنده‌های اطلاعاتی (informational) است.
<V>: کاهش سطح جزئیات. پیش‌فرض، تنها نمایش شمارنده‌های اطلاعاتی است.
<q>: خروج.
<CTRL+T>: نمونه‌گیری آنی.
<0>: بازنشانی میانگین‌ها.
<+>: افزایش بازهٔ نوسازی (refresh).
<->: کاهش بازهٔ نوسازی.

خروجی‌ها (OUTPUTS)

قالب خروجی XML به صورت زیر است:

<vinylstat timestamp="YYYY-MM-DDTHH:mm:SS">
  <stat>
    <name>FIELD NAME</name>
    <value>FIELD VALUE</value>
    <flag>FIELD SEMANTICS</flag>
    <format>FIELD DISPLAY FORMAT</format>
    <description>FIELD DESCRIPTION</description>
  </stat>
  [..]
</vinylstat>

قالب خروجی JSON به صورت زیر است:

{
  "timestamp": "YYYY-MM-DDTHH:mm:SS",
  "FIELD NAME": {
    "description": "FIELD DESCRIPTION",
    "flag": "FIELD SEMANTICS", "format": "FIELD DISPLAY FORMAT",
    "value": FIELD VALUE
  },
  "FIELD NAME": {
    "description": "FIELD DESCRIPTION",
    "flag": "FIELD SEMANTICS", "format": "FIELD DISPLAY FORMAT",
    "value": FIELD VALUE
  },
  [..]
}

برچسب زمانی (timestamp) بیانگر زمانی است که گزارش توسط vinylstat تولید شده است.

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

نویسندگان (AUTHORS)

این صفحهٔ راهنما توسط Dag-Erling Smørgrav، Per Buer، Lasse Karstensen و Martin Blix Grydeland نوشته شده است.