lsload

說明

載入資訊可以按主機或按資源顯示。

依預設，會顯示本端叢集中所有主機的負載資訊。

啟用 IBM® Spectrum LSF 多叢集功能 之後， lsload 指令也會顯示對等叢集中所有主機的負載資訊。

依預設，會顯示原始負載指標。

依預設，會根據 CPU 和分頁負載來顯示資源的負載資訊。

選項

-a

僅限動態叢集。 顯示所有主機的相關資訊，包括使用 jobvm 資源配置的「動態叢集」虛擬機器主機。 預設輸出僅包括配置有 dchost 資源的標準 LSF 主機及動態叢集主機。

-cname

在 LSF Advanced Edition中，包括輸出中執行叢集主機及主機群組的叢集名稱。

附註: 此指令選項已淘汰，且可能會在未來版本的 LSF中移除。

-gpu

顯示主機型 GPU 資訊。

-gpuload

顯示 GPU 型資訊。

-json

以 JSON 格式顯示自訂輸出。

以 -o 選項指定時，會以 JSON 格式顯示自訂輸出。

此選項應該與 -o 選項搭配使用。 如果此選項未與 -o 選項搭配使用，則必須定義 lsf.conf 檔案中的 LSF_LSLOAD_FORMAT 參數或 LSF_LSLOAD_FORMAT 環境變數。

-l

長格式。 顯示載入資訊，不截斷以及 I/O 及外部載入索引的額外欄位。

此選項會置換以 -I 選項指定的索引名稱。

此選項不會顯示 GPU 資源的相關資訊 (亦即，此選項不會顯示gpu_<num>n資源)。 使用 -gpu 選項來檢視主機型 GPU 資訊，或使用 -gpuload 選項來檢視 GPU 型資訊。

-N

顯示正規化 CPU 執行佇列長度載入索引。

-E

顯示有效 CPU 執行佇列長度負載指標。 選項 -N 與 -E 互斥。

-w

以寬格式顯示載入資訊。 顯示欄位時不會截斷。

-I load_index[:load_index] ...

只顯示指定的載入索引。 以冒號區隔多個索引名稱 (例如，r1m:pg:ut).

指定任何內建載入索引。 僅針對數字和動態的主機型資源指定外部負載指標 (您無法針對共用、字串或布林資源指定外部負載指標)。

-n num_hosts

只顯示所要求主機數目的負載資訊。 最多會顯示最符合資源需求的 num_hosts 主機的資訊。

-o

設定自訂輸出格式。

• 指定要顯示的 lsload 欄位、順序及寬度。
• 在欄位名稱中指定星號萬用字元 (*) ，以指定多個外部資源名稱。 您只能指定一個星號，但此星號可位於欄位名稱中的任何位置。

  例如，執行 lsload -o "gpu_mode*" 會顯示下列欄位:gpu_mode0,gpu_mode1,gpu_mode2,gpu_model0,gpu_model1，以及gpu_model2.

