.TH sreport "1" "Slurm Commands" "Slurm 26.05" "Slurm Commands" .SH "نام (NAME)" sreport \- تولید گزارش‌ها از داده‌های حسابداری اسلورم .SH "خلاصه دستور (SYNOPSIS)" \fBsreport\fR [\fIگزینه‌ها\fR...] [\fIدستورات\fR...] .SH "توضیحات (DESCRIPTION)" دستور \fBsreport\fR برای تولید گزارش‌های مربوط به میزان استفاده از جاب‌ها و میزان بهره‌برداری از کلاستر برای جاب‌های اسلورم که در پایگاه داده اسلورم (\fBslurmdbd\fR) ذخیره شده‌اند، استفاده می‌شود. داده‌های گزارش از تجمیع‌های (rollups) ساعتی، روزانه و ماهانه داده‌های حسابداری به دست می‌آیند که به صورت خودکار در پس‌زمینه انجام می‌شوند. داده‌ها از جدول تجمیعی با طولانی‌ترین بازه‌ای که بتواند دوره گزارش درخواستی را پوشش دهد، استخراج خواهند شد. به عنوان مثال، گزارشی در بازه زمانی "Start=01/01 End=03/01" می‌تواند داده‌ها را از جدول تجمیع ماهانه استخراج کند، در حالی که گزارشی با "Start=01/01-03:00 End=03/01" نیازمند استفاده از جدول تجمیع ساعتی خواهد بود. .SH "گزینه‌ها (OPTIONS)" .TP \fB\-a\fR, \fB\-\-all_clusters\fR استفاده از تمام کلاسترها به جای فقط کلاستری که دستور از آن اجرا شده است. .IP .TP \fB\-M\fR, \fB\-\-cluster\fR کلاستر(هایی) که گزارش برای آن‌ها تولید می‌شود. پیش‌فرض کلاستر محلی است، مگر اینکه کلاستر محلی در حال حاضر بخشی از یک فدراسیون باشد که در آن صورت گزارشی برای تمام کلاسترهای موجود در فدراسیون فعلی تولید می‌شود. اگر کلاسترهای موجود در فدراسیون در طول زمان تغییر می‌کنند، از این گزینه برای شناسایی کلاسترهایی که باید در گزارش گنجانده شوند استفاده کنید. این گزینه به منزله اعمال \-\-local است. .IP .TP \fB\-\-federation\fR تولید گزارش برای فدراسیون در صورت عضویت در آن. .IP .TP \fB\-h\fR, \fB\-\-help\fR چاپ پیام راهنما که نحوه استفاده از \fBsreport\fR را شرح می‌دهد. .IP .TP \fB\-\-local\fR تولید گزارش برای کلاستر محلی، حتی اگر بخشی از یک فدراسیون باشد. این گزینه بر \fB\-\-federation\fR اولویت دارد. .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\-Q\fR, \fB\-\-quiet\fR عدم چاپ پیام‌های هشدار یا اطلاعاتی؛ فقط پیام‌های خطا چاپ می‌شوند. .IP .TP \fB\-t\fR <\fIقالب_زمان\fR> تعیین قالب زمان در خروجی. گزینه‌های قالب زمان به حروف بزرگ و کوچک حساس نیستند و می‌توان آن‌ها را به صورت مخفف نوشت. قالب پیش‌فرض Minutes (دقیقه) است. گزینه‌های پشتیبانی‌شده برای قالب زمان در بخش دستور \fBtime\fP در ادامه فهرست شده‌اند. .IP .TP \fB\-T\fR, \fB\-\-tres\fR=<\fInames_tres\fR> منبع قابل رهگیری (TRES) برای گزارش مقادیر آن. به طور پیش‌فرض میزان استفاده از منابع CPU گزارش می‌شود (به جز در گزارش‌های رزرو؛ در گزارش‌های رزرو تمام انواع TRES رزروشده توسط یک رزرو به طور پیش‌فرض نمایش داده می‌شوند مگر اینکه با این گزینه بازنویسی شوند). نام‌های چندگانه TRES را می‌توان با یک فهرست جداشده با کاما برای تمام گزارش‌ها به جز گزارش‌های جاب مشخص کرد؛ گزارش‌های جاب تنها از یک نام TRES یا "ALL" برای همه TRESها پشتیبانی می‌کنند. مقدار "Reported" در Billing TRES از ضرب بزرگ‌ترین Billing TRES هر نود در بازه زمانی محاسبه می‌شود. برای مثال، اگر یک نود بخشی از چندین پارتیشن باشد و هر کدام TRESBillingWeights متفاوتی تعریف کرده باشند، Billing TRES برای نود بالاترین مقدار در بین پارتیشن‌ها خواهد بود. اگر TRESBillingWeights برای هیچ پارتیشنی در یک نود تعریف نشده باشد، آنگاه Billing TRES برابر با تعداد CPUهای روی نود خواهد بود. میزان استفاده نود در TRES دیگر با قالب درصد یا در میزان بهره‌برداری کلاستر (Cluster Utilization) گزارش نمی‌شود. لطفاً به جای آن از TRES CPU استفاده کنید. مسئله اصلی در استفاده از node این است که در اکثر پیکربندی‌ها چندین جاب قادر به اجرا روی یک نود یکسان هستند. این امر باعث می‌شود محاسبه TRES node همان نود را چندین بار در همان دوره زمانی بشمارد. در پیکربندی‌های نود اختصاصی (exclusive node)، محاسبه CPU همان میزان استفاده‌ای را برمی‌گرداند که محاسبه نود برمی‌گرداند. .IP .TP \fB\-v\fR, \fB\-\-verbose\fR چاپ لاگ‌های تفصیلی رویدادها. .IP .TP \fB\-V\fR , \fB\-\-version\fR چاپ اطلاعات نسخه و خروج. .IP .SH "دستورات (COMMANDS)" .LP می‌توان \ را از خط اجرا حذف کرد و در این حالت sreport در حالت تعاملی (interactive) اجرا خواهد شد. دستور sreport دستورات را به محض ورود پردازش می‌کند تا زمانی که صریحاً خاتمه یابد. .TP \fBexit\fP خاتمه دادن به اجرای sreport. مشابه دستور \fBquit\fR است. .IP .TP \fBhelp\fP نمایش شرحی از گزینه‌ها و دستورات sreport. .IP .TP \fBnonparsable\fP بازگرداندن خروجی به حالت عادی پس از تنظیم parsable یا parsable2. .IP .TP \fBparsable\fP خروجی با '|' جدا می‌شود و در انتها نویسه '|' خواهد داشت. .IP .TP \fBparsable2\fP خروجی با '|' جدا می‌شود و در انتها نویسه '|' نخواهد داشت. .IP .TP \fBquiet\fP عدم چاپ پیام‌های هشدار یا اطلاعاتی؛ فقط پیام‌های خطای مهلک چاپ می‌شوند. .IP .TP \fBquit\fP خاتمه دادن به اجرای sreport. مشابه دستور \fBexit\fR است. .IP .TP \fBtime <قالب_زمان>\fP تعیین قالب زمان در خروجی. گزینه‌های قالب زمان به حروف بزرگ و کوچک حساس نیستند و می‌توانند مخفف شوند. قالب پیش‌فرض Minutes (دقیقه) است. گزینه‌های پشتیبانی‌شده قالب زمان عبارتند از: .IP .RS .TP 10 \fBSecPer\fR ثانیه/درصد از کل .IP .TP \fBMinPer\fR دقیقه/درصد از کل .IP .TP \fBHourPer\fR ساعت/درصد از کل .IP .TP \fBSeconds\fR ثانیه .IP .TP \fBMinutes\fR دقیقه .IP .TP \fBHours\fR ساعت .IP .TP \fBPercent\fR درصد از کل .RE .IP .TP \fBverbose\fP فعال‌سازی ثبت تفصیلی رویدادها در لاگ. .IP .TP \fBversion\fP نمایش شماره نسخه sreport. .IP .TP \fB!!\fP تکرار آخرین دستور اجرا شده. .IP .SH "انواع گزارش (REPORT TYPES)" انواع معتبر گزارش عبارتند از: .RS .TP \fBcluster\fP \ \ .IP .TP \fBjob\fP \ \ .IP .TP \fBreservation\fP \ \ .IP .TP \fBuser\fP \ \ .IP .RE گزینه‌های \ برای هر نوع عبارتند از: .RS .TP \fBcluster\fR AccountUtilizationByUser, AccountUtilizationByQOS, UserUtilizationByAccount, UserUtilizationByWckey, Utilization, WCKeyUtilizationByUser .IP .TP \fBjob\fR SizesByAccount, SizesByAccountAndWcKey, SizesByWckey .IP .TP \fBreservation\fR Utilization .IP .TP \fBuser\fR TopUsage .IP .RE .LP \fBنکته\fR: اگر \fBOverSubscribe\fR در فایل slurm.conf شما روی \fBFORCE\fR یا \fBYES\fR تنظیم شده باشد و سیستم برای استفاده از پیش‌دستی (\fBPreemptMode=OFF\fR) پیکربندی نشده باشد، داده‌های حسابداری به راحتی می‌توانند به مقادیری بزرگ‌تر از میزان بهره‌برداری واقعی افزایش یابند. در چنین سیستم‌هایی معمولاً ممکن است در لاگ slurmdbd پیام خطایی با مضمون: "We have more allocated time than is possible." دریافت شود. .SH "توضیحات گزارش (REPORT DESCRIPTION)" .TP .B cluster AccountUtilizationByUser این گزارش میزان استفاده حساب (account) را همان‌طور که در درخت سلسله‌مراتبی نمایش می‌یابد، نشان می‌دهد. با شروع از حساب مشخص‌شده یا حساب root به صورت پیش‌فرض، این گزارش میزان استفاده زیرمجموعه‌ها را با مجموع هر سطح فهرست می‌کند. برای مشاهده بهتر ساختار درختی از گزینه 'tree' جهت گسترش درخت استفاده کنید. \fBنکته\fR: زمان بلااستفاده (Idle) رزرو به طور مساوی میان حساب‌ها/کاربرانی که به آن دسترسی دارند تقسیم می‌شود. هنگامی که یک رزرو به کل حساب‌ها تخصیص داده می‌شود، زمان در انتساب (association) مربوط به حساب‌ها محاسبه می‌شود، نه انتساب‌های کاربر در آن حساب‌ها. در این حالت، میزان استفاده یک حساب والد می‌تواند بزرگ‌تر از مجموع فرزندان آن باشد. .IP .TP .B cluster AccountUtilizationByQOS این گزارش میزان استفاده حساب را همان‌طور که در درخت سلسله‌مراتبی نمایش می‌یابد، نشان می‌دهد. با شروع از حساب root به طور پیش‌فرض، یا با حساب مشخص‌شده، این گزارش میزان استفاده زیرمجموعه در هر حساب را همراه با مجموع هر سطح فهرست می‌کند. برای مشاهده بهتر ساختار درختی از گزینه 'tree' جهت باز کردن درخت استفاده کنید. کاربران در اینجا نمایش داده نمی‌شوند، بلکه فقط حساب‌های والد نشان داده می‌شوند. \fBنکته\fR: زمان بلااستفاده رزرو به طور مساوی بین حساب‌هایی که به آن دسترسی دارند تقسیم می‌شود. از آنجا که هیچ QOS مستقیماً به زمان بلااستفاده مرتبط نیست، زمان به حساب QOS پیش‌فرض آن حساب محاسبه می‌شود، یا در صورتی که پیش‌فرضی وجود نداشته باشد، به عنوان 'normal' در نظر گرفته می‌شود. \fBنکته\fR: اگر داده‌ها را در پایگاه داده مجدداً محاسبه (reroll) کنید و QOS پیش‌فرض را در یک انتساب به مقداری غیر از آنچه در زمان تجمیع اولیه وجود داشته تغییر داده باشید، ممکن است داده‌های متفاوتی دریافت کنید. .TP .B cluster UserUtilizationByAccount این گزارش کاربران را بر اساس حساب و به ترتیب میزان بهره‌برداری، بدون گروه‌بندی چندین حسابِ یک کاربر در یک حساب، بلکه با نمایش آن‌ها در خطوط جداگانه نشان می‌دهد. .IP .TP .B cluster UserUtilizationByWCKey این گزارش کاربران را بر اساس wckey و به ترتیب میزان بهره‌برداری، بدون گروه‌بندی چندین wckeyِ یک کاربر در یک مورد، بلکه با نمایش آن‌ها در خطوط جداگانه نشان می‌دهد. .IP .TP .B cluster Utilization این گزارش کل میزان استفاده را که میان زمان‌های Allocated، Down، Planned Down، Idle و Planned تقسیم شده است، برای کلاسترهای انتخابی نمایش می‌دهد. برای شرح این فیلدها به بخش بعدی مراجعه کنید. نکته: رزروهای ایجادشده با فلگ IGNORE_JOBS در گزارش Cluster Utilization رهگیری نمی‌شوند، چرا که اجازه دادن به ادامه اجرای جاب‌های جاری/فعال در رزرو این امکان را ایجاد می‌کند که حسابداری آن‌ها نادرست محاسبه شود. جاب‌های موجود در این رزروها به جای تجمیع در زمان رزرو (مانند رزروهای فاقد فلگ IGNORE_JOBS)، به صورت عادی رهگیری خواهند شد. نکته: نمای پیش‌فرض گزارش "Cluster Utilization" شامل فیلدهای زیر است: Cluster، Allocated، Down، PlannedDown، Idle، Planned، Reported. می‌توانید فیلدهای بیشتری مانند فیلدهای OverCommitted و TresCount را با گزینه \fBFormat\fP اضافه کنید. در صورت استفاده از گزینه \fB\-T, \-\-tres \fR فیلد TresName نیز گنجانده خواهد شد. .IP .TP .B cluster WCKeyUtilizationByUser این گزارش میزان استفاده wckey را که بر اساس نام WCKey برای هر کاربر در هر کلاستر مرتب شده است، نمایش می‌دهد. .IP .TP .B job SizesByAccount این گزارش مقدار زمان مصرف‌شده برای بازه‌های جاب مشخص‌شده با گزینه 'grouping=' را نمایش می‌دهد. تنها یک سطح واحد از درخت نمایش داده می‌شود که پیش‌فرض آن دایرکتوری root است. اگر حساب‌های دیگری را با گزینه 'account=' مشخص کنید، sreport آن حساب‌ها را به عنوان حساب root استفاده خواهد کرد و مجموع تجمیعی هر حساب فهرست‌شده به همراه زیرحساب‌های آن را دریافت خواهید کرد. .IP .TP .B job SizesByAccountAndWckey این گزارش بسیار شبیه به SizesByAccount است، با این تفاوت که هر حساب با wckeyها جفت می‌شود؛ بنابراین شناسه به جای فقط account به صورت account:wckey خواهد بود، در نتیجه بسته به تعداد wckeyهای استفاده‌شده احتمالاً چندین حساب فهرست خواهند شد. .IP .TP .B job SizesByWckey این گزارش مقدار زمان را برای هر wckey برای بازه‌های جاب مشخص‌شده توسط گزینه 'grouping=' نمایش می‌دهد. .IP .TP .B reservation Utilization این گزارش کل میزان استفاده برای رزروها در سیستم‌ها را نمایش می‌دهد. نکته: درخواست‌های زمانی در این گزارش مدت‌زمان مصرف‌شده توسط رزرو را کوتاه (truncate) نمی‌کنند، بلکه تنها رزروهایی را که در هر زمانی در طول دوره درخواستی اجرا شده‌اند شامل می‌شوند. .IP .TP .B user TopUsage کاربران برتر در یک کلاستر را نمایش می‌دهد، یعنی کاربرانی که بالاترین میزان استفاده را دارند. به طور پیش‌فرض کاربران بر اساس CPUTime مرتب می‌شوند، اما گزینه \-T, \-\-tres کاربران را بر اساس اولین TRES مشخص‌شده مرتب خواهد کرد. برای گروه‌بندی حساب‌ها با یکدیگر از گزینه group استفاده کنید. حالت پیش‌فرض این است که برای هر ترکیب کاربر و حساب یک خط جداگانه نمایش داده شود. .IP .LP هر نوع گزارش دارای گزینه‌های متعددی است... .LP .B گزینه‌ها برای تمام انواع گزارش (OPTIONS FOR ALL REPORT TYPES) .RS .TP .B All_Clusters استفاده از تمام کلاسترهای پایش‌شده. پیش‌فرض کلاستر محلی است. .IP .TP .B Clusters= فهرست کلاسترهایی که باید در گزارش گنجانده شوند. پیش‌فرض کلاستر محلی است. .IP .TP .B End= پایان دوره گزارش. پیش‌فرض ساعت 23:59:59 روز قبل است. توجه داشته باشید در حالی که دقایق و ثانیه‌ها شناسایی می‌شوند، اما به ساعت قبلی گرد خواهند شد زیرا گزارش‌ها نمی‌توانند برای بازه زمانی دقیق‌تری تولید شوند. قالب‌های معتبر زمان عبارتند از... .sp HH:MM[:SS] [AM|PM] .br MMDD[YY] or MM/DD[/YY] or MM.DD[.YY] .br MM/DD[/YY]\-HH:MM[:SS] .br YYYY\-MM\-DD[THH:MM[:SS]] .br now[{+|\-}\fIcount\fR[seconds(default)|minutes|hours|days|weeks]] .IP .TP .B Format= فهرست جداشده با کاما از فیلدهایی که باید در گزارش نمایش داده شوند. هنگام استفاده از گزینه format برای فهرست کردن فیلدهای مختلف می‌توانید یک %NUMBER در ادامه درج کنید تا مشخص شود چند نویسه باید چاپ گردد. برای مثال format=name%30 تعداد ۳۰ نویسه از فیلد name را به صورت راست‌چین چاپ می‌کند. یک \-30 تعداد ۳۰ نویسه را به صورت چپ‌چین چاپ خواهد کرد. .IP .TP .B Start= شروع دوره گزارش. پیش‌فرض ساعت 00:00:00 روز قبل است. توجه داشته باشید در حالی که دقایق و ثانیه‌ها شناسایی می‌شوند، اما به ساعت بعدی گرد خواهند شد زیرا گزارش‌ها نمی‌توانند برای بازه زمانی دقیق‌تری تولید شوند. قالب‌های معتبر زمان عبارتند از... .sp HH:MM[:SS] [AM|PM] .br MMDD[YY] or MM/DD[/YY] or MM.DD[.YY] .br MM/DD[/YY]\-HH:MM[:SS] .br YYYY\-MM\-DD[THH:MM[:SS]] .br now[{+|\-}\fIcount\fR[seconds(default)|minutes|hours|days|weeks]] .ad .RE .IP .LP .B گزینه‌های اختصاصی گزارش‌های کلاستر (OPTIONS SPECIFICALLY FOR CLUSTER REPORTS) .RS .TP .B Accounts= هنگام استفاده با UserUtilizationByAccount یا AccountUtilizationBy[User|QOS]، فهرست حساب‌هایی که باید در گزارش گنجانده شوند. پیش‌فرض همه است. .IP .TP .B Tree هنگام استفاده با گزارش AccountUtilizationBy[User|QOS]، حساب‌ها را همان‌گونه که در ساختار سلسله‌مراتبی هستند گسترش می‌دهد. .IP .TP .B Users= هنگام استفاده با هر گزارشی غیر از Utilization، فهرست کاربرانی که باید در گزارش گنجانده شوند. پیش‌فرض همه است. .IP .TP .B Wckeys= هنگام استفاده با UserUtilizationByWckey یا WCKeyUtilizationByUser، فهرست wckeyهایی که باید در گزارش گنجانده شوند. پیش‌فرض همه است. .RE .IP .LP .B گزینه‌های اختصاصی گزارش‌های جاب (OPTIONS SPECIFICALLY FOR JOB REPORTS) .RS .TP .B Accounts= فهرست حساب‌هایی که باید برای گزارش استفاده شوند. پیش‌فرض همه است که تنها یک خط مربوط به مجموع تمام حساب‌های موجود در ساختار سلسله‌مراتبی را نشان می‌دهد. این توضیح در صورت اجرا با گزینه‌های FlatView یا AcctAsParent اعمال نمی‌شود. .IP .TP .B AcctAsParent هنگام استفاده با SizesbyAccount(*)، حساب‌های مشخص‌شده را به عنوان والد در نظر می‌گیرد و لایه بعدی حساب‌های زیرمجموعه آن حساب‌های مشخص‌شده نمایش داده خواهند شد. اگر حساب خاصی درخواست نشود، پیش‌فرض root است. هنگام استفاده از FlatView، این گزینه نادیده گرفته می‌شود. .IP .TP .B FlatView هنگام استفاده با SizesbyAccount(*)، حساب‌ها را در یک سطح سلسله‌مراتبی گروه‌بندی نمی‌کند، بلکه هر حسابی را که جاب‌ها روی آن اجرا شده‌اند در یک خط جداگانه بدون هیچ سلسله‌مراتبی چاپ می‌کند. .IP .TP .B GID= فهرست شناسه‌های گروه (GID) برای گنجاندن در گزارش. پیش‌فرض همه است. .IP .TP .B Grouping= فهرست جداشده با کاما از گروه‌بندی‌های اندازه. (برای مثال 50,100,150 تعداد CPU جاب را به دسته‌های 1\-49، 50\-99، 100\-149، > 150 گروه‌بندی می‌کند). grouping=individual به ایجاد یک ستون جداگانه برای هر اندازه جاب یافت‌شده منجر می‌شود. .IP .TP .B Jobs= فهرست جاب‌ها/گام‌ها برای گنجاندن در گزارش. پیش‌فرض همه است. .IP .TP .B Nodes= تنها نمایش جاب‌هایی که روی این نودها اجرا شده‌اند. پیش‌فرض همه است. .IP .TP .B Partitions= فهرست پارتیشن‌هایی که جاب‌ها روی آن‌ها اجرا شده‌اند برای گنجاندن در گزارش. پیش‌فرض همه است. .IP .TP .B PrintJobCount هنگام استفاده با گزارش Sizes، تعداد جاب‌های اجراشده را به جای زمان مصرف‌شده چاپ می‌کند. .IP .TP .B Users= فهرست جاب‌های کاربران برای گنجاندن در گزارش. پیش‌فرض همه است. .IP .TP .B Wckeys= فهرست wckeyهایی که باید برای گزارش استفاده شوند. پیش‌فرض همه است. گزارش SizesbyWckey تمام کاربران را به صورت تجمیع‌شده با هم گزارش می‌دهد. اگر مایلید فقط کاربران خاصی نمایش داده شوند، آن‌ها را با گزینه Users= مشخص کنید. .RE .IP .LP .B گزینه‌های اختصاصی گزارش‌های رزرو (OPTIONS SPECIFICALLY FOR RESERVATION REPORTS) .RS .TP .B Names= فهرست رزروهایی که باید برای گزارش استفاده شوند. پیش‌فرض همه است. .IP .TP .B Nodes= تنها نمایش رزروهایی که از این نودها استفاده کرده‌اند. پیش‌فرض همه است. .RE .IP .LP .B گزینه‌های اختصاصی گزارش‌های کاربر (OPTIONS SPECIFICALLY FOR USER REPORTS) .RS .TP .B Accounts= فهرست حساب‌هایی که باید برای گزارش استفاده شوند. پیش‌فرض همه است. .IP .TP .B Group گروه‌بندی تمام حساب‌ها برای هر کاربر در کنار یکدیگر. حالت پیش‌فرض، یک مدخل جداگانه برای هر ارجاع کاربر و حساب است. .IP .TP .B TopCount= در گزارش TopUsage استفاده می‌شود. تعداد کاربران نمایش‌داده‌شده را تغییر می‌دهد. پیش‌فرض ۱۰ است. .IP .TP .B Users= فهرست جاب‌های کاربران برای گنجاندن در گزارش. پیش‌فرض همه است. .RE .IP .SH "گزینه‌های قالب‌بندی برای هر گزارش (FORMAT OPTIONS FOR EACH REPORT)" .LP \fBگزینه‌های قالب‌بندی برای گزارش‌های کلاستر (FORMAT OPTIONS FOR CLUSTER REPORTS)\fP .RS .TP \fBAccountUtilizationByUser\fR Accounts, Cluster, Login, QOS, Proper, TresCount, Used .IP .TP \fBAccountUtilizationByQOS\fR Accounts, Cluster, QOS, TresCount, Used .IP .TP \fBUserUtilizationByAccount\fR Accounts, Cluster, Login, Proper, TresCount, Used .IP .TP \fBUserUtilizationByWckey\fR Cluster, Login, Proper, TresCount, Used, Wckey .IP .TP \fBUtilization\fR Allocated, Cluster, Down, Idle, OverCommitted, PlannedDown, Reported, Planned, TresCount, TresName .IP .TP \fBWCKeyUtilizationByUser\fR Cluster, Login, Proper, TresCount, Used, Wckey .IP .RE .LP \fBگزینه‌های قالب‌بندی برای گزارش‌های جاب (FORMAT OPTIONS FOR JOB REPORTS)\fP .RS .TP \fBSizesByAccount\fR Account, Cluster .IP .TP \fBSizesByAccountAndWckey\fR Account, Cluster .IP .TP \fBSizesByWckey\fR Wckey, Cluster .IP .RE .LP \fBگزینه‌های قالب‌بندی برای گزارش‌های رزرو (FORMAT OPTIONS FOR RESERVATION REPORTS)\fP .RS .TP \fBUtilization\fR Allocated, Associations, Cluster, End, Flags, Idle, Name, Nodes, ReservationId, Start, TotalTime, TresCount, TresName, TresTime .IP .RE .LP \fBگزینه‌های قالب‌بندی برای گزارش‌های کاربر (FORMAT OPTIONS FOR USER REPORTS)\fP .RS .TP \fBTopUsage\fR Account, Cluster, Login, Proper, Used .IP .RE .LP تمام دستورات و گزینه‌ها به حروف بزرگ و کوچک حساس نیستند (case\-insensitive). .SH "توضیح فیلدهای گزارش (EXPLANATION OF REPORT FIELDS)" .LP .TP \fBAccount\fP نام حساب .IP .TP \fBAllocated\fP \fBگزارش بهره‌برداری کلاستر:\fR مدت زمانی که نودها با جاب‌های فعال یا یک رزرو فعال در حال استفاده بوده‌اند. این زمان شامل رزروهای ایجادشده با فلگ‌های MAINT یا IGNORE_JOBS نمی‌شود. \fBگزارش‌های رزرو:\fR مدت زمانی که نودها با جاب‌های فعال در این رزرو در حال استفاده بوده‌اند .IP .TP \fBAssociations\fP انتساب‌های (associations) مجاز در رزرو .IP .TP \fBCluster\fP نام کلاستر .IP .TP \fBDown\fP \fBفقط گزارش بهره‌برداری کلاستر:\fR مدت زمانی که نودها به عنوان Down یا کاملاً Drained علامت‌گذاری شده بودند، یا زمانی که slurmctld پاسخگو نبوده است (اگر TrackSlurmctldDown در slurmdbd.conf تنظیم شده باشد) .IP .TP \fBEnd\fP \fBفقط گزارش‌های رزرو:\fR زمان پایان .IP .TP \fBEnergy\fP میزان مصرف انرژی (در صورت رهگیری مصرف انرژی) .IP .TP \fBFlags\fP \fBفقط گزارش‌های رزرو:\fR فلگ‌های اعمال‌شده روی رزرو .IP .TP \fBIdle\fP \fBگزارش بهره‌برداری کلاستر:\fR مدت زمانی که نودها در وضعیت‌های Allocated، Down، PlannedDown یا Planned نبوده‌اند \fBگزارش‌های رزرو:\fR مدت زمانی که نودها Allocated نبوده‌اند .IP .TP \fBLogin\fP نام کاربری ورود (Login) .IP .TP \fBName\fP \fBفقط گزارش‌های رزرو:\fR نام رزرو .IP .TP \fBOverCommitted\fP \fBفقط گزارش بهره‌برداری کلاستر:\fR مدت زمان جاب‌های واجد شرایطِ منتظر در صف که فراتر از زمان Planned است. این شامل هرگونه سرریز زمان Planned است که در غیر این صورت از زمان Reported فراتر می‌رفت. این فیلد معمولاً برای تعیین اینکه آیا سیستم شما دچار بار اضافه شده است و به چه میزان، مفید است. .IP .TP \fBPlanned\fP \fBفقط گزارش بهره‌برداری کلاستر:\fR مدت زمانی که نودها در وضعیت Allocated، Down یا PlannedDown نبوده‌اند و جاب‌های واجد شرایط در صف به دلیل محدودیت‌های زمانی یا اندازه‌ای قادر به شروع نبوده‌اند. اگر مجموع زمان Allocated به علاوه Planned از زمان Reported فراتر رود، مقدار مازاد به عنوان OverCommitted گزارش خواهد شد. اگر این مقدار برای شما اهمیتی ندارد، می‌توان این عدد را با زمان بیکاری (idle) تجمیع کرد. .IP .TP \fBPlannedDown\fP \fBفقط گزارش بهره‌برداری کلاستر:\fR مدت زمانی که نودها توسط رزروی ایجادشده با فلگ MAINT اما بدون فلگ IGNORE_JOBS در حال استفاده بوده‌اند. همچنین مدت زمانی که نودها در وضعیت FUTURE یا POWERED_DOWN بوده‌اند. .IP .TP \fBProper Name\fP نام واقعی / شناسنامه‌ای کاربر .IP .TP \fBReported\fP \fBفقط گزارش بهره‌برداری کلاستر:\fR کل مدت زمانی که سوابق برای آن در دسترس است. نودهایی که در طول دوره گزارش به کلاستر اضافه یا از آن حذف شده‌اند، تنها داده‌های استفاده را برای مدتی که در کلاستر حضور داشته‌اند ارائه می‌دهند و باعث می‌شوند محاسبات درصدی از ۱۰۰٪ انحراف پیدا کند. .IP .TP \fBReservationId\fP \fBفقط گزارش‌های رزرو:\fR شناسه رزرو .IP .TP \fBStart\fP \fBفقط گزارش‌های رزرو:\fR زمان شروع .IP .TP \fBTotalTime\fP \fBفقط گزارش‌های رزرو:\fR مدت زمانی که رزرو معتبر بوده است .IP .TP \fBTresCount\fP تعداد TRESهای موجود .IP .TP \fBTresName\fP نام TRES گزارش‌شده .IP .TP \fBTresTime\fP \fBفقط گزارش‌های رزرو:\fR کل زمان TRES در رزرو .IP .TP \fBUsed\fP دقیقه-TRES مصرف‌شده .IP .TP \fBWckey\fP کلید مشخصه بار کاری (Workload Characterization Key) .IP .SH "کارایی (PERFORMANCE)" .PP اجرای \fBsreport\fR یک فراخوانی رویه از راه دور (RPC) به \fBslurmdbd\fR ارسال می‌کند. اگر تعداد فراخوانی‌های کافی از سوی \fBsreport\fR یا سایر دستورات کلاینت اسلورم که به دیمن \fBslurmdbd\fR ارسال می‌شوند به طور همزمان وارد شوند، می‌تواند منجر به کاهش کارایی دیمن \fBslurmdbd\fR و احتمالاً منجر به منع سرویس (denial of service) شود. .PP از اجرای \fBsreport\fR یا سایر دستورات کلاینت اسلورم که به \fBslurmdbd\fR فراخوانی از راه دور ارسال می‌کنند در حلقه‌های اسکریپت‌های پوسته یا برنامه‌های دیگر خودداری کنید. اطمینان حاصل کنید که برنامه‌ها فراخوانی‌های \fBsreport\fR را به حداقل مقدار لازم برای اطلاعاتی که می‌خواهید جمع‌آوری کنید، محدود نمایند. .SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)" .PP برخی از گزینه‌های \fBsreport\fR می‌توانند از طریق متغیرهای محیطی تنظیم شوند. این متغیرهای محیطی به همراه گزینه‌های متناظر آن‌ها در زیر فهرست شده‌اند. (توجه: گزینه‌های خط فرمان همیشه این تنظیمات را بازنویسی خواهند کرد.) .IP .TP 20 \fBSREPORT_CLUSTER\fR مشابه \fB\-M\fR, \fB\-\-cluster\fR است. .IP .TP \fBSREPORT_FEDERATION\fR مشابه \-\-federation\fR است. .IP .TP \fBSREPORT_LOCAL\fR مشابه \-\-local\fR است. .IP .TP \fBSREPORT_TRES\fR مشابه \fB\-t, \-\-tres\fR است. .IP .TP \fBSLURM_CONF\fR محل فایل پیکربندی اسلورم. .in 0 .SH "مثال‌ها (EXAMPLES)" .TP گزارش تعداد جاب‌ها بر اساس حساب کاربری طبق بازه‌های مختلف اندازه جاب: .IP .nf $ sreport job sizesbyaccount Start=11:00 -------------------------------------------------------------------------------- Job Sizes 2024-08-19T11:00:00 - 2024-08-19T11:59:59 (3600 secs) Time reported in Minutes -------------------------------------------------------------------------------- Cluster Account 0-49 CPUs 50-249 CPUs 250-499 CPUs 500-999 CPUs >= 1000 CPUs % of cluster --------- --------- ------------- ------------- ------------- ------------- ------------- ------------ minesofm+ root 770 0 0 0 0 100.00% .fi .TP گزارش میزان بهره‌برداری کلاستر: .IP .nf $ sreport cluster utilization Start=11:00 -------------------------------------------------------------------------------- Cluster Utilization 2024-08-19T11:00:00 - 2024-08-19T11:59:59 Usage reported in CPU Minutes -------------------------------------------------------------------------------- Cluster Allocate Down Planned Idle Planned Reported --------- -------- -------- -------- -------- -------- -------- minesofm+ 770 120 239 3791 239 4920 .fi .TP گزارش بیشترین میزان استفاده: .IP .nf $ sreport user top Start=11:00 -------------------------------------------------------------------------------- Top 10 Users 2024-08-19T11:00:00 - 2024-08-19T11:59:59 (3600 secs) Usage reported in CPU Minutes -------------------------------------------------------------------------------- Cluster Login Proper Name Account Used Energy --------- --------- --------------- --------------- -------- -------- minesofm+ stephen ,,, main 538 0 minesofm+ phteven ,,, main 145 0 minesofm+ phteven ,,, rivendell 45 0 minesofm+ stephen ,,, rivendell 41 0 .fi .TP گزارش جاب‌ها بر اساس اندازه از کاربر و حساب مشخص: .IP .nf $ sreport job sizesbyaccount All_Clusters users=stephen account=main PrintJobCount Start=11:00 -------------------------------------------------------------------------------- Job Sizes 2024-08-19T11:00:00 - 2024-08-19T11:59:59 (3600 secs) Units are in number of jobs ran -------------------------------------------------------------------------------- Cluster Account 0-49 CPUs 50-249 CPUs 250-499 CPUs 500-999 CPUs >= 1000 CPUs % of cluster --------- --------- ------------- ------------- ------------- ------------- ------------- ------------ minesofm+ main 12 0 0 0 0 100.00% .fi .TP گزارش میزان استفاده حساب کلاستر با فیلدهای مشخص‌شده در طول روز مشخص‌شده و توسط کاربر مشخص‌شده: .IP .nf $ sreport cluster AccountUtilizationByUser start=7/10 end=7/11 \ cluster=minesofmoria user=stephen format=Account,Cluster,TresCount,Login,Proper,Used -------------------------------------------------------------------------------- Cluster/Account/User Utilization 2024-07-10T00:00:00 - 2024-07-10T23:59:59 (86400 secs) Usage reported in CPU Minutes -------------------------------------------------------------------------------- Account Cluster TRES Count Login Proper Name Used --------------- --------- ---------- --------- --------------- -------- main minesofm+ stephen ,,, 38 rivendell minesofm+ stephen ,,, 1 arwen minesofm+ stephen ,,, 1 elrond minesofm+ stephen ,,, 1 .fi .TP گزارش میزان استفاده حساب کلاستر توسط کاربر برای یک حساب خاص در طول یک دوره ۱ هفته‌ای: .IP .nf $ sreport cluster AccountUtilizationByUser start=7/23 end=7/24 \ cluster=minesofmoria account=main -------------------------------------------------------------------------------- Cluster/Account/User Utilization 2024-07-23T00:00:00 - 2024-07-23T23:59:59 (86400 secs) Usage reported in CPU Minutes -------------------------------------------------------------------------------- Cluster Account Login Proper Name Used Energy --------- --------------- --------- --------------- -------- -------- minesofm+ main 148 0 minesofm+ main phteven ,,, 2 0 minesofm+ main stephen ,,, 146 0 .fi .TP گزارش بیشترین میزان استفاده به درصد برای یک حساب خاص: .IP .nf $ sreport user topusage start=11:00 -t percent account=main -------------------------------------------------------------------------------- Top 10 Users 2024-08-19T11:00:00 - 2024-08-19T11:59:59 (3600 secs) Usage reported in Percentage of Total -------------------------------------------------------------------------------- Cluster Login Proper Name Account Used Energy --------- --------- --------------- --------------- -------- -------- minesofm+ stephen ,,, main 10.94% 0.00% minesofm+ phteven ,,, main 2.95% 0.00% .fi .SH "کپی‌رایت و تکثیر (COPYING)" Copyright (C) 2009\-2010 Lawrence Livermore National Security. Produced at Lawrence Livermore National Laboratory (cf, DISCLAIMER). .br Copyright (C) 2010\-2022 SchedMD LLC. .LP این پرونده بخشی از اسلورم (Slurm)، یک برنامه مدیریت منابع است. برای جزئیات بیشتر به مراجعه کنید. .LP اسلورم یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public License) منتشرشده توسط «بنیاد نرم‌افزارهای آزاد»؛ چه نسخه ۲ مجوز، یا (به انتخاب خودتان) هر نسخه بعدی، بازتوزیع کرده و/یا تغییر دهید. .LP اسلورم با این امید توزیع می‌شود که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی «قابل فروش بودن» یا «مناسب بودن برای یک هدف خاص». برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه فرمایید. .SH "همچنین ببینید (SEE ALSO)" \fBsacct\fR(1), \fBslurmdbd\fR(8)