PCP-ATOPRC(5)                 File Formats Manual                PCP-ATOPRC(5)

نام (NAME)
       ?3pcp-atoprc?1 - فایل پیکربندی و منابع برای pcp-atop و pcp-atopsar

توضیحات (DESCRIPTION)
       این صفحه راهنما فایل منابع دستورهای pcp-atop و pcp-atopsar را مستند
       می‌کند.  این دستورها را می‌توان برای نظارت بر بار سیستم و پردازش‌ها در یک
       سیستم به کار برد.

       فایل pcp-atoprc حاوی تنظیمات پیش‌فرض است. این تنظیمات هنگام راه‌اندازی،
       ابتدا از فایل rc سراسری سیستم /etc/atoprc و پس از آن از فایل rc مخصوص
       کاربر ~/.atoprc خوانده می‌شوند (بنابراین تنظیمات سراسری سیستم را می‌توان
       توسط یک کاربر به صورت جداگانه بازنویسی کرد).  گزینه‌ها در هر دو فایل rc
       یکسان هستند.

گزینه‌ها (OPTIONS)
       فایل rc حاوی جفت‌های کلیدواژه-مقدار است، هر کدام در یک خط (خطوط خالی و
       خطوطی که با علامت # آغاز می‌شوند نادیده گرفته می‌شوند).
       کلیدواژه‌های زیر را می‌توان مشخص کرد:

       flags
           فهرستی از گزینه‌ها و فلگ‌های پیش‌فرض برای pcp-atop را می‌توان در اینجا
           تعریف کرد. فلگ‌های مجاز عبارتند از:

       interval
           مقدار بازه زمانی پیش‌فرض بر حسب ثانیه.

       linelen
           طول خط نمایشگر هنگام ارسال خروجی به فایل یا لوله (پیش‌فرض 80).

       username
           عبارت منظم پیش‌فرض برای کاربرانی که پردازش‌های فعال آن‌ها نمایش داده
           خواهد شد.

       procname
           عبارت منظم پیش‌فرض برای نام پردازش‌هایی که باید نمایش داده شوند.

       maxlinecpu
           حداکثر تعداد پردازنده‌های فعالی که نمایش داده خواهند شد.

       maxlinegpu
           حداکثر تعداد GPUهای فعالی که نمایش داده خواهند شد.

       maxlinelvm
           حداکثر تعداد حجم‌های منطقی (LVM) فعالی که نمایش داده خواهند شد.

       maxlinemdd
           حداکثر تعداد دستگاه‌های چندگانه (MDD) فعالی که نمایش داده خواهند شد.

       maxlinedisk
           حداکثر تعداد دیسک‌های فعالی که نمایش داده خواهند شد.

       maxlinenfsm
           حداکثر تعداد مانت‌های NFS که روی یک کلاینت NFS نمایش داده خواهند شد.

       maxlineintf
           حداکثر تعداد رابط‌های شبکه فعالی که نمایش داده خواهند شد.

       maxlinecont
           حداکثر تعداد کانتینرهای فعالی که نمایش داده خواهند شد.

       cpucritperc
           درصد مشغول بودن بحرانی برای یک پردازنده (بخش COLORS را در صفحه
           راهنمای دستور pcp-atop ببینید).  از این درصد برای تعیین درصد وزنی
           جهت رنگ‌آمیزی خطوط و مرتب‌سازی پردازش‌های فعال در حالت متنی استفاده
           می‌شود.  اگر این مقدار صفر باشد، هیچ رنگ‌آمیزی یا مرتب‌سازی خودکاری
           برای این منبع انجام نمی‌شود.

       dskcritperc
           درصد مشغول بودن بحرانی برای یک دیسک (بخش COLORS را در صفحه راهنمای
           دستور pcp-atop ببینید).  از این درصد برای تعیین درصد وزنی جهت
           رنگ‌آمیزی خطوط و مرتب‌سازی پردازش‌های فعال در حالت متنی استفاده می‌شود.
           اگر این مقدار صفر باشد، هیچ رنگ‌آمیزی یا مرتب‌سازی خودکاری برای این
           منبع انجام نمی‌شود.

       netcritperc
           درصد مشغول بودن بحرانی برای یک رابط شبکه (بخش COLORS را در صفحه
           راهنمای دستور pcp-atop ببینید).  از این درصد برای تعیین درصد وزنی
           جهت رنگ‌آمیزی خطوط و مرتب‌سازی پردازش‌های فعال در حالت متنی استفاده
           می‌شود.  اگر این مقدار صفر باشد، هیچ رنگ‌آمیزی یا مرتب‌سازی خودکاری
           برای این منبع انجام نمی‌شود.

       memcritperc
           درصد بحرانی استفاده از حافظه (بخش COLORS را در صفحه راهنمای دستور
           pcp-atop ببینید).  از این درصد برای تعیین درصد وزنی جهت رنگ‌آمیزی
           خطوط و مرتب‌سازی پردازش‌های فعال در حالت متنی استفاده می‌شود.  اگر این
           مقدار صفر باشد، هیچ رنگ‌آمیزی یا مرتب‌سازی خودکاری برای این منبع
           انجام نمی‌شود.

       swpcritperc
           درصد اشغال بحرانی برای فضای سواپ (بخش COLORS را در صفحه راهنمای
           دستور pcp-atop ببینید).  از این درصد برای تعیین درصد وزنی جهت
           رنگ‌آمیزی خطوط و مرتب‌سازی پردازش‌های فعال استفاده می‌شود.  اگر این
           مقدار صفر باشد، هیچ رنگ‌آمیزی یا مرتب‌سازی خودکاری برای این منبع
           انجام نمی‌شود.

       swoutcritsec
           تعداد صفحات منتقل‌شده به سواپ در هر ثانیه که برای مصرف حافظه بحرانی
           تلقی می‌شود (بخش COLORS را در صفحه راهنمای دستور pcp-atop ببینید).
           این آستانه در ترکیب با 'memcritperc' برای تعیین درصد وزنی جهت
           رنگ‌آمیزی خطوط و مرتب‌سازی پردازش‌های فعال استفاده می‌شود.  اگر این
           مقدار صفر باشد، هیچ رنگ‌آمیزی یا مرتب‌سازی خودکاری برای این منبع
           انجام نمی‌شود.

       almostcrit
           درصدی از درصد بحرانی برای تعیین اینکه آیا منبع در آستانه وضعیت
           بحرانی است یا خیر (بخش COLORS را در صفحه راهنمای دستور pcp-atop
           ببینید).  اگر این مقدار صفر باشد، هیچ رنگ‌آمیزی خطی برای وضعیت «در
           آستانه بحرانی» انجام نمی‌شود.

       cpubarwidth
           تعداد ستون‌های مورد استفاده برای هر میله در نمودار میله‌ای پردازنده.
           مقدار پیش‌فرض 0 است که به این معناست که پهنای میله به صورت خودکار
           تغییر اندازه می‌دهد (هر چه ترمینال عریض‌تر باشد، ستون‌های بیشتری برای
           هر میله تا سقف ۳ ستون اختصاص می‌یابد).  با مقادیر 1، 2 یا 3 می‌توان
           تعداد ستون‌ها را ثابت نگه داشت، با یک ستون فاصله خالی میان میله‌ها.

       colorinfo
           تعریف نام رنگ برای پیام‌های اطلاعاتی (پیش‌فرض: green) در حالت متنی.
           رنگ‌های مجاز عبارتند از: red green yellow blue magenta cyan black
           white.

       colorthread
           تعریف نام رنگ برای خطوط مربوط به رشته‌ها هنگام استفاده از گزینه 'y'
           (پیش‌فرض: yellow).
           رنگ‌های مجاز عبارتند از: red green yellow blue magenta cyan black
           white.

       coloralmost
           تعریف نام رنگ برای منابع در آستانه بحرانی (پیش‌فرض: cyan) در حالت
           متنی.
           رنگ‌های مجاز عبارتند از: red green yellow blue magenta cyan black
           white.

       colorcritical
           تعریف نام رنگ برای منابع بحرانی (پیش‌فرض: red) در حالت متنی.
           رنگ‌های مجاز عبارتند از: red green yellow blue magenta cyan black
           white.

       pcp-atopsarflags
           فهرستی از فلگ‌های پیش‌فرض برای pcp-atopsar را می‌توان در اینجا تعریف
           کرد. فلگ‌های مجاز عبارتند از:

       نمونه‌ای از فایل /etc/atoprc یا ~/.atoprc :

        
               flags         Aaf
               interval      5
               username
               procname
               maxlinecpu    4
               maxlinedisk   10
               maxlineintf   5
               cpucritperc   80
               almostcrit    90
               pcp-atopsarflags  CMH
               ownprocline   PID:50 VGROW:40 RGROW:45 COMMAND-LINE:50
               ownpagline    PAGSCAN:3 BLANKBOX:0 PAGSWIN:3 PAGSWOUT:7

       کلیدواژه‌های 'ownprocline' و 'ownpagline' در بخش بعدی شرح داده شده‌اند.

تعریف اختصاصی خط خروجی (OWN DEFINITION OF OUTPUT LINE)
       از طریق فایل rc امکان تعریف قالب خطوط خروجی توسط خودتان وجود دارد، بدین
       معنی که می‌توانید قالب یک خط شامل اطلاعات پردازش را با کلیدواژه
       'ownprocline' تعریف کنید (که با کلید 'o' یا فلگ -o انتخاب می‌شود) و
       می‌توانید تمامی خطوط اطلاعات سیستم را بازتعریف نمایید.

       قالب یک خط خروجی را می‌توان به شرح زیر تعریف کرد (توجه داشته باشید که
       این مورد باید در قالب یک خط در فایل rc مشخص شود):

          keyword   <columnid>:<prio> [<columnid>:<prio> ...]

       شناسه columnid نام نمادین ستونی است که باید در این موقعیت در خط خروجی
       نمایش داده شود.
       شناسه prio یک مقدار عدد صحیح مثبت است که اولویت ستون‌ها را در صورتی که
       تمام ستون‌های مشخص‌شده در پهنای صفحه جاری جا نشوند، تعیین می‌کند. هرچه
       مقدار بالاتر باشد، اولویت بیشتر است.
       مشخصات ستون‌ها باید با یک فاصله از هم جدا شوند. ترتیبی که ستون‌ها در آن
       مشخص شده‌اند، ترتیب نمایش آن‌ها با در نظر گرفتن اولویتشان خواهد بود
       (ستون‌هایی که جا نشوند، به صورت پویا حذف خواهند شد).

       یک columnid ویژه برای خطوط سیستمی 'BLANKBOX' است. این شناسه نشان می‌دهد
       که در این موقعیت یک ستون خالی مورد نیاز است. همچنین این شناسه خاص با یک
       مقدار اولویت (معمولاً پایین) همراه است.

       تعریف زیر را می‌توان برای اطلاعات پردازش مشخص کرد:

       ownprocline
           شناسه‌های ستون‌ها همان نام‌های ستون‌هایی هستند که در خروجی عادی خطوط
           مربوط به پردازش توسط pcp-atop نمایش داده می‌شوند، مانند 'PID'،
           'CMD'، 'S' و غیره.  تنها استثنا شناسه ستون ویژه 'SORTITEM' است که
           برای نمایش یکی از ستون‌های %CPU%/DSK%/MEM%/NET بسته به معیار
           مرتب‌سازی انتخاب‌شده استفاده می‌شود.
           نمونه‌ای از یک خط پردازش تعریف‌شده توسط کاربر:

               ownprocline   PID:20 PPID:10 SYSCPU:15 USRCPU:15 VGROW:14
               VSIZE:12 RGROW:14 RSIZE:12 ST:8 EXC:7 S:11 SORTITEM:18 CMD:20

       تعاریف زیر به صورت داخلی توسط pcp-atop به عنوان خطوط سیستمی پیش‌فرض
       استفاده می‌شوند (می‌توانید هر یک از آن‌ها را در فایل rc به صورت یک خط
       بازتعریف کنید):

       ownsysprcline
           بازتعریف خط برچسب‌گذاری‌شده با 'PRC':

               ownsysprcline   PRCSYS:8 PRCUSER:8 BLANKBOX:0 PRCNPROC:7
               PRCNZOMBIE:5 PRCCLONES:4 BLANKBOX:0 PRCNNEXIT:6

       ownallcpuline
           بازتعریف خط برچسب‌گذاری‌شده با 'CPU' برای استفاده کل پردازنده:

               ownallcpuline   CPUSYS:8 CPUUSER:7 CPUIRQ:4 BLANKBOX:0
               CPUIDLE:5 CPUWAIT:6 BLANKBOX:0 CPUSTEAL:1 CPUGUEST:3

       ownonecpuline
           بازتعریف خط برچسب‌گذاری‌شده با 'CPU' برای استفاده از یک پردازنده
           مشخص:

               ownonecpuline   CPUISYS:8 CPUIUSER:7 CPUIIRQ:4 BLANKBOX:0
               CPUIIDLE:5 CPUIWAIT:6 BLANKBOX:0 CPUISTEAL:1 CPUIGUEST:3

       owncplline
           بازتعریف خط برچسب‌گذاری‌شده با 'CPL':

               owncplline   CPLAVG1:4 CPLAVG5:3 CPLAVG15:2 BLANKBOX:0 CPLCSW:6
               CPLINTR:5 BLANKBOX:0 CPLNUMCPU:1

       ownmemline
           بازتعریف خط برچسب‌گذاری‌شده با 'MEM':

               ownmemline   MEMTOT:2 MEMFREE:5 MEMCACHE:3 MEMDIRTY:1
               MEMBUFFER:3 MEMSLAB:3 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0
               BLANKBOX:0

       ownswpline
           بازتعریف خط برچسب‌گذاری‌شده با 'SWP':

               ownswpline   SWPTOT:3 SWPFREE:4 BLANKBOX:0 BLANKBOX:0
               BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 SWPCOMMITTED:5
               SWPCOMMITLIM:6

       ownpagline
           بازتعریف خط برچسب‌گذاری‌شده با 'PAG':

               ownpagline   PAGSCAN:3 PAGSTALL:1 BLANKBOX:0 PAGSWIN:4
               PAGSWOUT:3

       owndskline
           بازتعریف خطوط برچسب‌گذاری‌شده با 'LVM'، 'MDD' و 'DSK':

               owndskline   DSKNAME:8 DSKBUSY:7 DSKNREAD:6 DSKNWRITE:6
               DSKKBPERRD:4 DSKKBPERWR:4 DSKMBPERSECRD:5 DSKMBPERSECWR:5
               DSKAVQUEUE:1 DSKAVIO:5

       ownnettrline
           بازتعریف خط برچسب‌گذاری‌شده با 'NET' برای بخش انتقال (transport):

               ownnettrline   NETTRANSPORT:9 NETTCPI:8 NETTCPO:8 NETUDPI:8
               NETUDPO:8 NETTCPACTOPEN:6 NETTCPPASVOPEN:5 NETTCPRETRANS:4
               NETTCPINERR:3 NETTCPORESET:20 NETUDPNOPORT:1 NETUDPINERR:3

       ownnetnetline
           بازتعریف خط برچسب‌گذاری‌شده با 'NET' برای شبکه (network):

               ownnetnetline   NETNETWORK:5 NETIPI:4 NETIPO:4 NETIPFRW:4
               NETIPDELIV:4 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 NETICMPIN:1
               NETICMPOUT:1

       ownnetifline
           بازتعریف خط برچسب‌گذاری‌شده با 'NET' برای رابط‌ها (interfaces):

               ownnetifline   NETNAME:8 NETPCKI:7 NETPCKO:7 NETSPEEDIN:6
               NETSPEEDOUT:6 NETCOLLIS:3 NETMULTICASTIN:2 NETRCVERR:5
               NETSNDERR:5 NETRCVDROP:4 NETSNDDROP:4

       خطوط بالا به ترتیبی نمایش داده شده‌اند که توسط pcp-atop در ترکیب با فلگ
       -f نمایش داده می‌شوند (در یک پنجره بسیار عریض باید بتوانید تمامی ستون‌ها
       را مشاهده کنید).

همچنین ببینید (SEE ALSO)
       pcp(1), pcp-atop(1), pcp-atopsar(1) و PCPIntro(1).


Performance Co-Pilot                  PCP                        PCP-ATOPRC(5)