cqueue 查看作业队列¶

cqueue显示队列中的作业和作业步信息。默认情况下，它显示作业信息，包括pending、running和其他状态。使用-s/--step选项可以查询作业步信息。

查看集群中所有队列的作业信息：

cqueue

选项¶

-h, --help: 适用于： 作业, 作业步
显示cqueue命令的帮助信息。
-v, --version: 适用于： 作业, 作业步
显示cqueue版本信息。
-C, --config=<path>: 适用于： 作业, 作业步
配置文件路径。默认值："/etc/crane/config.yaml"。
-F, --full: 适用于： 作业, 作业步
显示完整的内容而不截断。默认情况下，每项输出30个字符。
-N, --noheader: 适用于： 作业, 作业步
输出时隐藏表头。
-m, --max-lines=<number>: 适用于： 作业, 作业步
指定输出结果的最大条数。例如，-m=500将输出限制为500行。默认显示100条。
-i, --iterate=<seconds>: 适用于： 作业, 作业步
指定间隔秒数刷新查询结果。例如，-i=3表示每隔3秒输出一次查询结果。
--json: 适用于： 作业, 作业步
以JSON格式输出命令执行结果，而不是表格格式。
-s, --step[=<stepid1,stepid2,...>]: 适用于： 作业步
查询作业步信息而非作业信息。接受可选的逗号分隔的作业步ID列表，格式为jobid.stepid（如123.1,123.2,456.3 ）。如果不提供参数，则显示所有作业步。此选项将查询模式从作业切换到作业步。
-j, --job=<jobid1,jobid2,...>: 适用于： 作业, 作业步
指定查询的作业ID（逗号分隔列表）。例如，-j=2,3,4。与--step一起使用时，过滤属于指定作业的作业步。
-n, --name=<name1,name2,...>: 适用于： 作业, 作业步
指定查询的作业名（逗号分隔列表，用于多个名称）。
-t, --state=<state>: 适用于： 作业, 作业步
指定查询的状态。有效值为'pending(p)'、'running®'和'all'。默认为'all' （显示所有pending和running）。对于作业步，有效状态包括'running'和其他作业步特定状态。
-S, --start: 适用于： 作业
显示开始时间。对于pending作业，显示预期开始时间。对于running作业，显示实际开始时间。
-u, --user=<username1,username2,...>: 适用于： 作业, 作业步
指定查询的用户（逗号分隔列表，用于多个用户）。按指定的用户名过滤作业或作业步。
-A, --account=<account1,account2,...>: 适用于： 作业, 作业步
指定查询的账户（逗号分隔列表，用于多个账户）。按指定的账户过滤作业或作业步。
-p, --partition=<partition1,partition2,...>: 适用于： 作业, 作业步
指定查询的分区（逗号分隔列表，用于多个分区）。按指定的分区过滤作业或作业步。
-q, --qos=<qos1,qos2,...>: 适用于： 作业, 作业步
指定查询的QoS（逗号分隔列表，用于多个QoS）。按指定的服务质量级别过滤作业或作业步。
--self: 适用于： 作业, 作业步
仅查看当前用户提交的作业或作业步。
-o, --format=<format_string>: 适用于： 作业, 作业步
使用格式说明符自定义输出格式。字段由百分号(%)后跟字符标识。格式规范语法：%[.]<size><type>。不带大小：字段使用自然宽度。仅带大小（ %5j）：最小宽度，左对齐。带点和大小（%.5j）：最小宽度，右对齐。作业查询和作业步查询可用的格式说明符不同（见下面的格式说明符部分）。

默认输出字段¶

查询作业时（默认模式），显示以下字段：

JobId：作业标识号
Partition：作业运行的分区
Name：作业名
User：作业所有者的用户名
Account：作业计费的账户
Status：当前作业状态（如RUNNING、PENDING）
Type：作业类型（如BATCH、INTERACTIVE）
TimeLimit：作业的时间限制
Nodes：分配的节点数
NodeList：作业运行的节点名称

