نام (NAME)

mfsstatsdump - استخراج داده‌های مصرف از فایل آمار مستر در قالب csv یا png

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

mfsstatsdump -f fields [-i stats_file] [-r range] [-s separator] [-p png_filename [-x chart_width] [-y chart_height]] [-hHd]

توضیحات (DESCRIPTION)

دستور mfsstatsdump داده‌های مصرف و عملکرد را از فایل آمار سرور مستر استخراج می‌کند. این داده‌ها همان مجموعه‌داده‌هایی هستند که برای ایجاد نمودارهای رابط گرافیکی کاربر (GUI) استفاده می‌شوند. خروجی می‌تواند در قالب متنی (csv) یا در قالب گرافیکی (png) باشد. این بدان معناست که گزینه‌های -p، -x و -y با گزینه‌های -h، -H و -d مانعه‌الجمع هستند.

سرور مستر MooseFS فایل آمار را در دایرکتوری DATA_PATH ذخیره می‌کند - به mfsmaster.cfg(5) مراجعه کنید.

خروجی (OUTPUT)

خروجی متنی - یک فایل متنی (csv) که ستون نخست آن برچسب زمان (یا تاریخ در صورت تعیین گزینه -d) است؛ ستون‌های بعدی مقادیر مشخص‌شده با گزینه -f هستند که بر اساس گزینه‌های به‌کاررفته (هیچ‌کدام، -s و -h یا -H) قالب‌بندی شده‌اند.

خروجی گرافیکی - یک فایل png حاوی نمودار برای هر فیلد مشخص‌شده با گزینه -f طبق الگوی نام‌گذاری اعلان‌شده با گزینه -p ایجاد می‌شود. ابعاد نمودار را می‌توان با گزینه‌های -x و -y تنظیم کرد.

گزینه‌ها (OPTIONS)

-f: نام فیلدها با جداکننده ویرگول «,» (بخش فیلدها را ببینید)؛ تعیین حداقل یک فیلد الزامی است؛ در صورت استفاده از ستاره (*)، تمامی فیلدها استخراج می‌شوند.
-i: نام فایل باینری آمار mfs (پیش‌فرض: default_data_path/stats.mfs)
-r: نوع بازه زمانی: 0 - بازه کوتاه (دقیقه)، 1 - بازه متوسط (۶ دقیقه)، 2 - بازه طولانی (۳۰ دقیقه)، 3 - بازه بسیار طولانی (روز)
-s: تعیین جداکننده ستون‌ها (پیش‌فرض: تب / tabulator)
-p: نام اختیاری فایل PNG (نام فیلد پیش از .png اضافه خواهد شد؛ YYYY -> YYYY_FIELD.png یا YYYY.png -> YYYY_FIELD.png)
-x: عرض نمودار PNG (پیش‌فرض: ۱۶۰۰)
-y: ارتفاع نمودار PNG (باید بر ۲۰ بخش‌پذیر باشد - در غیر این صورت تنظیم خواهد شد؛ پیش‌فرض: ۳۲۰)
-h: نمایش اعداد با خوانایی انسانی با استفاده از پیشوندهای بر مبنای ۲ (IEC 60027)
-H: نمایش اعداد با خوانایی انسانی با استفاده از پیشوندهای بر مبنای ۱۰ (SI)
-d: نمایش برچسب‌های زمانی در قالب YYYY-MM-DD HH:MM

فیلدها (FIELDS)

