.TH sstat "1" "Slurm Commands" "Slurm 26.05" "Slurm Commands"

.SH "نام (NAME)"
sstat \- نمایش اطلاعات وضعیت یک کار/گام در حال اجرا

.SH "خلاصه دستور (SYNOPSIS)"
\fBsstat\fR [\fIگزینه‌ها\fR...]

.SH "توضیحات (DESCRIPTION)"
.PP
اطلاعات وضعیت کارهای در حال اجرایی که با Slurm فراخوانی شده‌اند.
.PP
دستور \fBsstat\fR اطلاعات وضعیت کار را برای تحلیل و بررسی شما نمایش می‌دهد.
دستور \fBsstat\fR اطلاعات مربوط به CPU، تسک (Task)، گره (Node)،
اندازهٔ مجموعهٔ مقیم (RSS) و حافظهٔ مجازی (VM) را نمایش می‌دهد.
می‌توانید با استفاده از گزینهٔ \fB\-\-fields=\fR خروجی را سفارشی کرده
تا فیلدهایی که باید نشان داده شوند را مشخص نمایید.
.PP
برای کاربر ریشه (root)، دستور \fBsstat\fR داده‌های وضعیت کار را برای هر
کاری که روی سیستم در حال اجرا است نمایش می‌دهد.
.PP
برای کاربران غیر ریشه، خروجی \fBsstat\fR به کارهای خود کاربر محدود می‌شود.

.PP
\fBنکته\fR: دستور \fBsstat\fR نیازمند این است که افزونهٔ \fBjobacct_gather\fP
نصب و فعال باشد.

\fBنکته\fR: در دسترس بودن معیارها به افزونهٔ \fBjobacct_gather\fP مورد استفاده
بستگی دارد. برای نمونه، افزونهٔ jobacct_gather/cgroup در ترکیب با cgroup/v2
به دلیل محدودیت‌های رابط‌های cgroups در هسته، معیارهای حافظهٔ مجازی را ارائه نمی‌دهد
و برای فیلدهای مربوطه مقدار 0 را نمایش خواهد داد.
.SH "گزینه‌ها (OPTIONS)"

.TP
\fB\-a\fR, \fB\-\-allsteps\fR
در صورتی که هیچ گامی مشخص نشده باشد، تمام گام‌های کار(های) داده‌شده را چاپ می‌کند.
.IP

.TP
\fB\-o\fR, \fB\-\-format\fR, \fB\-\-fields\fR
فهرستی از فیلدها که با کاما از هم جدا شده‌اند.
(برای فهرستی از فیلدهای موجود از '\-\-helpformat' استفاده کنید).

\fBنکته\fR: هنگام استفاده از گزینهٔ format برای فهرست کردن فیلدهای مختلف، می‌توانید یک
NUMBER% در ادامهٔ آن قرار دهید تا مشخص کنید چه تعداد نویسه باید چاپ شود.

به‌عنوان مثال format=name%30 تعداد ۳۰ نویسه از نام فیلد را به‌صورت راست‌چین چاپ
می‌کند. مقدار \-30 تعداد ۳۰ نویسه را به‌صورت چپ‌چین چاپ خواهد کرد.
.IP

.TP
\fB\-h\fR, \fB\-\-help\fR
یک پیام راهنمای کلی را نمایش می‌دهد.
.IP

.TP
\fB\-e\fR, \fB\-\-helpformat\fR
فهرستی از فیلدهایی را که می‌توان با گزینهٔ '\-\-format' تعیین کرد، چاپ می‌کند.
.IP

.TP
\fB\-j\fR, \fB\-\-jobs\fR
قالب به‌صورت <job(.step)> است. وضعیت این گام کاری یا فهرستی از گام‌های کاری
جداشده با کاما را نمایش می‌دهد. کارها ممکن است با شناسهٔ عددی کار (job ID) یا SLUID مشخص شوند.
این گزینه الزامی است. هنگامی که هیچ گامی مشخص نشده باشد، تنها گام عادی با کمترین شماره
(به‌استثنای batch، extern و غیره) نمایش داده می‌شود.
از پرچم \fB\-\-allsteps\fR برای نمایش تمام گام‌های در حال اجرا برای کار(های) داده‌شده
استفاده کنید.
\fBنکته\fR: شناسهٔ گام 'batch' اطلاعات مربوط به گام batch را نمایش خواهد داد.
\fBنکته\fR: شناسهٔ گام 'extern' اطلاعات مربوط به گام extern را نمایش خواهد داد.
این گام تنها هنگام استفاده از PrologFlags=contain در دسترس است.
.IP

