PolarDB:スケジュールされたイベントの表示と管理

注意事項

• イベントは緊急度に応じて 2 つのレベルに分類されます：

  • [S0 Urgent] リスク修復：通常、サービス障害を防ぐために即時対応が必要な想定外の問題が対象となります。これらのイベントの通知は 3 日前、またはそれより直前に送信され、切り替え時間を再スケジュールできる期間も短くなります。例として、緊急のバージョン置き換えとアップグレード、ホスト障害復旧、有効期限が近い SSL 証明書のアップグレードが挙げられます。

  • [S1 Scheduled] システムメンテナンス：リスクの低い問題の修正、または計画的なソフトウェアとハードウェアのアップグレードが対象となります。これらのイベントの通知は通常 3 日より前に送信され、イベントをキャンセルできます。

• スケジュールされた運用保守イベントの通知を受信するには、メッセージセンター にログインし、ApsaraDB 障害またはメンテナンス通知の通知方法を選択して、連絡先を設定します。データベースの運用保守担当者を連絡先として追加することを推奨します。追加しない場合、イベント通知を受信できません。通知方法には Email とサイト内メッセージがあります。確実に配信されるよう、Email を選択することを推奨します。

  コンソールの右上にあるベルアイコンをクリックします。次に、[Internal Message Notifications] パネルで [Message Settings] をクリックします。

  図 1：メッセージ設定へのアクセス

  

  図 2：ApsaraDB の通知設定

• 運用保守イベントのリアルタイム更新を受け取る、またはイベント駆動のカスタム自動化を実装するには、CloudMonitor でシステムイベントサブスクリプションを設定します。ApsaraDB は、Scheduled、 In Progress、 Succeeded、 Canceled など、運用保守イベントのライフサイクル段階ごとにシステムイベントを CloudMonitor にプッシュします。詳細については、「イベントサブスクリプションの管理 (推奨)」をご参照ください。サブスクライブ可能な CloudMonitor イベントの一覧については、「付録 1：CloudMonitor 関連のシステムイベント」をご参照ください。

  展開すると、CloudMonitor イベントのサンプルが表示されます。

  {
    "eventId": "c864b30b-7f69-5f04-b0e7-8dfb0eabcfd9", // イベントの一意の ID。
    "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", // キャンセルリスクコード。詳細については、付録 2：詳細な原因コードとキャンセルリスクをご参照ください。
      "detailCode": "HostSoftHardwareUpgrade",            // 詳細な原因コード。詳細については、付録 2：詳細な原因コードとキャンセルリスクをご参照ください。
      "instanceInfo": ""
    },
    "instanceId": "rm-2ze9d66o65q1g02g6",             // インスタンス ID。
    "instanceComment": "rm-2ze9d66o65q1g02g6",        // インスタンスのエイリアス。
    "instanceType": "Maintenance",
    "publishTime": "2024-09-10T16:01:47+08:00"
  }

手順

1. お使いのデータベース製品のコンソールにログインします。

2. 左側のナビゲーションペインで、[イベントセンター (旧イベント管理)] > [スケジュールされたイベント] をクリックします。上部メニューバーで、インスタンスが配置されているリージョンを選択します。

