---
title: Google Cloud Database Migration
description: >-
  Monitor full dump progress, replication lag, and data written for your Google
  Cloud Database Migration jobs.
breadcrumbs: Docs > Integrations > Google Cloud Database Migration
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Google Cloud Database Migration
Integration version1.0.0
{% callout %}
# Important note for users on the following Datadog sites: us2.ddog-gov.com

{% alert level="info" %}
To find out if this integration is available in your organization, see your [Datadog Integrations](https://app.datadoghq.com/integrations) page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email [support@ddog-gov.com](mailto:support@ddog-gov.com).
{% /alert %}

{% /callout %}

## Overview{% #overview %}

[Google Cloud Database Migration](https://cloud.google.com/database-migration/docs) lets you migrate MySQL, PostgreSQL, SQL Server, and Oracle databases to Cloud SQL or AlloyDB for PostgreSQL with minimal downtime.

Get metrics from Google Cloud Database Migration to:

- Track full dump progress for each migration job and table.
- Monitor replication lag in bytes and seconds between source and destination databases.
- Watch data written to the destination and unsupported events encountered during migration.

## Setup{% #setup %}

### Installation{% #installation %}

If you haven't already, set up the [Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google-cloud-platform.md) first. There are no other installation steps that need to be performed.

## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

|  |
|  |
| **gcp.datamigration.migration_job.fulldump_progress_percentage**(gauge)               | Percentage of the initial full dump completed for the migration job.*Shown as percent*                                            |
| **gcp.datamigration.migration_job.fulldump_progress_percentage_per_object**(gauge)  | Percentage of the initial full dump completed for a single table in the migration job.*Shown as percent*                          |
| **gcp.datamigration.migration_job.initial_sync_complete**(gauge)                      | Whether all databases on the destination DB instance have completed the initial sync and are replicating changes from the source. |
| **gcp.datamigration.migration_job.max_replica_bytes_lag**(gauge)                     | Maximum replication lag in bytes, aggregated across all of the migration job's data.*Shown as byte*                               |
| **gcp.datamigration.migration_job.max_replica_sec_lag**(gauge)                       | Maximum replication lag in seconds, aggregated across all of the migration job's data.*Shown as second*                           |
| **gcp.datamigration.migration_job.sqlserver.processed_file_bytes_count**(count)      | Number of bytes uploaded to the destination.*Shown as byte*                                                                       |
| **gcp.datamigration.migration_job.sqlserver.processed_file_count**(count)             | Number of files uploaded to the destination.*Shown as file*                                                                       |
| **gcp.datamigration.migration_job.sqlserver.transaction_log_upload_sec_lag**(gauge) | The lag in seconds since the last uploaded transaction log.*Shown as second*                                                      |
| **gcp.datamigration.migration_job.sqlserver.unprocessed_file_bytes**(gauge)           | Unprocessed file bytes waiting to be uploaded to Cloud SQL.*Shown as byte*                                                        |
| **gcp.datamigration.migration_job.sqlserver.unprocessed_files**(gauge)                 | Unprocessed files waiting to be uploaded to Cloud SQL.*Shown as file*                                                             |
| **gcp.datamigration.migration_job.unsupported_events_count**(count)                   | Number of unsupported events per migration and per table.*Shown as event*                                                         |
| **gcp.datamigration.migration_job.write_bytes_count**(count)                          | Number of bytes written to the destination.*Shown as byte*                                                                        |
| **gcp.datamigration.migration_job.write_rows_count**(count)                           | Number of rows written to the destination.*Shown as row*                                                                          |

### Events{% #events %}

The Google Cloud Database Migration integration does not include any events.

### Service Checks{% #service-checks %}

The Google Cloud Database Migration integration does not include any service checks.

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).