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 during or after the migration.

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

Monitoring a data move

Before you begin

To access the data migration tool in the Admin console:

  1. Sign in to your Google Admin console.

    Sign in using an account with super administrator privileges (does not end in @gmail.com).

  2. From the Admin console Home page, go to Data migration.
Check the status of a user's migration

You can:

  • See the progress of an individual user's migration by checking the user's Status column.
  • Download a report by selecting a user and clicking Moreand thenDownload error report.
Request domain-level migration reports

Domain-level migration reports give the current status of all migrating users. There are 2 types of reports:

  • A domain migration report–Contains the current status of all migrating users. 
  • Item error report–Details any items that have failed to migrate.  

To request the reports:

  1. Click Moreand thenEmail reports.
  2. Choose the recipients of the reports:
    • Send to Super Admins–Reports are sent to the super administrators of your organization.
    • Send to Source Role Account–Reports are sent to the role account you set up for the migration. This option is only available when you're using a role account. Learn more about role accounts.
    • Additional Recipients–Reports are sent to the email addresses specified in this field. 
  3. Click Send.

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

Understand domain-level migration reports

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 helpful?
How can we improve it?