All Products
Search
Document Center

ApsaraDB for MongoDB:View and manage scheduled events

Last Updated:Apr 25, 2024

You can receive notifications for scheduled events such as instance migrations and version upgrades by phone call, email, or internal message or in the ApsaraDB for Redis console. You can view information such as event types, causes, and business impacts of scheduled events. You can also change the scheduled time of business switchover that is triggered by the scheduled events.

Prerequisites

Scheduled O&M events exist in ApsaraDB for MongoDB.

Note

In the top navigation bar of the ApsaraDB for MongoDB console, click the Scheduled Events button to check the number of scheduled events.

Precautions

You are notified of ApsaraDB for Redis pending events such as instance migrations or version upgrades at least three days before the events occur. Notifications for high-risk vulnerability fixes are sent three or fewer days before execution due to the urgency of these events. Event notifications are sent by using phone calls, emails, internal messages, or the ApsaraDB for Redis console. To use this feature, log on to the Message Center console, enable ApsaraDB Fault or Maintenance Notifications, and then specify a contact. We recommend that you specify an O&M engineer as the contact.

Figure 2. Message Center settingsMessage Center settings

Procedure

  1. Log on to the ApsaraDB for MongoDB console.

  2. In the left-side navigation pane, click Scheduled Events.

    Important

    If a pending event requires you to schedule the time to handle the event, a message that prompts you to schedule the time at the earliest opportunity appears.

  3. On the Scheduled Event page, perform the following operations:

    • View event details

      The Scheduled Events list contains the following columns: Event Type, Cause, Business Impact, Start Time, Scheduled Switching Time, Deadline, Status, Database Engine, and Cancellable. You can view the corresponding attributes of instances in the preceding columns. For more information about the causes and business impacts of the events, see Causes and impacts of events.

    • Configure switchover time

      Scheduled events support the following switchover time modes: scheduled switchover time, periodic switchover time, and instance maintenance window, which are listed in the descending order of priority.

      Switchover time mode

      Procedure

      Scheduled event

      1. In the scheduled event list, select one or more events.

      2. In the upper-left corner of the Scheduled Events page, click Add Scheduled Event.

      3. In the Schedule Event panel, specify the scheduled switchover time.

        Note
        • If you select Earliest Execution Time, the system automatically enters the earliest execution date and time. After you save the settings, the instances prepare for the switchover and enter the Pending state. If you do not select this option, you can customize the schedule.

        • The time specified by Scheduled Switching Time cannot be later than the time specified by Latest Execution Time.

      4. Check whether the appropriate events are selected.

        • If the appropriate events are selected, click Save to save the settings.

        • Otherwise, select appropriate events on the Scheduled Event page, and then re-configure the scheduled event.

      Periodic switchover time

      Important

      After the periodic switchover time is set, all scheduled events generated from the current time are switched based on the most recent switchover time.

      For example, if you set the periodic switchover time to 12:00:00 on Tuesday and 12:00:00 on Friday, scheduled events generated from 12:00:00 on Tuesday to 12:00:00 on Friday are switched at 12:00 on Friday. Scheduled events from 12:00:00 on Friday to 12:00:00 next Tuesday are switched at 12:00:00 next Tuesday.

      1. In the upper-left corner of the Scheduled Events page, click Global Scheduler.

      2. In the Global Scheduler panel, specify the periodic switchover time by Week or Month based on your business requirements.

        Note

        You can view the specified periodic switchover time in the upper-right corner of the Scheduled Event page. If you select None, the periodic switchover time is not displayed.

      3. Click Save to save the settings.

      Instance maintenance window

      The default maintenance window is 02:00-06:00. Click the instance ID. On the Basic Information page, you can view the maintenance window in the Specification Information section. You can also click Edit next to Maintenance Period to modify the maintenance window. For more information, see Specify a maintenance window.

    • Cancel the scheduled event

      If the value of the Event Type parameter of an event is Minor Version Upgrade, you can click Cancel Scheduled Event in the upper-left corner of the Scheduled Event page to cancel the specified scheduled event.

Causes and impacts of events

Cause

Impact

Description

Instance migration

Transient connections

When a switchover is performed at the scheduled switchover time, the following impacts may occur:

  • Your instance or the data shard in your instance encounters transient connections and remains in the read-only state for up to 30 seconds before all data is synchronized. We recommend that you perform the switchover during off-peak hours and make sure that your application is configured to automatically reconnect to your instance.

  • You cannot manage your instances by using Data Management (DMS) or Data Transmission Service (DTS). This impact is temporary.

Minor engine version update

Transient connections

When a switchover is performed at the scheduled switchover time, the following impacts may occur:

  • Your instance or the data shard in your instance encounters transient connections and remains in the read-only state for up to 30 seconds before all data is synchronized. We recommend that you perform the switchover during off-peak hours and make sure that your application is configured to automatically reconnect to your instance.

  • You cannot manage your instances by using DMS or DTS. This impact is temporary.

Minor version update

Different minor versions or kernel versions have different updates. You must take note of the differences between the current minor version and the minor version to which your instance is upgraded.

Minor version update for proxy nodes

Transient connections

When a switchover is performed at the scheduled switchover time, the following impacts may occur:

  • Your instance or the data shard in your instance encounters transient connections and remains in the read-only state for up to 30 seconds before all data is synchronized. We recommend that you perform the switchover during off-peak hours and make sure that your application is configured to automatically reconnect to your instance.

  • You cannot manage your instances by using DMS or DTS. This impact is temporary.

Minor version update

Different minor versions have different updates. You must take note of the differences between the current minor version and the minor version to which your proxy nodes are upgraded.

SSL certificate update

Transient connections

When a switchover is performed at the scheduled switchover time, the following impacts may occur:

  • Your instance encounters transient connections and remains in the read-only state for up to 30 seconds before all data is synchronized. We recommend that you perform the switchover during off-peak hours and make sure that your application is configured to automatically reconnect to your instance.

  • You cannot manage your instances by using DMS or DTS. This impact is temporary.

Related API operations

Operation

Description

DescribeActiveOperationTaskCount

Views the number of O&M tasks on an ApsaraDB for MongoDB instance.