نام (NAME)

pmiostat, pcp-iostat - گزارش آمار ورودی/خروجی (I/O) بلوکی

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

pcp [pcp options] iostat [-u?] [-G method] [-P precision] [-R pattern] [-x [dm][,t][,h][,noidle]]

توضیحات (DESCRIPTION)

دستور pcp-iostat آمار I/O را برای دستگاه‌های SCSI (به‌طور پیش‌فرض) یا سایر دستگاه‌ها (در صورت مشخص شدن گزینهٔ -x) گزارش می‌کند.

گزینه‌ها (OPTIONS)

هنگامی که این ابزار از طریق دستور pcp(1) فراخوانی می‌شود، گزینه‌های pcp شامل -A/--align، -a/--archive، -h/--host، -O/--origin، -S/--start، -s/--samples، -T/--finish، -t/--interval، -v/--version، -Z/--timezone و -z/--hostzone به‌صورت غیرمستقیم در دسترس قرار می‌گیرند؛ برای شرح کامل این گزینه‌ها به PCPIntro(1) مراجعه کنید.

گزینه‌های خط فرمان تکمیلی موجود برای pcp-iostat عبارتند از:

-G method, --aggregate=method: مشخص می‌کند که آمار برای نام دستگاه‌های منطبق با عبارت باقاعدهٔ تعیین‌شده با گزینهٔ -R regex باید بر اساس method تجمیع شوند. توجه داشته باشید که این یک تجمیع بر اساس تطابق نام دستگاه‌ها است (نه تجمیع بر مبنای زمان). هنگامی که -G استفاده شود، ستون نام دستگاه به‌صورت method(regex) گزارش می‌شود؛ برای مثال اگر -G sum و -R 'sd(a|b)$' تعیین شده باشد، ستون دستگاه sum(sd(a|b)$) خواهد بود و آمار جمع‌زده‌شده برای sda و sdb در سایر ستون‌ها گزارش خواهد شد. اگر -G تعیین شده باشد اما -R تعیین نشده باشد، در این صورت regex پیش‌فرض .* خواهد بود، یعنی تطابق با تمام نام‌های دستگاه‌ها. اگر method برابر با sum باشد، آن‌گاه آمار جمع زده می‌شوند. این مورد شامل ستون %util نیز می‌شود، که بنابراین اگر بیش از یک نام دستگاه تطابق داشته باشد، ممکن است مقدار آن از ۱۰۰٪ بیشتر شود. اگر method برابر با avg باشد، آن‌گاه آمار جمع زده شده و سپس با تقسیم بر تعداد نام‌های دستگاه منطبق، میانگین گرفته می‌شود. اگر method برابر با min یا max باشد، به‌ترتیب کمینه یا بیشینهٔ آمار برای دستگاه‌های منطبق گزارش می‌شود.
-P N, --precision=N: این گزینه دقت (تعداد ارقام اعشار) را برای گزارش مشخص می‌کند. دقت پیش‌فرض N می‌تواند روی مقداری به جز مقدار پیش‌فرض (۲) تنظیم شود. توجه داشته باشید که فیلدهای avgrq-sz و avgqu-sz همیشه با دقت N+1 رقم اعشار گزارش می‌شوند. این فیلدها معمولاً مقادیری کمتر از ۱ دارند.
-R pattern, --regex=pattern: این گزینه گزارش را به نام‌های دستگاه‌هایی که با عبارت باقاعدهٔ pattern تطابق دارند محدود می‌کند. عبارت pattern داده‌شده به‌صورت یک عبارت باقاعده به سبک perl جستجو می‌شود و با هر بخشی از نام دستگاه تطابق خواهد یافت. برای مثال، '^sd[a-zA-Z]+' با تمام نام‌های دستگاهی که با 'sd' آغاز شده و پس از آن یک یا چند نویسهٔ الفبایی قرار دارد تطابق می‌یابد. مثلاً '^sd(a|b)$' تنها با 'sda' و 'sdb' تطابق خواهد داشت. مثلاً 'sda$' با 'sda' تطابق دارد اما با 'sdab' تطابق ندارد. همچنین برای گزینه‌های تجمیع، گزینهٔ -G را ببینید.
-u, --no-interpolation: هنگام بازپخش مجموعه‌ای از بایگانی‌ها، مقادیر به‌طور پیش‌فرض بر اساس بازهٔ نمونه‌برداری درخواست‌شده (گزینهٔ -t) گزارش می‌شوند، نه بر اساس بازهٔ واقعی ثبت‌شده در بایگانی(ها). بدون این گزینه، PCP مقادیر گزارش را بر اساس رکوردهای موجود در مجموعه بایگانی درون‌یابی می‌کند؛ این قابلیت به‌ویژه زمانی مفید است که از گزینهٔ -t برای بازپخش مجموعه‌ای از بایگانی‌ها با بازهٔ نمونه‌برداری طولانی‌تر از آنچه بایگانی(ها) در ابتدا با آن ضبط شده‌اند استفاده شود. با گزینهٔ -u، گزارش‌دهیِ بدون درون‌یابی فعال می‌شود - هر مقدار بر اساس بازهٔ زمانی ثبت اصلی در مجموعه بایگانی گزارش می‌گردد. هنگامی که گزینهٔ -u مشخص شده باشد، گزینهٔ -t بی‌معنی و ناسازگار است زیرا بازهٔ بازپخش همواره همانند بازهٔ ثبت در مجموعه بایگانی است. علاوه بر این، -u تنها هنگام بازپخش بایگانی‌ها کاربرد دارد، به گزینهٔ -a در PCPIntro(1) مراجعه کنید، بنابراین اگر -u تعیین شده باشد، -a نیز باید تعیین گردد..TP -V, --version نمایش شماره نسخه و خروج.
-x comma-separated-options: فهرستی جداشده با کاما از یک یا چند گزینهٔ گزارش‌دهی گسترده را به شرح زیر مشخص می‌کند:
dm - گزارش آمار برای دستگاه‌های منطقی device-mapper به جای دستگاه‌های SCSI،
t - افزودن یک برچسب زمانی با قالب ctime(3) به ابتدای هر خط در گزارش،
h - حذف سربرگ، که در غیر این صورت پس از هر ۲۴ نمونه گزارش می‌شود،
noidle - عدم نمایش آمار برای دستگاه‌های بیکار (idle).
-?, --help: نمایش پیام راهنما و خروج.