查询作业步时（使用--step），显示以下字段：

StepId：作业步标识，格式为jobid.stepid
JobId：父作业标识号
Name：作业步名称
Partition：分区（从父作业继承）
User：用户名（从父作业继承）
State：当前作业步状态
ElapsedTime：作业步启动以来的经过时间
NodeList：作业步运行的节点名称

作业格式说明符¶

查询作业时（默认模式），支持以下格式标识符（不区分大小写）：

标识符	全名	描述
%a	Account	与作业关联的账户
%c	AllocCpus	分配给作业的CPU
%C	ReqCpus	作业请求的总CPU数
%e	ElapsedTime	作业启动以来的经过时间
%h	Held	作业的保持状态
%j	JobID	作业ID
%k	Comment	作业的备注
%l	TimeLimit	作业的时间限制
%L	NodeList	作业运行的节点列表（或pending原因）
%m	AllocMemPerNode	每个节点分配的内存
%M	ReqMemPerNode	每个节点请求的内存
%n	Name	作业名
%N	NodeNum	作业请求的节点数
%o	Command	作业的命令行
%p	Priority	作业的优先级
%P	Partition	作业运行的分区
%q	QoS	作业的服务质量级别
%Q	ReqCpuPerNode	每个节点请求的CPU数
%r	ReqNodes	请求的节点
%R	Reason	pending状态的原因
%s	SubmitTime	作业的提交时间
%S	StartTime	作业的开始时间
%t	State	作业的当前状态
%T	JobType	作业类型
%u	User	提交作业的用户
%U	Uid	作业的UID
%x	ExcludeNodes	从作业中排除的节点
%X	Exclusive	作业的独占状态

作业步格式说明符¶

查询作业步时（使用--step），支持以下格式标识符（不区分大小写）：

标识符	全名	描述
%i	StepId	作业步ID，格式为jobid.stepid
%j	JobId	父作业ID
%n	Name	作业步名称
%P	Partition	分区（从父作业继承）
%u	User	用户名（从父作业继承）
%U	Uid	用户ID
%e	ElapsedTime	作业步启动以来的经过时间
%L	NodeList	作业步运行的节点列表
%t	State	作业步的当前状态
%l	TimeLimit	作业步的时间限制
%N	NodeNum	分配给作业步的节点数
%a	Account	账户（从父作业继承）
%q	QoS	服务质量（从父作业继承）
%o	Command	作业步的命令行

使用示例¶

基本作业查询¶

查看所有作业：

cqueue

[cranetest@crane01 ~]$ cqueue
JOBID  PARTITION  NAME      USER       ACCOUNT    STATUS   TYPE   TIME      TIMELIMIT  NODES  NODELIST/REASON
30685  CPU        Test_Job  cranetest  CraneTest  Pending  Batch  -         00:30:01   2      Priority
30686  CPU        Test_Job  cranetest  CraneTest  Pending  Batch  -         00:30:01   2      Priority
30687  CPU        Test_Job  cranetest  CraneTest  Pending  Batch  -         00:30:01   2      Priority
30683  CPU        Test_Job  cranetest  CraneTest  Running  Batch  00:01:33   00:30:01   2      crane[02-03]
30684  CPU        Test_Job  cranetest  CraneTest  Running  Batch  00:01:31   00:30:01   2      crane[02-03]

显示帮助：

cqueue -h

[cranetest@crane01 ~]$ cqueue -h
Display the job information and queue status

Usage:
  cqueue [flags]

