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
Before you beginTo review data for a user or your organization:
-
Sign in to your Google Admin console.
Sign in using an account with super administrator privileges (does not end in @gmail.com).
-
From the Admin console Home page, go to Data migration.
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.
- Under Migrations, select a user and click More
Download user error report.
- If prompted, select the format of the report.
This option might not be currently available to your organization.
- Click Download.
- If the Tasks list doesn’t open automatically with the downloaded report, at the top, next to the search box, click Tasks
.
- Under Your Tasks, click the link to open the file.
- (Optional) To view the status of tasks performed by other administrators, click Others’ Tasks.
- (Optional) To close your Tasks list, click Tasks
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.
- Under Migrations, click More
- 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.
- 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.
- Under Migrations, click More
- Select the format of the report and click Download.
- If the Tasks list doesn’t open automatically with the downloaded report, at the top, next to the search box, click Tasks
- Under Your Tasks, click the link to open the file.
- (Optional) To view the status of tasks performed by other administrators, click Others’ Tasks.
- (Optional) To close your Tasks list, click Tasks
Understand migration reports
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. |
| 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. |
| 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. |
| 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. |
