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 Data migration 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 view the status of a specific user with the following methods.

Status column

The progress of an individual user's migration is listed in the user's Status column in the Migrations table.

If the migration encounters an error, information is placed in the Status column. Depending on the error, there might be an error description, error code, and a link to more information.

When the migration finishes, the word Complete appears in the Status column. To view metrics about a migration, point to Complete in the Status column. A tooltip displays the following statistics:

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

Error report

During or after a migration, you can download an error report.

To request the report:

  1. Select a user and click Moreand thenDownload error report in the Migrations table.

  2. The file download is added to your Tasks list. If the Tasks list doesn’t open automatically, next to the search bar at the top of the Admin console, click Tasks Tasks.

    Where to click Tasks

  3. In Your Tasks, under Completed, click Download CSV.
  4. (Optional) To view the status of tasks executed by other administrators, click Others’ Tasks.
  5. (Optional) To close your Tasks list, click Tasks Tasks again.
Request domain-level migration reports

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

  • A domain migration report–Contains the status of all migrating users.
  • Item error report–Details any items that couldn't migrate.

To request the reports:

  1. Click Moreand thenEmail reports in the Migrations table.

  2. Choose the recipients of the reports:
    • Send to Super Admins–Reports are sent to the super administrators of your organization. Learn more about super administrators.
    • 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 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 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
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 migrated since the report was generated.
Number of contacts failed Number of contacts that did not 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 migrated since the report was generated.
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

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 did not migrate.
Item ID ID of item that did not migrate.
Parent folder Name of parent folder of item that did not migrate.
Sent time (email) The time the email was sent.
Start time (calendar) The time the calendar event is scheduled to start.
Error code Error code associated with the unsuccessful item. Learn more about Data migration service error codes.
Error details Details on the type of error associated with the unsuccessful item. Learn more about Data migration service error messages.
Was this helpful?
How can we improve it?