نام (NAME)

pcp-vmstat, pmstat - نمای کلی و سطح‌بالا از کارایی سیستم

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

pcp [pcp options] vmstat [interval [samples]]

pmstat [-gLlPVxz?] [-a archive] [-A align] [-D debug] [-h host] [-H file] [-n pmnsfile] [-O offset] [-p port] [-s samples] [-S starttime] [-t interval] [-T endtime] [-Z timezone]

pcp-vmstat ...

توضیحات (DESCRIPTION)

دستور pmstat در هر واحد زمانی interval (پیش‌فرض ۵ ثانیه است)، یک خلاصهٔ تک‌خطی از کارایی سیستم ارائه می‌دهد. هدف pmstat پایش کارایی سیستم در بالاترین سطح است که پس از آن می‌توان از سایر ابزارها برای بررسی دقیق‌تر زیرسیستم‌هایی که در آن‌ها مشکلات احتمالی کارایی دیده می‌شود، استفاده کرد.

دستور pcp-vmstat یک پوشش (wrapper) ساده برای استفاده به همراه دستور pcp(1) است و برای برخی از کاربران ساختار خط فرمان آشناتری فراهم می‌کند. این دستور همچنین گزینهٔ گزارش تفصیلی را به‌طور پیش‌فرض فعال می‌کند؛ گزینهٔ -x را در ادامه ببینید.

می‌توان چند میزبان را با مشخص کردن بیش از یک میزبان از طریق چندین پرچم -h (برای پایش زنده)، یا با ارائهٔ نام فایل فهرست میزبان‌ها (که در آن هر خط شامل نام یک میزبان است) با -H، یا چندین پرچم -a (برای پایش گذشته‌نگر از مجموعه‌ای از بایگانی‌ها) پایش کرد.

به‌طور پیش‌فرض، pmstat معیارها را با اتصال به دیمن جمع‌آوری معیارهای کارایی (PMCD) روی میزبان محلی واکشی می‌کند. اگر گزینهٔ -L مشخص شده باشد، pmcd(1) دور زده شده و معیارها از PMDAهای روی میزبان محلی با استفاده از حالت مستقل PM_CONTEXT_LOCAL از pmNewContext(3) دریافت می‌شوند. هنگامی که گزینهٔ -h مشخص شود، pmstat به pmcd(1) روی host متصل شده و معیارها را از آنجا دریافت می‌کند. همان‌طور که در بالا ذکر شد، با مشخص کردن چندین پرچم -h می‌توان چندین میزبان را پایش کرد.

همچنین، اگر از گزینهٔ -a استفاده شود، معیارها از فایل‌های بایگانی Performance Co-Pilot مشخص‌شده توسط archive بازیابی می‌شوند؛ این آرگومان فهرستی از نام‌هاست که با کاما از هم جدا شده‌اند و هر یک می‌تواند نام پایهٔ یک بایگانی یا نام پوشه‌ای حاوی یک یا چند بایگانی باشد. با ارائهٔ چندین پرچم -a می‌توان چندین مجموعه بایگانی را بازپخش کرد. هنگامی که پرچم -a به‌کار رود، پرچم -P نیز می‌تواند برای توقف موقت خروجی پس از هر بازه استفاده شود.

حالت مستقل فقط می‌تواند به میزبان محلی متصل شود؛ استفاده از یک مجموعه بایگانی متضمن یک نام میزبان است؛ و تعیین یک میزبان مانع از استفاده از بایگانی می‌شود؛ بنابراین گزینه‌های -L، -a و -h مانعة‌الجمع هستند.

دستور pmstat می‌تواند کنترل زمان‌بندی خود را واگذار کرده و تحت کنترل یک فرایند pmtime(1) که از یک کادر گفتگوی گرافیکی (GUI) برای کنترل زمان استفاده می‌کند، عمل نماید. در این حالت، یا باید از گزینهٔ -g برای اجرای pmstat به عنوان تنها کلاینتِ نمونهٔ جدیدی از pmtime(1) استفاده شود، یا از -p برای متصل کردن pmstat به یک نمونهٔ موجود از pmtime(1) از طریق کانال IPC مشخص‌شده توسط آرگومان port استفاده گردد.

گزینه‌های -S، -T، -O و -A می‌توانند برای تعریف یک پنجره زمانی جهت محدود کردن نمونه‌های بازیابی‌شده، تعیین یک مبدأ اولیه درون پنجره زمانی، یا مشخص کردن تراز «طبیعی» زمان نمونه‌ها استفاده شوند؛ برای شرح کامل این گزینه‌ها به PCPIntro(1) مراجعه کنید..SH "گزینه‌ها (OPTIONS)" گزینه‌های دردسترس خط فرمان عبارتند از:

