sprio

部分: Slurm 命令 (1)
更新: Slurm 命令
索引

 

名称

sprio - 查看构成作业调度优先级的因素

 

概要

sprio [选项...]

 

描述

sprio 用于查看作业调度优先级的组成部分，当安装了多因素优先级插件时。 sprio 是一个只读工具，从多因素优先级插件中提取信息。默认情况下，sprio 返回所有待处理作业的信息。可以选择按作业 ID 和用户名显示特定作业。

 

选项

-M, --clusters=<字符串>
要发出命令的集群。只能指定一个集群名称。 请注意，slurmdbd 必须处于运行状态，以使此选项正常工作，除非 在配置了 FederationParameters=fed_display 的联合中运行，或设置了 --federation 选项。 此选项隐式设置 --local 选项。

--federation
如果是联合的成员，则显示联合中的作业。

-o, --format=<输出格式>
指定要显示的信息、其大小和位置（右对齐或左对齐）。当所有因素都分配了非零权重时，默认格式为
default
"%.15i %9r %.10Y %.10S %.10A %.10B %.10F %.10J %.10P %.10Q %20T"

-l, --long
"%.15i %9r %.8u %.8o %.10Y %.10S %.10A %.10B %.10F %.10J %.10P %.10n %.10Q %.11N %.20T";

每个字段的格式为 "%[.][size]type"。

size
是最小字段大小。 如果未指定大小，将使用打印信息所需的任何内容。

.
表示输出应左对齐。 默认情况下，输出是右对齐的。

有效的 type 规范包括：

%a
标准化的年龄优先级

%A
加权的年龄优先级

%b
标准化的关联优先级

%B
加权的关联优先级

%c
集群名称。仅适用于联合集群

%f
标准化的公平共享优先级

%F
加权的公平共享优先级

%i
作业 ID

%j
标准化的作业大小优先级

%J
加权的作业大小优先级

%n
QOS 名称

%N
Nice 调整

%o
账户名称

%p
标准化的分区优先级

%P
加权的分区优先级

%q
标准化的服务质量优先级

%Q
加权的服务质量优先级

%r
分区名称

%S
加权的管理员优先级。

%t
标准化的 TRES 优先级

%T
加权的 TRES 优先级

%u
作业的用户名

%Y
作业优先级

%y
标准化的作业优先级

--help
打印描述所有选项的帮助信息 sprio。

-j, --jobs=<作业_id_列表>
请求要显示的作业 ID 的逗号分隔列表。默认为 所有作业。由于此选项的参数是可选的，为了正确解析 单字母选项必须紧跟其值，并且两者之间不能有空格。例如 "-j1008,1009" 而不是 "-j 1008,1009"。

--local
仅显示本集群本地的作业。忽略此联合中的其他集群 （如果有）。覆盖 --federation。

-l, --long
报告所选作业的更多可用信息。

-h, --noheader
在输出中不打印标题。

-n, --norm
显示所选作业的标准化优先级因素。

-p, --partition=<分区_列表>
请求要显示的逗号分隔的分区列表。默认为 所有分区。

--sibling
显示联合集群上的所有兄弟作业。在联合集群中，如果没有此选项， 每个分区中的每个作业将仅报告其优先级及其 组件的优先级。联合中各个集群上的每个兄弟作业可能具有不同的优先级，如果不使用此选项，则不会报告。隐式地将 "%c"（集群名称）添加到 输出格式。

-S, --sort=<排序_列表>
指定作业报告的顺序。此选项使用与 <输出格式> 相同的 字段规范。可以通过列出多个用逗号分隔的排序字段来执行多个排序。字段规范可以 以 "+" 或 "-" 为前缀，分别表示升序（默认）或降序。 例如，<sort_list> 为 "u,r,-y" 将按 用户名、分区名称和降序作业优先级排序，顺序为此。默认的 <sort_list> 为 "i"（升序作业 ID）。

--usage
打印简要帮助信息，列出 sprio 选项。

-u, --user=<用户_列表>
请求来自逗号分隔的用户列表的作业。列表可以 由用户名或用户 ID 号码组成。

