نام (NAME)

pmlogsummary - محاسبه میانگین معیارهای ذخیره‌شده در مجموعه‌ای از آرشیوهای PCP

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

pmlogsummary [-abfFHiIlmMNsvVxyz?] [-B nbins] [-D debug] [-n pmnsfile] [-p precision] [-S starttime] [-T endtime] [-Z timezone] archive [metricname ...]

توضیحات (DESCRIPTION)

دستور pmlogsummary اطلاعات آماری درباره معیارهای از نوع عددی موجود در فایل‌های مجموعه‌ای از آرشیوهای Performance Co-Pilot (PCP) را چاپ می‌کند. خروجی پیش‌فرض، میانگین‌های زمانی را برای هر دو معیار شمارنده (counter) و غیرشمارنده چاپ می‌کند. مجموعه آرشیوها توسط archive مشخص می‌شود که فهرستی جداشده با ویرگول از نام‌ها است؛ هر یک می‌تواند نام پایه یک آرشیو یا نام یک دایرکتوری حاوی یک یا چند آرشیو باشد. آرشیوها معمولاً با استفاده از pmlogger(1) ایجاد می‌شوند.

معیارهای مورد نظر در آرگومان‌های metricname مشخص می‌شوند. اگر metricname یک گره غیربرگ در «فضای نام معیارهای کارایی» (PMNS(5)) باشد، آن‌گاه pmlogsummary به‌صورت بازگشتی در PMNS پیمایش کرده و تمام گره‌های برگ را گزارش می‌کند. اگر هیچ آرگومان metricname ارائه نشود، از ریشه فضای نام استفاده خواهد شد.

معیارهای دارای معناشناسی شمارنده پیش از ارزیابی به نرخ (rate) تبدیل می‌شوند.

گزینه‌ها (OPTIONS)

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

-a, --all: چاپ تمام اطلاعات. این گزینه معادل -blmMy است.
-b: چاپ هر دو شکل میانگین‌گیری، یعنی هم میانگین تصادفی (stochastic) و هم میانگین زمانی.
-B nbins, --bins=nbins: چاپ توزیع تقریبی مقادیر، با استفاده از دسته‌های هیستوگرام (histogram bins) به نحوی که بازه مقادیر (حداقل - حداکثر) برای هر معیار به‌طور مساوی به nbins دسته تقسیم می‌شود، و هر دسته فراوانی مقادیر مشاهده‌شده در بازه مربوطه را انباشته می‌کند. برای شرح نحوه گزارش توزیع مقادیر، به بخش “OUTPUT FORMAT” در زیر مراجعه کنید.
-f: قالب صفحه‌گسترده - از نویسه tab برای جداسازی هر فیلد چاپ‌شده استفاده می‌شود. این گزینه با این هدف در نظر گرفته شده که خروجی pmlogsummary بتواند مستقیماً به برنامه‌های کاربردی رایج صفحه‌گسترده وارد شود.
-F: قالب صفحه‌گسترده - از نویسه ویرگول برای جداسازی هر فیلد چاپ‌شده استفاده می‌شود. این گزینه با این هدف در نظر گرفته شده که خروجی pmlogsummary بتواند مستقیماً به برنامه‌های کاربردی رایج صفحه‌گسترده که از قالب مقادیر جداشده با ویرگول (.csv) پشتیبانی می‌کنند وارد شود.
-H, --header: چاپ یک سربرگ تک‌خطی در ابتدا که نشان می‌دهد هر فیلد نمایانگر چیست.
-i, --mintime: همچنین زمانی را که حداقل مقدار ثبت شده است، چاپ می‌کند. قالب این برچسب زمانی در بخش “OUTPUT FORMAT” در زیر شرح داده شده است.
-I, --maxtime: همچنین زمانی را که حداکثر مقدار ثبت شده است، چاپ می‌کند. قالب این برچسب زمانی در بخش “OUTPUT FORMAT” در زیر شرح داده شده است.
-l, --label: همچنین برچسب آرشیو را چاپ می‌کند که نسخه قالب آرشیو، زمان و تاریخ شروع و پایان پنجره زمانی آرشیو، و میزبانی را که مقادیر معیارهای کارایی از آن جمع‌آوری شده‌اند، نشان می‌دهد.
-m, --minimum: همچنین حداقل مقدار ثبت‌شده را برای هر معیار چاپ می‌کند.
-M, --maximum: همچنین حداکثر مقدار ثبت‌شده را برای هر معیار چاپ می‌کند.
-n pmnsfile, --namespace=pmnsfile: بارگذاری یک «فضای نام معیارهای کارایی» (PMNS(5)) جایگزین از فایل pmnsfile.
-N: فرونشاندن هرگونه هشدار ناشی از واکشی‌های جداگانه آرشیو (پیش‌فرض).
-p precision, --precision=precision: چاپ تمام اعداد ممیز شناور با precision رقم بعد از ممیز اعشار.
-s, --sum: چاپ (تنها) مجموع تمام مقادیر ثبت‌شده برای هر معیار.
-S starttime, --start=starttime: تنظیم starttime پنجره زمانی. برای شرح کامل ساختار نحوی starttime، به PCPIntro(1) مراجعه کنید.
-T endtime, --finish=endtime: تنظیم endtime پنجره زمانی. برای شرح کامل ساختار نحوی endtime، به PCPIntro(1) مراجعه کنید.
-v, --verbose: گزارش هشدارهای ناشی از واکشی‌های جداگانه آرشیو (با جزئیات کامل).
-V, --version: نمایش شماره نسخه و خروج.
-x: چاپ میانگین‌های تصادفی به جای میانگین‌های پیش‌فرض (میانگین‌های زمانی).
-y, --samples: همچنین تعداد نمونه‌های دیده‌شده در مجموعه آرشیوها را برای هر معیار چاپ می‌کند.
-z, --hostzone: تغییر منطقه زمانی به منطقه زمانی محلی میزبانی که منبع معیارهای کارایی است، همان‌طور که در رکورد برچسب آرشیو مشخص شده است.
-Z timezone, --timezone=timezone: به‌طور پیش‌فرض، pmlogsummary ساعت روز را بر اساس منطقه زمانی محلی سیستمی که pmlogsummary روی آن اجرا می‌شود، گزارش می‌کند. منطقه زمانی را به timezone در قالب متغیر محیطی TZ مطابق با توضیحات environ(7) تغییر می‌دهد..TP -?, --help نمایش پیام راهنمای استفاده و خروج.