-a archive, --archive=archive: مقادیر سنجه‌های کارایی از مجموعه‌ای از فایل‌های بایگانی Performance Co-Pilot (PCP) که توسط آرگومان archive مشخص شده‌اند بازیابی می‌شوند؛ این آرگومان فهرستی از نام‌های جداشده با کاما است که هر یک می‌تواند نام پایه یک بایگانی یا نام دایرکتوری حاوی یک یا چند بایگانی باشد.
-A align, --align=align: اجبار نمونه اولیه به تراز شدن روی مرز یک واحد زمانی طبیعی align. برای شرح کامل ساختار نحوی align به PCPIntro(1) مراجعه کنید.
-g, --guimode: اجرای pmstat به‌عنوان کلاینت یک فرآیند سرور جدید pmtime(1) برای بازپخش داده‌های کارایی بایگانی‌شده با استفاده از رابط گرافیکی کاربر pmtime(1).
-h host, --host=host: واکشی سنجه‌های کارایی از pmcd(1) روی host، به‌جای localhost پیش‌فرض.
-H path, --hostsfile=path: تعیین path به فایلی حاوی مجموعه‌ای از نام‌های میزبان که pmcd(1) روی آن‌ها در حال اجرا است، به‌جای استفاده از localhost پیش‌فرض.
-K spec, --spec-local=spec: هنگام واکشی سنجه‌ها از یک بافت محلی (ببینید -L)، گزینه -K می‌تواند برای کنترل DSO PMDAهایی که باید در دسترس قرار گیرند استفاده شود. آرگومان spec از ساختار نحوی شرح داده شده در pmSpecLocalPMDA(3) پیروی می‌کند. می‌توان از بیش از یک گزینه -K استفاده کرد.
-l, --suffix: چاپ ۷ نویسه آخر نام میزبان در خلاصه‌هایی که شامل بیش از یک میزبان هستند (زمانی که بیش از یک گزینه -h روی خط فرمان مشخص شده باشد).
-L, --local-PMDA: استفاده از یک بافت محلی برای جمع‌آوری سنجه‌ها از DSO PMDAها روی میزبان محلی بدون PMCD. همچنین ببینید -K.
-n pmnsfile, --namespace=pmnsfile: بارگذاری یک فضای نام سنجه‌های کارایی (PMNS(5)) جایگزین از فایل pmnsfile.
-O origin, --origin=origin: هنگام گزارش سنجه‌های بایگانی‌شده، گزارش‌دهی را از origin درون پنجره زمانی آغاز می‌کند (ببینید -S و -T). برای شرح کامل ساختار نحوی origin به PCPIntro(1) مراجعه کنید.
-p port, --guiport=port: اتصال pmstat به یک نمونه فرآیند کنترل زمان موجود pmtime(1) از طریق کانال IPC مشخص‌شده با آرگومان port. این گزینه معمولاً تنها توسط ابزارهای دیگر، مانند pmchart(1)، هنگامی که pmstat را با کنترل زمان همگام‌سازی‌شده اجرا می‌کنند، استفاده می‌شود.
-P, --pause: مکث بین به‌روزرسانی‌ها برای بازپخش بایگانی.
-s samples, --samples=samples: گزینه samples تعداد نمونه‌هایی را که باید بازیابی و گزارش شوند تعیین می‌کند. اگر samples برابر ۰ باشد یا -s مشخص نشده باشد، pmstat به‌طور پیوسته نمونه‌برداری و گزارش خواهد کرد - این رفتار پیش‌فرض است.
-S starttime, --start=starttime: هنگام گزارش سنجه‌های بایگانی‌شده، گزارش محدود به رکوردهایی خواهد بود که در زمان starttime یا پس از آن ثبت شده‌اند. برای شرح کامل ساختار نحوی starttime به PCPIntro(1) مراجعه کنید.
-t interval, --interval=interval: تنظیم interval گزارش‌دهی به مقداری غیر از ۵ ثانیه پیش‌فرض. آرگومان interval از ساختار نحوی شرح داده شده در PCPIntro(1) پیروی می‌کند و در ساده‌ترین شکل می‌تواند یک عدد صحیح بدون علامت باشد (واحد ضمنی در این حالت ثانیه است).
-T endtime, --finish=endtime: هنگام گزارش سنجه‌های بایگانی‌شده، گزارش محدود به رکوردهایی خواهد بود که در زمان endtime یا پیش از آن ثبت شده‌اند.
-V, --version: نمایش شماره نسخه و خروج.
-x, --xcpu: گزینه سنجه‌های گسترش‌یافته CPU، باعث می‌شود سه سنجه اضافی پردازنده گزارش شوند، یعنی انتظار برای ورودی/خروجی ("wa")، زمان ربوده‌شده مجازی‌سازی ("st")، و زمان مهمان مجازی ("gu").
-z, --hostzone: تغییر منطقه زمانی گزارش‌دهی به منطقه زمانی محلی میزبانی که منبع سنجه‌های کارایی است، همان‌طور که از طریق یکی از گزینه‌های -h یا -a مشخص شده است.
-Z timezone, --timezone=timezone: به‌طور پیش‌فرض، pmtime زمان روز را بر اساس منطقه زمانی محلی در سیستمی که pmstat روی آن اجرا می‌شود گزارش می‌کند. گزینه -Z منطقه زمانی را به timezone در قالب متغیر محیطی TZ همان‌طور که در environ(7) شرح داده شده تغییر می‌دهد.
-?, --help: نمایش پیام راهنمای استفاده و خروج..SH "خروجی (OUTPUT)" خروجی حاصل از pmstat به خروجی استاندارد هدایت می‌شود و ستون‌های موجود در گزارش به شرح زیر تفسیر می‌شوند:
loadavg: میانگین بار کاری 1 minute.
memory: ستون swpd میانگین فضای swap مصرفی در طول بازه زمانی را به کیلوبایت نشان می‌دهد. ستون free میانگین حافظه آزاد در طول بازه زمانی را به کیلوبایت نشان می‌دهد. ستون buff میانگین حافظه بافر در حال استفاده در طول بازه زمانی را به کیلوبایت نشان می‌دهد. ستون cache میانگین حافظه کش در حال استفاده در طول بازه زمانی را به کیلوبایت نشان می‌دهد.

