Stay organized with collections
Save and categorize content based on your preferences.
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 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.
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:
In the Google Cloud console, go to the Maintenance page,
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.
To filter the displayed maintenance activities, select options from the
Category, Location, and ResourceType selectors.
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-02 UTC."],[[["\u003cp\u003eMaintenance logging is enabled by default, but no data will appear on the Maintenance board if you have opted out.\u003c/p\u003e\n"],["\u003cp\u003eThis page describes the various sections of the Maintenance page.\u003c/p\u003e\n"],["\u003cp\u003eUsers can refer to the Unified Maintenance documentation for additional information.\u003c/p\u003e\n"]]],[],null,["# View maintenance activities\n\n| **Preview**\n|\n|\n| This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nSome Google Cloud services perform maintenance activities to keep your\nresources reliable, secure, and up-to-date, or for technical or business\nreasons. You can view planned, in-progress, completed, and canceled maintenance\nacross Google Cloud services in a Google Cloud project on the Maintenance\npage.\n\nThe Maintenance page displays maintenance activities for [Google Cloud\nservices](/unified-maintenance/docs/supported-services) that are supported by\n[Unified Maintenance](/unified-maintenance/docs/overview).\n\nBefore you begin\n----------------\n\n1. To view maintenance activities for resources in a project, the\n Unified Maintenance API must be enabled on your Google Cloud project.\n\n\n [Enable the API](https://console.cloud.google.com/flows/enableapi?apiid=maintenance.googleapis.com&redirect=https://console.cloud.google.com)\n\n \u003cbr /\u003e\n\n2. The Maintenance page only supports\n [viewing data by project](/hub/docs/app-project-views). To get an aggregate view of\n maintenance across projects, [centralize your logs](/logging/docs/export/aggregated_sinks) in a\n single project. You can then choose the project that stores your logs on the\n Maintenance page.\n\n### Required roles\n\n\nTo get the permissions that\nyou need to view maintenance activities,\n\nask your administrator to grant you the\n\n\n[Logs Viewer](/iam/docs/roles-permissions/logging#logging.viewer) (`roles/logging.viewer`)\nIAM role on project.\n\n\nFor more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\nYou might also be able to get\nthe required permissions through [custom\nroles](/iam/docs/creating-custom-roles) or other [predefined\nroles](/iam/docs/roles-overview#predefined).\n\nThe Logs View role is included in the Cloud Hub\nOperator (`roles/cloudhub.operator`).\n\nFor information about permissions to perform additional tasks with maintenance,\nlogs such as setting alerts and notifications, see the\n[Unified Maintenance documentation](/unified-maintenance/docs/access-control).\n\nView maintenance activities\n---------------------------\n\nTo view maintenance activities:\n\n1. In the Google Cloud console, go to the **Maintenance** page,\n\n\n [Go to Maintenance](https://console.cloud.google.com/cloud-hub/maintenance)\n\n \u003cbr /\u003e\n\n2. From the project selector, select the project that you want to view.\n\n The Maintenance page displays the following information:\n - **Maintenance summary** : This section displays the following data:\n - The total number of scheduled and in-progress (running) maintenance activities.\n - The total number of completed and canceled maintenance activities.\n - **Google-controlled maintenance**: Upcoming maintenance activities that that you cannot configure or control.\n - **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.\n - **Maintenance history**: Completed or canceled maintenance.\n3. To filter the displayed maintenance activities, select options from the\n **Category** , **Location** , and **ResourceType** selectors.\n\n4. To view details about a maintenance activity, click the activity name.\n\n The **Maintenance details** page displays the following information:\n - **Description**: a description of the maintenance activity. It includes links to product-specific information to help you manage the maintenance activity.\n - **Timeline**: the scheduled start time, scheduled end time, actual start time, actual end time, and duration of the maintenance activity.\n - **Resource progress**: a summary of the number of resources with scheduled, running, successful, and cancelled state.\n - **Locations**: the locations of impacted resources.\n - **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).\n\n To learn about options to reschedule the maintenance activity, click\n **Reschedule**.\n\nWhat's next\n-----------\n\n- Learn about setting [alerts and notifications](/unified-maintenance/docs/configure-alerts-and-notifications) for maintenance."]]