Flags:
  -A, --account string        Specify accounts to view (comma separated list), 
                              default is all accounts
  -C, --config string         Path to configuration file (default "/etc/crane/config.yaml")
  -o, --format string         Specify the output format.
                                Fields are identified by a percent sign (%) followed by a character or string.
                                Format specification: %[[.]size]type
                                  - Without size: field uses natural width
                                  - With size only (%5j): field uses minimum width, left-aligned (padding on right)
                                  - With dot and size (%.5j): field uses minimum width, right-aligned (padding on left)

                              Supported format identifiers or string, string case insensitive:
                                %a/%Account            - Display the account associated with the job/step.
                                %C/%ReqCpus            - Display the cpus requested to the job. (For jobs only)
                                %c/%AllocCpus          - Display the cpus allocated to the job. (For jobs only)
                                %e/%ElapsedTime        - Display the elapsed time from the start of the job/step.
                                %h/%Held               - Display the hold state of the job. (For jobs only)
                                %i/%StepId             - Display the ID of the step (format: jobId.stepId). (For steps only)
                                %j/%JobID              - Display the ID of the job (or parent job ID for steps).
                                %k/%Comment            - Display the comment of the job. (For jobs only)
                                %K/%Wckey              - Display the wckey of the job.
                                %L/%NodeList           - Display the list of nodes the job/step is running on.
                                %l/%TimeLimit          - Display the time limit for the job/step.
                                %M/%ReqMemPerNode      - Display the requested mem per node of the job. (For jobs only)
                                %m/%AllocMemPerNode    - Display the requested mem per node of the job. (For jobs only)
                                %N/%NodeNum            - Display the number of nodes requested by the job/step.
                                %n/%Name               - Display the name of the job/step.
                                %o/%Command            - Display the command line of the job/step.
                                %P/%Partition          - Display the partition the job/step is running in.
                                %p/%Priority           - Display the priority of the job. (For jobs only)
                                %Q/%ReqCpuPerNode      - Display the requested cpu per node of the job. (For jobs only)
                                %q/%QoS                - Display the Quality of Service level for the job/step.
                                %R/%Reason             - Display the reason of pending. (For jobs only)
                                %r/%ReqNodes           - Display the reqnodes of the job. (For jobs only)
                                %S/%StartTime          - Display the start time of the job. (For jobs only)
                                %s/%SubmitTime         - Display the submission time of the job. (For jobs only)
                                %t/%State              - Display the current state of the job/step.
                                %T/%JobType            - Display the job type. (For jobs only)
                                %U/%Uid                - Display the uid of the job/step.
                                %u/%User               - Display the user who submitted the job/step.
                                %X/%Exclusive          - Display the exclusive status of the job. (For jobs only)
                                %x/%ExcludeNodes       - Display the exclude nodes of the job. (For jobs only)

                              Examples:
                                --format "%j %n %t"              # Natural width for all fields
                                --format "%5j %20n %t"           # Left-aligned: JobID (min 5), Name (min 20), State
                                --format "%.5j %.20n %t"         # Right-aligned: JobID (min 5), Name (min 20), State
                                --format "ID:%8j | Name:%.15n"   # Mixed: left-aligned JobID, right-aligned Name with prefix

                              Note: If the format is invalid or unrecognized, the program will terminate with an error message.

  -F, --full                  Display full information (If not set, only display 30 characters per cell)
  -h, --help                  help for cqueue
  -i, --iterate uint          Display at specified intervals (seconds), default is 0 (no iteration)
  -j, --job string            Specify job ids to view (comma separated list), default is all
      --json                  Output in JSON format
  -L, --licenses string       Specify licenses to view (comma separated list), default is all licenses
  -m, --max-lines uint32      Limit the number of lines in the output, 0 means no limit (default 1000)
  -n, --name string           Specify job names to view (comma separated list), default is all
  -w, --nodelist string       Specify node names to view (comma separated list or patterns like node[1-10]), default is all
  -N, --noheader              Do not print header line in the output
  -p, --partition string      Specify partitions to view (comma separated list), 
                              default is all partitions
  -q, --qos string            Specify QoS of jobs to view (comma separated list), 
                              default is all QoS
      --self                  Display only the jobs submitted by current user
  -S, --start                 Display expected start time of pending jobs
  -t, --state string          Specify job states to view. Valid value are 'pending(p)', 'running(r)' and 'all'.
                              By default, 'all' is specified and all pending and running jobs will be reported (default "all")
  -s, --step string[="ALL"]   Specify step ids to view (comma separated list), default is all
      --type string           Specify task types to view (comma separated list), 
                              valid values are 'Interactive', 'Batch', 'Container', default is all types
  -u, --user string           Specify users to view (comma separated list), default is all users
  -v, --version               version for cqueue
  ```

**隐藏表头：**

```bash
cqueue -N

