Personalized Service Health 概念

本文說明 Personalized Service Health (PSH) 的重要概念和術語。瞭解這些概念有助於您有效解讀事件及設定快訊。

Personalized Service Health 事件

Service Health 事件(v1、v1beta) 是指任何會影響與您專案或資源相關 Google Cloud 產品的中斷事件。例如網路中斷、設定錯誤和效能問題。

每個事件都包含事件整體影響的詳細資料、Google 的最新消息,以及 Google Cloud 專案的特定資訊。

事件

「事件」是指與專案相關的新興和進行中 Google Cloud 服務中斷或降級。事件也是 Service Health 事件的一種類別。

事件包含下列項目:

  • 事件影響:事件範圍的詳細資料,例如受影響的Google Cloud 產品和位置。
  • Google Cloud的最新消息:Google Cloud 支援團隊會定期提供最新消息。
  • 個人化關聯性:事件與 Google Cloud專案的關聯性。
  • 症狀、解決方法和預計完成時間:協助評估影響、套用解決方法或進一步瞭解根本原因的資訊。

事件可能會有事件報告,其中包含導致事件的因素,以及 Google Cloud 計畫採取的步驟,以防止類似事件再次發生。符合下列條件的事件會提供事件報告:

  • 事件造成全球性影響,或影響一或多個區域中相當高比例的客戶專案。
  • 一或多項產品無法使用或效能嚴重降低。

事件狀態和詳細狀態

事件有兩個欄位,用於表示其狀態。這些欄位的值會隨著事件發展而變化。

  • 事件狀態:指出事件的整體狀態。可以是下列任一值:

    • Active:事件目前影響 Google Cloud ,且會持續收到更新。
    • 已關閉:事件不再影響任何 Google Cloud 產品,或已與其他事件合併。
  • 詳細狀態:提供更多事件狀態資訊。這項屬性僅適用於事件,且可能為下列其中一個值 (視事件狀態而定):

    • 新興:Google 工程師正在積極調查事件,以判斷影響。影響評估完成後,新興事件會變成已確認或已解決事件。進行中的事件可能是新發生的事件。

      新興事件支援僅適用於 Google Cloud網路產品。

    • 已確認:Google 工程師已確認事件,且至少有一個 Google Cloud 產品受到影響。我們會持續提供狀態更新,直到問題解決為止。

      作用中事件可能是已確認事件。

    • 已合併:事件已併入父項事件。日後所有更新都只會發布至父項。

    • 已解決:採取行動後,事件不再影響任何 Google Cloud產品。不會再有更新。

      已結案的事件通常代表已解決。

    • 偽陽性:經過調查,Google 工程師判定事件並未影響 Google Cloud 產品。如果再次審查事件,這個狀態可能會變更。

    • 自動關閉:事件因下列原因自動關閉:

      • 無法確認事件影響。
      • 事件時有時無,或已自行解決。

      由於未採取任何行動或調查,因此事件沒有解決方案。如果問題時有時無,事件可能會重新開啟。

精細中斷狀態

在多產品或多位置事件期間,個別產品或位置可能會在整體事件解決前恢復。Personalized Service Health 會依產品和位置提供精細的中斷狀態,反映事件發生期間的部分復原情況。專案層級和組織層級事件皆可查看精細的中斷狀態。

產品或位置可能會有下列其中一種精細中斷狀態:

  • 受影響:產品或位置因事件而中斷。
  • 已解決:特定產品或位置不再發生中斷情形,且已恢復正常。

事件狀態和精細狀態的差異

請務必區分整體事件狀態、詳細狀態,以及個別產品或位置的精細中斷狀態:

  • 整體事件狀態和詳細狀態:適用於整個事件。只要至少有一項產品或一個位置仍處於「受影響」狀態,事件就會維持「作用中」狀態 (詳細狀態為「已確認」等)。只有在所有相關產品和位置都達到「已解決」狀態後,事件才會轉換為「已結案」(詳細狀態為「已解決」)。
  • 精細中斷狀態:獨立套用至每個受影響的產品或位置。個別產品或地點可以轉換為「已解決」,而整體事件狀態仍為「進行中」。

事件「合併」至父項事件後,子事件的精細中斷狀態會清除,並將精細狀態委派給父項事件,做為單一事實來源。

關聯性

Personalized Service Health 會評估所有事件對專案的影響。如果事件可能或確定會影響您的專案,就會顯示在 Service Health 資訊主頁和 API 中。

「關聯性」指出專案是否受到事件影響、與事件相關,或與事件部分相關。對於預先發布版支援的產品,關聯性也會指出專案中受影響的特定資源。

