Monitor Dataplex Universal Catalog metrics

Cloud Monitoring provides visibility into theperformance, uptime, and overall health of cloud-powered applications.Google Cloud Observability collects and ingests metrics, events, and metadata fromDataplex Universal Catalog services to generate insights through dashboardsand charts.

To understand the costs, seeMonitoring pricing.

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

Access service metrics in Monitoring

Dataplex Universal Catalog service resource metrics are automatically enabled onDataplex Universal Catalog services. To view these metrics, useMonitoring.

You can access Monitoring from theGoogle Cloud console or by using theMonitoring API.

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

Console

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

    Go to Metrics explorer

  2. In theSelect a metric menu, select aCloud 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 metricname.

  4. ClickApply.

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

REST

To capture and list metrics defined by afilter expression,Use the MonitoringtimeSeries.listmethod.

To send an API request and display the response, on the API page, use theTry 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 withdataplex.googleapis.com/. That prefix has been omitted from the entries in the table. When querying a label, use themetric.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/activeBETA  (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_itemsBETA  (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_sizeBETA  (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_updatesBETA  (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_updatesBETA  (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/filesetsBETA  (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_actionBETA  (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/tablesBETA  (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_actionBETA  (project)
Requires action
GAUGE, INT64, 1
dataplex.googleapis.com/Lake		Whether the lake has unresolved admin actions.
zone/requires_actionBETA  (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 2026-02-12 22:12:11 UTC.

Build a custom Monitoring dashboard

You can build a custom Monitoring dashboard that displayscharts of selected Dataplex Universal Catalog service metrics. For more informationabout how to create a dashboard, seeCreate and manage custom dashboards. When youselect a metric for a widget on your dashboard, select aCloud Dataplexresource and then choose a Dataplex Universal Catalog metric.

Use Monitoring alerts

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

Create an alert

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

View alerts

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

To view an incident, follow this step:

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

For more information about alerts, seeIncidents for metric-based alerts.

What's next

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-19 UTC.