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

atopsar, pcp-atopsar - گزارش پیشرفتهٔ فعالیت سامانه (مرتبط با pcp-atop)

pcp [pcp options] atopsar [atop options] [-r file|date] [-h host] [-R cnt] [-b [YYYMMDD]hh:mm[ss]] [-e [YYYMMDD]hh:mm[ss]]
pcp [pcp options] atopsar [atop options] interval [samples]

برنامهٔ pcp-atopsar می‌تواند برای گزارش آمارها در سطح سامانه به کار رود.

در نخستین خط خلاصه دستور (که در آن بازه زمانی نمونه‌برداری مشخص نشده است)، pcp-atopsar داده‌ها را از یک فایل گزارش خام که پیش‌تر توسط pmlogger(1) (یا از طریق گزینهٔ -w در برنامهٔ pcp-atop) ضبط شده است، استخراج می‌کند.
می‌توانید نام فایل گزارش را با گزینهٔ -r برنامهٔ pcp-atopsar مشخص کنید. هنگامی که از فایل گزارش روزانهٔ pmlogger به نام $PCP_LOG_DIR/pmlogger/[host]/YYYYMMDD (که در آن YYYYMMDD بیانگر تاریخ است) استفاده می‌شود، به جای نام فایل می‌توان تاریخ مورد نظر با ساختار YYYYMMDD را با گزینهٔ -r تعیین کرد، یا اینکه از نام نمادین 'y' برای فایل گزارش روزانهٔ دیروز استفاده نمود (این عمل می‌تواند تکرار شود، بنابراین 'yyyy' نشان‌دهندهٔ فایل گزارش چهار روز پیش است). اگر گزینهٔ -r اصلاً مشخص نشود، فایل گزارش روزانهٔ امروز به صورت پیش‌فرض استفاده می‌شود.
به صورت پیش‌فرض، نام میزبان localhost هنگام تفکیک و دسترسی به بایگانی‌های pmlogger استفاده خواهد شد؛ با این حال، با استفاده از گزینهٔ -h می‌توان یک host جایگزین مشخص کرد.
زمان شروع و پایان گزارش را می‌توان با استفاده از گزینه‌های -b و -e به همراه یک آرگومان زمان با ساختار [YYYYMMDD]hh:mm[ss] تعیین کرد.

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

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

برخی پرچم‌های عمومی را می‌توان برای اثرگذاری بر رفتار برنامهٔ pcp-atopsar مشخص کرد:

