qacct
介绍
qacct 是用于查询已完成作业账目信息的工具，功能类似 Sun Grid Engine (SGE) 的 qacct 命令。用户可通过参数筛选并查看特定条件下的作业记录，支持按作业、用户、队列、项目、主机等多种维度进行统计和详情查询。
参数说明
支持参数列表
| 选项 | 是否需带值 | 功能描述 | 主要差异 |
|---|---|---|---|
-j | 可选 | 按作业 ID/作业名/模式过滤结果。带参数显示详细信息（无汇总），不带参数显示详情+系统汇总。 | 无差异。 |
-o | 可选 | 按提交者过滤或分组统计作业，支持多个用户（如 user1,user2）。 | 无差异。 |
-u | 可选 | 同 -o，按提交者过滤或分组统计作业。 | 无差异。 |
-b | 是 | 显示在指定时间之后开始的作业。格式：[[CC]YY]MMDDhhmm[.SS]（如 202601150800、01150800、2601150800、01150800.30）。 | 无差异。 |
-e | 是 | 显示在指定时间之前开始的作业。格式：[[CC]YY]MMDDhhmm[.SS]。 | 无差异。 |
-d | 是 | 显示在过去 N 天内开始的作业。 | 无差异。 |
-E | 否 | 使用作业结束时间而非开始时间进行时间过滤（需与 -b/-e/-d 配合）。 | 无差异。 |
-h | 可选 | 按主机名过滤或分组统计作业。 | 无差异。 |
-t | 是 | 按任务 ID 过滤数组作业任务。需与 -j 配合使用。 | 无差异。 |
-A | 可选 | 按账户分组或过滤作业。 | 无差异。 |
-P | 可选 | 按项目分组或过滤作业。 | project 对应 wckey 字段。 |
-q | 可选 | 按队列分组或过滤作业。 | 无差异。 |
-g | 可选 | 按用户组分组或过滤作业。 | 无差异。 |
-pe | 可选 | 按并行环境（PE）分组或过滤作业。 | 从作业 comment 字段提取 PE 信息（格式：PE:name 或 PE:name:slots）。 |
-slots | 可选 | 按槽数（CPU数）分组或过滤作业。 | 无差异。 |
-D | 可选 | 按部门分组或过滤作业。 | 固定显示 defaultdepartment（无部门概念）。 |
-ar | 可选 | 按高级预留（AR）分组或过滤作业。 | 固定显示 0（无 AR 概念）。 |
-l | 是 | 按资源需求过滤作业（如 mem_free=1G,arch=x86_64）。 | 支持资源属性：hostname、arch、num_proc、mem_free、mem_total、virtual_free、virtual_total。仅包括实际运行过的作业（start_time != 0）。 |
-m | 否 | 仅显示主任务（master tasks）。 | 当前为占位功能，实现与不带该选项相同。 |
-f | 是 | 指定自定义账目文件路径。 | 不支持，报错提示使用数据库而非账目文件。 |
输出模式说明
| 模式 | 触发条件 | 输出内容 |
|---|---|---|
| 详情模式 | -j <job_id|job_name|pattern> | 显示匹配作业的详细账目信息（无汇总统计）。 |
| 汇总模式 | 不带 -j 或 -j 不带参数 | 按指定维度分组显示统计汇总（如 WALLCLOCK、UTIME、STIME、CPU、MEMORY 等）。 |
| 混合模式 | -j（不带参数） | 显示所有作业详情 + Total System Usage 汇总。 |
汇总统计字段
| 输出项 | 功能描述 | 主要差异 |
|---|---|---|
WALLCLOCK | 作业总墙钟时间（秒）。 | 无差异。 |
UTIME | 用户 CPU 时间（秒）。 | 无差异。 |
STIME | 系统 CPU 时间（秒）。 | 无差异。 |
CPU | 总 CPU 时间（UTIME + STIME，秒）。 | 无差异。 |
MEMORY | 内存使用量（字节）。 | 当前实现为占位符，显示 0.000。 |
IO | I/O 读写量（字节）。 | 当前实现为占位符，显示 0.000。 |
IOW | I/O 等待时间（秒）。 | 当前实现为占位符，显示 0.000。 |
详情模式输出字段
| 输出项 | 功能描述 | 主要差异 |
|---|---|---|
qname | 队列名称（partition）。 | 无差异。 |
hostname | 执行主机名。 | 无差异。 |
group | 用户组名。 | 无差异。 |
owner | 用户名。 | 无差异。 |
project | 项目名称（wckey）。 | project 对应 wckey。 |
department | 部门名称。 | 固定显示 defaultdepartment。 |
jobname | 作业名称。 | 无差异。 |
jobnumber | 作业 ID。 | 数组作业显示 array_job_id。 |
taskid | 任务 ID（数组作业）。 | 非数组作业显示 undefined。 |
account | 账户名称。 | 默认显示 sge。 |
priority | 作业优先级。 | 固定显示 0。 |
qsub_time | 作业提交时间。 | 无差异。 |
start_time | 作业开始时间。 | 无差异。 |
end_time | 作业结束时间。 | 无差异。 |
granted_pe | 授予的并行环境。 | 固定显示 NONE。 |
slots | 分配的槽数（CPU数）。 | 从 TRES 数据中提取。 |
failed | 失败代码。 | 根据作业状态映射失败码（26/37/100 等）。 |
exit_status | 作业退出状态码。 | 失败作业加 128（ABNORMAL_EXIT_STATE_BASE）。 |
ru_wallclock | 墙钟时间。 | 无差异。 |
ru_utime | 用户 CPU 时间。 | 无差异。 |
ru_stime | 系统 CPU 时间。 | 无差异。 |
ru_maxrss | 最大常驻内存集。 | 从作业步骤的 TRES 数据中提取。 |
cpu | 总 CPU 时间。 | 无差异。 |
mem | 内存使用（带 s 后缀）。 | 从作业步骤的 TRES 数据中提取。 |
maxvmem | 最大虚拟内存。 | 从作业步骤的 TRES 数据中提取。 |
使用示例
示例 1：查询特定作业的账目信息（详情模式）
$ qacct -j 5678
==============================================================
qname normal
hostname compute01
group users
owner user1
project project1
department defaultdepartment
jobname myjob
jobnumber 5678
taskid undefined
account sge
priority 0
qsub_time Mon Jan 15 10:30:00 2026
start_time Mon Jan 15 10:31:00 2026
end_time Mon Jan 15 11:30:00 2026
...
说明：显示作业 5678 的完整账目详情，不显示汇总统计。
示例 2：按作业名模式匹配查询
$ qacct -j "test_*"
==============================================================
qname normal
hostname compute01
...
==============================================================
qname normal
hostname compute02
...
说明：支持通配符 * 和 ? 匹配作业名。
示例 3：按用户和时间范围查询（汇总模式）
$ qacct -o user1 -b "202601010000"
OWNER WALLCLOCK UTIME STIME CPU MEMORY IO IOW
=============================================================================================================================
user1 3600 100.000 50.000 150.000 0.000 0.000 0.000
说明：显示用户 user1 在 2026-01-01 00:00 后启动的所有作业的统计汇总。
示例 4：按队列分组汇总
$ qacct -q
CLUSTER QUEUE WALLCLOCK UTIME STIME CPU MEMORY IO IOW
==============================================================================================================================
normal 36000 1000.000 500.000 1500.000 0.000 0.000 0.000
highmem 72000 2000.000 1000.000 3000.000 0.000 0.000 0.000
说明：按队列分组显示统计信息。
示例 5：按主机分组汇总
$ qacct -h
HOST WALLCLOCK UTIME STIME CPU MEMORY IO IOW
=============================================================================================================================
compute01 2317 0.000 0.000 0.000 0.000 0.000 0.000
compute02 111 0.000 0.000 0.000 0.000 0.000 0.000
说明：按执行主机分组显示统计信息。
示例 6：查询数组作业的特定任务
$ qacct -j 1234 -t 10
==============================================================
qname normal
hostname compute01
...
jobnumber 1234
taskid 10
...
说明：-t 必须与 -j 配合使用，用于查询数组作业的特定任务。
示例 7：按资源需求过滤
$ qacct -l "mem_free=1G,arch=x86_64"
HOST WALLCLOCK UTIME STIME CPU MEMORY IO IOW
=============================================================================================================================
compute01 2317 0.000 0.000 0.000 0.000 0.000 0.000
说明：仅显示在满足资源需求的节点上运行过的作业。
示例 8：使用作业结束时间过滤
$ qacct -E -b "202601010000" -e "202601312359"
说明：-E 选项使时间过滤基于作业结束时间而非开始时间。
示例 9：显示系统总汇总（默认模式）
$ qacct
Total System Usage
WALLCLOCK UTIME STIME CPU MEMORY IO IOW
=============================================================================================================================
108000 3000.000 1500.000 4500.000 0.000 0.000 0.000
说明：不带任何参数时，显示系统总的使用统计。
示例 10：混合模式（显示详情+汇总）
$ qacct -j
==============================================================
qname normal
...
==============================================================
qname normal
...
Total System Usage
WALLCLOCK UTIME STIME CPU MEMORY IO IOW
=============================================================================================================================
108000 3000.000 1500.000 4500.000 0.000 0.000 0.000
说明：-j 不带参数时，显示所有作业详情后跟系统总汇总。
注意事项
1. 参数组合规则
- 详情模式：
-j带参数（-j <job_id\|name\|pattern>）显示详细信息，不显示汇总。 - 汇总模式：不带
-j或-j不带参数时显示统计汇总。 - 过滤参数组合：多个过滤参数（如
-j、-o、-h、-q、-l等）同时使用时，结果需同时满足所有条件（AND 逻辑）。 - 特殊组合：
-l和-h同时使用时，取两者的交集（仅显示在满足-l资源需求的节点中且主机名匹配-h的作业）。-t必须与-j配合使用，且-j必须带参数。
2. 时间过滤行为
- 默认时间范围：不带时间参数时，默认查询最近 30 天内开始的作业（可通过环境变量
FSCHED_ACCT_PAGE_SIZE调整分页大小）。 - 时间过滤基准：
- 不带
-E：基于作业开始时间过滤（start_time）。 - 带
-E：基于作业结束时间过滤（end_time）。
- 不带
- 时间格式：支持
[[CC]YY]MMDDhhmm[.SS]格式（如202601150800、01150800、2601150800、01150800.30）。
3. 查询性能优化
- 分页查询：非特定作业查询（不带
-j或-j不带参数）使用分页机制，避免内存溢出。 - 环境变量：可通过
FSCHED_ACCT_PAGE_SIZE环境变量调整每页查询的作业数（默认 100）。