[cranetest@crane01 ~]$ cqueue -N
30685 CPU Test_Job cranetest CraneTest Pending Batch -         00:30:01 2 Priority
30686 CPU Test_Job cranetest CraneTest Pending Batch -         00:30:01 2 Priority
30687 CPU Test_Job cranetest CraneTest Pending Batch -         00:30:01 2 Priority
30683 CPU Test_Job cranetest CraneTest Running Batch 00:03:33 00:30:01 2 crane[02-03]
30684 CPU Test_Job cranetest CraneTest Running Batch 00:03:31 00:30:01 2 crane[02-03]

显示开始时间：

cqueue -S

[cranetest@crane01 ~]$ cqueue -S
JOBID PARTITION NAME     USER       ACCOUNT    STATUS   TYPE   TIME      TIMELIMIT NODES NODELIST/REASON
30685 CPU       Test_Job cranetest CraneTest  Pending  Batch  -         00:30:01   2     Priority
30686 CPU       Test_Job cranetest CraneTest  Pending  Batch  -         00:30:01   2     Priority
30687 CPU       Test_Job cranetest CraneTest  Pending  Batch  -         00:30:01   2     Priority
30683 CPU       Test_Job cranetest CraneTest  Running  Batch  00:03:38   00:30:01   2     crane[02-03]
30684 CPU       Test_Job cranetest CraneTest  Running  Batch  00:03:36   00:30:01   2     crane[02-03]

过滤作业¶

查询特定作业：

cqueue -j 30686,30687

[cranetest@crane01 ~]$ cqueue -j 30686,30687
JOBID PARTITION NAME     USER       ACCOUNT    STATUS  TYPE  TIME TIMELIMIT NODES NODELIST/REASON
30686 CPU       Test_Job cranetest CraneTest  Pending Batch -    00:30:01   2     Priority
30687 CPU       Test_Job cranetest CraneTest  Pending Batch -    00:30:01   2     Priority

按状态过滤（pending作业）：

cqueue -t Pending

[cranetest@crane01 ~]$ cqueue -t Pending
JOBID PARTITION NAME     USER       ACCOUNT    STATUS  TYPE  TIME TIMELIMIT NODES NODELIST/REASON
30685 CPU       Test_Job cranetest CraneTest  Pending Batch -    00:30:01   2     Priority
30686 CPU       Test_Job cranetest CraneTest  Pending Batch -    00:30:01   2     Priority
30687 CPU       Test_Job cranetest CraneTest  Pending Batch -    00:30:01   2     Priority

按状态过滤（running作业，简写）：

cqueue -t r

[zhouhao@cranetest01 ~]$ cqueue -t r
JOBID PARTITION NAME        USER     ACCOUNT         STATUS   TYPE   TIME      TIMELIMIT NODES NODELIST/REASON
246   CPU       Test_Job_003 zhouhao  subAccountTest  Running  Batch  00:01:49   00:03:01   1     cranetest03

查询特定用户的作业：

cqueue -u cranetest

[cranetest@crane01 ~]$ cqueue -u cranetest
JOBID PARTITION NAME     USER       ACCOUNT    STATUS   TYPE   TIME      TIMELIMIT NODES NODELIST/REASON
30685 CPU       Test_Job cranetest CraneTest  Pending  Batch  -         00:30:01   2     Priority
30686 CPU       Test_Job cranetest CraneTest  Pending  Batch  -         00:30:01   2     Priority
30687 CPU       Test_Job cranetest CraneTest  Pending  Batch  -         00:30:01   2     Priority
30683 CPU       Test_Job cranetest CraneTest  Running  Batch  00:04:11   00:30:01   2     crane[02-03]
30684 CPU       Test_Job cranetest CraneTest  Running  Batch  00:04:09   00:30:01   2     crane[02-03]

