.TH ATOPRC 5 "January 2024" "Linux"
.SH "نام (NAME)"
.B atoprc
\- فایل پیکربندی برای ابزار مانیتورینگ atop
.SH "توضیحات (DESCRIPTION)"
این صفحهٔ راهنما، پروندهٔ پیکربندی (rcfile) دستورهای
.I atop
و
.I atopsar
را شرح می‌دهد.
این دستورها را می‌توان برای مانیتورینگ بار سیستم و پردازش‌ها در یک سیستم لینوکس استفاده کرد.
.PP
پروندهٔ atoprc شامل تنظیمات پیش‌فرض است. این تنظیمات در هنگام راه‌اندازی، ابتدا از پروندهٔ پیکربندی سراسری سیستم
.I /etc/atoprc
و سپس از پروندهٔ پیکربندی مخصوص کاربر
.I ~/.atoprc
خوانده می‌شوند
(بنابراین تنظیمات سراسری سیستم می‌توانند توسط هر کاربر لغو شوند).
گزینه‌ها در هر دو پروندهٔ پیکربندی یکسان هستند.
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
پروندهٔ پیکربندی شامل جفت‌های کلید-مقدار است، هر کدام در یک خط (خطوط خالی و خطوطی که با علامت # شروع می‌شوند، نادیده گرفته خواهند شد).
.br
کلیدواژه‌های زیر قابل تعیین هستند:
.PP
.TP 4
.B flags
فهرستی از پرچم‌های پیش‌فرض برای
.B atop
می‌تواند در اینجا تعریف شود. پرچم‌های مجاز عبارتند از:
't'، 'B'، 'H'، 'G'، '2' تا '9'، 'g'، 'm'، 'd'، 'n'، 'u'، 'p'، 's'، 'c'، 'v'،
\&'C'، 'M'، 'D'، 'N'، 'A'،
\&'a'، 'y'، 'Y'، 'f'، 'F'، 'R'، '1'، 'e'، 'E' و 'x'.
.PP
.TP 4
.B twindir
نام مسیر مطلق پیش‌فرض دایرکتوری موقتی که پروندهٔ twin باید در آن تخصیص یابد.
.PP
.TP 4
.B interval
مقدار بازهٔ زمانی پیش‌فرض بر حسب ثانیه.
.PP
.TP 4
.B linelen
طول یک خط صفحه هنگام ارسال خروجی به یک پرونده یا لوله (pipe) (پیش‌فرض 80).
.PP
.TP 4
.B username
عبارت باقاعده یا یک شناسه عددی کاربر (UID) برای انتخاب کاربرانی که پردازش‌های (فعال) آن‌ها نمایش داده خواهد شد.
.PP
.TP 4
.B procname
عبارت باقاعدهٔ پیش‌فرض برای نام پردازش‌هایی که باید نمایش داده شوند.
.PP
.TP 4
.B maxlinecpu
حداکثر تعداد پردازنده‌های فعالی که نمایش داده خواهند شد.
.PP
.TP 4
.B maxlinegpu
حداکثر تعداد پردازنده‌های گرافیکی فعالی که نمایش داده خواهند شد.
.PP
.TP 4
.B maxlinelvm
حداکثر تعداد حجم‌های منطقی فعالی که نمایش داده خواهند شد.
.PP
.TP 4
.B maxlinemdd
حداکثر تعداد دستگاه‌های چندگانه فعالی که نمایش داده خواهند شد.
.PP
.TP 4
.B maxlinedisk
حداکثر تعداد دیسک‌های فعالی که نمایش داده خواهند شد.
.PP
.TP 4
.B maxlinenfsm
حداکثر تعداد اتصال‌های NFS که روی یک کلاینت NFS نمایش داده خواهند شد.
.PP
.TP 4
.B maxlineintf
حداکثر تعداد رابط‌های شبکهٔ فعالی که نمایش داده خواهند شد.
.PP
.TP 4
.B maxlinecont
حداکثر تعداد کانتینرهای فعالی که نمایش داده خواهند شد.
.PP
.TP 4
.B maxlineifb
حداکثر تعداد درگاه‌های Infiniband که نمایش داده خواهند شد.
.PP
.TP 4
.B maxlinenuma
حداکثر تعداد معیارهای گره NUMA که نمایش داده خواهند شد.
توجه داشته باشید که برای هر گره NUMA دو خط نمایش داده می‌شود.
.PP
.TP 4
.B maxlinellc
حداکثر تعداد خطوط با معیارهای LLC که نمایش داده خواهند شد.
.PP
.TP 4
.B cpucritperc
درصد اشغال بحرانی برای یک پردازنده
(بخش COLORS را در صفحهٔ راهنمای دستور
.I atop
ببینید).
این درصد برای تعیین یک درصد وزن‌دار جهت رنگ‌آمیزی خطوط و مرتب‌سازی پردازش‌های فعال در حالت متنی استفاده می‌شود.
وقتی این مقدار صفر باشد، هیچ رنگ‌آمیزی خط یا مرتب‌سازی خودکاری برای این منبع انجام نمی‌شود.
.PP
.TP 4
.B dskcritperc
درصد اشغال بحرانی برای یک دیسک
(بخش COLORS را در صفحهٔ راهنمای دستور
.I atop
ببینید).
این درصد برای تعیین یک درصد وزن‌دار جهت رنگ‌آمیزی خطوط و مرتب‌سازی پردازش‌های فعال در حالت متنی استفاده می‌شود.
وقتی این مقدار صفر باشد، هیچ رنگ‌آمیزی خط یا مرتب‌سازی خودکاری برای این منبع انجام نمی‌شود.
.PP
.TP 4
.B netcritperc
درصد اشغال بحرانی برای یک رابط شبکه
(بخش COLORS را در صفحهٔ راهنمای دستور
.I atop
ببینید).
این درصد برای تعیین یک درصد وزن‌دار جهت رنگ‌آمیزی خطوط و مرتب‌سازی پردازش‌های فعال در حالت متنی استفاده می‌شود.
وقتی این مقدار صفر باشد، هیچ رنگ‌آمیزی خط یا مرتب‌سازی خودکاری برای این منبع انجام نمی‌شود.
.PP
.TP 4
.B memcritperc
درصد اشغال بحرانی برای استفاده از حافظه
(بخش COLORS را در صفحهٔ راهنمای دستور
.I atop
ببینید).
این درصد برای تعیین یک درصد وزن‌دار جهت رنگ‌آمیزی خطوط و مرتب‌سازی پردازش‌های فعال در حالت متنی استفاده می‌شود.
وقتی این مقدار صفر باشد، هیچ رنگ‌آمیزی خط یا مرتب‌سازی خودکاری برای این منبع انجام نمی‌شود.
.PP
.TP 4
.B swpcritperc
درصد اشغال بحرانی برای فضای مبادله (swap)
(بخش COLORS را در صفحهٔ راهنمای دستور
.I atop
ببینید).
این درصد برای تعیین یک درصد وزن‌دار جهت رنگ‌آمیزی خطوط و مرتب‌سازی پردازش‌های فعال در حالت متنی استفاده می‌شود.
وقتی این مقدار صفر باشد، هیچ رنگ‌آمیزی خط یا مرتب‌سازی خودکاری برای این منبع انجام نمی‌شود.
.PP
.TP 4
.B swoutcritsec
تعداد صفحاتی که در هر ثانیه به فضای مبادله منتقل می‌شوند و برای استفاده از حافظه بحرانی در نظر گرفته می‌شوند
(بخش COLORS را در صفحهٔ راهنمای دستور
.I atop
ببینید).
این آستانه در ترکیب با 'memcritperc' برای تعیین یک درصد وزن‌دار جهت رنگ‌آمیزی خطوط و مرتب‌سازی پردازش‌های فعال در حالت متنی استفاده می‌شود.
وقتی این مقدار صفر باشد، هیچ رنگ‌آمیزی خط یا مرتب‌سازی خودکاری برای این منبع انجام نمی‌شود.
.PP
.TP 4
.B almostcrit
درصدی از درصد بحرانی برای تعیین اینکه آیا منبع در وضعیت تقریباً بحرانی قرار دارد یا خیر
(بخش COLORS را در صفحهٔ راهنمای دستور
.I atop
ببینید).
وقتی این مقدار صفر باشد، هیچ رنگ‌آمیزی خطی برای وضعیت «تقریباً بحرانی» انجام نمی‌شود.
.PP
.TP 4
.B cpubarwidth
تعداد ستون‌های استفاده‌شده برای هر میله در نمودار میله‌ای پردازنده.
مقدار پیش‌فرض 0 است که به این معنی است که عرض میله به‌طور خودکار مقیاس‌بندی می‌شود (هر چه پایانه عریض‌تر باشد، ستون‌های بیشتری برای هر میله تا حداکثر سه ستون اختصاص می‌یابد).
با مقدار 1، 2 یا 3 تعداد میله‌ها می‌تواند به‌طور ایستا به آن تعداد ستون تثبیت شود، با یک ستون فاصلهٔ خالی بین میله‌ها.
.PP
.TP 4
.B colorinfo
تعریف نام رنگ برای پیام‌های اطلاعاتی (پیش‌فرض: green) در حالت متنی.
.br
رنگ‌های مجاز عبارتند از: red green yellow blue magenta cyan black white.
.PP
.TP 4
.B colorthread
تعریف نام رنگ برای خطوط مخصوص رشته‌ها هنگام استفاده از گزینهٔ 'y' (پیش‌فرض: yellow).
.br
رنگ‌های مجاز عبارتند از: red green yellow blue magenta cyan black white.
.PP
.TP 4
.B coloralmost
تعریف نام رنگ برای منابع تقریباً بحرانی (پیش‌فرض: cyan) در حالت متنی.
.br
رنگ‌های مجاز عبارتند از: red green yellow blue magenta cyan black white.
.PP
.TP 4
.B colorcritical
تعریف نام رنگ برای منابع بحرانی (پیش‌فرض: red) در حالت متنی.
.br
رنگ‌های مجاز عبارتند از: red green yellow blue magenta cyan black white.
.PP
.TP 4
.B atopsarflags
فهرستی از پرچم‌های پیش‌فرض برای
.B atopsar
می‌تواند در اینجا تعریف شود. پرچم‌های مجاز عبارتند از: 'S'، 'x'، 'C'، 'M'، 'H'، 'a'، 'A' و پرچم‌های انتخاب یک یا چند گزارش خاص.
.PP
.TP 4
.B perfevents
مشخص می‌کند که آیا شمارندهٔ چرخهٔ CPU باید توسط
.B atop
از طریق شمارنده‌های 'perf' دریافت شود یا خیر. مقادیر 'auto' (پیش‌فرض)، 'enable' یا 'disable' قابل تعیین هستند. در صورت 'auto'، شمارندهٔ چرخهٔ CPU در ماشین‌های مجازی به دلیل سربار خواندن این شمارنده در مهمان دریافت نخواهد شد.
.PP
.TP 4
.B pacctdir
نام دایرکتوری بالادستی استفاده‌شده توسط دیمن
.B atopacctd
است. در این دایرکتوری، دیمن یک زیردایرکتوری
.B pacct_shadow.d
ایجاد می‌کند که در آن پرونده‌های حاوی سوابق حسابرسی پردازش‌ها نوشته خواهند شد.
دایرکتوری بالادستی پیش‌فرض
.B /var/run
است و این گزینه فقط زمانی باید مشخص شود که دیمن
.B atopacctd
با یک دایرکتوری بالادستی جایگزین به عنوان آرگومان خط فرمان راه‌اندازی شود.
.br
این گزینه فقط می‌تواند در پروندهٔ
.B /etc/atoprc
(در سطح سیستم) مشخص شود!
.PP
نمونه‌ای از پروندهٔ
.B /etc/atoprc
یا
.B ~/.atoprc
:
.TP 8
\
.br
flags\ \ \ \ \ \ \ \ \ Aaf
.br
interval\ \ \ \ \ \ 5
.br
username
.br
procname
.br
maxlinecpu\ \ \ \ 4
.br
maxlinedisk\ \ \ 10
.br
maxlineintf\ \ \ 5
.br
cpucritperc\ \ \ 80
.br
almostcrit\ \ \ \ 90
.br
atopsarflags\ \ CMH
.br
ownprocline\ \ \ PID:50 VGROW:40 RGROW:45 COMMAND-LINE:50
.br
ownpagline\ \ \ \ PAGSCAN:3 BLANKBOX:0 PAGSWIN:3 PAGSWOUT:7
.PP
کلیدواژه‌های 'ownprocline' و 'ownpagline' در بخش بعدی توضیح داده شده‌اند.
.SH "تعریف سفارشی خط خروجی (OWN DEFINITION OF OUTPUT LINE)"
از طریق پروندهٔ پیکربندی، امکان تعریف چیدمان خطوط خروجی توسط خودتان وجود دارد؛ به عنوان مثال می‌توانید چیدمان یک خط با اطلاعات پردازش را با کلیدواژهٔ 'ownprocline' تعریف کنید (که با کلید 'o' یا پرچم \-o انتخاب می‌شود) و می‌توانید تمامی خطوط با اطلاعات سیستم را بازتعریف کنید.
.PP
چیدمان یک خط خروجی را می‌توان به صورت زیر تعریف کرد
(توجه داشته باشید که این مورد باید به صورت یک خط واحد در پروندهٔ پیکربندی مشخص شود):
.PP
\ \ \ keyword\ \ \ <columnid>:<prio> [<columnid>:<prio> ...]
.PP
شناسهٔ
.B columnid
نام نمادین ستونی است که باید در این موقعیت در خط خروجی نمایش داده شود.
.br
مقدار
.B prio
یک عدد صحیح مثبت است که مشخص می‌کند در صورتی که همهٔ ستون‌های مشخص‌شده در عرض فعلی صفحه جا نشوند، کدام ستون‌ها اولویت دارند.
مقدار بالاتر، اولویت بالاتر.
.br
مشخصات ستون‌ها باید با فاصله جدا شوند. ترتیبی که ستون‌ها مشخص شده‌اند همان ترتیبی است که نمایش داده خواهند شد، با توجه به اولویت آن‌ها (ستون‌هایی که جا نشوند، به صورت پویا حذف خواهند شد).
.PP
یک شناسهٔ ستون ویژه برای خطوط سیستم 'BLANKBOX' است. این شناسه نشان می‌دهد که یک ستون خالی در این موقعیت مورد نیاز است. همچنین این شناسهٔ ویژه ستون با یک اولویت همراه است (معمولاً پایین).
.PP
تعریف زیر می‌تواند برای اطلاعات پردازش مشخص شود:
.PP
.TP 4
.B ownprocline
شناسه‌های ستون‌ها (columnidها) نام ستون‌هایی هستند که در خروجی عادی خطوط مرتبط با پردازش توسط
.I atop
نمایش داده می‌شوند، مانند 'PID'، 'CMD'، 'S'، ....
تنها استثنا، شناسهٔ ویژهٔ 'SORTITEM' است که برای نمایش یکی از ستون‌های CPU%/DSK%/MEM%/NET% بسته به معیار مرتب‌سازی انتخاب‌شده استفاده می‌شود.
.br
نمونه‌ای از خط پردازش تعریف‌شده توسط کاربر:
.PP
.TP 8
\
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
.PP
تعاریف زیر به صورت داخلی توسط
.I atop
به عنوان خطوط پیش‌فرض سیستم استفاده می‌شوند (می‌توانید هر یک از آن‌ها را در پروندهٔ پیکربندی به عنوان یک خط بازتعریف کنید):
.PP
.TP 4
.B ownsysprcline
بازتعریف خط برچسب‌گذاری‌شده با 'PRC':
.PP
.TP 8
\
ownsysprcline\ \ \ PRCSYS:8 PRCUSER:8 BLANKBOX:0 PRCNPROC:7 PRCNZOMBIE:5 PRCCLONES:4 BLANKBOX:0 PRCNNEXIT:6
.PP
.TP 4
.B ownallcpuline
بازتعریف خط برچسب‌گذاری‌شده با 'CPU' برای استفادهٔ کل CPU:
.PP
.TP 8
\
ownallcpuline\ \ \ CPUSYS:8 CPUUSER:7 CPUIRQ:4 BLANKBOX:0 CPUIDLE:5 CPUWAIT:6 BLANKBOX:0 CPUSTEAL:1 CPUGUEST:3
.PP
.TP 4
.B ownonecpuline
بازتعریف خط برچسب‌گذاری‌شده با 'CPU' برای استفادهٔ یک CPU:
.PP
.TP 8
\
ownonecpuline\ \ \ CPUISYS:8 CPUIUSER:7 CPUIIRQ:4 BLANKBOX:0 CPUIIDLE:5 CPUIWAIT:6 BLANKBOX:0 CPUISTEAL:1 CPUIGUEST:3
.PP
.TP 4
.B owncplline
بازتعریف خط برچسب‌گذاری‌شده با 'CPL':
.PP
.TP 8
\
owncplline\ \ \ CPLAVG1:4 CPLAVG5:3 CPLAVG15:2 BLANKBOX:0 CPLCSW:6 CPLINTR:5 BLANKBOX:0 CPLNUMCPU:1
.PP
.TP 4
.B ownmemline
بازتعریف خط برچسب‌گذاری‌شده با 'MEM':
.PP
.TP 8
\
ownmemline\ \ \ MEMTOT:2 MEMFREE:5 MEMCACHE:3 MEMDIRTY:1 MEMBUFFER:3 MEMSLAB:3 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0
.PP
.TP 4
.B ownswpline
بازتعریف خط برچسب‌گذاری‌شده با 'SWP':
.PP
.TP 8
\
ownswpline\ \ \ SWPTOT:3 SWPFREE:4 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 SWPCOMMITTED:5 SWPCOMMITLIM:6
.PP
.TP 4
.B ownpagline
بازتعریف خط برچسب‌گذاری‌شده با 'PAG':
.PP
.TP 8
\
ownpagline\ \ \ PAGSCAN:3 PAGSTALL:1 BLANKBOX:0 PAGSWIN:4 PAGSWOUT:3
.PP
.TP 4
.B owndskline
بازتعریف خطوط برچسب‌گذاری‌شده با 'LVM'، 'MDD' و 'DSK':
.PP
.TP 8
\
owndskline\ \ \ DSKNAME:8 DSKBUSY:7 DSKNREAD:6 DSKNWRITE:6 DSKKBPERRD:4 DSKKBPERWR:4 DSKMBPERSECRD:5 DSKMBPERSECWR:5 DSKAVQUEUE:1 DSKAVIO:5
.PP
.TP 4
.B ownnettrline
بازتعریف خط برچسب‌گذاری‌شده با 'NET' برای لایهٔ انتقال (transport):
.PP
.TP 8
\
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
.PP
.TP 4
.B ownnetnetline
بازتعریف خط برچسب‌گذاری‌شده با 'NET' برای شبکه (network):
.PP
.TP 8
\
ownnetnetline\ \ \ NETNETWORK:5 NETIPI:4 NETIPO:4 NETIPFRW:4 NETIPDELIV:4 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 NETICMPIN:1 NETICMPOUT:1
.PP
.TP 4
.B ownnetifline
بازتعریف خط برچسب‌گذاری‌شده با 'NET' برای رابط‌ها (interfaces):
.PP
.TP 8
\
ownnetifline\ \ \ NETNAME:8 NETPCKI:7 NETPCKO:7 NETSPEEDIN:6 NETSPEEDOUT:6 NETCOLLIS:3 NETMULTICASTIN:2 NETRCVERR:5 NETSNDERR:5 NETRCVDROP:4 NETSNDDROP:4
.PP
خطوط فوق به همان ترتیبی که توسط
.I atop
در ترکیب با پرچم
.B \-f
نشان داده می‌شوند، نمایش می‌یابند (در یک پنجرهٔ بسیار عریض باید بتوانید همهٔ ستون‌ها را ببینید).
.SH "همچنین ببینید (SEE ALSO)"
.B atop(1),
.B atopsar(1),
.B atopacctd(8),
.B netatop(4),
.B netatopd(8),
.B logrotate(8)
.br
.B https://www.atoptool.nl
.SH "نویسنده (AUTHOR)"
Gerlof Langeveld (gerlof.langeveld@atoptool.nl)
.br
JC van Winkel