ucpu: میزان مصرف پردازنده در فضای کاربری (User CPU)
scpu: میزان مصرف پردازنده در فضای سیستم (System CPU)
cpu: میزان کل مصرف پردازنده (در csv مجموع scpu و ucpu، در png نمایش هر دو با رنگ‌های مجزا)
delete: تعداد عملیات‌های حذف چانک
replicate: تعداد عملیات‌های بازتولید چانک
statfs: تعداد عملیات‌های statfs
getattr: تعداد عملیات‌های getattr
setattr: تعداد عملیات‌های setattr
lookup: تعداد عملیات‌های lookup
mkdir: تعداد عملیات‌های mkdir
rmdir: تعداد عملیات‌های rmdir
symlink: تعداد عملیات‌های symlink (ایجاد پیوند نمادین)
readlink: تعداد عملیات‌های readlink (خواندن پیوند نمادین)
mknod: تعداد عملیات‌های mknod (ایجاد گره سیستم‌فایل)
unlink: تعداد عملیات‌های unlink (حذف پیوند یا فایل)
rename: تعداد عملیات‌های rename (تغییر نام)
link: تعداد عملیات‌های link (ایجاد پیوند سخت)
readdir: تعداد عملیات‌های readdir (خواندن محتوای دایرکتوری)
open: تعداد عملیات‌های open (باز کردن فایل)
read: تعداد عملیات‌های read (خواندن)
write: تعداد عملیات‌های write (نوشتن)
prcvd: تعداد بسته‌های دریافتی
psent: تعداد بسته‌های ارسالی
brcvd: میزان بایت‌های دریافتی
bsent: میزان بایت‌های ارسالی
memoryrss: میزان مصرف حافظه مقیم (Resident memory - RSS)
memoryvirt: میزان مصرف حافظه مجازی (Virtual memory)
mem: میزان کل مصرف حافظه (در csv همانند memoryvirt، در png نمایش هر دو مقدار memoryrss و memoryvirt با دو رنگ مجزا)
usedspace: میزان فضای خام مصرف‌شده دیسک
totalspace: میزان کل فضای خام دیسک
space: میزان کل فضای خام دیسک (در csv همانند totalspace، در png نمایش هر دو مقدار usedspace و totalspace با دو رنگ مجزا)
readchunk: تعداد عملیات‌های chunk_read (خواندن چانک)
writechunk: تعداد عملیات‌های chunk_write (نوشتن چانک)
create: تعداد دفعات تلاش برای ایجاد چانک
change: تعداد دفعات تلاش برای عملیات‌های داخلی چانک
delete_ok: تعداد عملیات‌های موفق حذف چانک
delete_err: تعداد عملیات‌های ناموفق حذف چانک
delete_stat: مجموع عملیات‌های موفق و ناموفق حذف چانک (در png نمایش هر دو مقدار delete_ok و delete_err با دو رنگ مجزا)
replicate_ok: تعداد عملیات‌های موفق بازتولید چانک
replicate_err: تعداد عملیات‌های ناموفق بازتولید چانک
replicate_stat: مجموع عملیات‌های موفق و ناموفق بازتولید چانک (در png نمایش هر دو مقدار replicate_ok و replicate_err با دو رنگ مجزا)
create_ok: تعداد عملیات‌های موفق ایجاد چانک
create_err: تعداد عملیات‌های ناموفق ایجاد چانک
create_stat: مجموع عملیات‌های موفق و ناموفق ایجاد چانک (در png نمایش هر دو مقدار create_ok و create_err با دو رنگ مجزا)
change_ok: تعداد عملیات‌های موفق داخلی چانک
change_err: تعداد عملیات‌های ناموفق داخلی چانک
change_stat: مجموع عملیات‌های موفق و ناموفق داخلی چانک (در png نمایش هر دو مقدار change_ok و change_err با دو رنگ مجزا)
split_ok: تعداد عملیات‌های موفق تقسیم چانک
split_err: تعداد عملیات‌های ناموفق تقسیم چانک
split_stat: مجموع عملیات‌های موفق و ناموفق تقسیم چانک (در png نمایش هر دو مقدار split_ok و split_err با دو رنگ مجزا)
fileobjects: تعداد اشیای فایلی
metaobjects: تعداد اشیای غیرفایلی (دایرکتوری‌ها، پیوندهای نمادین و غیره)
objects: تعداد کل اشیا (در png نمایش هر دو مقدار fileobjects و metaobjects با دو رنگ مجزا)
chunksec8: تعداد کل چانک‌های ذخیره‌شده در قالب EC8
chunksec4: تعداد کل چانک‌های ذخیره‌شده در قالب EC4
chunkscopy: تعداد کل چانک‌های ذخیره‌شده در قالب COPY
chunks: تعداد کل چانک‌های ذخیره‌شده در هر قالبی (در png نمایش chunksec8، chunksec4 و chunkscopy با سه رنگ مجزا)
chregdanger: تعداد چانک‌های در معرض خطر (به‌جز موارد علامت‌گذاری‌شده برای حذف)
chregunder: تعداد چانک‌های زیر هدف یا undergoal (به‌جز موارد علامت‌گذاری‌شده برای حذف)
regunder: تعداد چانک‌های در معرض خطر و زیر هدف (به‌جز موارد علامت‌گذاری‌شده برای حذف؛ در png نمایش هر دو مقدار chregdanger و chregunder با دو رنگ مجزا)
challdanger: تعداد چانک‌های در معرض خطر (شامل موارد علامت‌گذاری‌شده برای حذف)
challunder: تعداد چانک‌های زیر هدف یا undergoal (شامل موارد علامت‌گذاری‌شده برای حذف)
allunder: تعداد چانک‌های در معرض خطر و زیر هدف (شامل موارد علامت‌گذاری‌شده برای حذف؛ در png نمایش هر دو مقدار challdanger و challunder با دو رنگ مجزا)
bytesread: میانگین تعداد بایت‌های خوانده‌شده در ثانیه توسط تمامی کلاینت‌ها
byteswrite: میانگین تعداد بایت‌های نوشته‌شده در ثانیه توسط تمامی کلاینت‌ها
fsync: تعداد عملیات‌های fsync
lock: تعداد عملیات‌های lock (قفل‌گذاری)
snapshot: تعداد عملیات‌های snapshot (تصویربرداری وضعیت)
truncate: تعداد عملیات‌های truncate (کوتاه‌سازی)
getxattr: تعداد عملیات‌های getxattr
setxattr: تعداد عملیات‌های setxattr
getfacl: تعداد عملیات‌های getfacl
setfacl: تعداد عملیات‌های setfacl
fcreate: تعداد عملیات‌های ایجاد فایل
meta: تعداد عملیات‌های متادیتای اضافی (مانند sclass، trashretention، eattr و غیره)
delay: (صرفاً نگارش Pro) بیشینه تأخیر مستر به ثانیه
servers: تعداد کل چانک‌سرورهای ثبت‌شده (اعم از متصل و قطع‌شده)
dservers: تعداد کل چانک‌سرورهای قطع‌شده
mdservers: تعداد چانک‌سرورهای قطع‌شده که در حالت تعمیر و نگهداری (maintenance mode) قرار دارند
cservers: تعداد کل چانک‌سرورهای ثبت‌شده (در csv برابر با servers، در png نمایش servers، dservers و mdservers با سه رنگ مجزا)
udiff: اختلاف درصد مصرف فضا میان پرمصرف‌ترین و کم‌مصرف‌ترین چانک‌سرور