關聯性可能的值如下:

  • 受影響:已確認事件會影響您的專案。如果是支援的產品 (預先發布版),您也可以查看專案中哪些特定資源受到影響。
  • 相關:事件與專案有直接關聯,並會影響專案所用位置中的 Google Cloud 產品。
  • 部分相關:事件與專案使用的 Google Cloud產品有關聯,但應該不會對專案造成影響。舉例來說,事件可能會影響專案使用的 Google Cloud產品,但不涵蓋專案使用的位置。
  • 未受影響:事件不會影響您的專案。
  • 不明:目前無法得知對專案的影響。

受影響的資源

如果事件與專案的關聯性為IMPACTED,Personalized Service Health 可找出專案中受中斷影響的特定 Google Cloud 資源,例如特定 Cloud SQL 執行個體或 Google Kubernetes Engine 叢集。

在 Service Health v1beta API 中,每個受影響的資源都會以 Impact 資源 (projects/{PROJECT_ID}/locations/global/impacts/{IMPACT_ID}) 表示。Impact 資源包含:

  • 連結的事件 (events):一或多個與資源影響相關聯的專案層級 Service Health Event 資源名稱 (projects/{PROJECT_ID}/locations/global/events/{EVENT_ID})。
  • 受影響的素材資源 (asset):
    • assetName:受影響Google Cloud 資源的完整資源名稱 (例如 //cloudsql.googleapis.com/projects/123456789/instances/my-db-instance)。
    • assetType:受影響資源的 Cloud Asset Inventory 資源類型 (例如 sqladmin.googleapis.com/Instance 或 container.googleapis.com/Cluster)。
  • 說明 (description):有關資源影響的其他背景資訊 (如有)。
  • 時間戳記 (createTime、updateTime):資源影響記錄首次建立和上次更新的時間。

在預先發布版中使用受影響的資源時,請注意下列行為:

  • 專案影響與組織影響:
    • 影響 (projects.locations.impacts) 的範圍限於單一專案,且只有在事件確認與該專案有 IMPACTED 關聯,且產品支援可用時,才會傳回非容器資源。
    • 組織影響 (organizations.locations.organizationImpacts) 會匯總整個組織,傳回相關性不為零 (PARTIALLY_RELATED、RELATED 或 IMPACTED) 的容器資產 (專案),其中相關性不為零是指可能受 OrganizationEvent 影響的任何專案。
  • API 啟用必要條件:如要接收 Impact 記錄,必須在事件開始前至少 24 小時,在專案啟用 Service Health API (servicehealth.googleapis.com)。如果在事件開始後啟用 API,系統會回填過去 90 天內的專案層級事件,但不會回填資源層級影響。
  • 事件持續時間生命週期:一旦資源被判定為受事件影響,其 Impact 記錄在事件生命週期內會與事件保持關聯。使用連結的 Event 資源,追蹤整體事件狀態 (ACTIVE 或 COMPLETED) 和通訊更新。
  • 支援的產品和事件範圍:資源層級影響適用於支援的 Google Cloud 產品和資源類型。如果事件影響的產品不支援資源層級影響,或者中斷發生在控制層或區域層級,與個別資源執行個體無關,則專案 Event 仍會顯示 relevance: IMPACTED,而 impacts.list 會傳回空白清單。

如要查詢受影響的資源,請參閱「管理影響專案的事件」。

產品識別名稱和顯示名稱 (僅限 Alpha 和 Beta 版)

為了讓管理員快速找出作業,而不必在本機對應產品 ID,v1alpha 和 v1beta 版本中的事件項目會在參照的資源中提供顯示字串。

具體來說,在標準酬載上指定的 Product 物件 (位於 Event 和 OrganizationEvent 的 impact 集合中) 內,有兩個新屬性可協助識別:

  • display_name (字串):OUTPUT_ONLY 標記,用於顯示適合顧客閱讀的人類可讀產品名稱 (例如 "Google Cloud SQL")。
  • previous_display_names (重複字串):OUTPUT_ONLY 陣列,詳細列出這項特定資源先前支援的所有職稱。這樣一來,即使品牌重塑,也能持續追蹤事件。

為確保系統穩定,vGA (v1) 介面會延遲顯示產品欄位。

如要判斷篩選器和警告中使用的不可變 ID 是否正確,請按照下列步驟操作:

  1. 開啟「支援的產品和地區」指南。
  2. 在表格中找出目標 Google Cloud 產品。
  3. 複製「產品 ID」下方列出的值。

或者,直接從 API 酬載判斷正確的不變 ID:

  1. 發出 API 呼叫,傳回事件資源 (例如 projects.locations.events.list)。
  2. 檢查產生的 JSON 陣列中的 impact 區塊對應。
  3. 擷取 product 屬性中的字串。這個值代表穩定的產品 ID,不受顯示名稱變動影響。