-v, --verbose
报告 sprio 操作的详细信息。

-V, --version
打印版本信息并退出。

-w, --weights
显示每个因素的配置权重。此选项仅用于信息 目的。实际作业数据被抑制。

 

性能

执行 sprio 会向 slurmctld 发送远程过程调用。如果 来自 sprio 或其他发送远程 过程调用到 slurmctld 守护进程的 Slurm 客户端命令的调用过多，可能会导致 slurmctld 守护进程的性能下降，可能导致 服务拒绝。

请勿在 shell 脚本或其他程序的循环中运行 sprio 或其他发送远程过程 调用到 slurmctld 的 Slurm 客户端命令。确保 程序将对 sprio 的调用限制在收集信息所需的最小值。

 

环境变量

如果未指定相应的命令行选项，sprio 将使用 以下环境变量的值。

SLURM_CLUSTERS
与 --clusters 相同

SLURM_CONF
Slurm 配置文件的位置。

SLURM_DEBUG_FLAGS
指定 sprio 使用的调试标志。请参阅调试标志在 slurm.conf(5) 手册页以获取完整的标志列表。环境 变量优先于 slurm.conf 中的设置。

SPRIO_FEDERATION
与 --federation 相同

SPRIO_FORMAT
与 -o <output_format>, --format=<output_format> 相同

SPRIO_LOCAL
与 --local 相同

SPRIO_SIBLING
与 --sibling 相同

 

示例

打印所有待处理作业及其加权优先级的列表
$ sprio
  JOBID   PRIORITY        AGE  FAIRSHARE    JOBSIZE  PARTITION        QOS
  65539      62664          0      51664       1000      10000          0
  65540      62663          0      51663       1000      10000          0
  65541      62662          0      51662       1000      10000          0

打印所有待处理作业及其标准化优先级的列表
$ sprio -n
  JOBID PRIORITY   AGE        FAIRSHARE  JOBSIZE    PARTITION  QOS
  65539 0.00001459 0.0007180  0.5166470  1.0000000  1.0000000  0.0000000
  65540 0.00001459 0.0007180  0.5166370  1.0000000  1.0000000  0.0000000
  65541 0.00001458 0.0007180  0.5166270  1.0000000  1.0000000  0.0000000

打印特定作业的优先级
$ sprio --jobs=65548,65547
  JOBID   PRIORITY        AGE  FAIRSHARE    JOBSIZE  PARTITION        QOS
  65547      62078          0      51078       1000      10000          0
  65548      62077          0      51077       1000      10000          0

打印特定用户作业的优先级
$ sprio --users=fred,sally
  JOBID     USER  PRIORITY       AGE  FAIRSHARE   JOBSIZE  PARTITION     QOS
  65548     fred     62079         1      51077      1000      10000       0
  65549    sally     62080         1      51078      1000      10000       0

打印每个优先级组件的配置权重
$ sprio -w
  JOBID   PRIORITY        AGE  FAIRSHARE    JOBSIZE  PARTITION        QOS
  Weights                1000     100000       1000      10000          1

 

版权

版权所有 (C) 2009 劳伦斯利弗莫尔国家实验室。 在劳伦斯利弗莫尔国家实验室制作（请参阅免责声明）。
版权所有 (C) 2010-2022 SchedMD LLC。

此文件是 Slurm 的一部分，一个资源管理程序。 有关详细信息，请参见 <https://slurm.schedmd.com/>。

Slurm 是自由软件；您可以根据自由软件基金会发布的 GNU 通用公共许可证的条款重新分发和/或修改它；许可证的第 2 版，或（根据您的选择）任何更高版本。

Slurm 的分发是希望它会有用，但不提供任何 保证；甚至没有适销性或适合特定目的的隐含保证。有关更多详细信息，请参见 GNU 通用公共许可证。  

另见

squeue(1), sshare(1)

 

索引

名称
概要
描述
选项
性能
环境变量
示例
版权
另见
此文档由 man2html 使用手册页创建。
时间: 2025年7月2日 13:21:55 GMT