نکات (NOTES)

مجموعه‌داده‌های delete و delete_stat در یک سیستم سالم و به‌درستی کارکرد، باید تقریباً یکسان باشند، اما لزوماً (در قالب CSV خود) همیشه کاملاً همسان نیستند. این موضوع ناشی از آن است که مجموعه‌داده delete بر اساس تعداد درخواست‌های ارسالی توسط مستر محاسبه می‌شود و مجموعه‌داده delete_stat بر اساس تعداد پاسخ‌های دریافتی از چانک‌سرورها به دست می‌آید؛ بنابراین ممکن است نوسانات محلی مشاهده شود (برای نمونه در یک دقیقه تعداد درخواست‌های ارسالی بیشتر بوده و مقدار مجموعه‌داده delete بالاتر است، و در دقیقه بعد پاسخ‌های بیشتری دریافت شده و مقدار مجموعه‌داده delete_stat بیشتر می‌شود). اما اگر مجموع اختلاف‌های میان این دو مجموعه‌داده در طول زمان محاسبه شود، این مجموع هرگز نباید از حد معینی فراتر رود.

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

همین امر درباره مجموعه‌داده‌های replicate(_stat)، create(_stat)، change(_stat) و split(_stat) نیز صدق می‌کند.

گزارش اشکالات (REPORTING BUGS)

اشکالات را به <bugs@moosefs.com> گزارش دهید.

حق نشر (COPYRIGHT)

حق نشر (C) ۲۰۲۶ متعلق به Jakub Kruszona-Zawadzki, Saglabs SA است.

این فایل بخشی از MooseFS است.

نرم‌افزار MooseFS یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو منتشرشده توسط بنیاد نرم‌افزارهای آزاد، نگارش ۲ (صرفاً) بازتوزیع کرده یا تغییر دهید.

نرم‌افزار MooseFS با این امید توزیع شده است که سودمند باشد، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف مشخص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.

شما باید همراه با این برنامه یک نسخه از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، نشانی https://www.gnu.org/licenses را ببینید.

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

mfsmount(8), moosefs(7)