به صورت پیش‌فرض، اگر چندین خط برای یک بازه زمانی نمایش داده شود، از درج برچسب زمان در ابتدای خط صرف‌نظر می‌شود. با این پرچم، برای هر خط خروجی یک برچسب زمان درج می‌شود (که پس‌پردازش را آسان‌تر می‌کند).
به صورت پیش‌فرض، منابع خاصی مانند دیسک‌ها و رابط‌های شبکه تنها زمانی نشان داده می‌شوند که در طول آن بازه زمانی فعال بوده باشند. با این پرچم، تمام منابع از یک نوع مشخص نشان داده می‌شوند، حتی اگر در طول آن بازه زمانی غیرفعال بوده باشند.
به صورت پیش‌فرض pcp-atopsar تنها در صورتی از رنگ‌ها استفاده می‌کند که خروجی به یک ترمینال (پنجره) هدایت شده باشد. این رنگ‌ها ممکن است نشان‌دهندهٔ رسیدن به درصد اشغال بحرانی (قرمز) یا نزدیک شدن به آن (فیروزه‌ای) برای منبعی خاص باشند. برای توضیحات دقیق‌تر دربارهٔ این قابلیت، صفحهٔ راهنمای atop (بخش COLORS) را ببینید.
با پرچم -x استفاده از رنگ‌ها بدون قید و شرط غیرفعال می‌شود.
به صورت پیش‌فرض pcp-atopsar تنها در صورتی از رنگ‌ها استفاده می‌کند که خروجی به یک ترمینال (پنجره) هدایت شده باشد. این رنگ‌ها ممکن است نشان‌دهندهٔ رسیدن به درصد اشغال بحرانی (قرمز) یا نزدیک شدن به آن (فیروزه‌ای) برای منبعی خاص باشند. برای توضیحات دقیق‌تر دربارهٔ این قابلیت، صفحهٔ راهنمای atop (بخش COLORS) را ببینید.
با پرچم -C همیشه از رنگ‌ها استفاده خواهد شد، حتی اگر خروجی به ترمینال هدایت نشده باشد.
استفاده از نشانگرها در پایان خط برای نشان دادن اینکه برای منابعی خاص، درصد اشغال بحرانی حاصل شده است ('*') یا تقریباً حاصل شده است ('+'). نشانگر '*' مشابه رنگ قرمز و نشانگر '+' مشابه رنگ فیروزه‌ای است. برای توضیحات دقیق‌تر دربارهٔ این رنگ‌ها، صفحهٔ راهنمای atop (بخش COLORS) را ببینید.
تکرار خط سربرگ درون یک گزارش به ازای هر N خط جزئیات. مقدار N در صورت ارسال خروجی به یک tty/پنجره به صورت پویا تعیین می‌شود (بسته به تعداد خطوط)؛ برای ارسال خروجی به یک فایل یا لوله (pipe)، این مقدار ۲۳ است.
خلاصه‌سازی cnt نمونه در قالب یک نمونه. هنگامی که فایل گزارش به عنوان مثال حاوی نمونه‌های ۱۰ دقیقه‌ای است، استفاده از پرچم '-R 6' گزارشی با یک نمونه برای هر ساعت را نمایش می‌دهد..PP پرچم‌های دیگر برای تعیین گزارش‌های مورد نیاز به کار می‌روند:
نمایش تمام گزارش‌های ممکن.
گزارش درباره میزان استفاده از CPU (در مجموع و به ازای هر پردازنده).
گزارش درباره میزان استفاده از GPU (به ازای هر GPU).
گزارش درباره موارد مرتبط با پردازنده، مانند میانگین بار و وقفه‌های سخت‌افزاری.
گزارش درباره فرایندها.
میزان اشغال کنونی حافظه و swap.
گزارش درباره فعالیت صفحه‌بندی (paging) و مبادله حافظه (swapping)، و تخصیص بیش‌ازحد (overcommitment).
گزارش درباره اطلاعات توقف فشار (PSI).
گزارش درباره میزان استفاده از حجم‌های منطقی (logical volumes).
گزارش درباره میزان استفاده از چندین دستگاه (دستگاه‌های چندگانه).
گزارش درباره میزان استفاده از دیسک‌ها.
گزارش درباره سیستم‌فایل‌های NFS سوارشده (mounted) روی کلاینت NFS.
گزارش درباره فعالیت کلاینت NFS.
گزارش درباره فعالیت سرور NFS.
گزارش درباره رابط‌های شبکه.
گزارش درباره خطاهای رابط‌های شبکه.
گزارش درباره ترافیک شبکه نسخه ۴ IP.
گزارش درباره خطاهای ترافیک نسخه ۴ IP.
گزارش عمومی درباره فعالیت لایه نسخه ۴ ICMP.
گزارش تفکیک‌شده بر اساس نوع درباره فعالیت لایه نسخه ۴ ICMP.
گزارش درباره ترافیک شبکه نسخه ۴ UDP.
گزارش درباره ترافیک شبکه نسخه ۶ IP.
گزارش درباره خطاهای ترافیک نسخه ۶ IP.
گزارش عمومی درباره فعالیت لایه نسخه ۶ ICMP.
گزارش تفکیک‌شده بر اساس نوع درباره فعالیت لایه نسخه ۶ ICMP.
گزارش درباره ترافیک شبکه نسخه ۶ UDP.
گزارش درباره ترافیک شبکه TCP.
گزارش درباره خطاهای ترافیک TCP.
گزارش درباره میزان استفاده از Infiniband.
گزارش درباره ۳ فرایند برتری که بیشترین ظرفیت پردازنده را مصرف می‌کنند. این گزارش تنها در صورت استفاده از فایل لاگ در دسترس است (نه هنگام مشخص کردن یک بازه زمانی).
گزارش درباره ۳ فرایند برتری که بیشترین حافظه مقیم (resident memory) را مصرف می‌کنند. این گزارش تنها در صورت استفاده از فایل لاگ در دسترس است (نه هنگام مشخص کردن یک بازه زمانی).
گزارش درباره ۳ فرایند برتری که بیشترین انتقال‌های دیسک را انجام می‌دهند. این گزارش تنها در صورت استفاده از فایل لاگ در دسترس است (نه هنگام مشخص کردن یک بازه زمانی).
گزارش درباره ۳ فرایند برتری که بیشترین انتقال‌های سوکت IPv4/IPv6 را انجام می‌دهند. این گزارش تنها در صورت استفاده از فایل لاگ در دسترس است (نه هنگام مشخص کردن یک بازه زمانی)..SH "گزینه‌های PCP ATOPSAR (PCP ATOPSAR OPTIONS)" گزینه‌های بلند خط فرمان PCP زیر نیز در دسترس هستند:
نمونهٔ اولیه را مجبور می‌کند تا بر روی مرز یک واحد زمانی طبیعی align تراز شود. برای شرح کامل نحو align به PCPIntro(1) مراجعه کنید.
مقادیر معیارهای کارایی از مجموعهٔ فایل‌های بایگانی Performance Co-Pilot (PCP) که با آرگومان archive مشخص شده‌اند، بازیابی می‌شوند؛ این آرگومان فهرستی از نام‌هاست که با کاما از هم جدا شده‌اند و هر کدام می‌تواند نام پایهٔ یک بایگانی یا نام یک دایرکتوری حاوی یک یا چند بایگانی باشد.
هنگام گزارش معیارهای بایگانی‌شده، گزارش محدود به رکوردهایی خواهد بود که در یا پیش از endtime ثبت شده‌اند. برای شرح کامل نحو endtime به PCPIntro(1) مراجعه کنید.
معیارهای کارایی را به‌جای localhost پیش‌فرض، از pmcd(1) روی host واکشی می‌کند.
از منطقهٔ زمانی محلی میزبان مبدأ معیارهای کارایی، همان‌گونه که توسط گزینه‌های --host یا --archive مشخص شده است، استفاده می‌کند. حالت پیش‌فرض استفاده از منطقهٔ زمانی میزبان محلی است.
از معیارهای hotproc برنامهٔ pmdaproc(1) استفاده می‌کند.
بازهٔ گزارش‌دهی interval را روی مقداری غیر از ۱ ثانیهٔ پیش‌فرض تنظیم می‌کند. آرگومان interval از نحو شرح داده شده در PCPIntro(1) پیروی می‌کند و در ساده‌ترین شکل می‌تواند یک عدد صحیح بدون علامت باشد (در این حالت، واحد ضمنی ثانیه است).
گزینهٔ samples تعداد نمونه‌هایی را که باید بازیابی و گزارش شوند تعیین می‌کند.
هنگام گزارش معیارهای بایگانی‌شده، گزارش محدود به رکوردهایی خواهد بود که در زمان یا پس از starttime ثبت شده‌اند. برای شرح کامل نحو starttime به PCPIntro(1) مراجعه کنید.
از timezone برای تاریخ و زمان استفاده می‌کند. timezone به قالب متغیر محیطی TZ است، همان‌طور که در environ(7) شرح داده شده است.
شمارهٔ نسخه را نمایش داده و خارج می‌شود..SH "توضیحات خروجی (OUTPUT DESCRIPTION)" بسته به گزارش درخواستی، تعدادی ستون با مقادیر خروجی تولید می‌شوند. این مقادیر عمدتاً به صورت تعداد رویدادها در ثانیه ارائه می‌شوند.

