Troubleshoot Cloud Hub

This document helps you how to resolve some common issues with data that is missing or unavailable in Cloud Hub.

Cloud Hub displays data from other Google Cloud services. To view the data, the APIs that provide the data must be enabled and you must have permissions to view the data. To view data for an App Hub application, there are additional requirements.

To learn more about application and project data views, see Application views and project views.

Missing required APIs and permissions

If some or all data is missing from a Cloud Hub page, the cause might be that a required API is not enabled or that you are missing permissions to view the data.

Cloud Hub pages display a message if:

  • A required API is not enabled.
  • You don't have permissions to view data for the selected project or app-enabled folder.
  • The page doesn't support viewing data for a project or doesn't support viewing data for an application.

The following table lists each main page in Cloud Hub, the APIs required for each page, and support that each page provides for displaying data for a project or an application.

Page Required APIs View application data View project data
Home

This page displays a subset of data from other Cloud Hub pages. It will display data for APIs that are enabled for the other pages.

Yes Yes
Deployments

App Hub, Application Design Center

For app-enabled folders, these APIs are automatically enabled on the management project

Yes No
Health & troubleshooting

App Hub, Cloud Logging, Cloud Monitoring, Cloud Trace, Error Reporting, Personalized Service Health, Cloud Asset Inventory

For app-enabled folders, these APIs are automatically enabled on the management project

App Hub is only required to view data by application.

Yes Yes
Maintenance

Unified Maintenance

Capacity Planner is also required for users in the Capacity Planner private preview

No Yes
Quotas & reservations

Cloud Quotas, Compute Engine

No Yes
Support Cloud Customer Care No Yes

Some APIs such as Cloud Logging and Cloud Monitoring are enabled by default when you create a project. APIs for other services, such as Cloud Quotas, Unified Maintenance, and Personalized Service Health must be enabled separately to view data related to the service.

The names in the Page column link to the documentation for each page. The page-specific documentation describes required roles to view data on the page.

  • If you are viewing data by project, then you must have the required permissions on the selected project.
  • If you are viewing data by application, then the data that you can access depends on how your administrator granted permissions.

    For example:

    • Granting Identity and Access Management (IAM) roles on a folder provides access to data in descendant projects.
    • Granting IAM roles on the management project provides access to data that is stored in the management project or is visible from the management project.
    • Granting IAM roles on specific projects only provides access to data that is stored in or is visible from those projects.

Page is not viewable

When you try to open a page, you see one of the following messages:

  • Page not viewable for projects
  • Page not viewable for folders

Some Cloud Hub pages only display data for projects or only display data for applications.

  • If you see the message Page not viewable for projects, a project is selected in the project picker in the Google Cloud console toolbar and you are viewing a page that can only display data for an application. To view application data, select an app-enabled folder instead.
  • If you see the message Not viewable for folders when you try to view a page, then an app-enabled folder is selected in the project picker in the Google Cloud console toolbar and you can only view Cloud Hub pages that can display data for App Hub applications. You can view data for an individual project in the folder by selecting the project from the project picker.

Home page is not showing incidents

When you look at the Health & Troubleshooting page, the Google Cloud Incidents section shows that there are incidents that affect the selected application or project. However, the page displays the message No incidents found in the Google Cloud Incidents section.

Verify that you have the Personalized Service Health Viewer role (roles/servicehealth.viewer) on the selected project, or on the app-enabled folder for the selected application. The role is included in both of the predefined roles for using Cloud Hub:

  • Cloud Hub Operator (roles/cloudhub.operator)
  • App Management Viewer (roles/apphub.appManagementViewer)

Missing application data

This section describes requirements to view data for App Hub applications and some situations where you might encounter missing data for an App Hub application.

Verify requirements

To view data for App Hub applications, ensure that the following steps are complete:

  1. Set up App Hub for an app-enabled folder and create your applications. Learn about app-enabled folders.

  2. Set up aggregation of logs, metrics, and traces for your applications.

Can't select an application from the Application list

Some Cloud Hub pages such as Health & troubleshooting have an Application selector that you can use to choose an App Hub application to review.

If you see the message Application: not available, then a project is selected in the project picker in the Google Cloud console toolbar.

To view data for an application, choose an app-enabled folder in the project picker. If you don't know which folder is app-enabled in your organization, ask your administrator. To learn about enabling a folder for application management, see Managing applications in a folder.

The selected folder is not app-enabled

If you see the message Folder is not app-enabled, then the folder that is selected in the project picker in the Google Cloud console toolbar is not configured for application management.

To view data for an application, choose an app-enabled folder in the project picker. If you don't know which folder is app-enabled in your organization, ask your administrator. To learn about enabling a folder for application management, see Managing applications in a folder.