'\"macro stdmacro
.\"
.\" Copyright (c) 2014-2016,2019 Red Hat.
.\"
.\" This program is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by the
.\" Free Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
.\" or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" for more details.
.\"
.\"
.TH PCP-IOSTAT 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmiostat\f1,
\f3pcp-iostat\f1 \- گزارش آمار ورودی/خروجی (I/O) بلوکی
.SH "خلاصه دستور (SYNOPSIS)"
\f3pcp\f1 [\f2pcp\ options\f1] \f3iostat\f1
[\f3\-u?\f1]
[\f3\-G\f1 \f2method\f1]
[\f3\-P\f1 \f2precision\f1]
[\f3\-R\f1 \f2pattern\f1]
[\f3\-x\f1 [dm][,t][,h][,noidle]\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pcp-iostat
آمار I/O را برای دستگاه‌های SCSI (به‌طور پیش‌فرض) یا سایر دستگاه‌ها (در صورت مشخص شدن گزینهٔ \f3\-x\f1) گزارش می‌کند.
.SH "گزینه‌ها (OPTIONS)"
هنگامی که این ابزار از طریق دستور
.BR pcp (1)
فراخوانی می‌شود،
.I "گزینه‌های pcp"
شامل
.hy 0
.BR \-A /\c
.BR \-\-align ،
.BR \-a /\c
.BR \-\-archive ،
.BR \-h /\c
.BR \-\-host ،
.BR \-O /\c
.BR \-\-origin ،
.BR \-S /\c
.BR \-\-start ،
.BR \-s /\c
.BR \-\-samples ،
.BR \-T /\c
.BR \-\-finish ،
.BR \-t /\c
.BR \-\-interval ،
.BR \-v /\c
.BR \-\-version ،
.BR \-Z /\c
.B \-\-timezone
و
.BR \-z /\c
.B \-\-hostzone
به‌صورت غیرمستقیم در دسترس قرار می‌گیرند؛ برای شرح کامل این گزینه‌ها به
.BR PCPIntro (1)
مراجعه کنید.
.br
.hy
.PP
گزینه‌های خط فرمان تکمیلی موجود برای
.B pcp-iostat
عبارتند از:
.TP 5
\fB\-G \fImethod\fR\fR, \fB\-\-aggregate\fR=\fImethod\fR
مشخص می‌کند که آمار برای نام دستگاه‌های منطبق با عبارت باقاعدهٔ تعیین‌شده با گزینهٔ
.B \-R
.I regex
باید بر اساس
.IR method
تجمیع شوند.
توجه داشته باشید که این یک تجمیع بر اساس تطابق نام دستگاه‌ها است (نه تجمیع بر مبنای زمان).
هنگامی که
.B \-G
استفاده شود،
ستون نام دستگاه به‌صورت
.IR method (\fIregex\fR)
گزارش می‌شود؛ برای مثال اگر
.B \-G sum
و
.B \-R 'sd(a|b)$'
تعیین شده باشد، ستون دستگاه
.BR sum (\fBsd(a|b)$)\fR
خواهد بود و
آمار جمع‌زده‌شده برای
.B sda
و
.B sdb
در سایر ستون‌ها گزارش خواهد شد.
اگر
.B \-G
تعیین شده باشد اما
.B \-R
تعیین نشده باشد، در این صورت
.I regex
پیش‌فرض
.B .*
خواهد بود، یعنی تطابق با تمام نام‌های دستگاه‌ها.
اگر
.I method
برابر با
.B sum
باشد، آن‌گاه آمار جمع زده می‌شوند.
این مورد شامل ستون
.B %util
نیز می‌شود، که بنابراین اگر بیش از یک نام دستگاه تطابق داشته باشد، ممکن است مقدار آن از ۱۰۰٪ بیشتر شود.
اگر
.I method
برابر با
.B avg
باشد، آن‌گاه آمار جمع زده شده و سپس با تقسیم بر تعداد نام‌های دستگاه منطبق، میانگین گرفته می‌شود.
اگر
.I method
برابر با
.B min
یا
.B max
باشد، به‌ترتیب کمینه یا بیشینهٔ آمار برای دستگاه‌های منطبق گزارش می‌شود.
.TP
\fB\-P\fR \fIN\fR, \fB\-\-precision\fR=\fIN\fR
این گزینه دقت (تعداد ارقام اعشار) را برای گزارش مشخص می‌کند.
دقت پیش‌فرض \f2N\f1
می‌تواند روی مقداری به جز مقدار پیش‌فرض (۲) تنظیم شود.
توجه داشته باشید که فیلدهای
.B avgrq-sz
و
.B avgqu-sz
همیشه با دقت \f2N\f1+1 رقم اعشار گزارش می‌شوند.
این فیلدها معمولاً مقادیری کمتر از ۱ دارند.
.TP
\fB\-R\fR \fIpattern\fR, \fB\-\-regex\fR=\fIpattern\fR
این گزینه گزارش را به نام‌های دستگاه‌هایی که با عبارت باقاعدهٔ
.I pattern
تطابق دارند محدود می‌کند.
عبارت
.I pattern
داده‌شده به‌صورت یک عبارت باقاعده به سبک perl جستجو می‌شود و با هر بخشی از نام دستگاه تطابق خواهد یافت.
برای مثال، '^sd[a-zA-Z]+' با تمام نام‌های دستگاهی که با 'sd' آغاز شده و پس از آن یک یا چند نویسهٔ الفبایی قرار دارد تطابق می‌یابد.
مثلاً '^sd(a|b)$' تنها با 'sda' و 'sdb' تطابق خواهد داشت.
مثلاً 'sda$' با 'sda' تطابق دارد اما با 'sdab' تطابق ندارد.
همچنین برای گزینه‌های تجمیع، گزینهٔ
.B \-G
را ببینید.
.TP
\fB\-u\fR, \fB\-\-no-interpolation\fR
هنگام بازپخش مجموعه‌ای از بایگانی‌ها، مقادیر به‌طور پیش‌فرض بر اساس بازهٔ نمونه‌برداری درخواست‌شده (گزینهٔ \c
.BR \-t )
گزارش می‌شوند، نه بر اساس بازهٔ واقعی ثبت‌شده در بایگانی(ها).
بدون این گزینه، PCP مقادیر گزارش را بر اساس رکوردهای موجود در مجموعه بایگانی درون‌یابی می‌کند؛ این قابلیت به‌ویژه زمانی مفید است که از گزینهٔ
.B \-t
برای بازپخش مجموعه‌ای از بایگانی‌ها با بازهٔ نمونه‌برداری طولانی‌تر از آنچه بایگانی(ها) در ابتدا با آن ضبط شده‌اند استفاده شود.
با گزینهٔ
.BR \-u ،
گزارش‌دهیِ بدون درون‌یابی فعال می‌شود \- هر مقدار بر اساس بازهٔ زمانی ثبت اصلی در مجموعه بایگانی گزارش می‌گردد.
هنگامی که گزینهٔ
.B \-u
مشخص شده باشد، گزینهٔ
.B \-t
بی‌معنی و ناسازگار است زیرا بازهٔ بازپخش همواره همانند بازهٔ ثبت در مجموعه بایگانی است.
علاوه بر این،
.B \-u
تنها هنگام بازپخش بایگانی‌ها کاربرد دارد، به گزینهٔ
.B \-a
در
.BR PCPIntro (1)
مراجعه کنید، بنابراین اگر
.B \-u
تعیین شده باشد،
.B \-a
نیز باید تعیین گردد..TP
\fB\-V\fR, \fB\-\-version\fR
نمایش شماره نسخه و خروج.
.TP
\f3\-x\f1 \f2comma-separated-options\f1
فهرستی جداشده با کاما از یک یا چند گزینهٔ گزارش‌دهی گسترده را به شرح زیر مشخص می‌کند:
.br
\f3dm\fP - گزارش آمار برای دستگاه‌های منطقی device-mapper به جای دستگاه‌های SCSI،
.br
\f3t\fP - افزودن یک برچسب زمانی با قالب \f2ctime\fP(3) به ابتدای هر خط در گزارش،
.br
\f3h\fP - حذف سربرگ، که در غیر این صورت پس از هر ۲۴ نمونه گزارش می‌شود،
.br
\f3noidle\fP - عدم نمایش آمار برای دستگاه‌های بیکار (idle).
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.SH "گزارش (REPORT)"
ستون‌های موجود در گزارش
.B pcp-iostat
مفهوم زیر را دارند:
.TP
.B Timestamp
هنگامی که گزینهٔ \f3\-x t\fP مشخص شده باشد، این ستون برچسب زمانی در قالب \f3ctime\fP(3) است.
.TP
.B Device
نام دستگاه scsi را مشخص می‌کند، یا در صورتی که \f3-x dm\fP مشخص شده باشد، نام دستگاه منطقی device-mapper را نشان می‌دهد.
هنگامی که
.B \-G
مشخص شده باشد، این مقدار با روش تجمیع و عبارت باقاعده (regular expression) جایگزین می‌شود - گزینه‌های
.B \-G
و
.B \-R
در بالا را ببینید.
.TP
.B rrqm/s
تعداد درخواست‌های خواندن ادغام‌شده توسط زمان‌بند I/O در طول بازهٔ گزارش‌دهی، بر حسب نرخ بر ثانیه.
.TP
.B wrqm/s
تعداد درخواست‌های نوشتن ادغام‌شده توسط زمان‌بند I/O در طول بازهٔ گزارش‌دهی، بر حسب نرخ بر ثانیه.
.TP
.B r/s
تعداد درخواست‌های خواندن تکمیل‌شده توسط دستگاه (پس از ادغام‌ها)، بر حسب نرخ بر ثانیه در طول بازهٔ گزارش‌دهی.
.TP
.B w/s
تعداد درخواست‌های نوشتن تکمیل‌شده توسط دستگاه (پس از ادغام‌ها)، بر حسب نرخ بر ثانیه در طول بازهٔ گزارش‌دهی.
.TP
.B rkB/s
میانگین حجم داده‌های خوانده‌شده از دستگاه بر حسب کیلوبایت بر ثانیه در طول بازهٔ گزارش‌دهی.
.TP
.B wkB/s
میانگین حجم داده‌های نوشته‌شده بر روی دستگاه بر حسب کیلوبایت بر ثانیه در طول بازهٔ گزارش‌دهی.
.TP
.B avgrq-sz
میانگین اندازهٔ درخواست‌های I/O برای هر دو عمل خواندن و نوشتن به دستگاه بر حسب کیلوبایت در طول بازهٔ گزارش‌دهی.
.TP
.B avgqu-sz
میانگین طول صف درخواست‌های خواندن و نوشتن به دستگاه در طول بازهٔ گزارش‌دهی.
.TP
.B await
میانگین زمان بر حسب میلی‌ثانیه که درخواست‌های خواندن و نوشتن در طول بازهٔ گزارش‌دهی در صف دستگاه قرار گرفته (و سرویس‌دهی شده‌اند).
.TP
.B r_await
میانگین زمان بر حسب میلی‌ثانیه که درخواست‌های خواندن در طول بازهٔ گزارش‌دهی در صف دستگاه قرار گرفته (و سرویس‌دهی شده‌اند).
.TP
.B w_await
میانگین زمان بر حسب میلی‌ثانیه که درخواست‌های نوشتن در طول بازهٔ گزارش‌دهی در صف دستگاه قرار گرفته (و سرویس‌دهی شده‌اند).
.TP
.B %util
درصد زمانی در طول بازهٔ گزارش‌دهی که دستگاه مشغول پردازش درخواست‌ها بوده است.
مقدار ۱۰۰٪ نشان‌دهندهٔ اشباع دستگاه است..SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای تعیین نام‌های فایل و دایرکتوری مورد استفاده توسط PCP به کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP می‌تواند برای مشخص کردن یک فایل پیکربندی جایگزین، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده، استفاده شود.
.PP
برای متغیرهای محیطی مؤثر بر ابزارهای PCP، به \fBpmGetOptions\fP(3) مراجعه کنید.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه pcp
.B \-D
یا
.B \-\-debug
خروجی عیب‌یابی تکمیلی را روی
.I stderr
فعال می‌کند تا به ریشه‌یابی و دسته‌بندی مشکلات کمک کند، اگرچه این اطلاعات گاهی مبهم بوده و در درجه اول به منظور راهنمایی توسعه‌دهندگان تدوین شده است تا کاربران نهایی.
مقدار
.I debug
فهرستی از گزینه‌های اشکال‌زدایی است که با کاما از هم جدا شده‌اند؛ از
.BR pmdbg (1)
به همراه گزینه
.B \-l
برای به‌دست آوردن فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pcp (1)،
.BR iostat2pcp (1)،
.BR pmcd (1)،
.BR pmchart (1)،
.BR pmlogger (1)،
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ r_await w_await KBytes noidle avgqu avgrq scsi sdab perl
.\" +ok+ rrqm wrqm sda sdb rkB wkB avg zA {from regex} sd dm sz