.TP
\fB\-\-noconvert\fR
واحدها را از نوع اصلی‌شان تبدیل نمی‌کند (برای نمونه 2048M به 2G تبدیل نخواهد شد).
.IP

.TP
\fB\-n\fR, \fB\-\-noheader\fR
هیچ سرآیندی به خروجی افزوده نخواهد شد. عمل پیش‌فرض نمایش سرآیند است.
.IP

.TP
\fB\-p\fR, \fB\-\-parsable\fR
خروجی با '|' تفکیک خواهد شد و یک '|' در انتها خواهد داشت.
.IP

.TP
\fB\-P\fR, \fB\-\-parsable2\fR
خروجی با '|' تفکیک خواهد شد بدون اینکه '|' در انتها داشته باشد.
.IP

.TP
\fB\-i\fR, \fB\-\-pidformat\fR
قالب از پیش تعریف‌شده برای فهرست کردن pidهای در حال اجرا برای هر گام کاری.
(JobId,Nodes,Pids)
.IP

.TP
\fB\-\-usage\fR
خلاصه‌ای از کاربرد دستور را نمایش می‌دهد.
.IP

.TP
\fB\-v\fR, \fB\-\-verbose\fR
عمدتاً برای اهداف اشکال‌زدایی، وضعیت متغیرهای گوناگون را در طول پردازش گزارش می‌کند.
.IP

.TP
\fB\-V\fR, \fB\-\-version\fR
نسخه را چاپ می‌کند.
.IP

.SS "فیلدهای وضعیت کار (Job Status Fields)"
توضیحات مربوط به هر گزینهٔ فیلد را می‌توانید در زیر بیابید.
توجه داشته باشید که فیلدهای حسابداری Ave*، Max* و Min* مقادیر را برای
تمام تسک‌های هر گام در یک کار بررسی کرده و میانگین، بیشینه یا کمینهٔ مقادیر
تسک را برای آن گام کاری بازمی‌گردانند. برای نمونه، برای MaxRSS، مقدار
بازگردانده‌شده بیشینهٔ مصرف حافظه مشاهده‌شده توسط یکی از تسک‌های گام است،
و MaxRSSTask نشان می‌دهد که این کدام تسک است.
.RS

.TP
\f3AllocTRES\fP
میزان TRES تخصیص‌یافته به تمام تسک‌های موجود در کار.
.IP

.TP
\f3AveCPU\fP
میانگین زمان پردازنده (سیستم + کاربر) تمام تسک‌های موجود در کار.
.IP

.TP
\f3AveCPUFreq\fP
میانگین وزنی بسامد (فرکانس) پردازنده برای تمام تسک‌های موجود در کار، برحسب کیلوهرتز (kHz).
.IP

.TP
\f3AveDiskRead\fP
میانگین تعداد بایت‌های خوانده‌شده توسط تمام تسک‌های موجود در کار.
.IP

.TP
\f3AveDiskWrite\fP
میانگین تعداد بایت‌های نوشته‌شده توسط تمام تسک‌های موجود در کار.
.IP

.TP
\f3AvePages\fP
میانگین تعداد خطاهای صفحه (page faults) در تمام تسک‌های موجود در کار.
.IP

.TP
\f3AveRSS\fP
میانگین اندازهٔ مجموعهٔ مقیم (RSS) تمام تسک‌های موجود در کار.
.IP

.TP
\f3AveVMSize\fP
میانگین اندازهٔ حافظهٔ مجازی (VM) تمام تسک‌های موجود در کار.
.IP

.TP
\f3ConsumedEnergy\fP
مجموع انرژی مصرف‌شده توسط تمام تسک‌های موجود در کار، برحسب ژول.
نکته: تنها در صورت تخصیص اختصاصی کار، این مقدار نمایانگر مصرف واقعی
انرژی کار خواهد بود.
.IP

.TP
\f3JobID\fP
شمارهٔ کار یا گام کار.
به این صورت است:
\f2job.jobstep\fP
.IP

.TP
\f3MaxDiskRead\fP
بیشینهٔ تعداد بایت‌های خوانده‌شده توسط تمام تسک‌های موجود در کار.
.IP

