View maintenance activities

Some Google Cloud services perform maintenance activities to keep your resources reliable, secure, and up-to-date, or for technical or business reasons. You can view planned, in-progress, completed, and canceled maintenance across Google Cloud services in a Google Cloud project on the Maintenance page.

The Maintenance page displays maintenance activities for Google Cloud services that are supported by Unified Maintenance.

Before you begin

  1. To view maintenance activities for resources in a project, the Unified Maintenance API must be enabled on your Google Cloud project.

    Enable the API

  2. The Maintenance page only supports viewing data by project. To get an aggregate view of maintenance across projects, centralize your logs in a single project. You can then choose the project that stores your logs on the Maintenance page.

Required roles

To get the permissions that you need to view maintenance activities, ask your administrator to grant you the Logs Viewer (roles/logging.viewer) IAM role on project. For more information about granting roles, see Manage access to projects, folders, and organizations.

You might also be able to get the required permissions through custom roles or other predefined roles.

The Logs View role is included in the Cloud Hub Operator (roles/cloudhub.operator).

For information about permissions to perform additional tasks with maintenance, logs such as setting alerts and notifications, see the Unified Maintenance documentation.

View maintenance activities

To view maintenance activities:

  1. In the Google Cloud console, go to the Maintenance page,

    Go to Maintenance

  2. From the project selector, select the project that you want to view.

    The Maintenance page displays the following information:

    • Maintenance summary: This section displays the following data:
      • The total number of scheduled and in-progress (running) maintenance activities.
      • The total number of completed and canceled maintenance activities.
    • Google-controlled maintenance: Upcoming maintenance activities that that you cannot configure or control.
    • Planned maintenance: Upcoming maintenance activities that you can configure or control. For example, many Google Cloud services with planned maintenance let you set a maintenance window.
    • Maintenance history: Completed or canceled maintenance.

  3. To filter the displayed maintenance activities, select options from the Category, Location, and ResourceType selectors.

  4. To view details about a maintenance activity, click the activity name.

    The Maintenance details page displays the following information:

    • Description: a description of the maintenance activity. It includes links to product-specific information to help you manage the maintenance activity.
    • Timeline: the scheduled start time, scheduled end time, actual start time, actual end time, and duration of the maintenance activity.
    • Resource progress: a summary of the number of resources with scheduled, running, successful, and cancelled state.
    • Locations: the locations of impacted resources.
    • Affected Google Cloud resources a list of resources that are impacted by the maintenance activity with the impacted resource name, location, resource type, maintenance state, and timeline (scheduled start time, actual start time, actual end time and duration).

    To learn about options to reschedule the maintenance activity, click Reschedule.

What's next