قالب خروجی (OUTPUT FORMAT)

قالب خروجی pmlogsummary ساده و حداقلی است، چرا که هدف آن پردازش پس‌آیند با ابزارهای استاندارد است. این بدان معناست که هیچ یادداشت یا توضیح اضافی مرتبط با فیلدهای خروجی وجود ندارد، تا پردازش خودکار آن دشوار نشود. هدف این است که خروجی pmlogsummary را بتوان به قالبی تبدیل کرد که در برنامه‌های صفحه‌گسترده قابل استفاده باشد، برای گنجاندن در یک صفحهٔ وب مناسب باشد، یا هر کاربرد دیگری را پوشش دهد.

برای هر متریک، pmlogsummary یک خط خروجی به شکل زیر تولید می‌کند:

metricname  value(s) units

برای متریک‌های دارای چندین نمونه (instance)، pmlogsummary چندین خط خروجی به صورت زیر تولید می‌کند:

metricname ["instance 1"] value(s) units
metricname ["instance 2"] value(s) units
metricname ["instance N"] value(s) units

مقادیر چاپ‌شدهٔ value(s) برای هر متریک همیشه از این ترتیب پیروی می‌کنند: میانگین تصادفی، میانگین زمانی، کمینه، برچسب زمانی کمینه، بیشینه، برچسب زمانی بیشینه، تعداد، [محدودهٔ bin 1]، شمارش bin 1، ... [محدودهٔ bin nbins ]، شمارش bin nbins . مقادیر مجزا برای هر متریک با فاصله (space) از یکدیگر جدا می‌شوند (مگر اینکه از گزینهٔ -f استفاده شده باشد).

تمام متریک‌های شمارنده (counter) که برحسب واحدهای زمانی سنجیده می‌شوند، پیش از تبدیل نرخ و استفاده در محاسبات pmlogsummary به ثانیه تبدیل خواهند شد. مقادیر محاسبه‌شده برای این متریک‌ها نیز برحسب ثانیه چاپ می‌شوند.

واحدها در قالبی که توسط pmUnitsStr(3) توصیف شده است نمایش داده خواهند شد.

در صورت مشخص شدن هر یک از گزینه‌های -i یا -I ، دستور pmlogsummary بسته به بازهٔ زمانی اجرای خود، دو قالب مختلف برای برچسب زمانی تولید می‌کند. برای بازه‌ای بیش از ۲۴ ساعت، علاوه بر زمانی که بیشینه‌ها و/یا کمینه‌ها رخ داده‌اند، تاریخ نیز نمایش داده می‌شود. اگر گسترهٔ داده‌های در حال بررسی کمتر از ۲۴ ساعت باشد، قالبی دقیق‌تر به کار می‌رود (زمان با دقت میلی‌ثانیه اما بدون تاریخ نمایش داده می‌شود).