خروجی برای پرچم -c شامل ستون‌های زیر به ازای هر پردازنده (cpu) است:

درصد زمان پردازنده مصرف‌شده در حالت کاربر (کد برنامه) برای تمامی فرآیندهای فعالی که با مقدار nice صفر (پیش‌فرض) یا منفی (به معنای اولویت بالاتر از حد معمول) اجرا می‌شوند. مصرف پردازنده در حالت کاربر برای فرآیندهایی با مقدار nice بزرگ‌تر از صفر (اولویت پایین‌تر) در ستون nice% نشان داده می‌شود.
درصد زمان پردازنده مصرف‌شده در حالت کاربر (یعنی کد برنامه) برای تمامی فرآیندهایی که با مقدار nice بزرگ‌تر از صفر اجرا می‌شوند (به معنای اولویتی پایین‌تر از حد میانگین).
درصد زمان پردازنده مصرف‌شده در حالت سیستم (کد هسته) برای تمامی فرآیندهای فعال. درصد بالا معمولاً نشان‌دهنده صدور فراخوان‌های سیستمی متعدد است.
درصد زمان پردازنده مصرف‌شده برای مدیریت وقفه دستگاه‌ها.
درصد زمان پردازنده مصرف‌شده برای مدیریت وقفه‌های نرم‌افزاری.
درصد زمان پردازنده‌ای که توسط سایر ماشین‌های مجازی فعال روی همان سخت‌افزار تصاحب شده است.
درصد زمان پردازنده مصرف‌شده توسط سایر ماشین‌های مجازی فعال روی همان سخت‌افزار (با usr%/nice% هم‌پوشانی دارد).
درصد زمان بلااستفاده پردازنده در حالی که حداقل یکی از فرآیندهای در وضعیت انتظار، منتظر اتمام ورودی/خروجی (I/O) دیسک است.
درصد زمان بلااستفاده پردازنده به این دلیل که همه فرآیندها در وضعیت انتظار هستند اما منتظر I/O دیسک نیستند.

خروجی برای پرچم -g شامل ستون‌های زیر به ازای هر GPU است:

شماره GPU و شناسه گذرگاه (bus-ID) (جداشده با '/').
درصد مشغولی GPU در طول بازه زمانی.
درصد مشغولی حافظه GPU در طول بازه زمانی، یعنی زمان صرف‌شده برای صدور دسترسی‌های خواندن و نوشتن روی حافظه.
درصد اشغال حافظه در این لحظه.
کل حافظه در دسترس.
حافظه مصرف‌شده GPU در این لحظه.
نوع GPU.

خروجی برای پرچم -p شامل مقادیر زیر است:

تعداد تعویض فرآیند (که تعویض زمینه یا context switch نیز نامیده می‌شود) در ثانیه روی این پردازنده. تعویض فرآیند زمانی رخ می‌دهد که یک رشته فعال (یعنی رشته‌ای که از پردازنده استفاده می‌کند) وارد وضعیت انتظار شود یا برش زمانی خود را به‌طور کامل مصرف کرده باشد؛ سپس رشته دیگری برای استفاده از پردازنده انتخاب می‌شود.
تعداد وقفه‌های سخت‌افزاری رسیدگی‌شده در هر ثانیه روی این پردازنده.
تعداد رشته‌های جدید شروع‌شده در هر ثانیه.
میانگین بار سیستم (load average) که بیانگر میانگین تعداد رشته‌های حاضر در صف اجرا (runqueue) یا در وضعیت انتظار غیرقابل‌وقفه (معمولاً در انتظار ورودی/خروجی دیسک یا نوار) طی یک دقیقه گذشته است.
میانگین بار سیستم که بیانگر میانگین تعداد رشته‌های حاضر در صف اجرا یا در وضعیت انتظار غیرقابل‌وقفه (معمولاً در انتظار ورودی/خروجی دیسک یا نوار) طی ۵ دقیقه گذشته است.
میانگین بار سیستم که بیانگر میانگین تعداد رشته‌های حاضر در صف اجرا یا در وضعیت انتظار غیرقابل‌وقفه (معمولاً در انتظار ورودی/خروجی دیسک یا نوار) طی ۱۵ دقیقه گذشته است.

خروجی برای پرچم -P شامل اطلاعاتی درباره فرآیندها و رشته‌ها است:

تعداد رشته‌های جدید شروع‌شده در هر ثانیه.
تعداد کل فرآیندهای موجود در سیستم.
تعداد فرآیندهای زامبی (zombie) موجود در سیستم.
تعداد کل رشته‌های موجود در سیستم در وضعیت «running».
تعداد کل رشته‌های موجود در سیستم در وضعیت «interruptible sleeping».
تعداد کل رشته‌های موجود در سیستم در وضعیت «uninterruptible sleeping».
تعداد کل رشته‌های موجود در سیستم در وضعیت «idle» (خواب غیرقابل‌وقفه اما شمارش‌نشده در میانگین بار سیستم).

خروجی برای پرچم -m شامل اطلاعاتی درباره میزان استفاده از حافظه اصلی و swap است:

کل اندازه حافظه اصلی قابل استفاده.
اندازه حافظه اصلی در دسترس در این لحظه (تصویر لحظه‌ای).
حافظه اصلی مصرف‌شده در این لحظه برای کش کردن بلوک‌های فراداده (تصویر لحظه‌ای).
حافظه اصلی مصرف‌شده در این لحظه برای کش کردن بلوک‌های داده (تصویر لحظه‌ای).
مقدار حافظه در کش صفحه (page cache) که در این لحظه هنوز باید روی دیسک تخلیه شود (تصویر لحظه‌ای).
حافظه اصلی مصرف‌شده در این لحظه برای حافظه تخصیص‌یافته به صورت پویا توسط هسته (تصویر لحظه‌ای).
کل اندازه فضای swap در این لحظه (تصویر لحظه‌ای).
فضای swap در دسترس در این لحظه (تصویر لحظه‌ای).

