效能監視

pm-job observable-classes

顯示所有目前可觀察的物件類別清單，以便建立效能監視工作。

pm-job observable-objects [class= objectC lass] [domain=objectDomain]

顯示所有目前可觀察的物件清單，以便建立效能監視工作。預設會列出所有可觀察類別的所有物件和各個網域中的所有物件。物件清單會按照類別名稱排序。

class=objectClass

指定選擇性 objectClass 會將輸出限制於該指定類別的可觀察物件。objectClass 必須是 pm-job observable-classes 子指令所列出的其中一個類別。

domain=objectDomain

指定選擇性 objectDomain 會將輸出限制於該網域的可觀察物件。物件的網域是物件名稱中冒號 (「:」) 字元之前的字串。

pm-job observable-attributes class=objectClass

顯示指定 objectClass 中所有可觀察屬性的清單。屬性會與名稱和類型一併顯示。objectClass 必須是可支援效能監視工作類別的其中一個，如 pm-job observable-classes 子指令所列。

pm-job list

顯示目前所有已定義效能監視工作的清單。會針對各個具有已定義效能工作的物件列出工作，並且物件會按照類別名稱排序。針對各個工作顯示的資訊與 pm-job info 子指令顯示的資訊相同。

安全性：對於不是啟動 Common Agent Container 的使用者，則不會顯示任何工作。

pm-job info jobName

顯示名稱為 jobName 的效能監視工作詳細資訊。jobName 必須是 pm-job list 子指令顯示的項目。此子指令會顯示下列資訊：

• 效能監視工作的名稱。

• 「按照物件」或「按照類別」的效能監視工作類型。按照物件進行的工作會監視一個或多個已命名物件實例，而按照類別進行的工作會監視物件類別的各個實例。請注意，無法使用 mfwkadm 公用程式建立按照類別進行的工作。

• 效能監視工作的狀態：使用中已啟動、使用中未啟動或已暫停。使用中已啟動的工作目前已排程執行，並且正在收集資料。使用中未啟動的工作正在執行，但是由於目前時間不在工作排程之內，因此未收集資料。已暫停的工作未執行，並且未收集任何資料。使用 pm-job suspend 和 pm-job resume 子指令可變更效能監視工作的執行狀態。

• 效能監視工作的顆粒性 (以秒為單位)。這是此工作的資料收集時間間隔。

• 監視工作的報告週期。報告週期與顆粒性相乘等於通知頻率。例如，如果顆粒性週期是 10 秒，而報告週期為 6，按照事件進行的工作報告會每 10 秒收集一次資料，並且每 60 秒 (10*6) 傳送一次包含 6 份報告的通知。如果工作也按照檔案進行報告，則會每 60 秒傳送一次包含 6 個已產生檔案所在位置的事件。

• 效能監視工作是否按照事件進行報告。這表示，效能監視工作的結果會傳送至已註冊的用戶端做為通知。

• 效能監視工作是否按照檔案進行報告。這表示，效能監視工作的報告會寫入至本機檔案，而包含檔案名稱的通知會傳送至已註冊的用戶端。

• 效能監視工作的報告格式皆為 XML。

• 效能監視工作的排程。排程會指定工作在什麼日期和時間，處於使用中已啟動或使用中未啟動狀態 (分別表示是否收集資料)。

對於按照物件進行的工作：

• 所觀察物件的清單，按照名稱排序。

• 如果只指定部分可觀察的屬性，則受觀察物件的受觀察屬性會按照名稱和類型列出。

對於按照類別進行的工作：

• 所觀察類別的清單，按照名稱排序。

• 如果只指定部分可觀察的屬性，則受觀察類別的受觀察屬性會按照名稱和類型列出。這些屬性是所有類別共用的屬性。

安全性：對於不是啟動 Common Agent Container 的使用者，不會顯示任何資訊。

pm-job create jobName granularity= integerValue object=objectName [object= objectName ...]

在一或多個物件上建立新的效能監視工作。mfwkadm 指令無法建立按照類別進行的工作。建立效能監視工作時，可設定下列參數：

jobName

唯一識別效能監視工作的字串。任何其他效能監視工作都不可使用 jobName。

granularity=integerValue

當工作處於使用中已啟動狀態時，連續兩次收集測量資料啟動之間的指定時間 (以秒為單位)。例如，顆粒性週期可以是 300 秒 (5 分鐘)、900 秒 (15 分鐘)、1800 秒 (每半小時)、3600 秒 (每小時)。在大多數狀況下，300 秒的顆粒性週期已足夠。對於某些測量而言，以較大顆粒性週期收集資料可能更有意義。

object=objectName [object= objectName ...]

指一個或多個可觀察物件，讓效能監視工作向此物件收集資料並提出報告。objectName 必須是 pm-job list 或 pm-job observable-objects 子指令顯示的項目。指定多個 object= objectName 參數會建立一個監視多個物件的效能監視工作。

安全性：此子指令只能由啟動 Common Agent Container 的使用者執行。

pm-job delete jobName

刪除名稱為 jobName 的效能監視工作。jobName 必須是 pm-job list 子指令顯示的項目。

安全性：此子指令只能由啟動 Common Agent Container 的使用者執行。

pm-job suspend jobName

暫停名稱為 jobName 的效能監視工作。已暫停的工作不會處於使用中狀態，並且不論排程為何，都不再收集資料。然而，工作將維持已定義狀態，並且能夠以 pm-job resume 子指令再次設定為使用中。jobName 必須是由 pm-job list 子指令顯示的項目。

安全性：此子指令只能由啟動 Common Agent Container 的使用者執行。

pm-job resume jobName

繼續名稱為 jobName 的效能監視工作。已繼續的工作會根據排程開始收集資料，並傳送報告。jobName 必須是其中一個由 pm-job list 子指令顯示的項目。這與 pm-job suspend 子指令相對應。

安全性：此子指令只能由啟動 Common Agent Container 的使用者執行。