Monitor a migration

When using the data migration service, you can monitor your users' migration status in the Google Admin console. You can also download or email reports on migration status and any errors during or after a migration.

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

Monitor a data move

Open all   |   Close all

Before you begin

To review data for a user or your organization:

  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 status of an individual user and review any errors

View user’s migration status 

You can review the progress of a user’s migration in the Status column.

If there’s an error, there might be an error description, error code, and a link to more information. You can also download an error report (details below). 

When the migration finishes, the word Complete appears in the Status column. To view data about a migration, point to Complete to review:

  • Items successfully migrated
  • Items that failed to migrate
  • Total items discovered

Review a user’s error report

During or after a migration, you can download an error report for one or more users to your Tasks list

  1. Under Migrations, select a user and click Moreand thenDownload user error report.
  2. If prompted, select the format of the report.

    This option might not be currently available to your organization.

  3. Click Download.
  4. If the Tasks list doesn’t open automatically with the downloaded report, at the top, next to the search box, click Tasks "".

    Where to click Tasks

  5. Under Your Tasks, click the link to open the file.
  6. (Optional) To view the status of tasks performed by other administrators, click Others’ Tasks.
  7. (Optional) To close your Tasks list, click Tasks "" again.
Check the status of all users and review any errors

You can also review the migration status of all users. There are 2 types of reports:

  • Migration item error report–Details any email or calendar items that didn’t migrate. You can email or download this report. If you choose to email the report, there is a 2,000 item limit. There is no item limit if the report is downloaded. If the report has more than 2,000 items, you can review items that didn’t migrate in each user’s individual error report instead. For details, go to Check the status of an individual user (above).
  • Domain migration report–Contains the status of all users and is organized by the type of data you're migrating, for example, email or contacts data. You can email this report. 

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

Option 1: Email the reports

Use this option to email the both reports to selected recipients.

  1. Under Migrations, click Moreand thenEmail reports.
  2. Choose the recipients of the reports:
    • To send the reports to super administrators in your organization, select Send to Super Admins. Learn more about super administrators.
    • To send the reports to the role account for the migration, select Send to Source Role Account. This option is only available when using a role account. Learn more about role accounts.
    • To send the reports to specific email addresses, select Additional Recipients and enter the email addresses.
  3. Click Send.

Option 2: Download the migration item error report

This option might not be currently available to your organization. 

Use this option to download the report to your Tasks list

  1. Under Migrations, click Moreand thenDownload the migration item error report.
  2. Select the format of the report and click Download.
  3. If the Tasks list doesn’t open automatically with the downloaded report, at the top, next to the search box, click Tasks "".

    Where to click Tasks

  4. Under Your Tasks, click the link to open the file.
  5. (Optional) To view the status of tasks performed by other administrators, click Others’ Tasks.
  6. (Optional) To close your Tasks list, click Tasks "" again.

Understand migration reports

Open all   |   Close all

Email domain migration report
Field Description
Google Workspace 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 migrated since the migration started.
Number of emails failed Number of emails that did not migrate.
Total estimated number of emails to be migrated An estimation of the total number of emails to 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 emails migrated since the migration started.
Number of days worth of emails pending Number of days worth of emails still to be migrated.
Number of emails too big Number of emails that did not migrate because of their size.
Number of emails un-openable Number of emails that were unsuccessful because of an invalid format.
Number of unknown errors Number of emails that did not migrate for unknown reasons.
Contacts domain migration report
Field Description
Google Workspace 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 migrated since the migration started.
Number of contacts failed Number of contacts that did not migrate.
Calendar domain migration report
Field Description
Google Workspace 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 migrated since the migration started.
Number of events failed Number of calendar events that did not migrate.
Total estimated number of events to be migrated An estimation of the total number of calendar events to be 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
Field Description
Google Workspace username Email address of the user.
Item type Type of item that did not migrate.
Item ID ID of item that did not migrate.
Parent folder Name of item’s parent folder that did not migrate.
Sent time (email) Time the email was sent.
Start time (calendar) Time the calendar event started or is scheduled to start.
Error code Error code associated with the unsuccessful item. Learn more about error codes.
Error details Details on the type of error associated with the unsuccessful item. Learn more about error messages.
Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue

true
Start your free 14-day trial today

Professional email, online storage, shared calendars, video meetings and more. Start your free Google Workspace trial today.

Search
Clear search
Close search
Google apps
Main menu
Search Help Center
true
73010
false