Monitor Dataplex Universal Catalog metrics

Cloud Monitoring provides visibility into the performance, uptime, and overall health of cloud-powered applications. Google Cloud Observability collects and ingests metrics, events, and metadata from Dataplex Universal Catalog services to generate insights through dashboards and charts.

To understand the costs, see Monitoring pricing.

For more information about metric data retention, see Monitoring quotas and limits.

Access service metrics in Monitoring

Dataplex Universal Catalog service resource metrics are automatically enabled on Dataplex Universal Catalog services. To view these metrics, use Monitoring.

You can access Monitoring from the Google Cloud console or by using the Monitoring API.

If you're unable to view the monitoring graphs or create alerts, you might need additional Monitoring permissions.

Console

  1. In the Google Cloud console, go to the Metrics explorer page.

    Go to Metrics explorer

  2. In the Select a metric menu, select a Cloud Dataplex resource.

  3. Select a metric category, and then select a metric from the list.

    To display information about a metric, hold the pointer over the metric name.

  4. Click Apply.

  5. Optional: Select filters, group by metric labels, perform aggregations, and select chart display options.

REST

To capture and list metrics defined by a filter expression, Use the Monitoring timeSeries.list method.

To send an API request and display the response, on the API page, use the Try this API template.

Dataplex Universal Catalog service metrics in Monitoring

Dataplex Universal Catalog service metrics facilitates monitoring of service health.

The "metric type" strings in this table must be prefixed with dataplex.googleapis.com/. That prefix has been omitted from the entries in the table. When querying a label, use the metric.labels. prefix; for example, metric.labels.LABEL="VALUE".

Metric type Launch stage (Resource hierarchy levels)
Display name
Kind, Type, Unit
Monitored resources		 Description
Labels
asset/active BETA  (project)
Active
GAUGE, INT64, 1
dataplex.googleapis.com/Asset 		Whether the asset is active.
resource_type: The type of the referenced resource.
zone_type: The type of the parent zone.
asset/data_items BETA  (project)
Data items
GAUGE, INT64, 1
dataplex.googleapis.com/Asset 		The count of items within the referenced resource.
resource_type: The type of the referenced resource.
zone_type: The type of the parent zone.
asset/data_size BETA  (project)
Data size
GAUGE, INT64, By
dataplex.googleapis.com/Asset 		The number of stored bytes within the referenced resource.
resource_type: The type of the referenced resource.
zone_type: The type of the parent zone.
asset/entities_pending_bigquery_iampolicy_updates BETA  (project)
Entities with BigQuery IAM policy updates pending
GAUGE, INT64, 1
dataplex.googleapis.com/Asset 		Number of Entities associated with the Asset with BigQuery IAM policy updates pending.
resource_type: The type of the referenced resource.
zone_type: The type of the parent zone.
asset/entities_pending_bigquery_metadata_updates BETA  (project)
Entities with BigQuery metadata updates pending
GAUGE, INT64, 1
dataplex.googleapis.com/Asset 		Number of Entities associated with the Asset with BigQuery metadata updates pending.
resource_type: The type of the referenced resource.
zone_type: The type of the parent zone.
asset/filesets BETA  (project)
Filesets
GAUGE, INT64, 1
dataplex.googleapis.com/Asset 		The count of fileset entities within the referenced resource.
resource_type: The type of the referenced resource.
zone_type: The type of the parent zone.
asset/requires_action BETA  (project)
Requires action
GAUGE, INT64, 1
dataplex.googleapis.com/Asset 		Whether the asset has unresolved admin actions.
resource_type: The type of the referenced resource.
zone_type: The type of the parent zone.
asset/tables BETA  (project)
Tables
GAUGE, INT64, 1
dataplex.googleapis.com/Asset 		The count of table entities within the referenced resource.
resource_type: The type of the referenced resource.
zone_type: The type of the parent zone.
lake/requires_action BETA  (project)
Requires action
GAUGE, INT64, 1
dataplex.googleapis.com/Lake 		Whether the lake has unresolved admin actions.
zone/requires_action BETA  (project)
Requires action
GAUGE, INT64, 1
dataplex.googleapis.com/Zone 		Whether the zone has unresolved admin actions.
type: The type of the zone.

Table generated at 2025-08-20 20:46:56 UTC.

Build a custom Monitoring dashboard

You can build a custom Monitoring dashboard that displays charts of selected Dataplex Universal Catalog service metrics. For more information about how to create a dashboard, see Create and manage custom dashboards. When you select a metric for a widget on your dashboard, select a Cloud Dataplex resource and then choose a Dataplex Universal Catalog metric.

Use Monitoring alerts

You can create a Monitoring alert that notifies you when a Dataplex Universal Catalog service or job metric crosses a specified threshold.

Create an alert

To create an alert, follow the instructions in Create metric-threshold alerting policies. When you select a time series to be monitored, select a Cloud Dataplex resource and then choose a Dataplex Universal Catalog metric.

View alerts

When an alert is triggered by a metric threshold condition, Monitoring creates an incident and a corresponding event.

To view an incident, follow this step:

  • In the Google Cloud console, go to the Alerting page.

    Go to Alerting

If you defined a notification mechanism in the alert policy, such as an email or SMS notification, Monitoring also sends a notification of the incident.

For more information about alerts, see Incidents for metric-based alerts.

What's next