نام (NAME)

fio2gnuplot - رسم و نمایش پرونده‌های خروجی fio با ابزار gnuplot

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

fio2gnuplot [-ghbiodvk] [-t title] [-o outputfile]
               [-d output_dir] [-p pattern]
               [-G type] [-m min_time] [-M max_time]

توضیحات (DESCRIPTION)

دستور fio2gnuplot مجموعه‌ای از فایل‌های گزارش (لاگ) برنامه fio را تحلیل کرده و آنها را با ابزار gnuplot به مجموعه‌ای از نمودارهای گرافیکی تبدیل می‌کند. انواع مختلفی از رسم نمودار تولید می‌شوند:

نمودار دوبعدی انفرادی (Individual 2D Graph): هر فایل در یک فایل تصویری جداگانه با چندین گزینه رسم می‌شود:

raw (خام): رسم کارایی دقیق گزارش‌شده. خواندن این نمودار ممکن است دشوار باشد.
smooth (هموار): نسخه‌ای هموارتر از خروجی خام. با استفاده از گزینه csplines ابزار gnuplot، رندرینگ فیلتر می‌شود تا نموداری با خوانایی بهتر حاصل شود.
trend (روند): نسخه‌ای حتی هموارتر از چاپ خام جهت مشاهده روندها. منحنی‌های بزیر (Bezier) نمودارهای بسیار فیلترشده‌تری ایجاد می‌کنند. نمودار حاصل به درک روندها کمک می‌کند.

نمودار دوبعدی گروهی (Grouped 2D graph): همه فایل‌ها در یک تصویر واحد برای مقایسه آسان‌تر رسم می‌شوند. گزینه‌های رندرینگ مشابه با نمودار دوبعدی انفرادی به کار می‌روند:

raw (خام)
smooth (هموار)
trend (روند)

نمودار سه‌بعدی گروهی (Grouped 3D graph): همه فایل‌ها در یک نمودار سه‌بعدی واحد رسم می‌شوند. رسم سه‌بعدی یک 'سطح' ایجاد می‌کند تا برآورد کند که کارایی‌ها تا چه اندازه به یکدیگر نزدیک بوده‌اند. یک سطح صاف نشان‌دهنده یکپارچگی و همخوانی خوب بین داده‌ها است. یک سطح ناهموار نشان‌دهنده عدم همخوانی و پراکندگی بین داده‌ها است.
رسم ریاضی (Mathematical Plotting)

نمودار میانگین (Average graph): یک نمودار میله‌ای برای نمایش میانگین کارایی هر فایل. یک خط سبز برای نمایش میانگین سراسری کارایی اضافه شده است. این خط سبز کمک می‌کند تا فاصله هر فایل جداگانه از میانگین سنجیده شود.
نمودار حداقل (Min graph): یک خط سبز برای نمایش میانگین سراسری حداقل کارایی اضافه شده است. این خط سبز به درک فاصله هر فایل جداگانه از میانگین کمک می‌کند.
نمودار حداکثر (Max graph): یک نمودار میله‌ای برای نمایش حداکثر کارایی هر فایل. یک خط سبز برای نمایش میانگین سراسری حداکثر کارایی اضافه شده است. این خط سبز به درک فاصله هر فایل جداگانه از میانگین کمک می‌کند.
انحراف معیار (Standard Deviation): یک نمودار میله‌ای برای نمایش انحراف معیار هر فایل. یک خط سبز برای نمایش میانگین سراسری انحراف معیار اضافه شده است. این خط سبز کمک می‌کند تا فاصله هر فایل جداگانه از میانگین انحراف معیار مشخص شود.

گزینه‌ها (OPTIONS)

-h یا --help: گزینه -h راهنما را نمایش می‌دهد.
-p 'pattern' یا --pattern 'pattern': یک pattern به صورت عبارات باقاعده (regex) برای انتخاب فایل‌های ورودی fio. برای جلوگیری از تداخل شل، کوتیشن‌های تکی (') را فراموش نکنید.
-b یا --bandwidth: یک pattern از پیش تعریف‌شده برای انتخاب فایل‌های *_bw.log.
-i یا --iops: یک pattern از پیش تعریف‌شده برای انتخاب فایل‌های *_iops.log.
-g یا --gnuplot: رندر کردن نمودارهای gnuplot قبل از خروج.
-o file یا --outputfile file: نام پایه (basename) برای نمودارهای gnuplot (در صورت تعریف الگو، با pattern تنظیم می‌شود).
-d dir یا --outputdir dir: دایرکتوری‌ای که gnuplot فایل‌ها را در آن رندر می‌کند.
-t title یا --title title: عنوان (title) نمودارهای gnuplot. عنوان با اندازه بلوک شناسایی‌شده در لاگ fio تنظیم می‌شود.
-G type یا --Global type: جستجو برای 'type' در فایل‌های .global منطبق با pattern. انواع مجاز عبارتند از: min، max، avg، stddev. پسوند .global به طور خودکار به pattern اضافه می‌شود.
-m time یا --min_time time: تنها در نظر گرفتن داده‌ها از زمان 'time' ثانیه به بعد. مقدار پیش‌فرض 0 است.
-M time یا --max_time time: تنها در نظر گرفتن داده‌های پایان‌یافته قبل از زمان 'time' ثانیه. مقدار پیش‌فرض -1 (بدون محدودیت) است.
-v یا --verbose: افزایش پرگویی خروجی (جزئیات بیشتر).
-k یا --keep: نگه‌داشتن تمامی فایل‌های موقت در دایرکتوری خروجی gnuplot.

مثال‌ها (EXAMPLES)

برای رسم تمام نمودارهای با نامی مشابه 'host*_read_4k_iops.log':

$ fio2gnuplot -p 'host*_read_4k_iops.log' -g

برای رسم تمامی فایل‌های لاگ مرتبط با IO از دایرکتوری جاری:

$ fio2gnuplot -g -i

برای رسم تمامی فایل‌های لاگ مرتبط با پهنای باند از دایرکتوری جاری:

$ fio2gnuplot -g -b

برای رسم تمامی فایل‌های لاگ مرتبط با پهنای باند در پوشه‌ای با نام 'outdir':

$ fio2gnuplot -g -b -d outdir

نویسنده (AUTHOR)

Erwan Velu <erwan@enovance.com>