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:
-
Sign in to your Google Admin console.
Sign in using your administrator account (does not end in @gmail.com).
- 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 migrationTo see the progress of an individual user's migration, hover over the user's Status column. For a more detailed report, click Details.
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:
- Click Settings
> Migration Reports.
- 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.
- Click Send.
> Migration Reports.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. |
| 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. |
| 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. |
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. |
