PolarDB：查看並管理計劃內事件

注意事項

• 事件按緊急程度不同分為兩類：

  • 【S0緊急層級】風險修複：通常是非預期的需要儘快修複避免故障的情境，因此其通知可能會提前3天或更早且允許修改計劃切換時間的視窗更小，典型情境為緊急問題版本替換升級、宿主機異常修複、SSL認證到期升級等。

  • 【S1計劃層級】系統維護：通常是低風險問題修複或有計劃的軟硬體升級換代，通常提前3天以上發送通知且允許使用者取消事件。

• 為了確保您能接收營運事件的預約通知，您需要登入訊息中心，確保雲資料庫故障或營運通知的通知方式複選框處於選中狀態並設定訊息接收人（推薦設定為資料庫營運人員），否則您將無法收到事件通知資訊。通知方式為郵件、站內信，建議選中郵件，提高觸達成功率。

  

  圖1 訊息中心通知設定入口

  

  圖2 雲資料庫通知設定

• 如您需要第一時間獲知營運事件的動態或者希望通過事件驅動的方式做自訂營運自動化，您可以通過CloudMonitor平台配置系統事件訂閱。雲資料庫會對營運事件的生命週期（預約、開始、完成、取消等）推送CloudMonitor系統事件。具體操作，請參見管理事件訂閱（推薦），可訂閱的CloudMonitor事件參見附錄1 CloudMonitor相關係統事件。

  CloudMonitor事件格式樣本：

  {
    "eventId": "c864b30b-7f69-5f04-b0e7-8dfb0eabcfd9", // 事件ID，同一個事件的ID相同
    "product": "RDS",                                  // 產品代碼
    "reason": "Host software/hardware upgrade",        // 事件原因
    "extra": {
      "impactZh": "執行個體閃斷",                           // 事件影響
      "impactEn": "Transient instance disconnection",  // 事件影響
      "eventCode": "rds_apsaradb_transfer",            // 營運事件類型代碼
      "eventNameEn": "Instance migration",             // 營運事件名稱
      "eventNameZh": "執行個體遷移",                        // 營運事件名稱   
      "switchTime": "2024-09-15T01:30:00+08:00",       // 計劃切換時間，如果有切換即為執行個體串連閃斷的時間
      "startTime": "2024-09-14T21:30:00+08:00",          // 計劃開始時間，進入調度隊列等待執行
      "cancelCode": "OutOfGoodPerfBySoftHardwareUpgrade", // 取消風險碼，參見附錄2: 詳細原因碼和取消風險
      "detailCode": "HostSoftHardwareUpgrade",            // 詳細原因碼，參見附錄2: 詳細原因碼和取消風險
      "instanceInfo": ""
    },
    "instanceId": "rm-2ze9d66o65q1g02g6",             // 執行個體ID
    "eventType": "Maintenance",
    "instanceComment": "rm-2ze9d66o65q1g02g6",        // 執行個體別名
    "instanceType": "Instance",
    "publishTime": "2024-09-10T16:01:47+08:00"
  }

操作步驟

1. 登入各產品管理主控台。

2. 在左側導覽列單擊事件中心（原名：事件管理） > 計劃內事件，並在控制台上方選擇地區。

