sstat(1) Slurm Commands sstat(1) نام (NAME) sstat - نمایش اطلاعات وضعیت یک کار/گام در حال اجرا خلاصه دستور (SYNOPSIS) sstat [گزینه‌ها...] توضیحات (DESCRIPTION) اطلاعات وضعیت کارهای در حال اجرایی که با Slurm فراخوانی شده‌اند. دستور sstat اطلاعات وضعیت کار را برای تحلیل و بررسی شما نمایش می‌دهد. دستور sstat اطلاعات مربوط به CPU، تسک (Task)، گره (Node)، اندازهٔ مجموعهٔ مقیم (RSS) و حافظهٔ مجازی (VM) را نمایش می‌دهد. می‌توانید با استفاده از گزینهٔ --fields= خروجی را سفارشی کرده تا فیلدهایی که باید نشان داده شوند را مشخص نمایید. برای کاربر ریشه (root)، دستور sstat داده‌های وضعیت کار را برای هر کاری که روی سیستم در حال اجرا است نمایش می‌دهد. برای کاربران غیر ریشه، خروجی sstat به کارهای خود کاربر محدود می‌شود. نکته: دستور sstat نیازمند این است که افزونهٔ jobacct_gather نصب و فعال باشد. نکته: در دسترس بودن معیارها به افزونهٔ jobacct_gather مورد استفاده بستگی دارد. برای نمونه، افزونهٔ jobacct_gather/cgroup در ترکیب با cgroup/v2 به دلیل محدودیت‌های رابط‌های cgroups در هسته، معیارهای حافظهٔ مجازی را ارائه نمی‌دهد و برای فیلدهای مربوطه مقدار 0 را نمایش خواهد داد. گزینه‌ها (OPTIONS) -a, --allsteps در صورتی که هیچ گامی مشخص نشده باشد، تمام گام‌های کار(های) داده‌شده را چاپ می‌کند. -o, --format, --fields فهرستی از فیلدها که با کاما از هم جدا شده‌اند. (برای فهرستی از فیلدهای موجود از '--helpformat' استفاده کنید). نکته: هنگام استفاده از گزینهٔ format برای فهرست کردن فیلدهای مختلف، می‌توانید یک NUMBER% در ادامهٔ آن قرار دهید تا مشخص کنید چه تعداد نویسه باید چاپ شود. به‌عنوان مثال format=name%30 تعداد ۳۰ نویسه از نام فیلد را به‌صورت راست‌چین چاپ می‌کند. مقدار -30 تعداد ۳۰ نویسه را به‌صورت چپ‌چین چاپ خواهد کرد. -h, --help یک پیام راهنمای کلی را نمایش می‌دهد. -e, --helpformat فهرستی از فیلدهایی را که می‌توان با گزینهٔ '--format' تعیین کرد، چاپ می‌کند. -j, --jobs قالب به‌صورت است. وضعیت این گام کاری یا فهرستی از گام‌های کاری جداشده با کاما را نمایش می‌دهد. کارها ممکن است با شناسهٔ عددی کار (job ID) یا SLUID مشخص شوند. این گزینه الزامی است. هنگامی که هیچ گامی مشخص نشده باشد، تنها گام عادی با کمترین شماره (به‌استثنای batch، extern و غیره) نمایش داده می‌شود. از پرچم --allsteps برای نمایش تمام گام‌های در حال اجرا برای کار(های) داده‌شده استفاده کنید. نکته: شناسهٔ گام 'batch' اطلاعات مربوط به گام batch را نمایش خواهد داد. نکته: شناسهٔ گام 'extern' اطلاعات مربوط به گام extern را نمایش خواهد داد. این گام تنها هنگام استفاده از PrologFlags=contain در دسترس است. --noconvert واحدها را از نوع اصلی‌شان تبدیل نمی‌کند (برای نمونه 2048M به 2G تبدیل نخواهد شد). -n, --noheader هیچ سرآیندی به خروجی افزوده نخواهد شد. عمل پیش‌فرض نمایش سرآیند است. -p, --parsable خروجی با '|' تفکیک خواهد شد و یک '|' در انتها خواهد داشت. -P, --parsable2 خروجی با '|' تفکیک خواهد شد بدون اینکه '|' در انتها داشته باشد. -i, --pidformat قالب از پیش تعریف‌شده برای فهرست کردن pidهای در حال اجرا برای هر گام کاری. (JobId,Nodes,Pids) --usage خلاصه‌ای از کاربرد دستور را نمایش می‌دهد. -v, --verbose عمدتاً برای اهداف اشکال‌زدایی، وضعیت متغیرهای گوناگون را در طول پردازش گزارش می‌کند. -V, --version نسخه را چاپ می‌کند. فیلدهای وضعیت کار (Job Status Fields) توضیحات مربوط به هر گزینهٔ فیلد را می‌توانید در زیر بیابید. توجه داشته باشید که فیلدهای حسابداری Ave*، Max* و Min* مقادیر را برای تمام تسک‌های هر گام در یک کار بررسی کرده و میانگین، بیشینه یا کمینهٔ مقادیر تسک را برای آن گام کاری بازمی‌گردانند. برای نمونه، برای MaxRSS، مقدار بازگردانده‌شده بیشینهٔ مصرف حافظه مشاهده‌شده توسط یکی از تسک‌های گام است، و MaxRSSTask نشان می‌دهد که این کدام تسک است. AllocTRES میزان TRES تخصیص‌یافته به تمام تسک‌های موجود در کار. AveCPU میانگین زمان پردازنده (سیستم + کاربر) تمام تسک‌های موجود در کار. AveCPUFreq میانگین وزنی بسامد (فرکانس) پردازنده برای تمام تسک‌های موجود در کار، برحسب کیلوهرتز (kHz). AveDiskRead میانگین تعداد بایت‌های خوانده‌شده توسط تمام تسک‌های موجود در کار. AveDiskWrite میانگین تعداد بایت‌های نوشته‌شده توسط تمام تسک‌های موجود در کار. AvePages میانگین تعداد خطاهای صفحه (page faults) در تمام تسک‌های موجود در کار. AveRSS میانگین اندازهٔ مجموعهٔ مقیم (RSS) تمام تسک‌های موجود در کار. AveVMSize میانگین اندازهٔ حافظهٔ مجازی (VM) تمام تسک‌های موجود در کار. ConsumedEnergy مجموع انرژی مصرف‌شده توسط تمام تسک‌های موجود در کار، برحسب ژول. نکته: تنها در صورت تخصیص اختصاصی کار، این مقدار نمایانگر مصرف واقعی انرژی کار خواهد بود. JobID شمارهٔ کار یا گام کار. به این صورت است: job.jobstep MaxDiskRead بیشینهٔ تعداد بایت‌های خوانده‌شده توسط تمام تسک‌های موجود در کار. MaxDiskReadNode گره‌ای که maxdiskread روی آن رخ داده است. MaxDiskReadTask شناسهٔ تسکی که maxdiskread در آن رخ داده است. MaxDiskWrite بیشینهٔ تعداد بایت‌های نوشته‌شده توسط تمام تسک‌های موجود در کار. MaxDiskWriteNode گره‌ای که maxdiskwrite روی آن رخ داده است. MaxDiskWriteTask شناسهٔ تسکی (task ID) که maxdiskwrite در آن رخ داده است. MaxPages بیشینهٔ تعداد خطاهای صفحه (page faults) در میان تمام تسک‌های کار. MaxPagesNode گره‌ای که maxpages روی آن رخ داده است. MaxPagesTask شناسهٔ تسکی که maxpages در آن رخ داده است. MaxRSS بیشینهٔ اندازهٔ مجموعه مقیم (resident set size) در میان تمام تسک‌های کار. MaxRSSNode گره‌ای که maxrss روی آن رخ داده است. MaxRSSTask شناسهٔ تسکی که maxrss در آن رخ داده است. MaxVMSize بیشینهٔ اندازهٔ حافظهٔ مجازی (Virtual Memory) در میان تمام تسک‌های کار. MaxVMSizeNode گره‌ای که maxvsize روی آن رخ داده است. MaxVMSizeTask شناسهٔ تسکی که maxvsize در آن رخ داده است. MinCPU کمینهٔ زمان پردازنده (سامانه + کاربر) در میان تمام تسک‌های کار. MinCPUNode گره‌ای که mincpu روی آن رخ داده است. MinCPUTask شناسهٔ تسکی که mincpu در آن رخ داده است. NTasks تعداد کل تسک‌ها در یک کار یا گام. ReqCPUFreq بسامد پردازنده درخواستی برای گام، بر حسب kHz. SLUID شناسهٔ یکتای با قابلیت مرتب‌سازی لغوی (Lexicographically-sortable Unique Identifier) اختصاص‌یافته به کار در Slurm. این مقدار در طول عمر کار، حتی پس از یک resize، ثابت باقی می‌ماند. توجه داشته باشید که پایگاه‌دادهٔ accounting برای هر رکورد accounting یک SLUID جداگانه را پیگیری می‌کند که با resize یا requeue تغییر می‌یابد. TresUsageInAve میانگین مصرف ورودی TRES توسط تمام تسک‌ها در کار. نکته: اگر TresUsageInMaxTask متناظر برابر با -1 باشد، این معیار به‌جای تسک، گره‌محور است. TresUsageInMax بیشینهٔ مصرف ورودی TRES توسط تمام تسک‌ها در کار. نکته: اگر TresUsageInMaxTask متناظر برابر با -1 باشد، این معیار به‌جای تسک، گره‌محور است. TresUsageInMaxNode گره‌ای که بیشینهٔ مصرف خروجی TRES در آن رخ داده است. TresUsageInMaxTask تسکی که بیشینهٔ مصرف خروجی TRES در آن رخ داده است. TresUsageOutAve میانگین مصرف خروجی TRES توسط تمام تسک‌ها در کار. نکته: اگر TresUsageOutMaxTask متناظر برابر با -1 باشد، این معیار به‌جای تسک، گره‌محور است. TresUsageOutMax بیشینهٔ مصرف خروجی TRES توسط تمام تسک‌ها در کار. نکته: اگر TresUsageOutMaxTask متناظر برابر با -1 باشد، این معیار به‌جای تسک، گره‌محور است. TresUsageOutMaxNode گره‌ای که بیشینهٔ مصرف خروجی TRES در آن رخ داده است. TresUsageOutMaxTask تسکی که بیشینهٔ مصرف خروجی TRES در آن رخ داده است. اجرای sstat یک فراخوانی روال از راه‌دور به slurmctld ارسال می‌کند. اگر فراخوانی‌های متعددی به‌طور هم‌زمان از سوی sstat یا سایر دستورهای کلاینت Slurm که فراخوانی‌های روال از راه‌دور به دیمن slurmctld ارسال می‌کنند دریافت شود، می‌تواند منجر به افت کارایی دیمن slurmctld شده و احتمالاً به ایجاد وضعیت منع سرویس (denial of service) بینجامد. دستور sstat یا سایر دستورهای کلاینت Slurm را که فراخوانی‌های روال از راه‌دور به slurmctld می‌فرستند، از داخل حلقه‌ها در اسکریپت‌های شل یا سایر برنامه‌ها اجرا نکنید. اطمینان حاصل کنید که برنامه‌ها، فراخوانی‌های sstat را به حداقل میزان لازم برای اطلاعاتی که قصد گردآوری آن‌ها را دارید محدود کنند. متغیرهای محیطی (ENVIRONMENT VARIABLES) برخی از گزینه‌های sstat می‌توانند از طریق متغیرهای محیطی تنظیم شوند. این متغیرهای محیطی به همراه گزینه‌های متناظرشان در زیر فهرست شده‌اند. (نکته: گزینه‌های خط فرمان همواره بر این تنظیمات اولویت خواهند داشت.) SLURM_CONF محل فایل پیکربندی Slurm. SLURM_DEBUG_FLAGS پرچم‌های اشکال‌زدایی را جهت استفاده sstat مشخص می‌کند. برای فهرست کامل پرچم‌ها، DebugFlags را در صفحه راهنمای slurm.conf(5) ببینید. این متغیر محیطی بر تنظیمات موجود در slurm.conf اولویت دارد. مثال‌ها (EXAMPLES) نمایش اطلاعات گام کاری (job step) برای کار 11 با فیلدهای مشخص‌شده: $ sstat --format=AveCPU,AvePages,AveRSS,AveVMSize,JobID -j 11 25:02.000 0K 1.37M 5.93M 9.0 نمایش اطلاعات گام کاری برای کار 11 با فیلدهای مشخص‌شده در قالبی قابل تجزیه (parsable): $ sstat -p --format=AveCPU,AvePages,AveRSS,AveVMSize,JobID -j 11 25:02.000|0K|1.37M|5.93M|9.0| کپی‌رایت و تکثیر (COPYING) کپی‌رایت (C) 2009 Lawrence Livermore National Security. تولید شده در Lawrence Livermore National Laboratory (ر.ک DISCLAIMER). کپی‌رایت (C) 2010-2022 SchedMD LLC. این فایل بخشی از Slurm است؛ یک برنامه مدیریت منابع. برای جزئیات، را ببینید. نرم‌افزار Slurm یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، بازتوزیع کرده یا تغییر دهید؛ یا نسخه ۲ مجوز، یا (به انتخاب خودتان) هر نسخه بالاتری. نرم‌افزار Slurm با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر مجوز عمومی همگانی گنو را ببینید. همچنین ببینید (SEE ALSO) sacct(1) Slurm 26.05 Slurm Commands sstat(1)