• 僅指定 lsload 欄位名稱，以將其輸出設為無限制寬度及向左對齊。
• 指定不含寬度的寬度冒號 (:) ，以將輸出寬度設定為該欄位的建議寬度。
• 指定寬度為冒號 (:) 的寬度，以設定要針對欄位顯示的字元數上限。 當其值超出此寬度時， lsload 會截斷結束字元。
• 當 lsload 顯示特定欄位的輸出時，請指定連字號 (-) 以設定向右對齊。 如果未指定，當 lsload 顯示欄位的輸出時，預設值是設定左對齊。
• 指定單位冒號 (:) ，並以單位來設定特定欄位輸出的單位:
  • 指定 S 以使用空間或容量的內建轉換，例如記憶體或磁碟空間。 會自動調整 M (MB)、G (GB) 及 T (TB) 的值，其中預設單位是 M (MB)。
    例如，當顯示指定寬度為 3 的 mem 欄位時，

    • 若值為 30 ，則執行 lsload -o "mem:3:S" 指令會顯示30.0M.
    • 若值為 4096 ，執行 lsload -o "mem:3:S" 指令會顯示4.0G.
    • 若值為 5000000 ，執行 lsload -o "mem:3:S" 指令會顯示4.8T.
  • 指定 D 以使用持續時間或時間的內建轉換，例如記憶體或磁碟空間。 會自動調整 s (秒)、m (分鐘)、h (小時) 及 d (天) 的值，其中預設單位是 s (秒)。 自動調整的值會在第一個小數點之後四捨五入。
    例如，當顯示指定寬度為 5 的外部 mytime 資源欄位時，

    • 若值為 30 ，則執行 lsload -o "mytime:5:D" 指令會顯示30.0s.
    • 對於值 8000 ，執行 lsload -o "mytime:5:D" 指令會顯示2.2h.
    • 若值為 5000000 ，執行 lsload -o "mytime:5:D" 指令會顯示57.8d.
  • 指定 1-3 個字元的任何其他字串，並依現狀在欄位值中使用這些字元。 第一個字元必須是字母 (大寫或小寫)。 第二個和第三個字元必須是英數字元。

    例如，當顯示寬度為 3 的外部 gpu_temp 資源時，針對值 30 執行 lsload -o "gpu_temp:3:C" 指令會顯示30C

• 使用 delimiter= 來設定要在不同標頭和欄位之間顯示的定界字元。 此定界字元必須是單一字元。 依預設，定界字元是空格。

輸出自訂作業僅適用於特定 lsload 選項的輸出:

• LSF_LSLOAD_FORMAT 和 lsload -o 都適用於沒有選項的 lsload 指令的輸出，以及適用於具有簡短格式輸出且過濾資訊的 lsload 選項，包括下列選項: -a、 -E、 -cname、 -N、 -n、 -R。
• LSF_LSLOAD_FORMAT 及 lsload -o 不適用於使用已修改格式之 lsload 選項的輸出，包括下列選項: -I、 -l、 -w、 -s。

lsload -o 選項會置換 LSF_LSLOAD_FORMAT 環境變數，其會置換 lsf.conf中的 LSF_LSLOAD_FORMAT 設定。

依預設， lsload 指令會顯示內建資源索引。 您也可以指定外部資源的名稱。 下列是內建資源索引的欄位名稱，用來指定要顯示的 lsload 欄位、建議寬度，以及所顯示欄位的度量單位:

表 1. lsload 的輸出欄位

欄位名稱	寬度	單位
HOST_NAME	20 個
狀態	15 日
r15s	6
r1m	6
r15m	6
UT	6
PG	6
ls	6
it	6
IO	6
tmp	10	lsf.conf 中的 LSF_UNIT_FOR_LIMITS (依預設為 KB)
swp	10	lsf.conf 中的 LSF_UNIT_FOR_LIMITS (依預設為 KB)
mem	10	lsf.conf 中的 LSF_UNIT_FOR_LIMITS (依預設為 KB)
gpu_status * 例如，如果有兩個 GPU ，則為 gpu_status0 和 gpu_status1 。	10
gpu_error * 例如，如果有兩個 GPU ，則為 gpu_error0 和 gpu_error1 。	20 個

欄位名稱區分大小寫。 輸出寬度的有效值為任何正整數 1-4096。

例如，

lsload -o "HOST_NAME status: r15s:- r1m:7 r15m:-8 tmp:S swp::S mem:9:S delimiter='^'"

這個指令會顯示下列欄位:

