.\" Automatically generated by Pandoc 3.10.2
.\"
.TH "CSYSDIG" "8" "" "sysdig" "راهنمای مدیر سیستم"
.SH "نام (NAME)"
csysdig \- رابط کاربری تعاملی ncurses برای sysdig
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]csysdig\f[R] [\f[I]گزینه\f[R]]...
[\f[I]فیلتر\f[R]]
.SH "توضیحات (DESCRIPTION)"
دستور csysdig قابلیت‌های sysdig را از طریق یک رابط کاربری ساده، شهودی و قدرتمند مبتنی بر ncurses ارائه می‌دهد.
.PP
ابزار csysdig برای شبیه‌سازی و کارکردی مشابه با ابزارهایی مانند \f[B]top\f[R] و
\f[B]htop\f[R] طراحی شده است، اما امکانات و قابلیت‌های غنی‌تری ارائه می‌دهد، از جمله:
.IP \(bu 2
پشتیبانی از هر دو حالت تحلیل زنده سیستم و فایل‌های ردگیری (trace files) ابزار sysdig.
فایل‌های ردگیری می‌توانند مربوط به همان ماشین یا ماشینی دیگر باشند.
.IP \(bu 2
دیده‌پذیری و نظارت بر طیف گسترده‌ای از معیارها، از جمله پردازنده (CPU)، حافظه، ورودی/خروجی (I/O) دیسک و ورودی/خروجی شبکه.
.IP \(bu 2
قابلیت مشاهده فعالیت‌های ورودی/خروجی برای فرآیندها، فایل‌ها، اتصالات شبکه و موارد دیگر.
.IP \(bu 2
قابلیت کاوش دقیق‌تر (drill down) در فرآیندها، فایل‌ها، اتصالات شبکه و موارد دیگر جهت بررسی و تحلیل عمیق‌تر رفتار آن‌ها.
.IP \(bu 2
پشتیبانی کامل از شخصی‌سازی و سفارشی‌سازی.
.IP \(bu 2
پشتیبانی از زبان قدرتمند فیلترسازی sysdig.
.IP \(bu 2
پشتیبانی ذاتی و ساختاری از کانتینرها.
.PP
ابزار csysdig روی هر ترمینالی اجرا می‌شود و از رنگ‌ها و ورودی ماوس پشتیبانی می‌کند.
.PP
\f[B]نماها (Views)\f[R]
.PP
ابزار csysdig بر پایه مفهوم «نماها» (Views) بنا شده است؛ اسکریپت‌های کوچک به زبان Lua که نحوه جمع‌آوری، پردازش و نمایش معیارها را بر روی صفحه تعیین می‌کنند.
افزودن یک مصورسازی جدید به csysdig نیازی به به‌روزرسانی یا کامپایل مجدد برنامه ندارد و تنها با افزودن یک نمای جدید انجام می‌شود.
نماها به موتور پردازشی sysdig متکی هستند و این بدان معناست که می‌توانند شامل هر فیلد فیلتر دلخواه در sysdig باشند.
نماها در مسیر دایرکتوری chiselهای sysdig قرار دارند، که معمولاً
\f[I]/usr/share/sysdig/chisels\f[R] و \f[I]\(ti/.chisels\f[R] است.
.SH "کاربرد اولیه (BASIC USAGE)"
در اینجا چند نکته اساسی برای شروع کار با csysdig آمده است:
.IP "1." 3
اگر csysdig را بدون آرگومان اجرا کنید، داده‌های زنده سیستم را نمایش می‌دهد و هر ۲ ثانیه یک‌بار به‌روزرسانی می‌شود.
برای تحلیل یک فایل ردگیری، از گزینه خط فرمان \-r استفاده کنید.
.IP "2." 3
می‌توانید با استفاده از کلید \f[I]F2\f[R] به یک نمای دیگر جابه‌جا شوید.
.IP "3." 3
می‌توانید با فشردن کلید \f[I]Enter\f[R] به درون یک مورد انتخابی به کاوش دقیق‌تر بپردازید (drill down).
می‌توانید با فشردن کلید \f[I]Backspace\f[R] به نمای قبلی بازگردید.
.IP "4." 3
می‌توانید با فشردن کلید \f[I]F5\f[R] ورودی/خروجی مربوط به موجودیت انتخاب‌شده فعلی را مشاهده کنید.
.IP "5." 3
می‌توانید با فشردن کلید \f[I]F6\f[R] رویدادهای sysdig را برای موجودیت انتخاب‌شده فعلی مشاهده کنید.
.SH "کاوش دقیق‌تر (DRILLING DOWN)"
شما با انتخاب یک عنصر در یک نما و سپس فشردن کلید
\f[I]Enter\f[R] به کاوش دقیق‌تر می‌پردازید.
پس از ورود به یک مورد انتخابی، می‌توانید به نمای دیگری بروید و نمای جدید در زمینه (context) همان مورد انتخاب‌شده اعمال خواهد شد.
برای مثال، اگر به درون فرآیندی به نام foo کاوش کنید و سپس به نمای
\f[I]Connections\f[R] بروید، خروجی تنها شامل اتصالاتی خواهد بود که توسط
\f[I]foo\f[R] ایجاد شده یا دریافت شده‌اند.
.PP
برای کاوش‌های متوالی چندمرحله‌ای، کلید \f[I]Enter\f[R] را مکرراً فشار دهید.
برای نمونه، می‌توانید در نمای \f[I]Containers\f[R] روی یک کانتینر کلیک کنید تا فرآیندهای در حال اجرا درون آن را مشاهده کنید، و سپس روی یکی از آن فرآیندها کلیک کنید تا رشته‌های (threads) مربوط به آن را ببینید.
.SH "اقدامات و کلیدهای میانبر (ACTIONS AND HOTKEYS)"
هر نما دارای فهرستی از خطوط فرمان است که می‌توان آن‌ها را در زمینه مورد انتخاب‌شده فعلی با فشردن «کلیدهای میانبر» اجرا کرد.
برای مثال، فشردن \(aqk\(aq در نمای فرآیندها (Processes) فرآیند انتخاب‌شده را خاتمه می‌دهد (kill می‌کند) و فشردن \(aqb\(aq در نمای کانتینرها (Containers) یک پوسته تعاملی bash را درون کانتینر انتخاب‌شده باز می‌کند.
.PP
هر نما از اقدامات متفاوتی پشتیبانی می‌کند.
می‌توانید با فشردن کلید F8 مشاهده کنید که یک نما از چه اقداماتی پشتیبانی می‌کند.
می‌توانید با ویرایش فایل Lua مربوط به هر نما، اقدامات آن نما را سفارشی‌سازی کنید.
.SH "پشتیبانی از کانتینرها (CONTAINERS SUPPORT)"
راه‌اندازی csysdig با سوییچ خط فرمان \-pc موجب می‌شود بسیاری از نماها اطلاعات کانتینری تکمیلی را شامل شوند.
برای مثال، نمای \f[I]Processes\f[R] شامل ستونی خواهد بود که نشان می‌دهد فرآیند به کدام کانتینر تعلق دارد.
به طور مشابه، نمای \f[I]Connections\f[R] نشان می‌دهد که هر اتصال متعلق به کدام کانتینر است.
.SH "دستورات تعاملی (INTERACTIVE COMMANDS)"
.SS "پنجره نماها (Views Window)"
\f[B]Arrows, PgUP, PgDn, Home, End\f[R]
.PD 0
.P
.PD
تغییر مورد انتخابی و پیمایش محتوای نما، به دو صورت عمودی و افقی.
.PP
\f[B]Enter\f[R]
.PD 0
.P
.PD
کاوش دقیق‌تر در مورد هایلایت‌شده فعلی.
.PP
\f[B]Backspace\f[R]
.PD 0
.P
.PD
بازگشت به نمای قبلی.
.PP
\f[B]F2\f[R]
.PD 0
.P
.PD
نمایش پنجره انتخاب نما (View picker).
این پنجره امکان جابه‌جایی به نمایی دیگر را برای شما فراهم می‌کند.
.PP
\f[B]CTRL+F /\f[R]
.PD 0
.P
.PD
جستجوی تدریجی در فهرست موارد موجود در نما.
.PP
\f[B]F4\f[R]
.PD 0
.P
.PD
فیلتر کردن تدریجی موارد نما.
.PP
\f[B]F5, e\f[R]
.PD 0
.P
.PD
دستور \(aqecho FDs\(aq برای مورد انتخابی؛ یعنی مشاهده ورودی/خروجی توصیف‌کننده فایل (FD) برای مورد هایلایت‌شده فعلی.
.PP
\f[B]F6, d\f[R]
.PD 0
.P
.PD
دستور \(aqdig\(aq در مورد انتخابی؛ یعنی مشاهده رویدادهای sysdig برای مورد هایلایت‌شده فعلی.
برای آشنایی با نحوه تفسیر محتوای این پنجره، به صفحه راهنمای sysdig مراجعه کنید.
.PP
\f[B]F7\f[R]
.PD 0
.P
.PD
نمایش صفحه راهنما برای نمای در حال نمایش.
.PP
\f[B]F8\f[R]
.PD 0
.P
.PD
باز کردن پنل اقدامات نما.
.PP
\f[B]F9, >\f[R]
.PD 0
.P
.PD
باز کردن پنل مرتب‌سازی ستون‌ها.
.PP
\f[B]F10, q\f[R]
.PD 0
.P
.PD
خروج از برنامه.
.PP
\f[B]DEL, c\f[R]
.PD 0
.P
.PD
برای نماهایی که عناصر را بدون تجمیع بر اساس کلید فهرست می‌کنند (که با سرستون‌های زرد رنگ مشخص می‌شوند)، این دستور محتوای نما را پاک می‌کند.
.PP
\f[B]p\f[R]
.PD 0
.P
.PD
توقف موقت به‌روزرسانی‌های صفحه نمایش.
.PP
\f[B]\f[CB]<shift> <1\-9>\f[B]\f[R]
.PD 0
.P
.PD
مرتب‌سازی بر اساس ستون \f[CR]<n>\f[R].
.PP
\f[B]F1, h, ?\f[R]
.PD 0
.P
.PD
نمایش صفحه راهنما.
.SS "پنجره‌های Echo و sysdig (Echo and sysdig Windows)"
\f[B]Arrows, PgUP, PgDn, Home, End\f[R]
.PD 0
.P
.PD
پیمایش محتوای صفحه.
.PP
\f[B]Backspace\f[R]
.PD 0
.P
.PD
بازگشت به نمای قبلی.
.PP
\f[B]CTRL+F /\f[R]
.PD 0
.P
.PD
جستجو در محتوای پنجره.
.PP
\f[B]F3\f[R]
.PD 0
.P
.PD
یافتن مورد بعدی (Find Next).
.PP
\f[B]F2\f[R]
.PD 0
.P
.PD
انتخاب قالب رندر خروجی.
گزینه‌ها عبارتند از \(aqDotted ASCII\(aq (بایت‌های باینری غیرقابل چاپ به صورت نقطه نمایش داده می‌شوند)، \(aqPrintable ASCII\(aq (بایت‌های باینری غیرقابل چاپ گنجانده نمی‌شوند و انتهای خطوط به دقت نمایش داده می‌شوند) و \(aqHex\(aq (نمایش اسکی نقطه‌دار همراه با نمایش هگزادسیمال بافرها گنجانده می‌شود).
.PP
\f[B]DEL, c\f[R]
.PD 0
.P
.PD
پاک کردن محتوای صفحه نمایش.
.PP
\f[B]p\f[R]
.PD 0
.P
.PD
توقف موقت به‌روزرسانی‌های صفحه نمایش.
.PP
\f[B]CTRL+G\f[R]
.PD 0
.P
.PD
رفتن به سطر مشخص.
.SS "پنجره طیف‌نگار (Spectrogram Window)"
\f[B]F2\f[R]
.PD 0
.P
.PD
نمایش پنجره انتخاب نما.
این پنجره امکان جابه‌جایی به نمایی دیگر را برای شما فراهم می‌کند.
.PP
\f[B]p\f[R]
.PD 0
.P
.PD
توقف موقت یا ازسرگیری مصورسازی.
.PP
\f[B]Backspace\f[R]
.PD 0
.P
.PD
بازگشت به نمای قبلی.
.SH "استفاده از ماوس (MOUSE USAGE)"
.IP \(bu 2
کلیک روی سرستون‌ها امکان مرتب‌سازی جدول را به شما می‌دهد.
.IP \(bu 2
دوبار کلیک روی ردیف‌ها عملیات کاوش دقیق‌تر (drill down) را انجام می‌دهد.
.IP \(bu 2
کلیک روی رشته فیلتر در بالای صفحه (متن بعد از \(aqFilter:\(aq) به شما امکان می‌دهد فیلتر sysdig را تغییر داده و محتوای نما را شخصی‌سازی کنید.
.IP \(bu 2
می‌توانید با کلیک ماوس روی گزینه‌های منو در پایین صفحه، اقدامات مربوط به هر یک را اجرا کنید.
.SH "گزینه‌های خط فرمان (COMMAND LINE OPTIONS)"
\f[B]\-d\f[R] \f[I]period\f[R], \f[B]\-\-delay\f[R]=\f[I]period\f[R]
.PD 0
.P
.PD
تنظیم فاصله زمانی میان به‌روزرسانی‌ها به میلی‌ثانیه (مقدار پیش‌فرض = ۲۰۰۰).
عملکرد این گزینه مشابه با گزینه \-d در ابزار top است.
.PP
\f[B]\-E\f[R], \f[B]\-\-exclude\-users\f[R]
.PD 0
.P
.PD
هنگام آغاز به کار sysdig، از ایجاد جداول کاربر/گروه با استعلام از سیستم‌عامل خودداری می‌کند.
این همچنین به این معناست که هیچ اطلاعات کاربر یا گروهی با فلگ \-w در فایل ردگیری ذخیره نخواهد شد.
جداول کاربر/گروه برای استفاده از فیلدهای فیلترسازی مانند user.name یا group.name لازم هستند.
با این وجود، ایجاد این جداول ممکن است زمان راه‌اندازی اولیه sysdig را افزایش دهد.
.PP
\f[B]\-\-force\-term\-compat\f[R]
.PD 0
.P
.PD
تلاش برای اعمال تنظیمات ساده ترمینال (xterm\-1002) که با نرم‌افزارهایی مانند PuTTY سازگاری بهتری دارند.
اگر با مشکلات ترمینال از جمله عدم کارکرد صحیح ماوس مواجه شدید، از این فلگ استفاده کنید.
.PP
\f[B]\-h\f[R], \f[B]\-\-help\f[R]
.PD 0
.P
.PD
چاپ این صفحه راهنما.
.PP
\f[B]\-k\f[R], \f[B]\-\-k8s\-api\f[R]
.PD 0
.P
.PD
فعال‌سازی پشتیبانی از کوبرنتیز (Kubernetes) از طریق اتصال به سرور API که به عنوان آرگومان مشخص شده است.
به عنوان مثال:
\(dq\c
.UR http://admin:password@127.0.0.1:8080
.UE \c
\(dq.
همچنین می‌توان سرور API را از طریق متغیر محیطی SYSDIG_K8S_API مشخص کرد.
.PP
\f[B]\-K\f[R] \f[I]btfile | certfile:keyfile[#password][:cacertfile]\f[R], \f[B]\-\-k8s\-api\-cert=\f[R]\f[I]btfile | certfile:keyfile[#password][:cacertfile]\f[R]
.PD 0
.P
.PD
استفاده از نام فایل‌های ارائه‌شده برای احراز هویت کاربر و (به صورت اختیاری) تأیید هویت سرور API کوبرنتیز.
هر مدخل باید مسیر کامل (مطلق، یا نسبی نسبت به دایرکتوری جاری) به فایل مربوطه را مشخص کند.
رمز عبور کلید خصوصی اختیاری است (تنها در صورتی که کلید با رمز محافظت شده باشد لازم است).
گواهی CA اختیاری است.
برای تمام فایل‌ها، تنها قالب فایل PEM پشتیبانی می‌شود.
مشخص کردن گواهی CA به تنهایی منسوخ شده است \- اگر یک ورودی منفرد برای این گزینه داده شود، به عنوان نام فایل حاوی توکن حامل (bearer token) تفسیر خواهد شد.
توجه داشته باشید که قالب این گزینه خط فرمان، استفاده از نام فایل‌هایی را که شامل نویسه‌های \(aq:\(aq یا \(aq#\(aq باشند ممنوع می‌سازد.
این گزینه را می‌توان از طریق متغیر محیطی SYSDIG_K8S_API_CERT نیز مشخص نمود.
.PP
\f[B]\-l\f[R], \f[B]\-\-list\f[R]
.PD 0
.P
.PD
فهرست کردن تمام فیلدهایی که امکان استفاده از آن‌ها در نماها وجود دارد.
.PP
\f[B]\-\-logfile\f[R] \f[I]file\f[R]
.PD 0
.P
.PD
ذخیره و چاپ گزارش‌های لاگ برنامه در فایل مشخص‌شده.
.PP
\f[B]\-m\f[R] \f[I]url[,marathon\-url]\f[R], \f[B]\-\-mesos\-api=\f[R]\f[I]url[,marathon\-url]\f[R]
.PD 0
.P
.PD
فعال‌سازی پشتیبانی از Mesos از طریق اتصال به سرور API ارائه‌شده به عنوان آرگومان (مانند
\c
.UR http://admin:password@127.0.0.1:5050
.UE \c
).
آدرس URL مربوط به Mesos الزامی است.
آدرس Marathon اختیاری است و به طور پیش‌فرض روی دنبال کردن خودکار (auto\-follow) تنظیم است \- اگر سرور API مربوط به Marathon مشخص نشود، csysdig سعی می‌کند نشانی سرور API ماراتن را از سرور مستر Mesos استعلام کند (و در صورت جابه‌جایی، متعاقباً آن را دنبال کند).
توجه داشته باشید که با فعال بودن auto\-follow، ابزار csysdig به احتمال زیاد آدرس IP داخلی کلاستر را برای سرور API ماراتن دریافت می‌کند، بنابراین اجرای csysdig با قابلیت auto\-follow ماراتن از گرهی که عضوی از کلاستر Mesos نیست ممکن است به درستی کار نکند.
علاوه بر این، اجرای csysdig با پشتیبانی Mesos روی گرهی که فاقد هرگونه کانتینر مدیریت‌شده با Mesos است فایده چندانی ندارد، زیرا اگرچه متادیتای کلاستر گردآوری می‌شود، اما امکان فیلترسازی بر اساس Mesos/Marathon در دسترس نخواهد بود.
سرورهای API را می‌توان از طریق متغیر محیطی SYSDIG_MESOS_API نیز تعیین کرد.
.PP
\f[B]\-n\f[R] \f[I]num\f[R], \f[B]\-\-numevents\f[R]=\f[I]num\f[R]
.PD 0
.P
.PD
توقف ضبط رویدادها پس از ثبت \f[I]num\f[R] رویداد.
.PP
\f[B]\-\-page\-faults\f[R]
.PD 0
.P
.PD
ثبت نقص‌های صفحه (page faults) عمده و جزئی در فضای کاربری و هسته.
.PP
\f[B]\-pc\f[R], \f[B]\-pcontainers\f[R]
.PD 0
.P
.PD
دستور به csysdig برای به‌کارگیری قالبی سازگار با کانتینرها در نماهای خود.
این امر موجب می‌شود چندین نما شامل ستون‌های تکمیلی مرتبط با کانتینر شوند.
.PP
\f[B]\-R\f[R], \f[B]\-\-resolve\-ports\f[R]
.PD 0
.P
.PD
تبدیل شماره درگاه‌ها (پورت‌ها) به نام خدمات متناظر.
.PP
\f[B]\-r\f[R] \f[I]readfile\f[R], \f[B]\-\-read\f[R]=\f[I]readfile\f[R]
.PD 0
.P
.PD
خواندن رویدادها از فایل \f[I]readfile\f[R].
.PP
\f[B]\-s\f[R] \f[I]len\f[R], \f[B]\-\-snaplen\f[R]=\f[I]len\f[R]
.PD 0
.P
.PD
ضبط اولین \f[I]len\f[R] بایت از هر بافر ورودی/خروجی (I/O).
به طور پیش‌فرض، ۸۰ بایت نخست ضبط می‌شود.
از این گزینه با احتیاط استفاده کنید، زیرا می‌تواند فایل‌های ردگیری بسیار حجیمی تولید کند.
.PP
\f[B]\-T\f[R], \f[B]\-\-force\-tracers\-capture\f[R]
.PD 0
.P
.PD
دستور به درایور جهت اطمینان از ضبط بافرهای کامل از مسیر dev/null/، به منظور اطمینان از ثبت کامل ردیاب‌ها (tracers).
توجه داشته باشید که sysdig پس از تشخیص اینکه ردیاب‌ها در آن مسیر نوشته می‌شوند، قابلیت ضبط گسترش‌یافته dev/null/ را خودبه‌خود فعال می‌کند، اما این امر ممکن است سبب بریده شدن (truncation) برخی ردیاب‌ها در ابتدای عملیات ضبط شود.
این گزینه مانع از بروز این مشکل می‌شود.
.PP
\f[B]\-v\f[R] \f[I]view_id\f[R], \f[B]\-\-views\f[R]=\f[I]view_id\f[R]
.PD 0
.P
.PD
اجرای نمای دارای شناسه (ID) داده‌شده هنگام شروع برنامه csysdig.
شناسه‌های نماها را می‌توان در صفحات مستندات نما در csysdig یافت.
ترکیب این گزینه با یک فیلتر خط فرمان، امکان شخصی‌سازی کامل خروجی را فراهم می‌سازد.
.PP
\f[B]\-\-version\f[R]
.PD 0
.P
.PD
چاپ شماره نسخه برنامه.
.SH "فیلتر کردن (FILTERING)"
مشابه کاری که با sysdig انجام می‌دهید، می‌توانید فیلتری را در خط فرمان مشخص کنید تا رویدادهایی که csysdig پردازش می‌کند محدود شوند.
جهت ویرایش فیلتر در حین اجرای برنامه یا افزودن فیلتر در زمان اجرا، با ماوس روی متن فیلتر در رابط کاربری کلیک کنید.
.SH "شخصی‌سازی CSYSDIG (CUSTOMIZING CSYSDIG)"
ابزار csysdig کاملاً قابل تنظیم و شخصی‌سازی است.
این بدان معناست که می‌توانید هر یک از نماهای csysdig را تغییر داده و حتی نماهای اختصاصی خود را بسازید.
مشابه چیسل‌های sysdig، نماهای csysdig اسکریپت‌های Lua هستند.
اطلاعات تکمیلی را می‌توانید در صفحه ویکی گیت‌هاب زیر بیابید: \c
.UR https://github.com/draios/sysdig/wiki/csysdig-View-Format-Reference
.UE \c
\&.
.SH "فایل‌ها (FILES)"
\f[I]/usr/share/sysdig/chisels\f[R]
.PD 0
.P
.PD
دایرکتوری سراسری نماها در سیستم.
.PP
\f[I]\(ti/.chisels\f[R]
.PD 0
.P
.PD
دایرکتوری شخصی کاربر برای نماها.
.SH "نویسنده (AUTHOR)"
.PP
Draios Inc.
(dba Sysdig) \c
.MT info@sysdig.com
.ME \c
.SH "همچنین ببینید (SEE ALSO)"
\f[B]sysdig\f[R](8), \f[B]strace\f[R](8), \f[B]tcpdump\f[R](8),
\f[B]lsof\f[R](8)