گزارش (REPORT)

ستون‌های موجود در گزارش pcp-iostat مفهوم زیر را دارند:

Timestamp: هنگامی که گزینهٔ -x t مشخص شده باشد، این ستون برچسب زمانی در قالب ctime(3) است.
Device: نام دستگاه scsi را مشخص می‌کند، یا در صورتی که -x dm مشخص شده باشد، نام دستگاه منطقی device-mapper را نشان می‌دهد. هنگامی که -G مشخص شده باشد، این مقدار با روش تجمیع و عبارت باقاعده (regular expression) جایگزین می‌شود - گزینه‌های -G و -R در بالا را ببینید.
rrqm/s: تعداد درخواست‌های خواندن ادغام‌شده توسط زمان‌بند I/O در طول بازهٔ گزارش‌دهی، بر حسب نرخ بر ثانیه.
wrqm/s: تعداد درخواست‌های نوشتن ادغام‌شده توسط زمان‌بند I/O در طول بازهٔ گزارش‌دهی، بر حسب نرخ بر ثانیه.
r/s: تعداد درخواست‌های خواندن تکمیل‌شده توسط دستگاه (پس از ادغام‌ها)، بر حسب نرخ بر ثانیه در طول بازهٔ گزارش‌دهی.
w/s: تعداد درخواست‌های نوشتن تکمیل‌شده توسط دستگاه (پس از ادغام‌ها)، بر حسب نرخ بر ثانیه در طول بازهٔ گزارش‌دهی.
rkB/s: میانگین حجم داده‌های خوانده‌شده از دستگاه بر حسب کیلوبایت بر ثانیه در طول بازهٔ گزارش‌دهی.
wkB/s: میانگین حجم داده‌های نوشته‌شده بر روی دستگاه بر حسب کیلوبایت بر ثانیه در طول بازهٔ گزارش‌دهی.
avgrq-sz: میانگین اندازهٔ درخواست‌های I/O برای هر دو عمل خواندن و نوشتن به دستگاه بر حسب کیلوبایت در طول بازهٔ گزارش‌دهی.
avgqu-sz: میانگین طول صف درخواست‌های خواندن و نوشتن به دستگاه در طول بازهٔ گزارش‌دهی.
await: میانگین زمان بر حسب میلی‌ثانیه که درخواست‌های خواندن و نوشتن در طول بازهٔ گزارش‌دهی در صف دستگاه قرار گرفته (و سرویس‌دهی شده‌اند).
r_await: میانگین زمان بر حسب میلی‌ثانیه که درخواست‌های خواندن در طول بازهٔ گزارش‌دهی در صف دستگاه قرار گرفته (و سرویس‌دهی شده‌اند).
w_await: میانگین زمان بر حسب میلی‌ثانیه که درخواست‌های نوشتن در طول بازهٔ گزارش‌دهی در صف دستگاه قرار گرفته (و سرویس‌دهی شده‌اند).
%util: درصد زمانی در طول بازهٔ گزارش‌دهی که دستگاه مشغول پردازش درخواست‌ها بوده است. مقدار ۱۰۰٪ نشان‌دهندهٔ اشباع دستگاه است..SH "محیط PCP (PCP ENVIRONMENT)" متغیرهای محیطی با پیشوند PCP_ برای تعیین نام‌های فایل و دایرکتوری مورد استفاده توسط PCP به کار می‌روند. در هر نصب، فایل /etc/pcp.conf حاوی مقادیر محلی برای این متغیرها است. متغیر $PCP_CONF می‌تواند برای مشخص کردن یک فایل پیکربندی جایگزین، همان‌طور که در pcp.conf(5) شرح داده شده، استفاده شود.

برای متغیرهای محیطی مؤثر بر ابزارهای PCP، به pmGetOptions(3) مراجعه کنید.

گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)

گزینه pcp -D یا --debug خروجی عیب‌یابی تکمیلی را روی stderr فعال می‌کند تا به ریشه‌یابی و دسته‌بندی مشکلات کمک کند، اگرچه این اطلاعات گاهی مبهم بوده و در درجه اول به منظور راهنمایی توسعه‌دهندگان تدوین شده است تا کاربران نهایی. مقدار debug فهرستی از گزینه‌های اشکال‌زدایی است که با کاما از هم جدا شده‌اند؛ از pmdbg(1) به همراه گزینه -l برای به‌دست آوردن فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.

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

PCPIntro(1)، pcp(1)، iostat2pcp(1)، pmcd(1)، pmchart(1)، pmlogger(1)، pcp.conf(5) و pcp.env(5).