خروجی برای پرچم -s شامل اطلاعاتی درباره بسامد تعویض حافظه (swapping) است:

تعداد صفحات بررسی‌شده در ثانیه ناشی از این واقعیت که حافظه آزاد به زیر آستانه مشخصی افت کرده است.
تعداد صفحات حافظه خوانده‌شده توسط سیستم از دستگاه swap در هر ثانیه.
تعداد صفحات حافظه نوشته‌شده توسط سیستم روی دستگاه swap در هر ثانیه.
تعداد فرآیندهای کشته‌شده در طول بازه گذشته به دلیل کمبود حافظه/swap. مقدار -1 به این معنی است که این شمارنده توسط نسخه فعلی هسته پشتیبانی نمی‌شود..TP 12 commitspc فضای حافظه مجازی متعهدشده، یعنی فضای مجازی رزروشده برای تمامی تخصیص‌های فضای حافظه خصوصی فرایندها.
حداکثر سقف مجاز برای فضای متعهدشده، که به‌طور پیش‌فرض اندازه swap به اضافه ۵۰٪ از اندازه حافظه است. هسته تنها در صورتی بررسی می‌کند که آیا فضای متعهدشده از این سقف فراتر رفته است یا خیر که مدیریت سخت‌گیرانه overcommit پیکربندی شده باشد (vm.overcommit_memory برابر با 2 باشد).

خروجی پرچم -B شامل اطلاعات فشار واماندگی (PSI یا Pressure Stall Information) است:

میانگین درصد فشار در طول بازه زمانی برای دسته‌بندی 'CPU some'.
میانگین درصد فشار در طول بازه زمانی برای دسته‌بندی 'memory some'.
میانگین درصد فشار در طول بازه زمانی برای دسته‌بندی 'memory full'.
میانگین درصد فشار در طول بازه زمانی برای دسته‌بندی 'I/O some'.
میانگین درصد فشار در طول بازه زمانی برای دسته‌بندی 'I/O full'.

خروجی پرچم‌های -l (LVM)، -f (MD) و -d (دیسک سخت) شامل ستون‌های زیر به ازای هر واحد فعال است:

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

خروجی پرچم -n شامل اطلاعات مربوط به فعالیت روی سیستم‌فایل‌های سوارشده NFS (سمت کلاینت) است:

دستگاه سوارشده شامل نام سرور و دایرکتوری در حال سوار شدن سرور.
کیلوبایت داده که به‌صورت فیزیکی توسط فرایندهای در حال اجرا روی کلاینت NFS از سرور NFS خوانده شده است.
کیلوبایت داده که به‌صورت فیزیکی توسط فرایندهای در حال اجرا روی کلاینت NFS روی سرور NFS نوشته شده است.
هنگامی که سیستم‌فایل NFS در طول این بازه زمانی سوار شده باشد، وضعیت 'M' نمایش داده می‌شود.

خروجی پرچم -j شامل اطلاعات مربوط به فعالیت کلاینت NFS است:

تعداد فراخوانی‌های RPC صادرشده به سرور(های) NFS در هر ثانیه.
تعداد فراخوانی‌های RPC خواندن صادرشده به سرور(های) NFS در هر ثانیه.
تعداد فراخوانی‌های RPC نوشتن صادرشده به سرور(های) NFS در هر ثانیه.
تعداد فراخوانی‌های RPC بازفرستاده‌شده در هر ثانیه.
تعداد تازه‌سازی‌های مجوز در هر ثانیه.

خروجی پرچم -J شامل اطلاعات مربوط به فعالیت سرور NFS است:

تعداد فراخوانی‌های RPC دریافت‌شده از کلاینت(های) NFS در هر ثانیه.
تعداد فراخوانی‌های RPC خواندن دریافت‌شده از کلاینت(های) NFS در هر ثانیه.
تعداد فراخوانی‌های RPC نوشتن دریافت‌شده از کلاینت(های) NFS در هر ثانیه.
تعداد مگابایت در ثانیه که در پاسخ به درخواست‌های خواندن کلاینت‌ها بازگردانده شده است.
تعداد مگابایت در ثانیه که در درخواست‌های نوشتن توسط کلاینت‌ها ارسال شده است.
تعداد درخواست‌های رسیدگی‌شده در هر ثانیه از طریق TCP.
تعداد درخواست‌های رسیدگی‌شده در هر ثانیه از طریق UDP.

خروجی پرچم -i اطلاعاتی درباره میزان استفاده از رابط‌های شبکه ارائه می‌دهد:

نام رابط شبکه.
درصد مشغول بودن این رابط شبکه. اگر سرعت خط این رابط قابل تعیین نباشد (برای مثال برای رابط‌های مجازی)، یک علامت سؤال نمایش داده می‌شود.
تعداد بسته‌های دریافت‌شده از این رابط در هر ثانیه.
تعداد بسته‌های ارسال‌شده به این رابط در هر ثانیه.
تعداد کیلوبایت‌های دریافت‌شده از این رابط در هر ثانیه.
تعداد کیلوبایت‌های ارسال‌شده از طریق این رابط در هر ثانیه.
تعداد مگابیت مؤثر دریافت‌شده در هر ثانیه.
تعداد مگابیت مؤثر ارسال‌شده در هر ثانیه.
سرعت خط بر حسب تعداد مگابیت در هر ثانیه. اگر سرعت خط قابل تعیین نباشد (مانند رابط‌های مجازی)، مقدار 0 نشان داده می‌شود.
به دنبال سرعت خط، نشانه 'f' (تمام‌دوطرفه یا full duplex) یا 'h' (نیمه‌دوطرفه یا half duplex) می‌آید.