نکات (NOTES)

میانگین برای یک متریک منفرد به شرح زیر محاسبه می‌شود:

متریک‌های غیرشمارنده با استفاده از میانگین‌گیری تصادفی محاسبه می‌شوند - هر مشاهده در محاسبهٔ میانگین دارای وزن یکسانی است (مجموع همهٔ مقادیر تقسیم بر تعداد کل مقادیر، برای هر متریک).

متریک‌های شمارنده (به‌طور پیش‌فرض) با استفاده از میانگین‌گیری زمانی محاسبه می‌شوند، اما می‌توان از گزینهٔ -x استفاده کرد تا مشخص شود شمارنده‌ها در عوض با روش تصادفی میانگین‌گیری شوند. هنگام محاسبهٔ میانگین زمانی، مجموع حاصل‌ضرب هر مقدار نمونه در اختلاف زمانی بین هر نمونه، بر کل زمانی که متریک در آن ثبت شده تقسیم می‌شود.

متریک‌های شمارنده‌ای که اندازه‌گیری‌های آن‌ها ۹۰٪ از مجموعهٔ آرشیوها را پوشش نمی‌دهد، با یک علامت ستاره (*) در ابتدای نام متریک چاپ خواهند شد..SH "مثال‌ها (EXAMPLES)"

$ pmlogsummary -aN -p 1 -B 3 surf network.interface.out.bytes
Log Label (Log Format Version 1)
Performance metrics from host www.sgi.com
  commencing Tue Jan 14 20:50:50.317 1997
  ending     Wed Jan 29 10:13:07.387 1997
network.interface.out.bytes ["xpi0"] 202831.3 202062.5 20618.7 \
	1235067.7 971 [<=425435.0] 912 [<=830251.4] 42 [<=1235067.7] \
	17 byte / sec
network.interface.out.bytes ["xpi1"] 0.0 0.0 0.0 0.0 1033 [<=0.0] \
	1033 [] 0 [] 0 byte / sec
network.interface.out.bytes ["et0"] 0.0 0.0 0.0 0.0 1033 [<=0.0] \
	1033 [] 0 [] 0 byte / sec
network.interface.out.bytes ["lo0"] 899.0 895.2 142.6 9583.1 1031 \
	[<=3289.4] 1027 [<=6436.2] 3 [<=9583.1] 1 byte / sec

توضیحات مربوط به هر فیلد در سطر نخستِ خروجی آماری، که توصیف‌کننده یک نمونه از متریک network.interface.out.bytes است، در ادامه آمده است:

فیلد	مفهوم
["xpi0"]	نام نمونه
202831.3	میانگین تصادفی
202062.5	میانگین زمانی
20618.7	مقدار کمینه
1235067.7	مقدار بیشینه
971	تعداد کل مقادیر برای این نمونه
[<=425435.0]	بازه برای دسته اول (20618.7-425435.0)
912	تعداد مقادیر در دسته اول
[<=830251.4]	بازه برای دسته دوم (425435.0-830251.4)
42	تعداد مقادیر در دسته دوم
[<=1235067.7]	بازه برای دسته سوم (830251.4-1235067.7)
17	تعداد مقادیر در دسته سوم
byte / sec	واحدهای پایه برای این معیار

فایل‌ها (FILES)

$PCP_VAR_DIR/pmns/*: فایل‌های مشخصات پیش‌فرض PMNS
$PCP_LOG_DIR/pmlogger/<hostname>: دایرکتوری پیش‌فرض برای بایگانی‌های PCP شامل مقادیر معیارهای کارایی جمع‌آوری‌شده از میزبان <hostname>.

محیط PCP (PCP ENVIRONMENT)

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

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

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

گزینه‌های اشکال‌زدایی مختص pmlogsummary عبارتند از:

گزینه	توضیحات
appl0	گزارش معیارهای موجود در بایگانی، معیارهای انتخاب‌شده، مقادیر نمونه‌های معیار، رکوردهای نشانه‌گذاری (mark)، آغاز تکرار دوم
appl1	جزئیات دور زدن شمارنده‌ها (counter wrap)، داده‌های خام برای مقادیر اکسترمم و میانگین‌ها
appl2	ردیابی مقادیر بیشینه و کمینه
"همچنین ببینید (SEE ALSO)"
PCPIntro (1)،
pmchart (1)،
pmdumptext (1)،
pmlogextract (1)،
pmlogger (1)،
pmrep (1)،
pmval (1)،
PMAPI (3)،
pmUnitsStr (3)
و
PMNS (5).