Looker (Google Cloud Core) 每月會排定維護期,並在期間升級執行個體。維護期間,執行個體會重新啟動,您將暫時無法存取執行個體。您可以為執行個體指定維護期間,也就是維護作業執行的星期幾和時段。如未指定偏好的維護期間,升級作業會在推出新版 Looker (Google Cloud Core) 的兩週內進行。您也可以指定「拒絕維護期間」,禁止系統在指定時間進行維護作業。
如果您指定「拒絕維護期」,讓 Looker (Google Cloud Core) 執行個體升級至下一個支援的 Looker 版本,則 Looker (Google Cloud Core) 執行個體中可用的功能,可能與 Google Cloud 控制台顯示的升級版本可用設定不同。
本說明文件頁面將說明如何尋找預定維護作業的相關資訊、設定維護作業的偏好期間、指定拒絕維護期,以及設定 Looker (Google Cloud Core) 執行個體即將進行維護作業的相關通知。
發布版本和維護政策
如果 Looker (Google Cloud Core) 執行個體已註冊發布管道,您可以設定的維護設定會因執行個體的發布管道而異:
- 搶鮮版:不支援維護期間和拒絕維護期。如果註冊搶鮮版,系統會移除先前為執行個體設定的維護期間或拒絕維護期。
- 一般版:您可以指定偏好的維護期間和拒絕維護期。
- 不使用發布版本:您可以指定偏好的維護期間和拒絕維護期。
必要角色
如要取得設定 Looker (Google Cloud Core) 執行個體維護設定所需的權限,請要求管理員在建立執行個體的專案中,授予您 Looker 管理員 (roles/looker.admin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
維護設定
Looker (Google Cloud Core) 可讓您透過一組維護設定,設定維護更新。
您可以設定維護作業的排程,在短暫停機對執行個體影響最小的時間進行。您可以設定下列項目:
維護期間:Looker (Google Cloud Core) 排定維護作業的星期幾和時段。維護期間為一小時。
拒絕維護期:Looker (Google Cloud Core) 不會在這段期間安排維護作業。拒絕維護期的上限為 60 天。在任兩個拒絕維護期之間,至少須有 14 天的空檔,讓系統能執行維護作業。
您可以在建立 Looker (Google Cloud Core) 執行個體時更新維護政策,也可以編輯現有執行個體的設定。
設定偏好的維護期間
如要指定 Looker (Google Cloud Core) 排定維護作業的偏好時間範圍,請選取下列其中一個選項:
主控台
在 Google Cloud 控制台中,建立 Looker (Google Cloud Core) 執行個體,或編輯現有 Looker (Google Cloud Core) 執行個體的設定。
在「維護期間」下方的「偏好維護」部分,設定維護期間的下列設定:
日期:執行個體更新的星期幾
時段:執行個體維護作業的大約開始時間
按一下 [儲存]。
如果您的執行個體已加入快速發布管道,控制台中就不會顯示這個選項。 Google Cloud
gcloud
如果您要建立執行個體,請使用 gcloud looker instances create 指令;如果要更新執行個體,請使用 gcloud looker instances update 指令,並加入下列參數:
--maintenance-window-day=MAINTENANCE_WINDOW_DAY --maintenance-window-time=MAINTENANCE_WINDOW_TIME
更改下列內容:
MAINTENANCE_WINDOW_DAY:執行個體更新的星期幾。必須是下列其中一項:friday、monday、saturday、sunday、thursday、tuesday、wednesday。MAINTENANCE_WINDOW_TIME:維護期間的開始時間,採用世界標準時間 24 小時制格式 (例如13:00、17:45)。
如果已在發布管道預先發布版功能中,將 Looker (Google Cloud Core) 執行個體註冊至搶鮮版,就無法為該執行個體設定維護期間。
指定維護時段後,設定變更最多需要一週才會生效。
設定拒絕維護期
如要將排定的維護作業延後,可以變更執行個體的拒絕維護期。拒絕維護期的上限為 60 天。
在任兩個拒絕維護期之間,至少須有 14 天的空檔,讓系統能執行維護作業。
如要指定 Looker (Google Cloud Core) 不會執行維護作業的偏好期間,請選取下列其中一個選項:
主控台
在 Google Cloud 控制台中建立 Looker (Google Cloud Core) 執行個體,或編輯現有 Looker (Google Cloud Core) 執行個體的設定。
在「拒絕維護期」部分,設定拒絕維護期的下列設定:
開始日期:選擇維護作業不會進行的期間開始日期。
結束日期:選擇維護作業不會進行的期間結束日期。
開始/結束時間:定義「拒絕維護期」的開始時間 (您為「開始日期」指定的日期) 和結束時間 (您為「結束日期」指定的日期)。
- 按一下 [儲存]。
如果您的執行個體已加入快速發布管道,控制台中就不會顯示這個選項。 Google Cloud
gcloud
如果您要建立執行個體,請使用 gcloud looker instances create 指令;如果要更新執行個體,請使用 gcloud looker instances update 指令,並加入下列參數:
--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE
--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE
--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME
更改下列內容:
DENY_MAINTENANCE_PERIOD_START_DATE:拒絕期間的開始日期,格式為YYYY-MM-DD。DENY_MAINTENANCE_PERIOD_END_DATE:拒絕期限的結束日期,格式為YYYY-MM-DD。DENY_MAINTENANCE_PERIOD_TIME:以世界標準時間 24 小時制格式表示開始和結束時間 (例如13:00、17:45)。
如果已在發布管道預先發布功能中,將 Looker (Google Cloud Core) 執行個體註冊至「搶鮮版」管道,就無法為該執行個體設定拒絕維護期。
維護範例
舉例來說,您可以將正式版執行個體的維護設定設為:
- 維護期間:每週日凌晨 12:00 至凌晨 1:00 (美國東部時間)
- 拒絕維護期:12 月 1 日晚上 10 點至 1 月 15 日晚上 10 點
即將進行的維護作業通知
您可以設定在預定維護作業開始前一週,透過電子郵件接收即將進行維護作業的通知。如要為通知設定電子郵件篩選器,電子郵件標題為「[Looker (Google Cloud Core) Advanced Maintenance Notification] Your instance is scheduled for maintenance.」([Looker (Google Cloud Core) 進階維護通知] 您的執行個體排定進行維護作業)。
系統預設不會傳送維護作業通知。如要接收即將進行的維護更新通知,請務必完成下列兩個步驟:
- 設定維護期間。
- 在專案層級選擇接收維護通知,或設定以記錄為準的快訊。
- 如要接收預定維護作業的通知,請務必在 Looker (Google Cloud Core) 執行個體下次預定維護更新前,至少七天完成下列兩個步驟。
透過 Google Cloud 控制台設定的通知會傳送至與您 Google 帳戶相關聯的電子郵件地址。您可以使用自訂電子郵件別名 (例如團隊電子郵件別名)。
如果 Looker (Google Cloud Core) 執行個體使用 SAML 或 OpenID Connect (OIDC) 進行驗證,或是您想將通知傳送至 Slack、PagerDuty 或自訂 Webhook 等第三方通訊管道,可以設定記錄檔式快訊。
您可以為特定專案中設有維護期間的所有 Looker (Google Cloud Core) 執行個體,啟用維護通知。每個執行個體都會收到一則通知。
選擇接收維護通知
如要在 Google Cloud 控制台中開啟維護通知,請按照下列步驟操作:
前往 Google Cloud 控制台的「Communication」(通訊) 頁面:
選取「產品通知」分頁標籤。
從下拉式選單中選取您的專案。
在 Looker (Google Cloud Core) 的列中,將電子郵件切換鈕設為「開啟」。
為維護事件設定記錄檔型快訊
如果您使用員工身分聯盟進行驗證,控制台就無法將維護通知傳送至您的聯盟帳戶。 Google Cloud Google Cloud 此外,您可能還想將通知轉送至 Slack、PagerDuty 或自訂 webhook 等服務。如要在這些情況下接收通知,您可以在 Cloud Logging 中設定以記錄為準的快訊政策。
當 Looker (Google Cloud Core) 排定、開始、完成或取消維護更新時,系統會將活動記錄項目寫入 Cloud Logging。您可以建立與這些記錄檔項目相符的快訊政策,並將通知傳送至已設定的通知管道。
如要為維護事件建立記錄型警告,請按照「使用 Logs Explorer 建立記錄型警告政策」一文中的操作說明建立警告政策。如需可在政策中使用的查詢範例,請參閱「維護記錄查詢」。
維護記錄查詢
請使用下列查詢,為維護生命週期的不同階段建立記錄型快訊。
將 LOOKER_INSTANCE_NAME 替換為 Looker (Google Cloud Core) 執行個體的名稱。
預先通知 (已排定):在系統排定執行個體維護作業時通知您。
log_id("maintenance.googleapis.com/activity_log") AND resource.type = "gce_instance" AND labels.activity_type_name = "LookerRolloutAdvanced" AND labels.instance_id = "LOOKER_INSTANCE_NAME"開始通知:在執行個體開始維護時通知您。
log_id("maintenance.googleapis.com/activity_log") AND resource.type = "gce_instance" AND labels.activity_type_name = "LookerRolloutInProgress" AND labels.is_completed = "false" AND labels.is_failed = "false" AND labels.instance_id = "LOOKER_INSTANCE_NAME"完成通知 (成功):維護作業順利完成時,系統會通知您。
log_id("maintenance.googleapis.com/activity_log") AND resource.type = "gce_instance" AND labels.activity_type_name = "LookerRolloutInProgress" AND labels.is_completed = "true" AND labels.is_failed = "false" AND labels.instance_id = "LOOKER_INSTANCE_NAME"通知維護作業失敗或取消:通知你維護作業失敗或取消。
log_id("maintenance.googleapis.com/activity_log") AND resource.type = "gce_instance" AND (labels.is_failed = "true" OR labels.activity_type_name = "LookerRolloutCanceled") AND labels.instance_id = "LOOKER_INSTANCE_NAME"
尋找預定維護作業
如果系統已排定執行個體的維護作業,請按照下列步驟查看:
前往 Google Cloud 控制台的「Looker (Google Cloud Core)」頁面。
選取要查看排定維護作業的執行個體名稱。
查看執行個體的設定詳細資料時,您可以在「詳細資料」頁面中查看下列資訊: