服務健全度檢查

檢查哪些資訊？

每個演算法都負責檢查一種健全度檢查條件。條件應定義為有效的健全度元件類型 (如 HEALTH_​COMP_​FLG 查尋中定義)。此演算法可以檢查許多記錄 (稱為「健全度元件」) 的條件，並傳回每個健全度元件的狀態與明細。例如，如果演算法正在檢查系統中批次程式的服務等級，則在此情況下批次控制即為健全度元件。演算法應該收集每個批次程式的服務等級結果，並將資訊集合傳回給呼叫程式。

外掛點的演算法應該傳回每個健全度元件的下列資訊。

• 健全度元件明細中應填入已檢查物件的特定資訊。例如，如果演算法正在檢查批次控制服務等級，則會有「批次控制」代碼。此外，若要允許顯示每個健全度元件類型的明細，則演算法應植入維護物件代碼、主索引鍵欄位與值明細，以及導覽選項。

• 健全度元件狀態標誌與健全度元件狀態描述中應植入適用於檢查條件的有效狀態代碼與描述。由於每個健全度元件類型可能具有自己的唯一狀態值，因此這項資訊會根據健全度元件類型而有所不同。

• 健全度元件狀態原因旨在提供健全度元件狀態值的支援資訊。例如，如果元件提供狀態的錯誤類型，則會有狀態原因。

• 健全度元件回應可用來將健全度元件的狀態值對應至查尋 HEALTH_​RESPONSE_​FLG 中定義的標準值。此值是 HTTP 回應代碼的子集。支援的值有所有檢查均成功 (200)、非關鍵功能的效能降低 (203)、無內容 (204) 和一或多項關鍵功能的效能降低 (500)。

• 系統會提供回應明細列表，供健全度元件檢查在健全度檢查的過程中檢查數個條件。每個條件都可以傳回自己的狀態。在此情況下，演算法應使用回應明細列表來記錄個別回應，並在整體「健全度元件狀態標誌」、「描述」及「原因」中植入摘要資訊。建議執行以下操作：

  • 根據個別回應的明細設定狀態標誌與回應。請參考下方批次的服務等級資訊，以取得此邏輯的範例。

  • 植入回應列表時，健全度檢查使用者介面會顯示整體的「狀態原因」文字，以及可展開明細的圖示。建議在此欄位中植入「請參閱詳細資料結果」之類的文字。

系統會提供演算法來檢查批次的服務等級健全度元件類型。此健全度元件類型會尋找所有至少設有一個服務等級演算法的批次控制，然後為每個批次控制叫用演算法。業務服務會為每個批次控制植入此健全度服務的輸出，方式如下：

• 健全度元件明細中會植入批次控制代碼與描述。此外，還提供能夠鑽探至批次控制的導覽資訊，並用來將資料欄建立為超文字。

• 植入狀態時，會根據批次控制具有一個還是多個演算法來植入。如果有一個演算法，則會傳回該演算法所傳回的「服務等級」查尋值。如果是多個演算法，系統就會根據來自每個演算法的詳細狀態值來判斷整體狀態。如果任一演算法傳回「錯誤」，便會傳回該值。如果任一演算法傳回「警告」，則會傳回該值。否則，會傳回「正常」。

• 植入狀態原因時，會根據批次控制具有一個還是多個演算法來植入。如果有一個演算法，則會傳回該演算法所傳回狀態原因的展開文字。如果有多個，則會傳回訊息類目/訊息編號 11002 / 22001 中的文字 (請參閱結果以取得明細)

• 植入回應時，會根據整體「服務等級」狀態的值來植入。當「服務等級」為正常或已停用時，它會設為全部檢查成功 (200)；當「服務等級」為警告時，會設為非關鍵功能的效能降低 (203)，而當「服務等級」為錯誤時，則會設為一或多項關鍵功能的效能降低 (500)。

如何呼叫演算法？

這些演算法是由產品 F1-HealthCheck 提供的業務服務所呼叫。

該服務會根據所有演算法傳回的全部明細來計算整體「健全度回應」值。上述 HEALTH_​RESPONSE_​FLG 的值代表使用的值。

另請注意，系統為 SOAP 和 REST 服務呼叫的這個業務服務提供內送 Web 服務，讓外部系統能夠使用 Web 服務來擷取此資訊。