仅显示当前用户的作业：

cqueue --self

[zhouhao@cranetest01 ~]$ cqueue --self
JOBID PARTITION NAME        USER     ACCOUNT         STATUS   TYPE   TIME      TIMELIMIT NODES NODELIST/REASON
246   CPU       Test_Job_003 zhouhao  subAccountTest  Running  Batch  00:01:12   00:03:01   1     cranetest03

查询特定账户的作业：

cqueue -A CraneTest

[cranetest@crane01 ~]$ cqueue -A CraneTest
JOBID PARTITION NAME     USER       ACCOUNT    STATUS   TYPE   TIME      TIMELIMIT NODES NODELIST/REASON
30685 CPU       Test_Job cranetest CraneTest  Pending  Batch  -         00:30:01   2     Priority
30686 CPU       Test_Job cranetest CraneTest  Pending  Batch  -         00:30:01   2     Priority
30687 CPU       Test_Job cranetest CraneTest  Pending  Batch  -         00:30:01   2     Priority
30683 CPU       Test_Job cranetest CraneTest  Running  Batch  00:04:32   00:30:01   2     crane[02-03]
30684 CPU       Test_Job cranetest CraneTest  Running  Batch  00:04:30   00:30:01   2     crane[02-03]

按分区过滤：

cqueue -p CPU

[cranetest@crane01 ~]$ cqueue -p CPU
JOBID PARTITION NAME     USER       ACCOUNT    STATUS   TYPE   TIME      TIMELIMIT NODES NODELIST/REASON
30685 CPU       Test_Job cranetest CraneTest  Pending  Batch  -         00:30:01   2     Priority
30686 CPU       Test_Job cranetest CraneTest  Pending  Batch  -         00:30:01   2     Priority
30687 CPU       Test_Job cranetest CraneTest  Pending  Batch  -         00:30:01   2     Priority
30683 CPU       Test_Job cranetest CraneTest  Running  Batch  00:04:50   00:30:01   2     crane[02-03]
30684 CPU       Test_Job cranetest CraneTest  Running  Batch  00:04:48   00:30:01   2     crane[02-03]

按作业名过滤：

cqueue -n test

[root@cranetest-rocky01 zhouhao]# cqueue -n test
JOBID   PARTITION   NAME   USER   ACCOUNT   STATUS   TYPE   TIME   TIMELIMIT   NODES   NODELIST/REASON
1276686 CPU         test   root   ROOT      Pending  Batch  -      00:03:01    1       Priority

按QoS过滤：

cqueue -q test_qos

[zhouhao@cranetest01 ~]$ cqueue -q test_qos
JOBID PARTITION NAME        USER     ACCOUNT         STATUS   TYPE   TIME      TIMELIMIT NODES NODELIST/REASON QOS
246   CPU       Test_Job_003 zhouhao  subAccountTest  Running  Batch  00:02:40   00:03:01   1     cranetest03     test_qos

输出控制¶

限制输出到3行：

cqueue -m 3

[cranetest@crane01 ~]$ cqueue -m 3
JOBID PARTITION NAME     USER       ACCOUNT    STATUS  TYPE  TIME TIMELIMIT NODES NODELIST/REASON
30685 CPU       Test_Job cranetest CraneTest  Pending Batch -    00:30:01   2     Priority
30686 CPU       Test_Job cranetest CraneTest  Pending Batch -    00:30:01   2     Priority
30687 CPU       Test_Job cranetest CraneTest  Pending Batch -    00:30:01   2     Priority

每3秒自动刷新：

cqueue -i 3

