PCP-TAPESTAT(1) General Commands Manual PCP-TAPESTAT(1)

pcp-tapestat - گزارش آمار I/O دستگاه‌های نوار

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

دستور pcp-tapestat آمارهای I/O را برای دستگاه‌های نوار (tape devices) گزارش می‌کند.

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

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

مشخص می‌کند که آمار نام‌های دستگاه‌هایی که با عبارت باقاعده تعیین‌شده توسط گزینهٔ -R regex مطابقت دارند، بر اساس method تجمیع شوند. توجه داشته باشید که این تجمیع بر اساس نام‌های دستگاه‌های منطبق است (نه تجمیع زمانی). هنگامی که از -G استفاده می‌شود، ستون نام دستگاه به‌صورت method(regex) گزارش می‌گردد؛ به‌عنوان مثال، اگر -G sum -R 'st(0|1)$' مشخص شده باشد، ستون دستگاه به‌صورت sum(st(0|1)$) خواهد بود و آمارهای جمع‌بندی‌شده برای st0 و st1 در ستون‌های باقیمانده گزارش خواهد شد. اگر -G تعیین شده باشد اما -R مشخص نشده باشد، مقدار پیش‌فرض regex برابر با .* خواهد بود، یعنی منطبق با همهٔ نام‌های دستگاه‌ها. اگر method برابر با sum باشد، آمارها جمع زده می‌شوند. اگر method برابر با avg باشد، آمارها جمع زده شده و سپس با تقسیم بر تعداد نام‌های دستگاه‌های منطبق، میانگین‌گیری می‌شوند. اگر method برابر با min یا max باشد، به‌ترتیب کمترین یا بیشترین آمار دستگاه‌های منطبق گزارش می‌شود.
دقت (تعداد ارقام اعشار) را برای گزارش مشخص می‌کند. دقت پیش‌فرض N می‌تواند روی مقداری غیر از پیش‌فرض (۲) تنظیم شود. توجه داشته باشید که فیلدهای avgrq-sz و avgqu-sz همواره با دقت N+1 رقم اعشار گزارش می‌شوند. این فیلدها معمولاً مقادیری کمتر از ۱ دارند.
گزارش را به نام‌های دستگاه‌هایی که با عبارت باقاعدهٔ pattern مطابقت دارند محدود می‌کند. الگوی pattern داده‌شده به‌صورت عبارت باقاعده سبک perl جستجو می‌شود و با هر بخشی از نام دستگاه مطابقت خواهد داشت. برای مثال، '^st[0-9]+' با تمام نام‌های دستگاهی که با 'st' شروع شده و به دنبال آن یک یا چند عدد می‌آید مطابقت دارد. برای مثال، '^st(0|1)$' تنها با 'st0' و 'st1' مطابقت خواهد داشت. برای مثال، 'st0$' با 'st0' مطابقت دارد ولی با 'st1' خیر. همچنین برای گزینه‌های تجمیع، گزینهٔ -G را ببینید.
هنگام بازپخش یک مجموعه از بایگانی‌ها، به‌طور پیش‌فرض مقادیر بر اساس بازهٔ نمونه‌برداری درخواستی (گزینهٔ -t ) گزارش می‌شوند، نه بر اساس بازهٔ واقعی ثبت‌شده در بایگانی(ها). بدون این گزینه، PCP مقادیر گزارش‌شده را بر اساس رکوردهای موجود در مجموعهٔ بایگانی‌ها درون‌یابی می‌کند؛ این ویژگی به‌ویژه زمانی مفید است که از گزینهٔ -t برای بازپخش یک مجموعه بایگانی با بازهٔ نمونه‌برداری طولانی‌تر از آن‌چه بایگانی(ها) در اصل با آن ضبط شده‌اند استفاده شود. با گزینهٔ -u، گزارش‌دهیِ بدون درون‌یابی فعال می‌شود - هر مقدار بر اساس بازهٔ ضبط اصلی در مجموعهٔ بایگانی‌ها گزارش می‌شود. هنگامی که گزینهٔ -u مشخص شده باشد، گزینهٔ -t بی‌معنی بوده و ناسازگار است زیرا بازهٔ بازپخش همواره با بازهٔ ضبط در مجموعهٔ بایگانی یکسان است. علاوه بر این، -u تنها هنگام بازپخش بایگانی‌ها کاربرد دارد، گزینهٔ -a را در PCPIntro(1) ببینید، بنابراین اگر -u تعیین شود، -a نیز باید مشخص گردد.
نمایش شمارهٔ نسخه و خروج.
فهرستی جداشده با کاما از یک یا چند گزینهٔ گزارش‌دهی پیشرفته را به شرح زیر مشخص می‌کند:
t - درج برچسب زمانی با فرمت ctime(3) در ابتدای هر خط گزارش،
h - حذف عنوان (heading)، که در غیر این صورت هر ۲۴ نمونه یک بار گزارش می‌شود،
noidle - عدم نمایش آمار برای دستگاه‌های بیکار (idle).
-?, --help
نمایش پیام راهنما و خروج.