خروجی پرچم -I اطلاعاتی درباره خطاهای شناسایی‌شده برای رابط‌های شبکه ارائه می‌دهد:

نام رابط شبکه.
تعداد بسته‌های معیوب دریافت‌شده از این رابط در هر ثانیه..TP 12 oerr/s تعداد دفعاتی در ثانیه که ارسال بسته به این رابط با شکست مواجه شد.
تعداد تصادم‌های (collisions) رخ‌داده در ثانیه هنگام ارسال بسته‌ها.
تعداد بسته‌های دریافتی دور انداخته‌شده در ثانیه به دلیل کمبود فضای بافر در سیستم محلی.
تعداد بسته‌های ارسالی دور انداخته‌شده در ثانیه به دلیل کمبود فضای بافر در سیستم محلی.
تعداد خطاهای ترازبندی فریم (alignment-errors) رخ‌داده در ثانیه بر روی بسته‌های دریافتی.
تعداد خطاهای حامل (carrier-errors) رخ‌داده در ثانیه بر روی بسته‌های ارسالی.

خروجی مربوط به پرچم -w اطلاعاتی دربارهٔ میزان استفاده از لایهٔ IPv4 ارائه می‌دهد (نام‌های رسمی SNMP در پرانتز قرار دارند):

تعداد دیتاگرام‌های IP دریافتی از رابط‌ها در ثانیه، شامل موارد دریافت‌شده همراه با خطا (ipInReceives).
تعداد دیتاگرام‌های IP در ثانیه که پروتکل‌های محلی لایه‌های بالاتر جهت ارسال به IP تحویل داده‌اند (ipOutRequests).
تعداد دیتاگرام‌های IP دریافتی در ثانیه که با موفقیت به لایه‌های پروتکل بالاتر تحویل داده شده‌اند (ipInDelivers).
تعداد دیتاگرام‌های IP دریافتی در ثانیه که این موجودیت مقصد نهایی IP آن‌ها نبوده و در نتیجه برای بازفرستادن (forward) آن‌ها تلاش شده است (ipForwDatagrams).
تعداد دیتاگرام‌های IP که در ثانیه با موفقیت بازترکیب شده‌اند (ipReasmOKs).
تعداد قطعات (fragments) دیتاگرام IP تولیدشده در ثانیه در این موجودیت (ipFragCreates).

خروجی مربوط به پرچم -W اطلاعاتی دربارهٔ خطاهای شناسایی‌شده در لایهٔ IPv4 ارائه می‌دهد (نام‌های رسمی SNMP در پرانتز قرار دارند):

تعداد دیتاگرام‌های IP ورودی در ثانیه که مشکلی برای جلوگیری از ادامهٔ پردازش آن‌ها وجود نداشته اما دور انداخته شده‌اند، به عنوان مثال به دلیل کمبود فضای بافر (ipInDiscards).
تعداد دیتاگرام‌های IP ورودی در ثانیه که به دلیل خطا در سرایند (header) بستهٔ IP دور انداخته شده‌اند (ipInHdrErrors).
تعداد دیتاگرام‌های IP ورودی در ثانیه که دور انداخته شده‌اند، زیرا نشانی IP در فیلد مقصد برای دریافت توسط این موجودیت معتبر نبوده است (ipInAddrErrors).
تعداد بسته‌های ورودی در ثانیه که به دلیل یک پروتکل ناشناخته یا پشتیبانی‌نشده دور انداخته شده‌اند (ipInUnknownProtos).
تعداد شرایط اتمام مهلت زمانی (timeout) در ثانیه در حین انتظار برای سایر قطعات جهت بازترکیب موفقیت‌آمیز (ipReasmTimeout).
تعداد شکست‌های شناسایی‌شده در ثانیه توسط الگوریتم بازترکیب IP (ipReasmFails).
تعداد دیتاگرام‌های IP خروجی در ثانیه که هیچ مشکلی برای جلوگیری از ادامهٔ پردازش آن‌ها وجود نداشته اما دور انداخته شده‌اند، برای نمونه به دلیل کمبود فضای بافر (ipOutDiscards).
تعداد دیتاگرام‌های IP در ثانیه که به دلیل پیدا نشدن مسیر دور انداخته شده‌اند (ipOutNoRoutes).

خروجی مربوط به پرچم -y اطلاعاتی دربارهٔ میزان استفادهٔ کلی از لایهٔ ICMPv4 و برخی اطلاعات به تفکیک نوع پیام ICMP ارائه می‌دهد (نام‌های رسمی SNMP در پرانتز قرار دارند):

تعداد پیام‌های ICMP (از هر نوعی) که در ثانیه در این موجودیت دریافت شده‌اند (icmpInMsgs).
تعداد پیام‌های ICMP (از هر نوعی) که در ثانیه از این موجودیت ارسال شده‌اند (icmpOutMsgs).
تعداد پیام‌های Echo (درخواست یا request) پروتکل ICMP دریافت‌شده در ثانیه (icmpInEchos).
تعداد پیام‌های Echo-Reply پروتکل ICMP دریافت‌شده در ثانیه (icmpInEchoReps).
تعداد پیام‌های Echo (درخواست یا request) پروتکل ICMP ارسال‌شده در ثانیه (icmpOutEchos).
تعداد پیام‌های Echo-Reply پروتکل ICMP ارسال‌شده در ثانیه (icmpOutEchoReps).

خروجی مربوط به پرچم -Y اطلاعاتی دربارهٔ سایر انواع پیام‌های ICMPv4 ارائه می‌دهد (نام‌های رسمی SNMP در پرانتز قرار دارند):

