PolarDB:スケジュール済みイベントの表示と管理

イベントの緊急度レベル

スケジュール済みイベントは、以下の 2 つの緊急度レベルに分類されます。

• [S0：緊急] リスク対応：障害を未然に防止するため、迅速な対応が必要な予期せぬイベントです。例として、緊急のハードウェア交換、不具合のあるバージョンへのアップグレード、ホスト異常の修正、有効期限切れ前の SSL 証明書の更新などがあります。通知は通常、3 日以上前に行われますが、再スケジュール可能な期間は短くなります。

• [S1：スケジュール済み] システム保守：リスクが低く、事前に計画されたソフトウェアおよびハードウェアのアップグレードです。通知は 3 日以上前に送信され、これらのイベントはキャンセル可能です。

通知の設定

PolarDB は、イベントの緊急度に応じて、イベント発生の 1～3 日前に通知を送信します。

通知を受信するには、メッセージセンター で ApsaraDB の障害または保守に関する通知 の連絡先を設定してください。データベース運用・保守（O&M）担当者を連絡先として追加します。配信信頼性を最大限に高めるため、通知方法として 電子メール を選択することを推奨します。サイト内メッセージも利用可能です。

図 1 メッセージセンター コンソールにおけるメッセージ設定のエントリ

図 2 ApsaraDB の障害または保守に関する通知の通知設定メッセージセンター通知方法には電子メールおよびサイト内メッセージがあります。通知の成功確率を向上させるため、電子メールを選択することを推奨します。

イベント駆動型のO&M自動化では、CloudMonitorシステムイベントをサブスクライブします。CloudMonitorは、各メンテナンスイベントに対して、サブスクライブ、開始、終了、キャンセルのライフサイクル通知をプッシュします。設定手順については、「イベントサブスクリプションポリシーの管理（推奨）」をご参照ください。サブスクライブ可能なCloudMonitorシステムイベントについて詳しくは、このトピックの「付録1 CloudMonitor関連のシステムイベント」セクションをご覧ください。

CloudMonitor イベントペイロードのサンプル：

{
  "eventId": "c864b30b-7f69-5f04-b0e7-8dfb0eabcfd9",
  "product": "RDS",
  "reason": "Host software/hardware upgrade",
  "extra": {
    "impactEn": "Transient instance disconnection",
    "eventCode": "rds_apsaradb_transfer",
    "eventNameEn": "Instance migration",
    "switchTime": "2024-09-15T01:30:00+08:00",
    "startTime": "2024-09-14T21:30:00+08:00",
    "cancelCode": "OutOfGoodPerfBySoftHardwareUpgrade",
    "detailCode": "HostSoftHardwareUpgrade",
    "instanceInfo": ""
  },
  "instanceId": "rm-2ze9d66o65q1g02g6",
  "eventType": "Maintenance",
  "instanceComment": "rm-2ze9d66o65q1g02g6",
  "instanceType": "Instance",
  "publishTime": "2024-09-10T16:01:47+08:00"
}

ペイロード内の主要フィールド：

スケジュール済みイベントの表示

1. PolarDB コンソールにログインします。

2. 左側ナビゲーションウィンドウで、イベントセンター（旧称：イベント管理） > スケジュール済みイベント を選択します。上部ナビゲーションバーから、ご利用のクラスターが配置されているリージョンを選択します。

3. [スケジュール済みイベント] ページで、イベントの詳細を表示します。予定済み 状態のイベントがデフォルトで表示されます。完了済み タブまたは キャンセル済み タブをクリックして、履歴イベントを表示できます。

   属性	例	説明
   イベントタイプ	リスク対応	緊急度レベル：リスク対応またはシステム保守。
   ステータス	未処理	スケジューリング状況。下記の「イベントステータス」をご参照ください。
   イベントタイプ	マイナーバージョンアップデート	保守イベントの具体的なタイプ。全リストについては、「イベントタイプと影響」をご参照ください。
   原因	-	イベントの原因。
   業務への影響	一時的な接続	イベントがワークロードに与える影響。イベントタイプによって異なります。
   O&M に関する推奨事項	アプリケーションがクラスターへの自動再接続を正しく構成していることを確認してください。	イベント発生前または発生中の推奨アクション。
   開始時刻	-	イベントがスケジューリングキューに入る時刻。「待機中（時間設定待ち）」ステータスの場合は空欄になります。この時刻より前はクラスターに影響はありません。この時刻以降は、構成変更やゾーン間マイグレーションなどのクラスターレベルの操作が一時的に利用不可になります。
   予定切り替え日時	-	プライマリ／セカンダリまたはリンクのスイッチオーバーにより瞬断が発生すると予想される時刻。極端なケースでは、最大 2 回のスイッチオーバーが発生する可能性があります。
   締切日時	-	実行時刻を設定できる最終時刻。設定するスイッチオーバー時刻は、この締切日時より後になることはできません。
   キャンセル可能	はい	このイベントをキャンセルできるかどうか。ほとんどのシステム O&M イベントで利用可能です。
   スケジュール変更可能	はい	このイベントのスケジュールを変更できるかどうか。短い再スケジュール期間を持つ緊急のリスク対応イベントでは利用できません。

イベントの再スケジュール

再スケジュールするイベントを選択し、イベントのスケジュール をクリックします。以下のいずれかのオプションを選択します。

• 即時実行：イベントを直ちに開始します。現在時刻が開始時刻として使用され、イベントはすぐに実行キューに入ります。

• 指定時刻でのスイッチオーバー：許容範囲内のスイッチオーバー時刻を選択します。開始時刻は、選択したスイッチオーバー時刻に基づいて自動計算されます。新しい開始時刻は、現在時刻より前になることはできません。

イベントを再スケジュールできない場合：

以下のいずれかの条件が成立する場合、再スケジュールはブロックされます。

• イベントが 実行中 ステータスである。

• イベントの開始時刻がすでに経過している。

• 現在時刻がイベントの締切日時より後である。

• イベントの新しい開始時刻が現在時刻より前である。

• このイベントのスイッチオーバー時刻を変更できない。

締切日時を超えてスイッチオーバー時刻を設定する（関連リスクを承諾する場合）には、チケットを送信してください。

定期的な保守ウィンドウの設定

定期的なタイムウィンドウを設定することで、今後の保守イベントの実行時刻を優先的に指定できます。新しいイベントが作成された際、システムはクラスターの保守ウィンドウではなく、この定期的なタイムウィンドウに基づいて実行時刻を算出します。

イベント一覧の右上隅にある 定期的なタイムウィンドウ設定 をクリックします。月単位または週単位でウィンドウを設定できます。

例： 定期的なウィンドウを月曜日および火曜日の 02:00～03:00 に設定し、新しいイベントの許容時間範囲が今週の火曜日から来週の日曜日までである場合、候補となるスイッチオーバースロットは火曜日 02:00～03:00 および来週の月曜日 02:00～03:00 となります。システムは、火曜日のスイッチオーバーを優先的にスケジュールします。

個別のクラスターのメンテナンスウィンドウを設定する方法について詳しくは、「メンテナンスウィンドウの設定」をご参照ください。

イベントタイプと影響

よくある質問

API リファレンス