qhost

查看集群中主机的状态、资源和负载信息。

---

参数说明

支持参数列表

选项	是否需要值	取值范围	用途	主要差异
(默认)	否	无	显示所有主机的基本状态和资源信息	无差异
-F	可选	资源属性列表（逗号分隔）	显示主机的所有资源属性或指定资源属性。支持25个资源属性	m_topology 和 m_topology_inuse 为dummy值 "NONE"
-h	是	主机列表（逗号分隔）	仅显示指定主机的信息。支持通配符 *	无差异
-j	否	无	显示主机上运行的作业信息	仅显示运行中的作业，master 列为dummy值 "MASTER"
-l	是	资源表达式	仅显示满足资源需求的主机	支持 arch=, num_proc=, mem_total=, mem_free=
-cb	否	无	显示核心绑定信息（默认行为）	默认显示NSOC/NCOR/NTHR列
-ncb	否	无	抑制核心绑定相关的列（NSOC, NCOR, NTHR）	无差异
-q	否	无	显示主机上的队列实例信息	队列类型为dummy值 "BIP"，保留槽位为dummy值 0
-u	是	用户名	仅显示有指定用户作业运行的主机	无差异
-xml	否	无	以XML格式输出	XML schema与原生SGE略有差异
-help	否	无	显示帮助信息	实现了详细的帮助信息

---

默认的输出项

输出项	功能描述	主要差异
HOSTNAME	主机名称	第一行为 global 且所有字段为 -
ARCH	主机架构（如 lx-amd64）	离线节点显示 -
NCPU	CPU数量	离线节点显示 -
NSOC	Socket数量	离线节点显示 -（使用 -ncb 隐藏）
NCOR	每个Socket的核心数	离线节点显示 -（使用 -ncb 隐藏）
NTHR	每个核心的线程数	离线节点显示 -（使用 -ncb 隐藏）
LOAD	平均负载	保留2位小数，离线节点显示 -
MEMTOT	总内存	带单位（G/M），离线节点显示 -
MEMUSE	已用内存	带单位（G/M），离线节点显示 -
SWAPTO	总交换空间	不带单位，离线节点显示 -
SWAPUS	已用交换空间	不带单位，离线节点显示 -

-F 选项的资源属性

支持以下25个资源属性，资源前缀为 hl: (host level)：

资源名称	描述	格式说明	主要差异
arch	主机架构	字符串	无
num_proc	CPU数量	浮点数（6位小数）	无
mem_total	总内存	带单位 G	无
swap_total	总交换空间	无单位	无
virtual_total	虚拟内存总量（mem + swap）	带单位 G	无
m_topology	CPU拓扑字符串	字符串	dummy值 "NONE"
m_socket	Socket数量	浮点数（6位小数）	无
m_core	核心数	浮点数（6位小数）	无
m_thread	线程数	浮点数（6位小数）	无
load_avg	平均负载	浮点数（6位小数）	无
load_short	短期负载（15s）	浮点数（6位小数）	从fsched r15s获取
load_medium	中期负载（1m）	浮点数（6位小数）	从fsched r1m获取
load_long	长期负载（15m）	浮点数（6位小数）	从fsched r15m获取
mem_free	可用内存	带单位 G	无
swap_free	可用交换空间	无单位	无
virtual_free	可用虚拟内存	带单位 G	无
mem_used	已用内存	带单位 G	无
swap_used	已用交换空间	无单位	无
virtual_used	已用虚拟内存	带单位 G	无
cpu	CPU使用率百分比	浮点数（6位小数）	从load/ncpu计算得出
m_topology_inuse	正在使用的CPU拓扑	字符串	dummy值 "NONE"
np_load_avg	归一化平均负载	浮点数（6位小数）	计算值：load/ncpu
np_load_short	归一化短期负载	浮点数（6位小数）	计算值：r15s/ncpu
np_load_medium	归一化中期负载	浮点数（6位小数）	计算值：r1m/ncpu
np_load_long	归一化长期负载	浮点数（6位小数）	计算值：r15m/ncpu

-j 选项的输出项

显示主机上运行的作业，在主机行下方添加作业列表：

