You can use the Google Cloud console to access the monitoring dashboardfor a single subscription or all the subscriptions available in your project.

• A Cloud Billing account

• A Pub/Sub project with billing enabled

• At least one topic with a subscription in your Pub/Sub project

• Familiarity withCloud MonitoringandMetrics Explorer

View the monitoring dashboard for all subscriptions

To view the monitoring dashboard for all the subscriptionsin a project, perform the following steps:

1. In the Google Cloud console, go to the Pub/SubSubscriptions page.

   Go to Subscriptions

2. Click theMetrics tab.

   The monitoring dashboard is displayed for all subscriptions in the project.

The monitoring dashboard has two sections:Overview andQuota.

View the monitoring dashboard for a single subscription

To view the monitoring dashboard for a single subscriptionin a project, perform the following steps:

1. In the Google Cloud console, go to the Pub/SubSubscriptions page.

   Go to Subscriptions

2. In theSubscriptions page, click any subscription.

   The subscription details page is displayed.

3. Within the subscription details page, click theMetrics tab.

   The monitoring dashboard is displayed for the single subscription.

The monitoring dashboard has four sections:Overview,Health,Retention, andPull orPush, depending on your subscription type.You can see theRetention section only if you enable message retention forthe subscription.

Customize the monitoring dashboard

You can create a custom dashboard or add individual charts to anexisting custom dashboard.

To create a custom dashboard, perform the following steps:

1. Follow the steps to go to the monitoring page forall subscriptions or forasingle subscription.

2. Choose one of the following options:

   • To create a new dashboard containing all the charts, or to add all thecharts to an existing custom dashboard, clickSave as custom dashboard.

   • To add a single chart to a new or custom dashboard, in an individual chart,expand themore_vertMore Actions option and clickAdd to custom dashboard.

You can view all your dashboards in theMonitoring console.

Modify a chart

To modify a chart, perform the following steps:

1. Follow the steps to go to the monitoring page forall subscriptions or forasingle subscription.

2. In an individual chart, expand themore_vertMore Actions option and clickView in Metrics Explorer.

   The chart opens inMetrics Explorer.

3. You can usePromQL queries to make changes to yourchart and test the output.

4. ClickSave chart to save the changes.

Create an alerting policy

Creating an alerting policy for a chart lets you set up an alert that monitors themetric, configure the circumstances under which you want to bealerted, and configure how you want to be notified.

For more information on how to create alerts, seeCreate metric-based alert policies.

Some charts might not offer aCreate alerting policy option.In this case, perform the following steps:

1. Save the chart to a custom dashboard.

2. In the custom dashboard, for the individual chart, expandthemore_vertMore Actions option.

3. ClickConvert to alert chart.

Key charts to monitor subscriptions

Although there are a number of charts available to monitor your subscription,the following charts are a good starting point to check thestatus of a single subscription:

• TheOldest unacked message chart in theHealth section lets you check if any messages are taking a long timeto be acknowledged after being published.

• TheUnacked messages by region chart in theOverview section lets youcheck the number of unacknowledged messages in each region for the subscription.

• TheDelivery latency health score chart in theHealth section lets youcheck which factors may be contributing to an increased delivery latency. Formore information about this metric, seeMonitor delivery latency health.

The following chart in theQuota section help you monitor quotas forall the subscriptions in your project:

• TheAdministrator operations chart lets you monitor administrativeoperations regarding subscriptions. Each administrator operation charges oneunit against this quota.

For more information, seePub/Sub quotas and limits.

What's next

• To monitor topics, seeMonitor topics within Pub/Sub.

• To learn more about using PromQL to buildmonitoring charts, seeUsing the Query Editor.

• To learn more about maintaining a healthy subscription, seeMaintain a healthy subscription.