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

pcp-pidstat - گزارش آمار تسک‌های لینوکس

pcp [pcp options] pidstat [-I] [-l] [-R] [-r] [-k] [-U [username]] [-V] [-G processname] [-p pid1,pid2..] [-t interval] [-s count] [-a archive] [-B state] [-f format] [-Z timezone] [-z] [-?]

دستور pcp-pidstat برای نظارت بر تسک‌های منفرد در حال اجرا روی سیستم به کار می‌رود. با استفاده از گزینه‌های گوناگون، این ابزار به کاربر کمک می‌کند تا اطلاعات مفیدی درباره فرایندها مشاهده نماید. این اطلاعات شامل درصد استفاده از CPU، میزان مصرف حافظه و پشته، زمان‌بندی و اولویت است. به‌طور پیش‌فرض، pcp-pidstat داده‌های زنده را برای میزبان محلی گزارش می‌کند.

هنگامی که این دستور از طریق pcp(1) فراخوانی شود، گزینه‌های -h/--host، -a/--archive، -O/--origin، -s/--samples، -t/--interval، -Z/--timezone و چندین pcp options دیگر به‌طور غیرمستقیم در دسترس قرار می‌گیرند؛ برای توضیحات کامل درباره این گزینه‌ها به PCPIntro(1) مراجعه کنید.

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

در یک محیط SMP، مشخص می‌کند که میزان مصرف CPU تسک‌ها باید بر تعداد کل پردازنده‌ها تقسیم شود.
نمایش نام دستور فرایند و تمام آرگومان‌های آن.
گزارش اولویت بلادرنگ و اطلاعات خط‌مشی زمان‌بندی. مقدارهای زیر ممکن است نمایش داده شوند:

UID
شناسه کاربری واقعی تسک در حال نظارت.

USER
نام کاربر واقعی مالک تسک در حال نظارت.

PID
شناسه فرایند تسک در حال نظارت.

prio
اولویت بلادرنگ تسک در حال نظارت.

policy
خط‌مشی زمان‌بندی تسک در حال نظارت.

Command
نام دستور تسک.

گزارش خطاهای صفحه (page faults) و میزان مصرف حافظه. مقدارهای زیر ممکن است نمایش داده شوند:

UID
شناسه کاربری واقعی تسک در حال نظارت.

USER
نام کاربر واقعی مالک تسک در حال نظارت.

PID
شناسه فرایند تسک در حال نظارت.

minflt/s
تعداد کل خطاهای جزئی (minor faults) ایجادشده توسط تسک در هر ثانیه؛ خطاهایی که نیازی به بارگذاری صفحه حافظه از دیسک نداشته‌اند.

majflt/s
تعداد کل خطاهای عمده (major faults) ایجادشده توسط تسک در هر ثانیه؛ خطاهایی که نیازمند بارگذاری صفحه حافظه از دیسک بوده‌اند.

VSZ
Virtual Size: کل حافظه مجازی مورد استفاده کل تسک بر حسب کیلوبایت.

RSS
Resident Set Size: حافظه فیزیکی مبادله‌نشده (non-swapped) مورد استفاده تسک بر حسب کیلوبایت.

%MEM
سهم فعلی تسک از کل حافظه فیزیکی موجود بر حسب درصد.

Command
نام دستور تسک.

گزارش میزان مصرف پشته (stack). مقدارهای زیر ممکن است نمایش داده شوند:

UID
شناسه کاربری واقعی تسک در حال نظارت.

USER
نام کاربر واقعی مالک تسک در حال نظارت.

PID
شناسه فرایند تسک در حال نظارت.

StkSize
میزان حافظه بر حسب کیلوبایت که به عنوان پشته برای تسک رزرو شده، اما لزوماً استفاده نشده است.

StkRef
میزان حافظه بر حسب کیلوبایت که به عنوان پشته ارجاع داده شده و توسط تسک استفاده شده است.

Command
نام دستور تسک.

نمایش نام کاربر واقعی تسک‌های در حال نظارت به جای UID. اگر username مشخص شود، تنها تسک‌های متعلق به کاربر مشخص‌شده نمایش داده می‌شوند.
چاپ شماره نسخه و سپس خروج.
فقط فرایندهایی را نمایش می‌دهد که نام دستور آن‌ها شامل رشتهٔ processname باشد. این رشته می‌تواند یک عبارت منظم (regular expression) باشد.
تنها نمایش فرایندهایی که دارای PIDهای فهرست‌شده هستند.
تنظیم فاصله زمانی بین دو نمونه‌برداری. مقدار پیش‌فرض یک ثانیه است.
تنظیم تعداد نمونه‌هایی که باید نمایش داده شوند. از آنجا که نمونه اول برای تبدیل نرخ برخی از معیارها استفاده می‌شود، تعداد کل نمونه‌های گزارش‌شده یکی کمتر از count خواهد بود. حالت پیش‌فرض، ادامه‌دار و پیوسته است.
باعث می‌شود pcp-pidstat به جای اتصال به PMCD از آرشیو مشخص‌شده استفاده کند. آرگومان ورودی -a فهرستی از نام‌هاست که با کاما از هم جدا شده‌اند، و هر کدام می‌تواند نام پایه یک آرشیو یا نام دایرکتوری حاوی یک یا چند آرشیو باشد.
گزارش وضعیت فرایندها. آرگومان ورودی -B یکی از موارد زیر است:

detail
نمایش کل زمانی که فرایندها در هر یک از ۵ وضعیت مختلف سپری کرده‌اند

all
نمایش کل زمانی که فرایندها در وضعیت فعلی خود سپری کرده‌اند

[R,S,T,D,Z]
فهرستی از وضعیت‌های فرایند که با کاما از هم جدا شده‌اند. برای نمونه، -B R,S فرایندهایی را که هم‌اکنون در یکی از وضعیت‌های R یا S هستند گزارش می‌دهد و فرایندهایی را که در هر وضعیت دیگری باشند گزارش نخواهد کرد.

استفاده از رشته قالب‌بندی برای شکل‌دهی به برچسب زمان (timestamp). این قالب با متد datetime.strftime در python(1) استفاده می‌شود که مشابه با موارد شرح‌داده‌شده در strftime(3) است. یک رشته قالب خالی (یعنی "") برچسب‌های زمانی را از خروجی حذف خواهد کرد. مقدار پیش‌فرض در stdout برابر با %H:%M:%S است.
به‌طور پیش‌فرض، pcp-pidstat زمان روز را بر اساس منطقه زمانی محلی سیستمی که pcp-pidstat روی آن اجرا می‌شود گزارش می‌کند. گزینهٔ -Z منطقه زمانی را به timezone در قالب متغیر محیطی TZ همان‌طور که در environ(7) شرح داده شده است، تغییر می‌دهد.
تغییر منطقه زمانی گزارش‌دهی به منطقه زمانی محلی در میزبانی که منبع معیارهای کارایی است. هنگام بازپخش یک آرشیو PCP که در یک منطقه زمانی دیگر ضبط شده است، گزینهٔ -z تقریباً همیشه استفاده می‌شود (منطقه زمانی پیش‌فرض گزارش‌دهی، منطقه زمانی محلی است که ممکن است با منطقه زمانی آرشیو PCP یکسان نباشد).
-? , --help
نمایش پیام راهنمای استفاده و خروج.

دستور pcp-pidstat از دستور pidstat(1) الهام گرفته شده و هدف آن سازگاری در خط فرمان و قالب خروجی با آن است.

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

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

PCPIntro(1)، pcp(1)، pidstat(1)، python(1)، pmParseInterval(3)، strftime(3) و environ(7).

PCP Performance Co-Pilot