子指令 (Sun Java Enterprise System 5 監視指南)

Sun Java Enterprise System 5 監視指南

子指令

start

啟動 Monitoring Framework 節點代理程式和關聯的元件產品模組，而不停止 Common Agent Container。

此動作會先部署節點代理程式，然後在 Common Agent Container 中部署關聯的元件產品模組。此設備是一種包裝程式，優先於 cacaoadm 公用程式的 lock 和 undeploy 子指令。

start 子指令只會啟動節點代理程式，以及與 Monitoring Framework 相關聯的 Java ES 元件模組。元件模組的前綴是 com.sun.cmm。

安全性：start 子指令只能由已啟動 Common Agent Container 的使用者執行。否則會出現類似下列的錯誤訊息：

Error occured in mfwkadm
Problem running /usr/sbin/cacaoadm unlock com.sun.mfwk 2>&1.
Stdout/Stderr: This command must be run by user: [root].

stop

停止 Common Agent Container 中的 Monitoring Framework 節點代理程式及其關聯的 Java ES 元件模組。

此動作會先停止在 Common Agent Container 中部署的所有 Java ES 元件模組，然後停止節點代理程式。此設備是一種包裝程式，優先於 cacaoadm 公用程式的 lock 和 unlock 子指令。

stop 子指令只會先停止與 Monitoring Framework 相關聯的 Java ES 元件模組，再停止節點代理程式自身。元件模組的前綴是 com.sun.cmm。

安全性：stop 子指令只能由已啟動 Common Agent Container 的使用者執行。否則會出現類似下列的錯誤訊息：

在 mfwkadm 中發生錯誤
執行 /usr/sbin/cacaoadm unlock com.sun.mfwk 2>&1 時發生問題。
Stdout/Stderr：這個指令必須由使用者 [root] 執行。

restart

重新啟動 Common Agent Container 中的 Monitoring Framework 節點代理程式及其相關聯的 Java ES 元件模組。

此動作會嘗試停止然後重新啟動 Common Agent Container 中的節點代理程式及其相關聯的模組，方式與 stop 和 start 子指令相同。

安全性：restart 子指令只能由已啟動 Common Agent Container 的使用者執行。否則會出現類似下列的錯誤訊息：

Error occured in mfwkadm
Problem running //usr/sbin/cacaoadm unlock com.sun.mfwk 2>&1.
Stdout/Stderr: This command must be run by user: [root].

list-params

列出與 Monitoring Framework 節點代理程式相關聯的所有配置參數。

安全性：此指令沒有任何使用者限制。

list-modules

顯示實作 Common Monitoring Model (CMM) 且載入至 Common Agent Container 的元件產品模組清單。此子指令也會列出各個已安裝 Java ES 元件的所有執行中實例。各個元件可以有 0、1 或多個執行中實例。

安全性：對於不是啟動 Common Agent Container 的使用者，已安裝 Java ES 元件的清單不會包含元件實例。

info runningInstance

顯示關於已命名 runningInstance 的資訊。runningInstance 必須符合 list-modules 子指令輸出所列的執行中實例。

顯示的資訊包括：

對於各種類型的監視工作，會按照類別名稱順序顯示所有與執行中實例相關聯的可觀察物件。可觀察物件是可分別使用 pm-job、opstat-job 或 thrsh-job 子指令建立效能監視工作、作業狀態工作或臨界值監視工作的物件。
對於各個類別的可觀察物件，會顯示所有可觀察屬性，包括各個屬性的名稱和類型。

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

效能監視

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 的使用者執行。

作業狀態監視

opstat-job observable-classes

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

opstat-job observable-objects [class= objectClass] [domain=objectDomain]

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

class=objectClass: 指定選擇性 objectClass 會將輸出限制於該指定類別的可觀察物件。objectClass 必須是 opstat-job observable-classes 子指令所列出的其中一個類別。
domain=objectDomain: 指定選擇性 objectDomain 會將輸出限制於該網域的可觀察物件。物件的網域是物件名稱中冒號 (「:」) 字元之前的字串。

