ATOPRC(5) File Formats Manual ATOPRC(5)

atoprc - فایل پیکربندی برای ابزار مانیتورینگ atop

این صفحهٔ راهنما، پروندهٔ پیکربندی (rcfile) دستورهای atop و atopsar را شرح می‌دهد. این دستورها را می‌توان برای مانیتورینگ بار سیستم و پردازش‌ها در یک سیستم لینوکس استفاده کرد.

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

پروندهٔ پیکربندی شامل جفت‌های کلید-مقدار است، هر کدام در یک خط (خطوط خالی و خطوطی که با علامت # شروع می‌شوند، نادیده گرفته خواهند شد).
کلیدواژه‌های زیر قابل تعیین هستند:

فهرستی از پرچم‌های پیش‌فرض برای atop می‌تواند در اینجا تعریف شود. پرچم‌های مجاز عبارتند از: 'C'، 'M'، 'D'، 'N'، 'A'، 'a'، 'y'، 'Y'، 'f'، 'F'، 'R'، '1'، 'e'، 'E' و 'x'.
نام مسیر مطلق پیش‌فرض دایرکتوری موقتی که پروندهٔ twin باید در آن تخصیص یابد.
مقدار بازهٔ زمانی پیش‌فرض بر حسب ثانیه.
طول یک خط صفحه هنگام ارسال خروجی به یک پرونده یا لوله (pipe) (پیش‌فرض 80).
عبارت باقاعده یا یک شناسه عددی کاربر (UID) برای انتخاب کاربرانی که پردازش‌های (فعال) آن‌ها نمایش داده خواهد شد.
عبارت باقاعدهٔ پیش‌فرض برای نام پردازش‌هایی که باید نمایش داده شوند.
حداکثر تعداد پردازنده‌های فعالی که نمایش داده خواهند شد.
حداکثر تعداد پردازنده‌های گرافیکی فعالی که نمایش داده خواهند شد.
حداکثر تعداد حجم‌های منطقی فعالی که نمایش داده خواهند شد.
حداکثر تعداد دستگاه‌های چندگانه فعالی که نمایش داده خواهند شد.
حداکثر تعداد دیسک‌های فعالی که نمایش داده خواهند شد.
حداکثر تعداد اتصال‌های NFS که روی یک کلاینت NFS نمایش داده خواهند شد.
حداکثر تعداد رابط‌های شبکهٔ فعالی که نمایش داده خواهند شد.
حداکثر تعداد کانتینرهای فعالی که نمایش داده خواهند شد.
حداکثر تعداد درگاه‌های Infiniband که نمایش داده خواهند شد.
حداکثر تعداد معیارهای گره NUMA که نمایش داده خواهند شد. توجه داشته باشید که برای هر گره NUMA دو خط نمایش داده می‌شود.
حداکثر تعداد خطوط با معیارهای LLC که نمایش داده خواهند شد.
درصد اشغال بحرانی برای یک پردازنده (بخش COLORS را در صفحهٔ راهنمای دستور atop ببینید). این درصد برای تعیین یک درصد وزن‌دار جهت رنگ‌آمیزی خطوط و مرتب‌سازی پردازش‌های فعال در حالت متنی استفاده می‌شود. وقتی این مقدار صفر باشد، هیچ رنگ‌آمیزی خط یا مرتب‌سازی خودکاری برای این منبع انجام نمی‌شود.
درصد اشغال بحرانی برای یک دیسک (بخش COLORS را در صفحهٔ راهنمای دستور atop ببینید). این درصد برای تعیین یک درصد وزن‌دار جهت رنگ‌آمیزی خطوط و مرتب‌سازی پردازش‌های فعال در حالت متنی استفاده می‌شود. وقتی این مقدار صفر باشد، هیچ رنگ‌آمیزی خط یا مرتب‌سازی خودکاری برای این منبع انجام نمی‌شود.
درصد اشغال بحرانی برای یک رابط شبکه (بخش COLORS را در صفحهٔ راهنمای دستور atop ببینید). این درصد برای تعیین یک درصد وزن‌دار جهت رنگ‌آمیزی خطوط و مرتب‌سازی پردازش‌های فعال در حالت متنی استفاده می‌شود. وقتی این مقدار صفر باشد، هیچ رنگ‌آمیزی خط یا مرتب‌سازی خودکاری برای این منبع انجام نمی‌شود.
درصد اشغال بحرانی برای استفاده از حافظه (بخش COLORS را در صفحهٔ راهنمای دستور atop ببینید). این درصد برای تعیین یک درصد وزن‌دار جهت رنگ‌آمیزی خطوط و مرتب‌سازی پردازش‌های فعال در حالت متنی استفاده می‌شود. وقتی این مقدار صفر باشد، هیچ رنگ‌آمیزی خط یا مرتب‌سازی خودکاری برای این منبع انجام نمی‌شود.
درصد اشغال بحرانی برای فضای مبادله (swap) (بخش COLORS را در صفحهٔ راهنمای دستور atop ببینید). این درصد برای تعیین یک درصد وزن‌دار جهت رنگ‌آمیزی خطوط و مرتب‌سازی پردازش‌های فعال در حالت متنی استفاده می‌شود. وقتی این مقدار صفر باشد، هیچ رنگ‌آمیزی خط یا مرتب‌سازی خودکاری برای این منبع انجام نمی‌شود.
تعداد صفحاتی که در هر ثانیه به فضای مبادله منتقل می‌شوند و برای استفاده از حافظه بحرانی در نظر گرفته می‌شوند (بخش COLORS را در صفحهٔ راهنمای دستور atop ببینید). این آستانه در ترکیب با 'memcritperc' برای تعیین یک درصد وزن‌دار جهت رنگ‌آمیزی خطوط و مرتب‌سازی پردازش‌های فعال در حالت متنی استفاده می‌شود. وقتی این مقدار صفر باشد، هیچ رنگ‌آمیزی خط یا مرتب‌سازی خودکاری برای این منبع انجام نمی‌شود.
درصدی از درصد بحرانی برای تعیین اینکه آیا منبع در وضعیت تقریباً بحرانی قرار دارد یا خیر (بخش COLORS را در صفحهٔ راهنمای دستور atop ببینید). وقتی این مقدار صفر باشد، هیچ رنگ‌آمیزی خطی برای وضعیت «تقریباً بحرانی» انجام نمی‌شود.
تعداد ستون‌های استفاده‌شده برای هر میله در نمودار میله‌ای پردازنده. مقدار پیش‌فرض 0 است که به این معنی است که عرض میله به‌طور خودکار مقیاس‌بندی می‌شود (هر چه پایانه عریض‌تر باشد، ستون‌های بیشتری برای هر میله تا حداکثر سه ستون اختصاص می‌یابد). با مقدار 1، 2 یا 3 تعداد میله‌ها می‌تواند به‌طور ایستا به آن تعداد ستون تثبیت شود، با یک ستون فاصلهٔ خالی بین میله‌ها.
تعریف نام رنگ برای پیام‌های اطلاعاتی (پیش‌فرض: green) در حالت متنی.
رنگ‌های مجاز عبارتند از: red green yellow blue magenta cyan black white.
تعریف نام رنگ برای خطوط مخصوص رشته‌ها هنگام استفاده از گزینهٔ 'y' (پیش‌فرض: yellow).
رنگ‌های مجاز عبارتند از: red green yellow blue magenta cyan black white.
تعریف نام رنگ برای منابع تقریباً بحرانی (پیش‌فرض: cyan) در حالت متنی.
رنگ‌های مجاز عبارتند از: red green yellow blue magenta cyan black white.
تعریف نام رنگ برای منابع بحرانی (پیش‌فرض: red) در حالت متنی.
رنگ‌های مجاز عبارتند از: red green yellow blue magenta cyan black white.
فهرستی از پرچم‌های پیش‌فرض برای atopsar می‌تواند در اینجا تعریف شود. پرچم‌های مجاز عبارتند از: 'S'، 'x'، 'C'، 'M'، 'H'، 'a'، 'A' و پرچم‌های انتخاب یک یا چند گزارش خاص.
مشخص می‌کند که آیا شمارندهٔ چرخهٔ CPU باید توسط atop از طریق شمارنده‌های 'perf' دریافت شود یا خیر. مقادیر 'auto' (پیش‌فرض)، 'enable' یا 'disable' قابل تعیین هستند. در صورت 'auto'، شمارندهٔ چرخهٔ CPU در ماشین‌های مجازی به دلیل سربار خواندن این شمارنده در مهمان دریافت نخواهد شد.
نام دایرکتوری بالادستی استفاده‌شده توسط دیمن atopacctd است. در این دایرکتوری، دیمن یک زیردایرکتوری pacct_shadow.d ایجاد می‌کند که در آن پرونده‌های حاوی سوابق حسابرسی پردازش‌ها نوشته خواهند شد. دایرکتوری بالادستی پیش‌فرض /var/run است و این گزینه فقط زمانی باید مشخص شود که دیمن atopacctd با یک دایرکتوری بالادستی جایگزین به عنوان آرگومان خط فرمان راه‌اندازی شود.
این گزینه فقط می‌تواند در پروندهٔ /etc/atoprc (در سطح سیستم) مشخص شود!

نمونه‌ای از پروندهٔ /etc/atoprc یا ~/.atoprc :
flags         Aaf
interval      5
username
procname
maxlinecpu    4
maxlinedisk   10
maxlineintf   5
cpucritperc   80
almostcrit    90
atopsarflags  CMH
ownprocline   PID:50 VGROW:40 RGROW:45 COMMAND-LINE:50
ownpagline    PAGSCAN:3 BLANKBOX:0 PAGSWIN:3 PAGSWOUT:7

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

از طریق پروندهٔ پیکربندی، امکان تعریف چیدمان خطوط خروجی توسط خودتان وجود دارد؛ به عنوان مثال می‌توانید چیدمان یک خط با اطلاعات پردازش را با کلیدواژهٔ 'ownprocline' تعریف کنید (که با کلید 'o' یا پرچم -o انتخاب می‌شود) و می‌توانید تمامی خطوط با اطلاعات سیستم را بازتعریف کنید.

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

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

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

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

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

شناسه‌های ستون‌ها (columnidها) نام ستون‌هایی هستند که در خروجی عادی خطوط مرتبط با پردازش توسط 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

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

بازتعریف خط برچسب‌گذاری‌شده با 'PRC':
ownsysprcline   PRCSYS:8 PRCUSER:8 BLANKBOX:0 PRCNPROC:7 PRCNZOMBIE:5 PRCCLONES:4 BLANKBOX:0 PRCNNEXIT:6
بازتعریف خط برچسب‌گذاری‌شده با 'CPU' برای استفادهٔ کل CPU:
ownallcpuline   CPUSYS:8 CPUUSER:7 CPUIRQ:4 BLANKBOX:0 CPUIDLE:5 CPUWAIT:6 BLANKBOX:0 CPUSTEAL:1 CPUGUEST:3
بازتعریف خط برچسب‌گذاری‌شده با 'CPU' برای استفادهٔ یک CPU:
ownonecpuline   CPUISYS:8 CPUIUSER:7 CPUIIRQ:4 BLANKBOX:0 CPUIIDLE:5 CPUIWAIT:6 BLANKBOX:0 CPUISTEAL:1 CPUIGUEST:3
بازتعریف خط برچسب‌گذاری‌شده با 'CPL':
owncplline   CPLAVG1:4 CPLAVG5:3 CPLAVG15:2 BLANKBOX:0 CPLCSW:6 CPLINTR:5 BLANKBOX:0 CPLNUMCPU:1
بازتعریف خط برچسب‌گذاری‌شده با 'MEM':
ownmemline   MEMTOT:2 MEMFREE:5 MEMCACHE:3 MEMDIRTY:1 MEMBUFFER:3 MEMSLAB:3 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0
بازتعریف خط برچسب‌گذاری‌شده با 'SWP':
ownswpline   SWPTOT:3 SWPFREE:4 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 SWPCOMMITTED:5 SWPCOMMITLIM:6
بازتعریف خط برچسب‌گذاری‌شده با 'PAG':
ownpagline   PAGSCAN:3 PAGSTALL:1 BLANKBOX:0 PAGSWIN:4 PAGSWOUT:3
بازتعریف خطوط برچسب‌گذاری‌شده با 'LVM'، 'MDD' و 'DSK':
owndskline   DSKNAME:8 DSKBUSY:7 DSKNREAD:6 DSKNWRITE:6 DSKKBPERRD:4 DSKKBPERWR:4 DSKMBPERSECRD:5 DSKMBPERSECWR:5 DSKAVQUEUE:1 DSKAVIO:5
بازتعریف خط برچسب‌گذاری‌شده با '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
بازتعریف خط برچسب‌گذاری‌شده با 'NET' برای شبکه (network):
ownnetnetline   NETNETWORK:5 NETIPI:4 NETIPO:4 NETIPFRW:4 NETIPDELIV:4 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 NETICMPIN:1 NETICMPOUT:1
بازتعریف خط برچسب‌گذاری‌شده با '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

خطوط فوق به همان ترتیبی که توسط atop در ترکیب با پرچم -f نشان داده می‌شوند، نمایش می‌یابند (در یک پنجرهٔ بسیار عریض باید بتوانید همهٔ ستون‌ها را ببینید).

atop(1), atopsar(1), atopacctd(8), netatop(4), netatopd(8), logrotate(8)
https://www.atoptool.nl

Gerlof Langeveld (gerlof.langeveld@atoptool.nl)
JC van Winkel

January 2024 Linux