تعداد پیام‌های ICMP در ثانیه که دریافت شده‌اند ولی مشخص شد که خطاهای مختص ICMP دارند (icmpInErrors).
تعداد پیام‌های Source Quench پروتکل ICMP دریافتی در ثانیه (icmpInSrcQuenchs).
تعداد پیام‌های Redirect پروتکل ICMP دریافتی در ثانیه (icmpInRedirects).
تعداد پیام‌های Destination Unreachable پروتکل ICMP دریافتی در ثانیه (icmpInDestUnreachs).
تعداد پیام‌های Time Exceeded پروتکل ICMP دریافتی در ثانیه (icmpOutTimeExcds).
تعداد پیام‌های ICMP در ثانیه که ارسال شده‌اند اما مشخص شد دارای خطاهای مختص ICMP هستند (icmpOutErrors).
تعداد پیام‌های Source Quench پروتکل ICMP ارسالی در ثانیه (icmpOutSrcQuenchs).
تعداد پیام‌های Redirect پروتکل ICMP ارسالی در ثانیه (icmpOutRedirects).
تعداد پیام‌های Destination Unreachable پروتکل ICMP ارسالی در ثانیه (icmpOutDestUnreachs).
تعداد پیام‌های Time Exceeded پروتکل ICMP ارسالی در ثانیه (icmpOutTimeExcds).

خروجی مربوط به پرچم -u اطلاعاتی دربارهٔ میزان استفاده از لایهٔ UDPv4 ارائه می‌دهد (نام‌های رسمی SNMP در پرانتز قرار دارند):

تعداد دیتاگرام‌های UDP در ثانیه که به کاربران UDP تحویل داده شده است (udpInDatagrams).
تعداد دیتاگرام‌های UDP ارسال‌شده در ثانیه از این موجودیت (udpOutDatagrams).
تعداد دیتاگرام‌های UDP دریافتی در ثانیه که به دلایلی غیر از نبود برنامه در درگاه مقصد، قابل تحویل نبوده‌اند (udpInErrors)..TP 12 noport/s تعداد دیتاگرام‌های UDP دریافت‌شده در هر ثانیه که هیچ برنامه‌ای برای آن‌ها در درگاه مقصد وجود نداشت (udpNoPorts).

خروجی مربوط به پرچم -z اطلاعاتی دربارهٔ میزان بهره‌برداری از لایهٔ IPv6 ارائه می‌دهد (نام‌های رسمی SNMP درون پرانتزها):

تعداد دیتاگرام‌های ورودی IPv6 دریافت‌شده از رابط‌ها در هر ثانیه، شامل مواردی که با خطا دریافت شده‌اند (ipv6IfStatsInReceives).
تعداد دیتاگرام‌های IPv6 در هر ثانیه که پروتکل‌های محلی لایهٔ بالاتر در درخواست‌های ارسال به IP تحویل داده‌اند (ipv6IfStatsOutRequests). این شمارنده شامل هیچ‌یک از دیتاگرام‌های هدایت‌شده نمی‌شود.
تعداد بسته‌های چندپخشی (multicast) در هر ثانیه که توسط رابط دریافت شده‌اند (ipv6IfStatsInMcastPkts).
تعداد بسته‌های چندپخشی (multicast) در هر ثانیه که به رابط ارسال شده‌اند (ipv6IfStatsOutMcastPkts).
تعداد دیتاگرام‌های IP که در هر ثانیه با موفقیت به پروتکل‌های کاربری IPv6، از جمله ICMP، تحویل داده شده‌اند (ipv6IfStatsInDelivers).
تعداد دیتاگرام‌های IPv6 که در هر ثانیه با موفقیت بازترکیب شده‌اند (ipv6IfStatsReasmOKs).
تعداد قطعات دیتاگرام IPv6 تولیدشده در هر ثانیه در این موجودیت (ipv6IfStatsOutFragCreates).

خروجی مربوط به پرچم -Z اطلاعاتی دربارهٔ خطاهای شناسایی‌شده در لایهٔ IPv6 ارائه می‌دهد (نام‌های رسمی SNMP درون پرانتزها):

تعداد دیتاگرام‌های ورودی IPv6 در هر ثانیه که مشکلی برای جلوگیری از ادامهٔ پردازش آن‌ها وجود نداشت اما دور ریخته شدند، برای نمونه به دلیل کمبود فضای بافر (ipv6IfStatsInDiscards).
تعداد دیتاگرام‌های ورودی دور ریخته‌شده در هر ثانیه به دلیل خطا در سرآیند IPv6 (ipv6IfStatsInHdrErrors).
تعداد دیتاگرام‌های ورودی دور ریخته‌شده در هر ثانیه به این دلیل که نشانی IPv6 در فیلد مقصد برای دریافت توسط این موجودیت معتبر نبود (ipv6IfStatsInAddrErrors).
تعداد دیتاگرام‌های با نشانی محلی در هر ثانیه که به دلیل پروتکل ناشناخته یا پشتیبانی‌نشده دور ریخته شدند (ipv6IfStatsInUnknownProtos).
تعداد دفعات اتمام مهلت زمانی در هر ثانیه در حین انتظار برای سایر قطعات IPv6 جهت بازترکیب موفقیت‌آمیز (ipv6ReasmTimeout).
تعداد خطاهای شناسایی‌شده در هر ثانیه توسط الگوریتم بازترکیب IPv6 (ipv6IfStatsReasmFails).
تعداد دیتاگرام‌های خروجی IPv6 در هر ثانیه که مشکلی برای جلوگیری از ادامهٔ پردازش آن‌ها وجود نداشت اما دور ریخته شدند، برای نمونه به دلیل کمبود فضای بافر (ipv6IfStatsOutDiscards).
تعداد دیتاگرام‌های IPv6 دور ریخته‌شده در هر ثانیه به دلیل پیدا نشدن مسیر (ipv6IfStatsInNoRoutes).