ستون‌های موجود در گزارش pcp-tapestat دارای تعابیر زیر هستند:

هنگامی که گزینهٔ -x t مشخص شده باشد، این ستون برچسب زمانی در قالب ctime(3) خواهد بود.
نام دستگاه نوار را مشخص می‌کند. هنگامی که -G مشخص شده باشد، این ستون با روش تجمیع و عبارت باقاعده جایگزین می‌شود - گزینه‌های -G و -R در بالا را ببینید.
تعداد درخواست‌های خواندن صادر شده که به‌صورت تعداد در ثانیه میانگین‌گیری‌شده در طول بازه بیان می‌شود.
تعداد درخواست‌های نوشتن صادر شده که به‌صورت تعداد در ثانیه میانگین‌گیری‌شده در طول بازه بیان می‌شود.
مقدار داده‌های خوانده‌شده برحسب کیلوبایت در ثانیه که در طول بازه میانگین‌گیری شده است.
مقدار داده‌های نوشته‌شده برحسب کیلوبایت در ثانیه که در طول بازه میانگین‌گیری شده است.
درصد انتظار خواندن - درصد زمانی در طول بازه که صرف انتظار برای تکمیل درخواست‌های خواندن شده است. این زمان از هنگام ارسال درخواست به لایهٔ میانی SCSI تا اعلام سیگنال تکمیل آن اندازه‌گیری می‌شود.
درصد انتظار نوشتن - درصد زمانی در طول بازه که صرف انتظار برای تکمیل درخواست‌های نوشتن شده است. این زمان از هنگام ارسال درخواست به لایهٔ میانی SCSI تا اعلام سیگنال تکمیل آن اندازه‌گیری می‌شود.
درصد انتظار کلی - درصد زمانی در طول بازه که صرف انتظار برای تکمیل هرگونه درخواست I/O (خواندن، نوشتن و سایر) شده است.
تعداد عملیات‌های I/O، بیان‌شده به‌صورت تعداد در ثانیه میانگین‌گیری‌شده در طول بازه، که در آن‌ها یک مقدار باقیماندهٔ (residual value) غیرصفر رخ داده است.
تعداد عملیات‌های I/O، بیان‌شده به‌صورت تعداد در ثانیه میانگین‌گیری‌شده در طول بازه، که به‌عنوان "other" (سایر) در نظر گرفته شده‌اند. سایر I/Oها شامل فراخوانی‌های ioctl انجام‌شده به راه‌انداز نوار و عملیات‌های ضمنی انجام‌شده توسط راه‌انداز نوار نظیر بازپیچی هنگام بستن (rewind on close برای دستگاه‌های نواری که این قابلیت را پیاده‌سازی کرده‌اند) می‌شود. این مقدار شامل هیچ‌یک از I/Oهایی که با روش‌هایی خارج از راه‌انداز نوار انجام شده باشند (مانند ioctlهای sg) نمی‌شود.

متغیرهای محیطی با پیشوند PCP_ برای تعیین پارامترهای نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند. در هر نصب، فایل /etc/pcp.conf حاوی مقادیر محلی برای این متغیرها است. متغیر $PCP_CONF ممکن است برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در pcp.conf(5) شرح داده شده است.

برای متغیرهای محیطی که ابزارهای PCP را تحت تأثیر قرار می‌دهند، pmGetOptions(3) را ببینید.

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

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

PCP Performance Co-Pilot