.TP
\f3MaxDiskReadNode\fP
گره‌ای که maxdiskread روی آن رخ داده است.
.IP

.TP
\f3MaxDiskReadTask\fP
شناسهٔ تسکی که maxdiskread در آن رخ داده است.
.IP

.TP
\f3MaxDiskWrite\fP
بیشینهٔ تعداد بایت‌های نوشته‌شده توسط تمام تسک‌های موجود در کار.
.IP.TP
\f3MaxDiskWriteNode\fP
گره‌ای که maxdiskwrite روی آن رخ داده است.
.IP

.TP
\f3MaxDiskWriteTask\fP
شناسهٔ تسکی (task ID) که maxdiskwrite در آن رخ داده است.
.IP

.TP
\f3MaxPages\fP
بیشینهٔ تعداد خطاهای صفحه (page faults) در میان تمام تسک‌های کار.
.IP

.TP
\f3MaxPagesNode\fP
گره‌ای که maxpages روی آن رخ داده است.
.IP

.TP
\f3MaxPagesTask\fP
شناسهٔ تسکی که maxpages در آن رخ داده است.
.IP

.TP
\f3MaxRSS\fP
بیشینهٔ اندازهٔ مجموعه مقیم (resident set size) در میان تمام تسک‌های کار.
.IP

.TP
\f3MaxRSSNode\fP
گره‌ای که maxrss روی آن رخ داده است.
.IP

.TP
\f3MaxRSSTask\fP
شناسهٔ تسکی که maxrss در آن رخ داده است.
.IP

.TP
\f3MaxVMSize\fP
بیشینهٔ اندازهٔ حافظهٔ مجازی (Virtual Memory) در میان تمام تسک‌های کار.
.IP

.TP
\f3MaxVMSizeNode\fP
گره‌ای که maxvsize روی آن رخ داده است.
.IP

.TP
\f3MaxVMSizeTask\fP
شناسهٔ تسکی که maxvsize در آن رخ داده است.
.IP

.TP
\f3MinCPU\fP
کمینهٔ زمان پردازنده (سامانه + کاربر) در میان تمام تسک‌های کار.
.IP

.TP
\f3MinCPUNode\fP
گره‌ای که mincpu روی آن رخ داده است.
.IP

.TP
\f3MinCPUTask\fP
شناسهٔ تسکی که mincpu در آن رخ داده است.
.IP

.TP
\f3NTasks\fP
تعداد کل تسک‌ها در یک کار یا گام.
.IP

.TP
\f3ReqCPUFreq\fP
بسامد پردازنده درخواستی برای گام، بر حسب kHz.
.IP

.TP
\f3SLUID\fP
شناسهٔ یکتای با قابلیت مرتب‌سازی لغوی (Lexicographically\-sortable Unique Identifier) اختصاص‌یافته به کار در Slurm.
این مقدار در طول عمر کار، حتی پس از یک resize، ثابت باقی می‌ماند.
توجه داشته باشید که پایگاه‌دادهٔ accounting برای هر رکورد accounting یک SLUID جداگانه را پیگیری می‌کند که با resize یا requeue تغییر می‌یابد.
.IP

.TP
\f3TresUsageInAve\fP
میانگین مصرف ورودی TRES توسط تمام تسک‌ها در کار.
\fBنکته\fR: اگر TresUsageInMaxTask متناظر برابر با \-1 باشد، این معیار به‌جای تسک، گره‌محور است.
.IP

.TP
\f3TresUsageInMax\fP
بیشینهٔ مصرف ورودی TRES توسط تمام تسک‌ها در کار.
\fBنکته\fR: اگر TresUsageInMaxTask متناظر برابر با \-1 باشد، این معیار به‌جای تسک، گره‌محور است.
.IP

.TP
\f3TresUsageInMaxNode\fP
گره‌ای که بیشینهٔ مصرف خروجی TRES در آن رخ داده است.
.IP

.TP
\f3TresUsageInMaxTask\fP
تسکی که بیشینهٔ مصرف خروجی TRES در آن رخ داده است.
.IP

.TP
\f3TresUsageOutAve\fP
میانگین مصرف خروجی TRES توسط تمام تسک‌ها در کار.
\fBنکته\fR: اگر TresUsageOutMaxTask متناظر برابر با \-1 باشد، این معیار به‌جای تسک، گره‌محور است.
.IP