3. [スケジュールされたイベント] ページには、スケジュールされたイベントの詳細が表示されます。デフォルトでは、ステータスが [計画済み] のイベントが表示されます。過去のイベントを表示するには、[完了] または [キャンセル済み] タブをクリックします。次の表に、イベントの属性を示します。

   属性	例	説明
   イベントタイプ	リスク修復	イベントは緊急度によって、リスク修復とシステムメンテナンスの 2 種類に分類されます。
   ステータス	保留中	イベントのスケジューリングステータスです。以下の主要なステータスに注意してください： 実行時間設定待ち：実行時間が設定されていません。ビジネス要件に基づいて時間を設定する必要があります。最終期限までに時間を設定しない場合、イベントは自動的にキャンセルされます。 保留中：イベントは、予定された開始時刻にスケジューリングフェーズに入るのを待っています。 実行中：イベントは進行中です。この段階では手動で介入することはできません。緊急停止をリクエストするには、チケットを送信してください。このような非標準的な操作は、未知のリスクをもたらす可能性があることにご注意ください。 成功：イベントは完了しました。 キャンセル済み：イベントの実行が失敗したか、キャンセルされました。一般的なキャンセルの理由は次のとおりです： ユーザーによるキャンセル (UserCancel)：ユーザーがコンソールで、または API を呼び出してイベントをキャンセルしました。 ユーザー応答タイムアウト (UserResponseTimeout)：最終期限までに実行時間が設定されなかったため、イベントは自動的にキャンセルされました。 制御システムによるキャンセル (SupervisorCancel)：イベントの起票者がイベントをキャンセルしました。 不要によるキャンセル (AvoidCancel)：リスクが解決されたか、インスタンスの現在の状態によりイベントが不要になったため、イベントは不要になりました。たとえば、インスタンスがすでに最新バージョンであり、更新が不要な場合です。 システムによるキャンセル (AutoCancel)：システムは定期的にスケジュールされたイベントを検査します。インスタンスが実行の前提条件を満たさない場合、たとえばインスタンスが異常な状態でコマンドを受信できない場合、イベントはキャンセルされます。 実行タイムアウト (ExecuteTimeout)：イベントは実行キューに入りましたが、想定された時間内に終了しませんでした。 実行失敗 (ExecuteFail)：実行中に不明なエラーによりイベントが失敗しました。
   イベントタイプ	マイナーバージョンアップグレード	イベントタイプの具体的な名称です。詳細については、「イベントタイプと影響」をご参照ください。
   原因	-	詳細については、「付録 2: 詳細な原因コードとキャンセルリスク」をご参照ください。
   ビジネスへの影響	一時的な接続の中断	ビジネスへの影響はイベントによって異なります。詳細については、「イベントタイプと影響」をご参照ください。
   運用保守の提案	アプリケーションに自動再接続メカニズムを実装し、潜在的なビジネスへの影響に対処できるようにしてください。	運用保守の提案はイベントによって異なります。詳細については、「付録 1: CloudMonitor 関連のシステムイベント」をご参照ください。
   開始時刻	-	イベントがスケジューリングキューに入る時刻です。開始時刻より前は、イベントはインスタンスに影響を与えません。開始時刻後は、データベースには引き続きアクセスできますが、構成の変更やアベイラビリティーゾーン間の移行など、インスタンスレベルの操作は実行できません。イベントのステータスが 実行時間設定待ち の場合、このフィールドは空になります。
   予定切り替え日時	-	該当する場合、プライマリ/セカンダリ スイッチオーバーまたはリンクスイッチオーバーが発生する時刻です。通常、このタイミングで一時的な接続の中断が発生します。スイッチオーバーはこの推定時刻頃に発生する見込みです。まれに、元のアベイラビリティーゾーンへのフェイルバックなど、2 回目のスイッチオーバーが発生することがあります。 説明 スイッチオーバーの前には、イベントのスケジューリングやデータ準備などのタスクのために準備期間が必要です。そのため、開始時刻と切り替え時刻との間に時間差が生じます。この時間差は、データベース製品やイベントタイプによって異なります。
   最終期限	-	切り替え時間を設定できる最終時刻です。調整後の切り替え時間をこの最終期限より遅くすることはできません。
   キャンセル可能	はい	イベントをキャンセルして実行を防ぐことができます。このオプションは通常、システムメンテナンスイベントで利用できます。 重要 スケジュールされたイベントは通常、定期的な検査中にクラウドデータベース管理システムによって発行されます。イベントをキャンセルすると、次の検査サイクルで新しいイベントが発行される可能性があります。頻繁なキャンセルはリスクを増大させる可能性があります。これらのリスクを回避するため、イベントをキャンセルするのではなく、ビジネスニーズに基づいて適切な時間にイベントをスケジュールしてください。キャンセルリスクの詳細については、「付録 2: 詳細な原因コードとキャンセルリスク」をご参照ください。
   リスケジュール可能	はい	ほとんどのイベントで実行時間を変更できます。緊急性の高い高リスクの修正を伴うまれなケースでは、再スケジュールに十分な時間的余裕がない場合があります。

4. (オプション) スケジュールされたイベントの変更

   リスケジュールしたいイベントを選択し、[スケジュールされたイベントの変更] をクリックします。イベントは次の 2 つの方法で変更できます：

   • 即時実行：イベントの開始時刻が現在時刻に設定され、ただちに実行キューに入ります。

   • 指定時刻に切り替え：利用可能な範囲から切り替えに適した時刻を選択します。開始時刻は切り替え時刻に基づいて自動的に計算されます。新しい開始時刻を現在時刻より前に設定することはできません。設定した場合、変更は失敗します。

5. (オプション) 繰り返しタイムウィンドウの変更

   イベントリストの右上隅にある [繰り返しタイムウィンドウの設定] をクリックして設定ページを開きます。

   スケジュールされたイベントの実行時刻は、通常、インスタンスのメンテナンスウィンドウに基づいて計算されます。詳細については、RDS、Tair、MongoDB、PolarDB のメンテナンスウィンドウの設定に関するドキュメントをご参照ください。また、運用保守の要件を満たすために、カスタムの繰り返しタイムウィンドウを定義することもできます。クラウドデータベースサービスは、新しいイベントをスケジュールする際に、このカスタムウィンドウを優先します。

   ウィンドウは週単位または月単位で設定できます。たとえば、繰り返しの切り替え時刻を毎週月曜日と火曜日の 02:00–03:00 に設定し、プラットフォーム全体のイベントウィンドウが今週の火曜日から次の日曜日までである場合、システムは今週の火曜日の 02:00–03:00 と来週の月曜日の 02:00–03:00 の両方を有効な切り替え時刻として識別します。通常、より早い時刻 (今週の火曜日) が優先されます。

   重要

   1. この設定は新しいイベントにのみ適用されます。リスト内の既存のイベントの時刻を変更するには、[実行時間の設定] をクリックします。

   2. この設定は実行時刻を計算するための補助的なものであり、システムメンテナンスイベントにのみ適用されます。実際の実行時刻は、イベントリストに表示される時刻が優先されます。

   3. これはアカウントレベルの設定です。一度設定すると、繰り返しタイムウィンドウをサポートするすべてのデータベース製品に適用されます。

6. (オプション) スケジュールされたイベントのキャンセル

   キャンセルしたいイベントを選択し、[スケジュールされたイベントのキャンセル] をクリックします。リスクを確認した後、[確認] をクリックしてイベントをキャンセルします。

イベントタイプと影響

付録

付録 1：CloudMonitor のシステムイベント

付録 2：理由コードとキャンセルリスク

付録 3：イベントタイプ

関連 API