اگر مقادیر بزرگ شوند، به‌صورت مگابایت (پسوند m) یا گیگابایت (پسوند g) گزارش می‌شوند.

swap: معیارهای این بخش از ابزارهای سنجش هسته (kernel instrumentation) ارزش تحلیلی متفاوتی دارند. تلاش می‌شود میانگین تعداد صفحاتی که در هر ثانیه در طول بازه زمانی به حافظه وارد (pi) و از آن خارج (po) شده‌اند، گزارش شود. اگر معیارهای متناظر مبادله صفحه (page swapping) در دسترس نباشند، میانگین نرخ عملیات مبادله ورودی (si) و خروجی (so) در ثانیه در طول بازه زمانی گزارش می‌شود. غیرصفر بودن مقادیر «in» طبیعی است، اما اگر مقادیر «out» در یک بازه زمانی طولانی غیرصفر بمانند، سیستم دچار فشار حافظه (memory stress) است.

اگر مقادیر بزرگ شوند، به‌صورت هزاران عملیات در ثانیه (پسوند K) یا میلیون‌ها عملیات در ثانیه (پسوند M) گزارش می‌شوند.

io: ستون‌های bi و bo به ترتیب نشان‌دهنده میانگین نرخ عملیات ورودی و خروجی بلوک در ثانیه در طول بازه زمانی هستند. مگر در حالتی که تمام سیستم‌های فایل دارای اندازه بلوک ۱ کیلوبایتی باشند، این نرخ‌ها مستقیماً بیانگر کیلوبایت‌های منتقل‌شده نیستند.

اگر مقادیر بزرگ شوند، به‌صورت هزاران عملیات در ثانیه (پسوند K) یا میلیون‌ها عملیات در ثانیه (پسوند M) گزارش می‌شوند.

system: نرخ وقفه (in) و نرخ تعویض زمینه (cs). نرخ‌ها به‌صورت میانگین عملیات در ثانیه در طول بازه زمانی بیان می‌شوند. توجه داشته باشید که نرخ وقفه معمولاً حداقل HZ (نرخ وقفه ساعت، معمولاً ۱۰۰) وقفه در ثانیه است.

اگر مقادیر بزرگ شوند، به‌صورت هزاران عملیات در ثانیه (پسوند K) یا میلیون‌ها عملیات در ثانیه (پسوند M) گزارش می‌شوند.

cpu: درصد زمان پردازنده صرف‌شده برای اجرای کد کاربر و «nice user» (us)، کد سیستم و پردازش وقفه (sy)، و حلقه بی‌کاری (id).

اگر مقداری برای هر یک از معیارهای کارایی مرتبط در دسترس نباشد، مقدار آن به‌صورت «?» در خروجی نمایش داده می‌شود..SH "فایل‌ها (FILES)"

$PCP_VAR_DIR/pmns/*: فایل‌های مشخصات پیش‌فرض PMNS
$PCP_VAR_DIR/config/pmlogger/config.pmstat: پیکربندی pmlogger(1) برای ایجاد یک آرشیو مناسب جهت بازپخش با pmstat

محیط PCP (PCP ENVIRONMENT)

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

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

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

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

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

PCPIntro(1), pmclient(1), pmtime(1), PMAPI(3), pmNewContext(3), pcp.conf(5), pcp.env(5) و PMNS(5).