opstat-job observable-attributes class= objectClass

顯示指定 objectClass 中所有可觀察屬性的清單。屬性會與名稱和類型一併顯示。objectClass 必須是 opstat-job observable-classes 子指令所列出的其中一個類別。

opstat-job list

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

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

opstat-job info jobName

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

作業狀態監視工作的名稱。
「按照物件」或「按照類別」的作業狀態監視工作類型。按照物件進行的工作會監視已命名物件實例，而按照類別進行的工作會監視物件類別的各個實例。請注意，無法使用 mfwkadm 公用程式建立按照類別進行的工作。
作業狀態監視工作的狀態。使用中已啟動、使用中未啟動或已暫停。使用中已啟動的工作目前已排程執行，並且正在收集資料。使用中未啟動的工作正在執行，但是由於目前時間不在工作排程之內，因此未收集資料。已暫停的工作未執行，並且未收集任何資料。使用 opstat-job suspend 和 opstat-job resume 子指令可變更作業狀態監視工作的執行狀態。
作業狀態監視工作的顆粒性 (以秒為單位)。這是此工作的資料收集時間間隔。
作業狀態監視工作是否按照事件進行報告。這表示，作業狀態監視工作的結果會傳送至已註冊的用戶端做為通知。
作業狀態監視工作是否按照檔案進行報告。這表示，作業狀態監視工作的報告會寫入至本機檔案，而包含檔案名稱的通知會傳送至已註冊的用戶端。
作業狀態監視工作的報告格式皆為 XML。
作業狀態監視工作的排程。排程會指定工作在什麼日期和時間，處於使用中已啟動或使用中未啟動狀態 (分別表示是否收集資料)。
對於按照物件進行的工作，則是按照名稱排序的受觀察物件清單。
對於按照類別進行的工作，則是按照名稱排序的受觀察物件清單。

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

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

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

jobName: 唯一識別作業狀態監視工作的字串。任何其他作業狀態監視工作都不可使用 jobName。
granularity=integerValue: 當工作處於使用中已啟動狀態時，兩次連續收集測量資料啟動之間的指定時間 (以秒為單位)。
object=objectName [object= objectName ...]: 指一個或多個可觀察物件，讓作業狀態監視工作向此物件收集資料並提出報告。objectName 必須是 opstat-job list 或 opstat-job observable-objects 子指令顯示的項目。指定多個 object= objectName 參數會建立一個監視多個物件的作業狀態工作。

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

opstat-job delete jobName

刪除名稱為 jobName 的作業狀態監視工作。jobName 必須是 opstat-job list 子指令顯示的項目。

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

opstat-job suspend jobName

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

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

opstat-job resume jobName

繼續名稱為 jobName 的作業狀態監視工作。已繼續的工作會根據排程收集資料，並傳送報告。jobName 必須是 opstat-job list 子指令顯示的項目。這與 opstat-job suspend 子指令相對應。

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

臨界值監視

thrsh-job observable-classes

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

thrsh-job observable-objects [class= objectClass] [domain=objectDomain]

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

class=objectClass: 指定選擇性 objectClass 會將輸出限制於該指定類別的可觀察物件。objectClass 必須是 thrsh-job observable-classes 子指令所列出的其中一個類別。
domain=objectDomain: 指定選擇性 objectDomain 會將輸出限制於該網域的可觀察物件。物件的網域是物件名稱中冒號 (「:」) 字元之前的字串。

thrsh-job observable-attributes class=objectClass

顯示指定 objectClass 中所有可觀察屬性的清單。屬性會與名稱和類型一併顯示。objectClass 必須是 thrsh-job observable-classes 子指令所列出的其中一個類別。

thrsh-job list

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

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

thrsh-job info jobName

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