3. 在計劃內事件頁面，可查看事件詳細資料，預設顯示的為計劃中未完結的事件，查看歷史已完結事件可以點擊已完成或已取消切換查詢，事件屬性的詳細介紹如下：

   屬性	樣本	說明
   事件類型	風險修複	事件按緊急程度不同分為“風險修複”和“系統維護”。
   運行狀態	等待執行	事件的調度狀態，需要關注的狀態如下： 等待設定時間：事件的執行時間為空白，需要您根據業務情況設定時間，如果截至最晚操作時間仍未設定時間，系統會自動取消且不會自動執行。 等待執行：事件等待到達計劃開始時間進入到調度階段。 執行中：事件進入調度執行，此時無法人工幹預，如需緊急終止需要提工單（非標操作可能有未知風險）。 成功結束：執行成功。 已取消：執行失敗或取消，常見取消原因。 客戶自主取消（UserCancel）：使用者在控制台或通過OpenAPI取消。 客戶響應逾時（UserResponseTimeout）：需要指定時間的事件超截止時間未設定時間，事件自動取消。 資料庫管控取消（SupervisorCancel）：事件發起端主動取消。 無需執行的規避性取消（AvoidCancel）：風險已解除或執行個體目前狀態已無需執行此事件，比如執行個體已經是最新版本無需再做升級。 系統自動取消（AutoCancel）：系統會對計劃中事件定期巡檢，如果執行個體不具備執行事件條件可能會被取消，比如當前執行個體狀態異常無法下發動作。 執行逾時（ExecuteTimeout）：事件進入執行隊列未在預期時間內完結。 執行失敗（ExecuteFail）：事件執行過程中有未知異常失敗。
   事件類型	小版本升級	參見事件的類型與影響。
   事件原因	-	參見附錄2 詳細原因碼和取消風險。
   業務影響	執行個體閃斷	不同事件的業務影響不同，參見事件的類型與影響。
   營運建議	確認業務應用具備資料庫自動重連機制並關注業務影響	不同事件的營運建議不同，參見附錄1 CloudMonitor相關係統事件。
   計劃開始時間	-	事件開始進入到調度隊列的時間，在開始時間之前，此事件對執行個體無任何影響，過了開始時間您仍可正常訪問資料庫，但是無法執行執行個體層級的操作（例如變更配置、遷移可用性區域等）；狀態為“等待設定時間”時此時間為空白。
   計劃切換時間	-	主備或鏈路切換（如果有）的時間，通常指執行個體串連有閃斷影響的時間；此時間是預估值，發生切換在此時間附近都符合預期，極端情況下，比如涉及回切可用性區域情境下可能有二次切換。 說明 考慮到事件調度、資料準備耗時等因素通常在切換之前需要一定的前置準備時間，因此開始時間和切換時間有一定間隔，不同資料庫產品不同事件間隔可能不同。
   最晚操作時間	-	可設定切換時間的最晚時間，要調整的切換時間不能晚於此時間。
   是否可取消	是	如需屏蔽本次事件您可以操作取消，通常“系統營運”類事件開放此功能。 重要 計劃事件通常是雲資料庫管控系統定期巡檢下發，當次取消後可能會在下個巡檢周期有新事件下發，如果頻繁取消也可能會出現風險升級，建議您根據業務情況選擇合適時間執行而不是取消事件。取消後的風險參見附錄2 詳細原因碼和取消風險。
   是否可改時間	是	絕大多數都可以調整事件執行時間，很少情境的高危風險緊急修複沒有足夠的執行時間調整視窗可能不允許調整時間。

4. 修改計劃事件（可選）

   可選中需要調整執行時間的記錄，點擊修改計劃事件進入設定切換時間介面，支援兩種修改方式：

   • 立即執行：即任務開始時間將設定為目前時間，隨後進入執行隊列立即執行。

   • 指定切換時間：根據可配置切換時間範圍選擇合適的時間點作為切換時間執行，開始時間將會根據切換時間自動計算，但新的開始時間不能早於目前時間，否則無法修改。

5. 修改周期時間視窗（可選）

   點擊事件列表右上方的“周期時間視窗配置”可進入周期時間視窗配置頁面。

   計劃內事件的執行時間通常是根據執行個體的營運時間自動計算的（參見設定可維護時間段 RDS|Tair/Redis|MongoDB|PolarDB），您也可以根據自己的營運需要自訂周期時間視窗，雲資料庫在後續發起新事件時會優先根據您設定的時間視窗編排計算執行時間。

   支援按月或周兩個維度設定視窗，例如設定的周期切換時間為每周一、周二的02:00～03:00，雲平台的計劃事件視窗為本周二至下周日，則事件的切換時間會命中本周二的02:00～03:00和下周一的02:00～03:00，通常優先選擇本周二切換。

   重要

   1. 此配置僅對未來新的事件有效，當前事件列表中的事件如果希望調整時間請點擊“設定執行時間”

   2. 此配置僅作為輔助計算執行時間的配置且僅對事件類型為“系統維護”的事件有效，實際計算的執行時間請以事件列表的時間為準。

   3. 此配置為帳號層級配置，配置後所有支援周期時間的資料庫產品均會同步生效。

6. 取消計劃事件（可選）

   可選中需要取消的事件記錄，點擊取消計劃事件進入取消介面，知曉取消風險後可點擊確認發起取消。

事件的類型與影響

相關API