خروجی مربوط به پرچم -k اطلاعاتی دربارهٔ میزان بهره‌برداری کلی از لایهٔ ICMPv6 و اطلاعاتی به تفکیک نوع پیام‌های ICMP ارائه می‌دهد (نام‌های رسمی SNMP درون پرانتزها):

تعداد پیام‌های ICMPv6 (از هر نوع) دریافت‌شده در هر ثانیه در رابط (ipv6IfIcmpInMsgs).
تعداد پیام‌های ICMPv6 (از هر نوع) ارسال‌شده در هر ثانیه از این موجودیت (ipv6IfIcmpOutMsgs).
تعداد پیام‌های ICMPv6 دریافت‌شده در هر ثانیه که دارای خطاهای خاص ICMP بوده‌اند، مانند چک‌سام نادرست ICMP، طول نادرست و غیره (ipv6IfIcmpInErrors).
تعداد پیام‌های Neighbor Solicit مربوط به ICMP دریافت‌شده در هر ثانیه (ipv6IfIcmpInNeighborSolicits).
تعداد پیام‌های Neighbor Advertisement مربوط به ICMP دریافت‌شده در هر ثانیه (ipv6IfIcmpInNeighborAdvertisements).
تعداد پیام‌های Neighbor Solicit مربوط به ICMP ارسال‌شده در هر ثانیه (ipv6IfIcmpOutNeighborSolicits).
تعداد پیام‌های Neighbor Advertisement مربوط به ICMP ارسال‌شده در هر ثانیه (ipv6IfIcmpOutNeighborAdvertisements).

خروجی مربوط به پرچم -K اطلاعاتی دربارهٔ سایر انواع پیام‌های ICMPv6 ارائه می‌دهد (نام‌های رسمی SNMP درون پرانتزها):

تعداد پیام‌های Echo (درخواست) مربوط به ICMP دریافت‌شده در هر ثانیه (ipv6IfIcmpInEchos).
تعداد پیام‌های Echo-Reply مربوط به ICMP دریافت‌شده در هر ثانیه (ipv6IfIcmpInEchoReplies).
تعداد پیام‌های Echo-Reply مربوط به ICMP ارسال‌شده در هر ثانیه (ipv6IfIcmpOutEchoReplies).
تعداد پیام‌های Destination Unreachable مربوط به ICMP دریافت‌شده در هر ثانیه (ipv6IfIcmpInDestUnreachs).
تعداد پیام‌های Destination Unreachable مربوط به ICMP ارسال‌شده در هر ثانیه (ipv6IfIcmpOutDestUnreachs).
تعداد پیام‌های Redirect مربوط به ICMP دریافت‌شده در هر ثانیه (ipv6IfIcmpInRedirects).
تعداد پیام‌های Redirect مربوط به ICMP ارسال‌شده در هر ثانیه (ipv6IfIcmpOutRedirect).
تعداد پیام‌های Time Exceeded مربوط به ICMP دریافت‌شده در هر ثانیه (ipv6IfIcmpInTimeExcds).
تعداد پیام‌های Time Exceeded مربوط به ICMP ارسال‌شده در هر ثانیه (ipv6IfIcmpOutTimeExcds).

خروجی مربوط به پرچم -U اطلاعاتی دربارهٔ میزان بهره‌برداری از لایهٔ UDPv6 ارائه می‌دهد (نام‌های رسمی SNMP درون پرانتزها):

تعداد دیتاگرام‌های UDPv6 تحویل داده‌شده به کاربران UDP در هر ثانیه (udpInDatagrams)،
تعداد دیتاگرام‌های UDPv6 ارسال‌شده از این موجودیت در هر ثانیه (udpOutDatagrams)،
تعداد دیتاگرام‌های UDPv6 دریافت‌شده در هر ثانیه که به دلایلی غیر از نبود برنامه در درگاه مقصد، تحویل داده نشدند (udpInErrors).
تعداد دیتاگرام‌های UDPv6 دریافت‌شده در هر ثانیه که هیچ برنامه‌ای برای آن‌ها در درگاه مقصد وجود نداشت (udpNoPorts).

خروجی مربوط به پرچم -t اطلاعاتی دربارهٔ میزان بهره‌برداری از لایهٔ TCP ارائه می‌دهد (نام‌های رسمی SNMP درون پرانتزها):

تعداد سگمنت‌های دریافت‌شده در هر ثانیه، شامل مواردی که با خطا دریافت شده‌اند (tcpInSegs)..TP 12 outsegs/s تعداد قطعه‌های (segment) ارسال‌شده در ثانیه، به استثنای قطعه‌هایی که فقط شامل بایت‌های (octet) بازفرستاده‌شده هستند (tcpOutSegs).
تعداد بازگشایی‌های فعال در ثانیه که توسط این نهاد پشتیبانی شده است (tcpActiveOpens).
تعداد بازگشایی‌های غیرفعال (passive) در ثانیه که توسط این نهاد پشتیبانی شده است (tcpPassiveOpens).
تعداد اتصالات در حال حاضر باز (تصویر لحظه‌ای)، که وضعیت آن‌ها ESTABLISHED یا CLOSE-WAIT است (tcpCurrEstab).

خروجی برای پرچم -T اطلاعاتی را درباره خطاهای شناسایی‌شده در لایهٔ TCP ارائه می‌دهد (نام‌های رسمی SNMP درون پرانتزها آمده است):

تعداد قطعه‌های خطادار دریافت شده در ثانیه (tcpInErrs).
تعداد قطعه‌های بازفرستاده‌شده (retransmitted) در ثانیه (tcpRetransSegs).
تعداد تلاش‌های ناموفق اتصال در ثانیه که در این نهاد رخ داده است (tcpAttemptFails).
تعداد بازنشانی‌های (reset) رخ‌داده در این نهاد در ثانیه (tcpEstabResets).
تعداد قطعه‌های ارسال‌شده در ثانیه که حاوی پرچم RST هستند (tcpOutRsts).