.TP
\f3TresUsageOutMax\fP
بیشینهٔ مصرف خروجی TRES توسط تمام تسک‌ها در کار.
\fBنکته\fR: اگر TresUsageOutMaxTask متناظر برابر با \-1 باشد، این معیار به‌جای تسک، گره‌محور است.
.IP

.TP
\f3TresUsageOutMaxNode\fP
گره‌ای که بیشینهٔ مصرف خروجی TRES در آن رخ داده است.
.IP

.TP
\f3TresUsageOutMaxTask\fP
تسکی که بیشینهٔ مصرف خروجی TRES در آن رخ داده است.
.IP.SH "کارایی (PERFORMANCE)"
.PP
اجرای \fBsstat\fR یک فراخوانی روال از راه‌دور به \fBslurmctld\fR ارسال می‌کند. اگر
فراخوانی‌های متعددی به‌طور هم‌زمان از سوی \fBsstat\fR یا سایر دستورهای کلاینت Slurm که
فراخوانی‌های روال از راه‌دور به دیمن \fBslurmctld\fR ارسال می‌کنند دریافت شود، می‌تواند منجر به
افت کارایی دیمن \fBslurmctld\fR شده و احتمالاً به ایجاد وضعیت منع سرویس (denial of service)
بینجامد.
.PP
دستور \fBsstat\fR یا سایر دستورهای کلاینت Slurm را که فراخوانی‌های روال از راه‌دور
به \fBslurmctld\fR می‌فرستند، از داخل حلقه‌ها در اسکریپت‌های شل یا سایر برنامه‌ها اجرا نکنید.
اطمینان حاصل کنید که برنامه‌ها، فراخوانی‌های \fBsstat\fR را به حداقل میزان لازم برای
اطلاعاتی که قصد گردآوری آن‌ها را دارید محدود کنند.

.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.PP
برخی از گزینه‌های \fBsstat\fR می‌توانند از طریق متغیرهای محیطی تنظیم شوند. این
متغیرهای محیطی به همراه گزینه‌های متناظرشان در زیر فهرست شده‌اند.
(نکته: گزینه‌های خط فرمان همواره بر این تنظیمات اولویت خواهند داشت.)

.TP 20
\fBSLURM_CONF\fR
محل فایل پیکربندی Slurm.
.IP

.TP
\fBSLURM_DEBUG_FLAGS\fR
پرچم‌های اشکال‌زدایی را جهت استفاده sstat مشخص می‌کند. برای فهرست کامل پرچم‌ها،
DebugFlags را در صفحه راهنمای \fBslurm.conf\fR(5) ببینید. این متغیر
محیطی بر تنظیمات موجود در slurm.conf اولویت دارد.
.IP

.SH "مثال‌ها (EXAMPLES)"

.TP
نمایش اطلاعات گام کاری (job step) برای کار 11 با فیلدهای مشخص‌شده:
.IP
.nf
$ sstat \-\-format=AveCPU,AvePages,AveRSS,AveVMSize,JobID \-j 11
25:02.000  0K         1.37M      5.93M      9.0
.fi

.TP
نمایش اطلاعات گام کاری برای کار 11 با فیلدهای مشخص‌شده در \
قالبی قابل تجزیه (parsable):
.IP
.nf
$ sstat \-p \-\-format=AveCPU,AvePages,AveRSS,AveVMSize,JobID \-j 11
25:02.000|0K|1.37M|5.93M|9.0|
.fi

.SH "کپی‌رایت و تکثیر (COPYING)"
کپی‌رایت (C) 2009 Lawrence Livermore National Security.
تولید شده در Lawrence Livermore National Laboratory (ر.ک DISCLAIMER).
.br
کپی‌رایت (C) 2010\-2022 SchedMD LLC.
.LP
این فایل بخشی از Slurm است؛ یک برنامه مدیریت منابع.
برای جزئیات، <https://slurm.schedmd.com> را ببینید.
.LP
نرم‌افزار Slurm یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو
(GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است،
بازتوزیع کرده یا تغییر دهید؛ یا نسخه ۲ مجوز، یا (به انتخاب خودتان) هر نسخه بالاتری.
.LP
نرم‌افزار Slurm با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛
حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات
بیشتر مجوز عمومی همگانی گنو را ببینید.

.SH "همچنین ببینید (SEE ALSO)"
\fBsacct\fR(1)