输出项	功能描述	主要差异
job-ID	作业ID	无
prior	作业优先级（0-1）	无
name	作业名称	无
user	作业所属用户	无
state	作业状态	仅显示运行中的作业（r）
submit/start at	提交/开始时间	格式化显示
queue	队列@主机	格式：队列名@节点名
master	Master/Slave标识	dummy值 "MASTER"
ja-task-ID	数组作业任务ID	非数组作业为空

-q 选项的输出项

显示主机上的队列实例，在主机行下方添加队列列表：

输出项	功能描述	主要差异
queuename	队列名称	无
qtype	队列类型	dummy值 "BIP"
used/reserved/total	已用/保留/总槽位数	reserved 为dummy值 0
states	队列状态码	从节点状态映射

队列状态码说明：

• (空) - 正常
• a - alarm（节点DOWN/DRAIN/FAIL）
• u - unavailable（节点不可用）
• d - disabled（节点DRAIN）
• E - error（节点错误状态）

---

使用示例

示例1：查看所有主机的基本信息

qhost

输出示例：

HOSTNAME                ARCH         NCPU NSOC NCOR NTHR  LOAD  MEMTOT  MEMUSE  SWAPTO  SWAPUS
----------------------------------------------------------------------------------------------
global                  -               -    -    -    -     -       -       -       -       -
node01                  lx-amd64       16    2    8    1  2.35   31.3G   12.5G   8192    1024
node02                  lx-amd64       32    2   16    1  4.20   62.5G   28.3G  16384    2048

示例2：显示指定主机的资源属性

qhost -h node01 -F mem_total,num_proc,load_avg

输出示例：

HOSTNAME                ARCH         NCPU NSOC NCOR NTHR  LOAD  MEMTOT  MEMUSE  SWAPTO  SWAPUS
----------------------------------------------------------------------------------------------
global                  -               -    -    -    -     -       -       -       -       -
node01                  lx-amd64       16    2    8    1  2.35   31.3G   12.5G   8192    1024
  hl:mem_total=31.300000G
  hl:num_proc=16.000000
  hl:load_avg=2.350000

示例3：查看主机上运行的作业

qhost -j

输出示例：

HOSTNAME                ARCH         NCPU NSOC NCOR NTHR  LOAD  MEMTOT  MEMUSE  SWAPTO  SWAPUS
----------------------------------------------------------------------------------------------
global                  -               -    -    -    -     -       -       -       -       -
node01                  lx-amd64       16    2    8    1  2.35   31.3G   12.5G   8192    1024
  12345  0.50 test_job  alice  r  01/15/2024 10:30:00  compute@node01  MASTER
  12346  0.45 analysis  bob    r  01/15/2024 11:00:00  compute@node01  MASTER

示例4：按资源过滤主机

qhost -l arch=lx-amd64,num_proc=16

效果：仅显示架构为 lx-amd64 且CPU数量为16的主机。

示例5：查看队列实例信息

qhost -q

输出示例：

HOSTNAME                ARCH         NCPU NSOC NCOR NTHR  LOAD  MEMTOT  MEMUSE  SWAPTO  SWAPUS
----------------------------------------------------------------------------------------------
global                  -               -    -    -    -     -       -       -       -       -
node01                  lx-amd64       16    2    8    1  2.35   31.3G   12.5G   8192    1024
  compute      BIP   4/0/16

示例6：抑制核心绑定列

qhost -ncb

输出示例：

HOSTNAME                ARCH         NCPU  LOAD  MEMTOT  MEMUSE  SWAPTO  SWAPUS
----------------------------------------------------------------------------------
global                  -               -     -       -       -       -       -
node01                  lx-amd64       16  2.35   31.3G   12.5G   8192    1024

示例7：过滤特定用户的作业主机

qhost -u alice -j

效果：仅显示有alice用户作业运行的主机，并显示作业信息。

示例8：使用通配符过滤主机

qhost -h "node*"

效果：显示所有以 node 开头的主机。

示例9：XML格式输出

qhost -xml

效果：以XML格式输出主机信息，便于程序解析。