خروجی برای پرچم -h اطلاعاتی درباره میزان استفاده از درگاه‌های Infiniband ارائه می‌دهد:

نام کنترلر.
درگاه کنترلر.
درصد مشغولی برای این درگاه.
تعداد بسته‌های دریافت‌شده از این درگاه در ثانیه.
تعداد بسته‌های ارسال‌شده به این درگاه در ثانیه.
تعداد گیگابیت مؤثر دریافت شده در ثانیه.
تعداد گیگابیت مؤثر ارسال شده در ثانیه.
بیشترین نرخ بر حسب تعداد گیگابیت در ثانیه.
تعداد خطوط ارتباطی (lanes).

خروجی برای پرچم -O اطلاعاتی درباره ۳ فرایند برتر با بیشترین میزان مصرف پردازنده ارائه می‌دهد:

شناسه فرایند (اگر صفر باشد، فرایند در شرایطی پایان یافته است که شناسه آن قابل تشخیص نبوده است).
نام فرایند.
درصد ظرفیت پردازنده که مصرف می‌شود. این مقدار می‌تواند برای یک فرایند چندنخی که روی یک ماشین چندپردازنده‌ای اجرا می‌شود، از ۱۰۰٪ فراتر رود.

خروجی برای پرچم -G اطلاعاتی درباره ۳ فرایند برتر با بیشترین میزان مصرف حافظه ارائه می‌دهد:

شناسه فرایند (اگر صفر باشد، فرایند در شرایطی پایان یافته است که شناسه آن قابل تشخیص نبوده است).
نام فرایند.
درصد استفاده از حافظهٔ مقیم (resident memory) توسط این فرایند.

خروجی برای پرچم -D اطلاعاتی درباره ۳ فرایند برتر با بیشترین درخواست‌های خواندن و نوشتن روی دیسک ارائه می‌دهد:

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

خروجی برای پرچم -N اطلاعاتی درباره ۳ فرایند برتر با بیشترین تبادلات سوکت برای پروتکل‌های IPv4/IPv6 ارائه می‌دهد:

شناسه فرایند (اگر صفر باشد، فرایند در شرایطی پایان یافته است که شناسه آن قابل تشخیص نبوده است).
نام فرایند.
درصد تبادلات سوکت نسبت به کل انتقال‌های صورت‌گرفته توسط تمام فرایندها؛ بنابراین درصد بالا لزوماً به معنی بار زیاد شبکه در سطح سیستم نیست..SH "مثال‌ها (EXAMPLES)" برای مشاهده فعالیت پردازنده (CPU) امروز تا به این لحظه (با فرض اینکه atop در پس‌زمینه مشغول ثبت وقایع است):
  pcp-atopsar

برای مشاهده میزان اشغال حافظه در تاریخ ۵ ژوئن ۲۰۱۸ بین ساعات 10:00 و 12:30 (با فرض اینکه pmlogger به‌طور روزانه در پس‌زمینه بر روی میزبان acme.com وقایع را ثبت کرده باشد):

  pcp-atopsar -m -r $PCP_LOG_DIR/pmlogger/acme.com/20180605 -b 10:00 -e 12:30

 
یا
  pcp-atopsar -m -r 20180605 -b 10:00 -e 12:30

 
یا با فرض اینکه در این لحظه تاریخ ۸ ژوئن ۲۰۱۸ است
  pcp-atopsar -m -r yyy -b 10:00 -e 12:30

ثبت یک فایل لاگ با atop برای ضبط رفتار سیستم به مدت ۳۰ دقیقه (۳۰ نمونه‌ی یک‌دقیقه‌ای) و تولید تمام گزارش‌های موجود پس از آن:

  pcp-atop -w /tmp/atoplog 60 30
  pcp-atopsar -A -r /tmp/atoplog

برای مشاهده روند فعالیت TCP به مدت ده دقیقه (۱۰ نمونه با بازه‌های زمانی شصت ثانیه‌ای):

  pcp-atopsar -t 60 10

برای مشاهده خطوط سرآیند (نویسه '_' به عنوان آخرین کاراکتر) در تمامی گزارش‌ها، به طوری که فقط خطوط جزئیاتی که مصرف بحرانی منابع را نشان می‌دهند (علامت '*' یا '+' به عنوان آخرین کاراکتر) نمایش داده شوند:

  pcp-atopsar -AM | grep '[_*+]$'

/etc/atoprc
فایل پیکربندی شامل مقادیر پیش‌فرض سراسری سیستم (عمدتاً پرچم‌ها). صفحه راهنمای مربوطه را ببینید.
~/.atoprc
فایل پیکربندی شامل مقادیر پیش‌فرض شخصی (عمدتاً پرچم‌ها). صفحه راهنمای مربوطه را ببینید.
$PCP_LOG_DIR/pmlogger/HOST/YYYYMMDD
فایل داده‌های روزانه، که در آن YYYYMMDD ارقام نشان‌دهنده تاریخ، و HOST نام میزبان دستگاهی است که وقایع آن ثبت شده است.

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

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

گزینه -D یا --debug در pcp خروجی اطلاعات عیب‌یابی اضافی را بر روی stderr فعال می‌کند تا به تریاژ و ریشه‌یابی مشکلات کمک کند، اگرچه اطلاعات گاهی مبهم بوده و عمدتاً به جای کاربران نهایی برای راهنمایی توسعه‌دهندگان در نظر گرفته شده است. debug یک فهرست جداشده با کاما از گزینه‌های اشکال‌زدایی است؛ از pmdbg(1) همراه با گزینه -l برای دریافت فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید..SH "همچنین ببینید (SEE ALSO)" PCPIntro(1)، pcp(1)، pcp-atop(1)، mkaf(1)، pmlogger(1)، pmlogger_daily(1) و pcp-atoprc(5).

PCP Performance Co-Pilot