臨界值監視工作的名稱。
臨界值監視工作的多重性。在此發行版本中，只可使用在一個物件上監視一個屬性的簡單臨界值工作。
臨界值監視工作的狀態：使用中已啟動、使用中未啟動或已暫停。使用中已啟動的工作目前已排程執行，並且正在收集資料。使用中未啟動的工作正在執行，但是由於目前時間不在工作排程之內，因此未收集資料。已暫停的工作未執行，並且未收集任何資料。使用 thrsh-job suspend 和 thrsh-job resume 子指令可變更臨界值監視工作的執行狀態。
臨界值監視工作的顆粒性 (以秒為單位)。這是此工作的資料收集時間間隔。
臨界值監視工作的排程。排程會指定工作在什麼日期和時間，處於使用中已啟動或使用中未啟動狀態 (分別表示是否收集資料)。
臨界值監視工作的警示配置。當受監視屬性的受觀察值超過定義的臨界值時，會觸發此警示。其中會顯示警視的類型和嚴重性。
臨界值監視工作的受觀察物件。
套用臨界值的屬性名稱。
會觸發警示的臨界值。
會在臨界值觸發警示的值進度方向，RISING 或 FALLING。
臨界值的偏差偏移。方向是 RISING 時，在受觀察屬性小於 thresholdValue-offsetValue 之前，都不會再次觸發警示。方向是 FALLING 時，在受觀察屬性大於 thresholdValue+offsetValue 之前，都不會再次觸發警示。即使偏移為零，運作方式仍會是如此。

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

thrsh-job create jobName object= objectName granularity=integerValue attributeName= attributeName attributeType=attributeType thresholdValue= thresholdValue thresholdOffset=offsetValue thresholdDirection= [RISING|FALLING]

建立新的臨界值監視工作，監視單一物件的一個屬性。建立臨界值工作時，可設定下列參數：

jobName: 唯一識別臨界值監視工作的字串。任何其他臨界值監視工作都不可使用 jobName。
object=objectName: 臨界值監視工作會收集屬性值以比對臨界值的可觀察物件。objectName 必須是 thrsh-job list 或 thrsh-job observable-objects 子指令顯示的項目。
granularity=integerValue: 當工作處於使用中已啟動狀態時，連續兩次觀察屬性值啟動之間的指定時間 (以秒為單位)。
attributeName=attributeName: 指屬性名稱，讓臨界值監視工作向此屬性收集值並且與臨界值比對。attributeName 必須由 thrsh-job info 或 thrsh-job observable-attributes 子指令列出。
attributeType=attributeType: 所需監視的可觀察屬性類型。attributeType 必須由 thrsh-job info 或 thrsh-job observable-attributes 子指令列出。
thresholdValue=thresholdValue: 以 thresholdDirection 中指定的方向越過時，會讓此臨界值工作觸發警示的受監視屬性值。
thresholdOffset=offsetValue: offsetValue 會判斷觸發連續警示的臨界值工作偏差。offsetValue 必須為零或正值。在觸發警示事件之後，將不會觸發新的警示事件，直到受監視屬性的值超過 offsetValue 和 thresholdDirection 定義的範圍。
thresholdDirection=[RISING|FALLING]: 方向為 RISING 時，在受觀察屬性值小於 thresholdValue-offsetValue 之前，都不會再次觸發警示事件。方向為 FALLING 時，在受觀察屬性值大於 thresholdValue+offsetValue 之前，都不會再次觸發警示事件。即使 offsetValue 為零，運作方式仍會是如此。

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

thrsh-job delete jobName

刪除名稱為 jobName 的臨界值監視工作。jobName 必須是 thrsh-job list 子指令顯示的項目。

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

thrsh-job suspend jobName

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

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

thrsh-job resume jobName

繼續名稱為 jobName 的臨界值監視工作。已繼續的工作會根據排程收集資料，並傳送報告。jobName 必須是 thrsh-job list 子指令顯示的項目。這與 thrsh-job suspend 子指令相對應。

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