• HOST_NAME 具有無限制寬度且靠左對齊。
• status ，寬度上限為 15 個字元 (建議寬度) 且向左對齊。
• r15s ，寬度上限為 6 個字元 (建議寬度) ，並向右對齊。
• r1m ，寬度上限為 7 個字元，並向左對齊。
• r15m ，寬度上限為 8 個字元，並向右對齊。
• tmp ，具有無限制寬度、靠左對齊及自動調整的空間或容量 (MB、GB 及 TB)。
• swp ，寬度上限為 10 個字元 (建議寬度) ，靠左對齊，並自動調整以取得空間或容量 (MB、GB 及 TB)
• mem ，最大寬度為 9 個字元，靠左對齊，並自動調整空間或容量 (MB、GB 及 TB)
• The^字元會顯示在不同的標頭和欄位之間。

-R res_req

只顯示滿足指定資源需求之主機的負載資訊。

主機的負載資訊會根據指定資源上的負載來排序。

如果 res_req 包含特殊資源名稱，則只會顯示提供這些資源之主機的載入資訊 (執行 lshosts 以找出每一部主機上可用的資源)。

如果指定一個以上主機名稱，則只會顯示滿足資源需求之主機的相關載入資訊。

使用 IBM Spectrum LSF 多叢集功能，當指定叢集名稱時，會顯示指定叢集中滿足資源需求之主機的負載資訊。

host_name ... | host_group ... | cluster_name ...

只顯示指定主機、主機群組或組合; 或叢集的負載資訊。

若要顯示主機群組資訊，必須在 lsf.conf 檔案中指定 LSF_HOSTGROUP_INFO=Y 設定。

使用 IBM Spectrum LSF 多叢集功能，只會顯示指定叢集中主機的負載資訊。

-s [resource_name ...] [-loc]

顯示叢集中配置的所有動態資源的相關資訊，或僅顯示指定資源的相關資訊。 指定動態資源 (共用或主機型)。

此選項不會顯示 GPU 資源的相關資訊 (亦即，此選項不會顯示gpu_<num>n資源)。 使用 -gpu 選項來檢視主機型 GPU 資訊，或使用 -gpuload 選項來檢視 GPU 型資訊。

如果 lsf.cluster.clustername 檔案中的 LOCATION 參數設為 all ，以指出叢集中的所有主機都共用資源，則LOCATIONlsload -s 指令輸出中的欄位也會顯示ALL. 若要在 lsload -s 指令輸出中顯示叢集中所有主機的個別名稱，請指定 -loc 選項及 -s 選項。

-h

將指令用法列印至 stderr 並結束。

-V

將 LSF 發行版本列印至 stderr 並結束。

預設主機型輸出

內建載入索引包括r15s,r1m,r15m,ut,pg,io,ls,it,swp,mem，以及tmp. 外部載入索引配置在 lsf.cluster.cluster_name檔案中。 資源需求的選取和排序區段會控制顯示哪些主機，以及資訊的排序方式。

具有 lsload -s 的資源型輸出

範例

下列指令顯示至少具有 20 MB 交換空間且 1 分鐘執行佇列長度小於 0.5的 ALPHA 主機負載。

lsload -R "select[r1m<=0.5 && swp>=20 && type==ALPHA]"

下列指令以受限格式指定相同的資源需求:

lsload -R r1m=0.5:swp=20:type=ALPHA

下列指令顯示交換空間使用率小於 75% 之主機的負載。 產生的主機依分頁率排序。

lsload -R "select[(1-swp/maxswp)<0.75] order[pg]"

下列指令會顯示叢集中所有主機的 1 分鐘 CPU 原始執行佇列長度、CPU 使用率、磁碟 I/O 及分頁率。

lsload -I r1m:ut:io:pg

下列指令會顯示所有主機的負載，依r15s:pg. CPU 執行佇列長度是有效執行佇列長度。

lsload -E

診斷程式

LSF 問題或無效資源名稱的結束狀態為 -10。

如果指定無效的選項，則結束狀態為 -1。

lsload 指令的正常結束狀態為 0。

另請參閱

lim, lsf.cluster, lsplace, lshosts, lsinfo, lslockhost, ls_load.