.\" Automatically generated by Pandoc 3.10.2
.\"
.TH "SYSDIG" "8" "" "sysdig" "راهنمای مدیر سیستم"
.SH "نام (NAME)"
sysdig \- ابزار جامع و نهایی عیب‌یابی سیستم و فرآیندها
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]sysdig\f[R] [\f[I]گزینه\f[R]]...
[\f[I]فیلتر\f[R]]
.SH "توضیحات (DESCRIPTION)"
\f[B]نکته: چنانچه به رابط کاربری ساده‌تری برای استفاده از امکانات sysdig علاقه‌مندید، از ابزار خط فرمان csysdig استفاده کنید.\f[R]
.PP
ابزار sysdig برنامه‌ای برای عیب‌یابی، تحلیل و کاوش در سیستم است.
از این ابزار می‌توان برای ضبط، فیلتر کردن و رمزگشایی فراخوان‌های سیستمی (system calls) و سایر رویدادهای سیستم‌عامل استفاده نمود.
ابزار sysdig را هم می‌توان برای بازرسی سیستم‌های زنده به کار برد و هم برای تولید فایل‌های ردگیری (trace files) که می‌توانند در مراحل بعدی مورد تجزیه و تحلیل قرار گیرند.
.PP
ابزار sysdig شامل یک زبان فیلترسازی قدرتمند است، خروجی‌های قابل سفارشی‌سازی دارد، و می‌تواند از طریق اسکریپت‌های Lua که چیسل (chisel) نامیده می‌شوند توسعه یابد.
.PP
\f[B]قالب خروجی (Output format)\f[R]
.PP
به‌طور پیش‌فرض، sysdig اطلاعات هر رویداد ثبت‌شده را در یک خط منفرد و با قالب زیر چاپ می‌کند:
.PP
\f[CR]*%evt.num %evt.time %evt.cpu %proc.name (%thread.tid) %evt.dir %evt.type %evt.info\f[R]
.PP
که در آن:
.IP \(bu 2
\f[I]evt.num\f[R] شماره افزایشی رویداد است
.IP \(bu 2
\f[I]evt.time\f[R] برچسب زمان (timestamp) رویداد است
.IP \(bu 2
\f[I]evt.cpu\f[R] شماره پردازنده‌ای (CPU) است که رویداد در آن ضبط شده است
.IP \(bu 2
\f[I]proc.name\f[R] نام فرآیندی است که رویداد را ایجاد کرده است
.IP \(bu 2
\f[I]thread.tid\f[R] شناسه رشته‌ای (TID) است که رویداد را ایجاد کرده، که برای فرآیندهای تک‌رشته‌ای معادل PID است
.IP \(bu 2
\f[I]evt.dir\f[R] جهت رویداد است؛ > برای رویدادهای ورود (enter) و < برای رویدادهای خروج (exit)
.IP \(bu 2
\f[I]evt.type\f[R] نام رویداد است، مانند
\(aqopen\(aq یا \(aqread\(aq
.IP \(bu 2
\f[I]evt.args\f[R] فهرست آرگومان‌های رویداد است.
.PP
قالب خروجی را می‌توان با سوییچ
.B \-p
و با استفاده از هر یک از فیلدهای فهرست‌شده توسط دستور
\(aqsysdig \-l\(aq
شخصی‌سازی کرد.
.PP
با استفاده از
.B \-pc
یا
.BR \-pcontainer ,
قالب پیش‌فرض به قالبی سازگار با کانتینرها تغییر خواهد کرد:
.PP
\f[CR]*%evt.num %evt.time %evt.cpu %container.name (%container.id) %proc.name (%thread.tid:%thread.vtid) %evt.dir %evt.type %evt.info\f[R]
.PP
\f[B]فایل‌های ردگیری (Trace Files)\f[R]
.PP
یک فایل ردگیری را می‌توان با استفاده از سوییچ
.B \-w
ایجاد کرد:
.RS
.PP
$ sysdig \-w trace.scap
.RE
.PP
سوییچ
.B \-s
می‌تواند برای تعیین تعداد بایت‌هایی از هر بافر داده که باید روی دیسک ذخیره شود، استفاده شود.
همچنین از فیلترها می‌توان برای ذخیره تنها رویدادهای خاصی روی دیسک بهره گرفت:
.RS
.PP
$ sysdig \-s 2000 \-w trace.scap proc.name=cat
.RE
.PP
فایل‌های ردگیری را می‌توان با استفاده از سوییچ
.B \-r
خواند:
.RS
.PP
$ sysdig \-r trace.scap
.RE
.PP
\f[B]فیلتر کردن (Filtering)\f[R]
.PP
فیلترهای sysdig در انتهای خط فرمان مشخص می‌شوند.
ساده‌ترین فیلتر یک بررسی پایه‌ای مقدار و فیلد است:
.RS
.PP
$ sysdig proc.name=cat
.RE
.PP
فهرست فیلدهای موجود را می‌توان با دستور \(aqsysdig \-l\(aq به دست آورد.
عبارات فیلتر می‌توانند از یکی از این عملگرهای مقایسه‌ای استفاده کنند:
\f[I]=\f[R]، \f[I]!=\f[R]، \f[I]<\f[R]، \f[I]<=\f[R]، \f[I]>\f[R]،
\f[I]>=\f[R]، \f[I]contains\f[R]، \f[I]icontains\f[R]، \f[I]in\f[R] و
\f[I]exists\f[R].
برای مثال:
.RS
.PP
$ sysdig fd.name contains /etc
.PP
$ sysdig \(dqevt.type in ( \(aqselect\(aq, \(aqpoll\(aq )\(dq
.PP
$ sysdig proc.name exists
.RE
.PP
می‌توان چند بررسی را با پرانتز و عملگرهای بولی زیر ترکیب کرد:
\f[I]and\f[R]، \f[I]or\f[R]، \f[I]not\f[R].
برای مثال:
.RS
.PP
$ sysdig \(dqnot (fd.name contains /proc or fd.name contains /dev)\(dq
.RE
.PP
\f[B]چیسل‌ها (Chisels)\f[R]
.PP
چیسل‌های (chisels) sysdig اسکریپت‌های کوچکی هستند که جریان رویدادهای sysdig را به منظور انجام عملیات‌های مفید تحلیل می‌کنند.
برای دریافت فهرست چیسل‌های موجود، دستور زیر را وارد کنید:
.RS
.PP
$ sysdig \-cl
.RE
.PP
برای دریافت جزئیات درباره یک چیسل خاص، دستور زیر را وارد کنید:
.RS
.PP
$ sysdig \-i spy_ip
.RE
.PP
برای اجرای یکی از چیسل‌ها، از فلگ
.B \-c
استفاده کنید، برای مثال:
.RS
.PP
$ sysdig \-c topfiles_bytes
.RE
.PP
اگر یک چیسل به آرگومان نیاز داشته باشد، آن‌ها را پس از نام چیسل مشخص می‌کنید:
.RS
.PP
$ sysdig \-c spy_ip 192.168.1.157
.RE
.PP
اگر چیسل بیش از یک آرگومان داشته باشد، آن‌ها را پس از نام چیسل درون علامت نقل‌قول قرار دهید:
.RS
.PP
$ sysdig \-c chisel_name \(dqarg1 arg2 arg3\(dq
.RE
.PP
چیسل‌ها را می‌توان با فیلترها ترکیب نمود:
.RS
.PP
$ sysdig \-c topfiles_bytes \(dqnot fd.name contains /dev\(dq
.RE
.SH "گزینه‌ها (OPTIONS)"
\f[B]\-A\f[R], \f[B]\-\-print\-ascii\f[R]
.PD 0
.P
.PD
فقط چاپ بخش متنی بافرهای داده، و چاپ نویسه‌های انتهای خط.
این گزینه برای نمایش داده‌های خوانا برای انسان مفید است.
.PP
\f[B]\-b\f[R], \f[B]\-\-print\-base64\f[R]
.PD 0
.P
.PD
چاپ بافرهای داده در قالب base64.
این گزینه برای کدگذاری داده‌های دودویی (باینری) که باید در محیط‌های ویژه مدیریت داده‌های متنی (مانند ترمینال یا json) استفاده شوند، کاربرد دارد.
.PP
\f[B]\-c\f[R] \f[I]chiselname\f[R] \f[I]chiselargs\f[R],
\f[B]\-\-chisel\f[R]=\f[I]chiselname\f[R] \f[I]chiselargs\f[R]
.PD 0
.P
.PD
اجرای چیسل مشخص‌شده.
اگر چیسل به آرگومان نیاز داشته باشد، باید در خط فرمان پس از نام آن قید شوند.
.PP
\f[B]\-C\f[R] \f[I]filesize\f[R]
.PD 0
.P
.PD
تقسیم عملیات ضبط به فایل‌های جداگانه، و محدود کردن اندازه هر فایل بر اساس تعداد مگابایت مشخص‌شده.
واحد \f[I]filesize\f[R] میلیون بایت (10\(ha6، نه 2\(ha20) است.
جهت فعال‌سازی چرخش خودکار فایل‌ها، همراه با
.B \-W
استفاده شود.
در غیر این صورت، ایجاد فایل‌های جدید تا زمان توقف دستی عملیات ضبط ادامه خواهد یافت.
.PP
فایل‌ها نام مشخص‌شده توسط
.B \-w
را همراه با یک شمارنده که از ۰ آغاز می‌شود خواهند داشت.
.PP
\f[B]\-cl\f[R], \f[B]\-\-list\-chisels\f[R]
.PD 0
.P
.PD
فهرست کردن چیسل‌های موجود.
ابزار sysdig چیسل‌ها را در دایرکتوری‌های زیر جستجو می‌کند: ./chisels،
\(ti/.chisels و /usr/share/sysdig/chisels.
.PP
\f[B]\-d\f[R], \f[B]\-\-displayflt\f[R]
.PD 0
.P
.PD
تبدیل فیلتر ارائه‌شده به فیلتر نمایشی.
تنظیم این گزینه باعث می‌شود رویدادها پس از تجزیه توسط سیستم وضعیت (state system) فیلتر شوند.
رویدادها معمولاً پیش از تجزیه و تحلیل فیلتر می‌شوند که کارآمدتر است، اما می‌تواند منجر به از دست رفتن وضعیت (مانند نام توصیف‌کننده‌های فایل یا FD) شود.
.PP
\f[B]\-D\f[R], \f[B]\-\-debug\f[R]
.PD 0
.P
.PD
ضبط رویدادهای مربوط به خود sysdig، نمایش رویدادهای داخلی افزون بر رویدادهای سیستم، و چاپ لاگ‌های تکمیلی روی خطای استاندارد (stderr).
.PP
\f[B]\-E\f[R], \f[B]\-\-exclude\-users\f[R]
.PD 0
.P
.PD
عدم ایجاد جدول‌های کاربر/گروه از طریق استعلام از سیستم‌عامل در زمان راه‌اندازی sysdig.
این همچنین بدان معناست که هیچ اطلاعات کاربری یا گروهی توسط فلگ
.B \-w
در فایل ردگیری نوشته نخواهد شد.
جدول‌های کاربر/گروه برای استفاده از فیلدهای فیلتر مانند user.name یا group.name ضروری هستند.
با این حال، ایجاد آن‌ها می‌تواند زمان راه‌اندازی sysdig را افزایش دهد.
علاوه بر این، آن‌ها حاوی اطلاعاتی هستند که ممکن است از نظر حریم خصوصی حساس باشند.
.PP
\f[B]\-e\f[R] \f[I]numevents\f[R]
.PD 0
.P
.PD
تقسیم عملیات ضبط به فایل‌های جداگانه، و محدود کردن اندازه هر فایل بر اساس تعداد مشخص رویدادها.
همراه با
.B \-W
برای فعال‌سازی چرخش خودکار فایل‌ها استفاده شود.
در غیر این صورت، ایجاد فایل‌های جدید تا زمان توقف دستی عملیات ضبط ادامه می‌یابد.
.PP
فایل‌ها نام مشخص‌شده توسط
.B \-w
را همراه با یک شمارنده که از ۰ آغاز می‌شود خواهند داشت.
.PP
\f[B]\-F\f[R], \f[B]\-\-fatfile\f[R]
.PD 0
.P
.PD
فعال کردن حالت fatfile.
هنگام نوشتن در حالت fatfile، فایل خروجی حاوی رویدادهایی خواهد بود که هنگام خواندن فایل نامرئی هستند، اما برای بازسازی کامل وضعیت سیستم ضروری می‌باشند.
حالت fatfile هنگام ذخیره رویدادها روی دیسک با فیلترهای تهاجمی و سخت‌گیرانه کاربرد دارد.
چنین فیلتری ممکن است رویدادهایی را که سبب به‌روزرسانی وضعیت می‌شوند (مانند ()clone یا ()open) حذف کند.
با حالت fatfile، این رویدادها همچنان در فایل ذخیره می‌شوند، اما «پنهان» خواهند بود تا در زمان خواندن فایل نمایش داده نشوند.
توجه داشته باشید که استفاده از این فلگ ممکن است فایل‌های ردگیری به مراتب حجیم‌تری ایجاد کند.
.PP
\f[B]\-\-filter\-proclist\f[R]
.PD 0
.P
.PD
اعمال فیلتر روی جدول فرآیندها.
یک رونوشت کامل از دایرکتوری proc/ معمولاً در تمام فایل‌های ردگیری گنجانده می‌شود تا اطمینان حاصل شود که تمام وضعیت‌های لازم برای رمزگشایی رویدادها در فایل موجود است.
این امر ممکن است باعث شود فایل شامل اطلاعات ناخواسته یا حساس باشد.
استفاده از این فلگ موجب می‌شود که فیلتر خط فرمان بر روی رونوشت proc/ نیز اعمال گردد.
.PP
\f[B]\-G\f[R] \f[I]numseconds\f[R]
.PD 0
.P
.PD
تقسیم عملیات ضبط به فایل‌های جداگانه، و محدود کردن اندازه هر فایل بر اساس تعداد ثانیه‌های مشخص‌شده.
همراه با
.B \-W
برای فعال‌سازی چرخش خودکار فایل‌ها استفاده شود.
در غیر این صورت، ایجاد فایل‌های جدید تا زمان توقف دستی عملیات ضبط ادامه خواهد داشت.
.PP
فایل‌ها نام مشخص‌شده توسط
.B \-w
را خواهند داشت که باید شامل قالب زمانی تعریف‌شده در strftime(3) باشد.
اگر قالب زمانی مشخص نشود، از یک شمارنده استفاده خواهد شد.
.PP
\f[B]\-h\f[R], \f[B]\-\-help\f[R]
.PD 0
.P
.PD
چاپ این صفحه راهنما.
.PP
\f[B]\-H\f[R] \f[I]pluginname\f[R][:\f[I]initconfig\f[R]],
\f[B]\-\-plugin\f[R] \f[I]pluginname\f[R][:\f[I]initconfig\f[R]]
.PD 0
.P
.PD
ثبت یک افزونه (پلاگین)، همراه با استفاده از پیکربندی اولیه‌سازی داده‌شده (در صورت وجود).
می‌توان از یک مسیر نیز به عنوان pluginname استفاده کرد.
قالب initconfig توسط افزونه تعیین می‌شود؛ برای اطلاع از آن به مستندات هر افزونه مراجعه نمایید.
.PP
\f[B]\-I\f[R] \f[I]pluginname\f[R][:\f[I]openparams\f[R]],
\f[B]\-\-input\f[R] \f[I]pluginname\f[R][:\f[I]openparams\f[R]]
.PD 0
.P
.PD
ضبط رویدادها با استفاده از افزونه با نام pluginname، و ارسال رشته openparams به عنوان پارامترها به افزونه.
قالب پارامترها توسط افزونه کنترل می‌شود؛ برای آشنایی با آن به مستندات هر افزونه رجوع کنید.
منابع رویداد موجود برای ضبط بسته به افزونه‌های نصب‌شده متفاوت است.
می‌توانید فهرست افزونه‌های بارگذاری‌شده را با استفاده از فلگ \-Il مشاهده کنید.
.PP
\f[B]\-Il\f[R], \f[B]\-\-list\-inputs\f[R]
.PD 0
.P
.PD
فهرست کردن افزونه‌های بارگذاری‌شده.
ابزار sysdig افزونه‌ها را در دایرکتوری‌های زیر جستجو می‌کند: ./plugins،
\(ti/.plugins و /usr/share/sysdig/plugins.
.PP
\f[B]\-\-plugin\-config\-file\f[R]
.PD 0
.P
.PD
بارگذاری پیکربندی افزونه از یک فایل پیکربندی yaml سازگار با Falco.
ترکیب این گزینه با \(aq\-H\(aq یا \(aq\-I\(aq پشتیبانی نمی‌شود.
برای اطلاعات بیشتر بخش پلاگین را در \c
.UR https://falco.org/docs/configuration
.UE \c
\ ببینید.
.PP
\f[B]\-i\f[R] \f[BI]chiselname\f[R],
\f[B]\-\-chisel\-info=\f[R]\f[I]chiselname\f[R]
.PD 0
.P
.PD
دریافت توضیحات کامل‌تر و آرگومان‌های مرتبط با یک چیسل موجود در فهرست گزینه \-cl.
.PP
\f[B]\-j\f[R], \f[B]\-\-json\f[R]
.PD 0
.P
.PD
تولید خروجی در قالب json؛ روش کدگذاری بافر داده به قالب چاپ انتخاب‌شده بستگی خواهد داشت.
.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
استفاده از نام فایل‌های ارائه‌شده برای احراز هویت کاربر و (در صورت تمایل) اعتبارسنجی هویت سرور K8S API.
هر ورودی باید مسیر کامل (مطلق، یا نسبی به دایرکتوری جاری) را به فایل مربوطه مشخص کند.
گذرواژه کلید خصوصی اختیاری است (تنها در صورتی که کلید با گذرواژه محافظت شده باشد لازم است).
گواهی CA اختیاری است.
برای تمام فایل‌ها، تنها قالب فایل PEM پشتیبانی می‌شود.
مشخص کردن گواهی CA به تنهایی منسوخ شده است \- اگر یک ورودی منفرد برای این گزینه داده شود، به عنوان نام فایل حاوی توکن حامل (bearer token) تفسیر خواهد شد.
توجه داشته باشید که قالب این گزینه خط فرمان، استفاده از نام فایل‌هایی را که شامل نویسه‌های \(aq:\(aq یا \(aq#\(aq باشند ممنوع می‌سازد.
این گزینه را می‌توان از طریق متغیر محیطی SYSDIG_K8S_API_CERT نیز مشخص نمود.
.PP
\f[B]\-L\f[R], \f[B]\-\-list\-events\f[R]
.PD 0
.P
.PD
فهرست کردن رویدادهایی که موتور برنامه از آن‌ها پشتیبانی می‌کند.
.PP
\f[B]\-l\f[R], \f[B]\-\-list\f[R]
.PD 0
.P
.PD
فهرست کردن فیلدهایی که می‌توان از آن‌ها برای فیلترسازی و قالب‌بندی خروجی استفاده نمود.
از \-lv برای دریافت اطلاعات بیشتر در مورد هر فیلد استفاده کنید.
.PP
\f[B]\-\-list\-markdown\f[R]
.PD 0
.P
.PD
مشابه \-l، اما خروجی را در قالب مارک‌داون (Markdown) تولید می‌کند.
.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 مشخص نشود، sysdig سعی می‌کند نشانی سرور API ماراتن را از سرور مستر Mesos استعلام کند (و در صورت جابه‌جایی، متعاقباً آن را دنبال کند).
توجه داشته باشید که با فعال بودن auto\-follow، ابزار sysdig به احتمال زیاد آدرس IP داخلی کلاستر را برای سرور API ماراتن دریافت می‌کند، بنابراین اجرای sysdig با قابلیت auto\-follow ماراتن از گرهی که عضوی از کلاستر Mesos نیست ممکن است به درستی کار نکند.
علاوه بر این، اجرای sysdig با پشتیبانی Mesos روی گرهی که فاقد هرگونه کانتینر مدیریت‌شده با Mesos است فایده چندانی ندارد، زیرا اگرچه متادیتای کلاستر گردآوری می‌شود، اما امکان فیلترسازی بر اساس Mesos/Marathon در دسترس نخواهد بود.
سرورهای API را می‌توان از طریق متغیر محیطی SYSDIG_MESOS_API نیز تعیین کرد.
.PP
\f[B]\-M\f[R] \f[I]num_seconds\f[R]
.PD 0
.P
.PD
توقف گردآوری پس از رسیدن به \f[I]num_seconds\f[R] ثانیه.
.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]\-P\f[R], \f[B]\-\-progress\f[R]
.PD 0
.P
.PD
چاپ میزان پیشرفت روی خطای استاندارد (stderr) هنگام پردازش فایل‌های ردگیری.
.PP
\f[B]\-p\f[R] \f[I]outputformat\f[R],
\f[B]\-\-print\f[R]=\f[I]outputformat\f[R]
.PD 0
.P
.PD
تعیین قالب مورد استفاده هنگام چاپ رویدادها.
استفاده از \-pc یا \-pcontainer از قالبی سازگار با کانتینر استفاده خواهد کرد.
استفاده از \-pk یا \-pkubernetes از قالبی سازگار با کوبرنتیز استفاده خواهد کرد.
استفاده از \-pm یا \-pmesos از قالبی سازگار با Mesos استفاده خواهد کرد.
تعیین گزینه \f[B]\-pp\f[R] در خط فرمان موجب چاپ قالب پیش‌فرض خط فرمان توسط sysdig و سپس خروج از برنامه می‌شود.
.PP
\f[B]\-q\f[R], \f[B]\-\-quiet\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]\-R\f[R], \f[B]\-\-resolve\-ports\f[R]
.PD 0
.P
.PD
تبدیل شماره درگاه‌ها (پورت‌ها) به نام خدمات متناظر.
.PP
\f[B]\-S\f[R], \f[B]\-\-summary\f[R]
.PD 0
.P
.PD
چاپ چکیده رویدادها (یعنی فهرست رویدادهای برتر) هنگام پایان عملیات ضبط.
.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[I]timetype\f[R],
\f[B]\-\-timetype\f[R]=\f[I]timetype\f[R]
.PD 0
.P
.PD
تغییر نحوه نمایش زمان رویدادها.
مقادیر پذیرفته‌شده عبارتند از:
\f[B]h\f[R] برای رشته زمان خوانا توسط انسان،
\f[B]a\f[R] برای برچسب زمان مطلق از مبدا زمان (epoch)،
\f[B]r\f[R] برای زمان نسبی نسبت به اولین رویداد نمایش‌داده‌شده،
\f[B]d\f[R] برای اختلاف زمان (دلتا) میان ورود و خروج رویداد، و
\f[B]D\f[R] برای اختلاف زمان نسبت به رویداد پیشین.
.PP
\f[B]\-T\f[R], \f[B]\-\-force\-tracers\-capture\f[R]
.PD 0
.P
.PD
دستور به درایور جهت اطمینان از ضبط بافرهای کامل از مسیر dev/null/، به منظور اطمینان از ثبت کامل ردیاب‌ها (tracers).
توجه داشته باشید که sysdig پس از تشخیص اینکه ردیاب‌ها در آن مسیر نوشته می‌شوند، قابلیت ضبط گسترش‌یافته dev/null/ را خودبه‌خود فعال می‌کند، اما این امر ممکن است سبب ناقص ماندن برخی ردیاب‌ها در ابتدای عملیات ضبط شود.
این گزینه مانع از بروز این مشکل می‌شود.
.PP
\f[B]\-\-unbuffered\f[R]
.PD 0
.P
.PD
غیرفعال کردن بافرینگ خروجی.
این امر موجب تخلیه (flush) بی‌درنگ تک‌تک خطوط تولیدشده توسط sysdig می‌شود که اگرچه مصرف پردازنده (CPU) بیشتری به همراه دارد، اما هنگام انتقال خروجی sysdig از طریق لوله (pipe) به فرآیندی دیگر یا به یک اسکریپت بسیار مفید است.
.PP
\f[B]\-v\f[R], \f[B]\-\-verbose\f[R]
.PD 0
.P
.PD
خروجی با جزئیات کامل (Verbose).
این فلگ موجب می‌شود محتوای کامل بافرهای متنی و دودویی روی صفحه چاپ شود، به جای آنکه به ۴۰ نویسه کوتاه شود.
توجه داشته باشید که طول بافرهای داده همچنان توسط snaplen محدود است (به مستندات فلگ \-s مراجعه کنید).
گزینه \-v همچنین باعث می‌شود sysdig اطلاعات خلاصه‌ای را در پایان عملیات ضبط چاپ کند.
.PP
\f[B]\-\-version\f[R]
.PD 0
.P
.PD
چاپ شماره نسخه برنامه.
.PP
\f[B]\-w\f[R] \f[I]writefile\f[R],
\f[B]\-\-write\f[R]=\f[I]writefile\f[R]
.PD 0
.P
.PD
نوشتن رویدادهای ضبط‌شده در فایل \f[I]writefile\f[R].
.PP
\f[B]\-W\f[R] \f[I]num\f[R]
.PD 0
.P
.PD
فعال کردن چرخش فایل‌ها برای ضبط پیوسته، و محدود کردن تعداد فایل‌های ایجادشده به عدد مشخص‌شده.
به محض رسیدن به این سقف، فایل‌های قدیمی‌تر بازنویسی می‌شوند (بافر حلقوی).
همراه با گزینه‌های
\f[B]\-C\f[R] / \f[B]\-G\f[R] / \f[B]\-e\f[R]
استفاده شود تا اندازه هر فایل بر اساس تعداد مگابایت، ثانیه، و/یا رویداد (به ترتیب) محدود گردد.
.PP
\f[B]\-x\f[R], \f[B]\-\-print\-hex\f[R]
.PD 0
.P
.PD
چاپ بافرهای داده در قالب هگزادسیمال (hex).
.PP
\f[B]\-X\f[R], \f[B]\-\-print\-hex\-ascii\f[R]
.PD 0
.P
.PD
چاپ بافرهای داده در هر دو قالب هگزادسیمال و ASCII.
.PP
\f[B]\-z\f[R], \f[B]\-\-compress\f[R]
.PD 0
.P
.PD
در صورت استفاده به همراه \f[B]\-w\f[R]، فشرده‌سازی فایل‌های ردگیری را فعال می‌کند.
.SH "مثال‌ها (EXAMPLES)"
ضبط تمامی رویدادها از سیستم زنده و چاپ آن‌ها روی صفحه نمایش:
.RS
.PP
$ sysdig
.RE
.PP
ضبط تمامی رویدادها از سیستم زنده و ذخیره آن‌ها روی دیسک:
.RS
.PP
$ sysdig \-w dumpfile.scap
.RE
.PP
ضبط تمامی رویدادها در ۲۴ ساعت گذشته و ذخیره آن‌ها روی دیسک در قالب فایل‌هایی که هر کدام شامل ۱ ساعت فعالیت سیستم هستند:
.RS
.PP
$ sysdig \-G 3600 \-W 24 \-w dumpfile.scap
.RE
.PP
خواندن رویدادها از یک فایل و چاپ آن‌ها روی صفحه نمایش:
.RS
.PP
$ sysdig \-r dumpfile.scap
.RE
.PP
آماده‌سازی نسخه‌ای پالایش‌شده و امن از ضبط سیستم:
.RS
.PP
$ sysdig \-r dumpfile.scap \(aqnot evt.buffer contains foo\(aq \-w cleandump.scap
.RE
.PP
چاپ تمامی فراخوان‌های سیستمی open اجراشده توسط cat:
.RS
.PP
$ sysdig proc.name=cat and evt.type=open
.RE
.PP
چاپ نام فایل‌های بازشده توسط cat:
.RS
.PP
$ sysdig \-p\(dq%evt.arg.name\(dq proc.name=cat and evt.type=open
.RE
.PP
فهرست کردن چیسل‌های موجود:
.RS
.PP
$ sysdig \-cl
.RE
.PP
استفاده از چیسل spy_ip برای بررسی داده‌های تبادل‌شده با 192.168.1.157:
.RS
.PP
$ sysdig \-c spy_ip 192.168.1.157
.RE
.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 "اشکالات (BUGS)"
.IP \(bu 2
ابزار sysdig و چیسل‌های آن برای استفاده به همراه LuaJIT در حالت Lua 5.1 طراحی شده‌اند.
اگرچه امکان استفاده از sysdig با LuaJIT در حالت Lua 5.2 یا Lua معمولی وجود دارد، اما ممکن است برخی از چیسل‌ها طبق انتظار عمل نکنند.
.SH "نویسنده (AUTHOR)"
.PP
Draios Inc.
(معروف به sysdig) \c
.MT info@sysdigcloud.com
.ME \c
.SH "همچنین ببینید (SEE ALSO)"
\f[B]csysdig\f[R](8), \f[B]strace\f[R](8), \f[B]tcpdump\f[R](8),
\f[B]lsof\f[R](8)