[cranetest@crane01 ~]$ cqueue -i 3
2024-07-24 11:39:02
JOBID PARTITION NAME     USER       ACCOUNT    STATUS   TYPE   TIME      TIMELIMIT NODES NODELIST/REASON
30685 CPU       Test_Job cranetest CraneTest  Pending  Batch  -         00:30:01   2     Priority
30686 CPU       Test_Job cranetest CraneTest  Pending  Batch  -         00:30:01   2     Priority
30687 CPU       Test_Job cranetest CraneTest  Pending  Batch  -         00:30:01   2     Priority
30683 CPU       Test_Job cranetest CraneTest  Running  Batch  00:04:36   00:30:01   2     crane[02-03]
30684 CPU       Test_Job cranetest CraneTest  Running  Batch  00:04:34   00:30:01   2     crane[02-03]

2024-07-24 11:39:05
JOBID PARTITION NAME     USER       ACCOUNT    STATUS   TYPE   TIME      TIMELIMIT NODES NODELIST/REASON
30685 CPU       Test_Job cranetest CraneTest  Pending  Batch  -         00:30:01   2     Priority
30686 CPU       Test_Job cranetest CraneTest  Pending  Batch  -         00:30:01   2     Priority
30687 CPU       Test_Job cranetest CraneTest  Pending  Batch  -         00:30:01   2     Priority
30683 CPU       Test_Job cranetest CraneTest  Running  Batch  00:04:39   00:30:01   2     crane[02-03]
30684 CPU       Test_Job cranetest CraneTest  Running  Batch  00:04:37   00:30:01   2     crane[02-03]

2024-07-24 11:39:08
JOBID PARTITION NAME     USER       ACCOUNT    STATUS   TYPE   TIME      TIMELIMIT NODES NODELIST/REASON
30685 CPU       Test_Job cranetest CraneTest  Pending  Batch  -         00:30:01   2     Priority
30686 CPU       Test_Job cranetest CraneTest  Pending  Batch  -         00:30:01   2     Priority
30687 CPU       Test_Job cranetest CraneTest  Pending  Batch  -         00:30:01   2     Priority
30683 CPU       Test_Job cranetest CraneTest  Running  Batch  00:04:42   00:30:01   2     crane[02-03]
30684 CPU       Test_Job cranetest CraneTest  Running  Batch  00:04:40   00:30:01   2     crane[02-03]

JSON输出：

cqueue --json

自定义格式输出¶

所有字段使用自然宽度：

cqueue --format "%j %n %t"

左对齐，带最小宽度：

cqueue --format "%5j %20n %t"

右对齐，带最小宽度：

cqueue --format "%.5j %.20n %t"

带标签的混合格式：

cqueue --format "ID:%8j | Name:%.15n | State:%t"

复杂自定义格式：

cqueue -o="%n %u %.5j %.5t %.3T %.5T"

[cranetest@crane01 ~]$ cqueue -o="%n %u %.5j %.5t %.3T %.5T"
NAME     USER       JOBID  STATU TYP TYPE
Test_Job cranetest  30685  Pendi Bat Batch
Test_Job cranetest  30686  Pendi Bat Batch
Test_Job cranetest  30687  Pendi Bat Batch
Test_Job cranetest  30683  Runni Bat Batch
Test_Job cranetest  30684  Runni Bat Batch

作业步查询¶

查询所有作业步：

cqueue --step

查询特定作业步：

cqueue --step 100.1,100.2,200.3

查询特定作业的作业步：

cqueue --step -j 123

使用自定义格式查询作业步：

cqueue --step --format "%i %n %t %e %L"

查询容器作业

容器作业（Pod）和容器步骤的类型显示为 Container。使用 cacct --type Container 可过滤容器作业，或使用 cqueue --step -j <pod_job_id> 查看容器作业的步骤。更多容器操作参见 ccon 命令手册。

查询特定用户的作业步：

cqueue --step -u username

作业步右对齐格式：

cqueue --step --format "%.10i %.20n %.10t"

按状态过滤作业步：

cqueue --step -t running

查询多个作业的作业步：

cqueue --step -j 100,200,300