Monitor a migration

When using the data migration service, you can monitor the status of an individual user's migration in the Google Admin console. Alternatively, you can request a domain-level report while the migration is running or when it's complete.

You must be signed in as a super administrator for this task.

First, access the Data migration tool in the Admin console:

  1. Sign in to your Google Admin console.

    Sign in using your administrator account (does not end in @gmail.com).

  2. From the Admin console Home page, go to Data migration.

    To see Data migration, you might have to click More controls at the bottom.

How to monitor a migration

Check the status of a user's migration

To see the progress of an individual user's migration, hover over the user's Status column. For a more detailed report, click Details.

Request domain-level migration reports

To see the current status of all migrating users, you can request a domain migration report. You'll also receive an domain-level item error report which details any items that have failed to migrate.  

To request the reports:

  1. Click Settings  More > Migration Reports.
  2. In the Deliver to section:
    • If you want the reports to be sent to the super administrator of the domain, check the Super admins box.
    • Specify other recipients by adding their email addresses in a comma-separated list. 
  3. Click Send.

Tip: When you exit a migration, a domain migration report is automatically sent to all super administrators of the domain and the migration role account.

Understanding domain-level migration reports

A domain-level migration report is sent as a comma-separated values (CSV) file. The following details are outlined in the report:

Email domain migration report
Field Description
G Suite username Email address of the user.
Status Status of the user migration, such as completed, running, failing, not started, or unknown.
Status detail Details about the status, which could be any error details or OK if there are no errors.
Number of emails migrated Number of emails that have migrated since the migration started.
Number of emails failed Number of emails that have failed to migrate.
Total estimated number of emails to be migrated An estimation of the total number of emails that will be migrated. 
Percent complete Percentage of the migration that is complete for the user, based on the number of emails migrated. 
Number of days worth of emails migrated Number of days worth of email that have been migrated since the migration started. 
Number of days worth of emails pending Number of days worth of emails that are still to be migrated. 
Number of emails too big Number of emails that have failed to migrate because of their size.
Number of emails un-openable Number of emails that have failed due to having an invalid format.
Number of unknown errors Number of emails that have failed to migrate for unknown reasons.
Contacts domain migration report
Field Description
G Suite username Email address of the user.
Status Status of the user migration, such as completed, running, failing, not started, or unknown.
Status detail Details about the status, which could be any error details or OK if there are no errors.
Number of contacts migrated Number of contacts that have migrated since the report was generated.
Number of contacts failed Number of contacts that have failed to migrate.
Calendar domain migration report
Field Description
G Suite username Email address of the user.
Status Status of the user migration, such as completed, running, failing, not started, or unknown.
Status detail Details about the status, which could be any error details or OK if there are no errors.
Number of events migrated Number of calendar events that have migrated since the report was generated.
Number of events failed Number of calendar events that have failed to migrate.
Total estimated number of events to be migrated Number of calendar events that have not yet migrated.
Percent complete Percentage of the migration that is complete for the user, based on the number of calendar events migrated.
Migration item error report

Item error reports are produced for email and calendar migrations.

Field Description
G Suite username Email address of the user.
Item type Type of item that has failed to migrate. 
Item ID ID of item that has failed to migrate. 
Parent folder Name of parent folder of item that has failed to migrate.
Sent time (email) The time that the email was sent.
Start time (calendar) The time that the calendar event is scheduled to start. 
Error code Error code associated with the failed item. See Data migration service error codes for more information. 
Error details Details on the type of error associated with the failed item. See Data migration service error messages for more information.
Was this article helpful?
How can we improve it?