Understand the new data migration service reports

The new data migration service is currently in public beta and is subject to the "Pre-general availability offerings terms" section of the Google Workspace Service-Specific Terms.

When migrating data with the new data migration service, you can access reports to get detail on migrated items. The 2 types of reports are a migration report and a user report.

Access the reports

1. To download the reports in CSV format, in your Google Admin console of your target account, click Download migration report or Download user report.
2. If the Tasks list doesn't open automatically with the downloaded report, click Tasks .
3. For Your Tasks, click the link to open the file.

Interpret the migration report

The migration report gives detail on migrated items. You can use the report to identify items that didn't migrate and the reasons for the failure.

Error report field	Description
Status	The migration status of the item (skipped, warning, error, success)
Error/warning code & description	The code and message associated with the error or warning status. For help with frequently seen error messages, go to Common error messages (later on this page).
Processing start time	Start time of the migration of the item
Processing end time	End time of the migration of the item
Source type & source identifier	Gmail message—users/user_email/messages/message_id Gmail message crawler—users/user_email Gmail label—users/user_email/labels/label_id Gmail label crawler—users/user_email Source URI—Full header (message-ID) of a message from the source account
Target type & target identifier	Gmail message—users/user_email/messages/message_id Gmail label—users/user_email/labels/label_id

Common error messages

If you get an error that is not mentioned in this table, try running a delta migration.

Error message	Description & troubleshooting help
User not found	A user in the migration map wasn't found. Either the domain or the username is incorrect. Remove the current migration map, correct the map, and upload again. For details, go to Create & upload a migration map.
Virus or other attachment problem	Gmail blocks messages that might spread viruses, such as messages that include executable files or certain links. For more information, go to File types blocked in Gmail.
Connection not in usable state	Your connection contains errors and is no longer in a usable state. Disconnect the current connection and create a new connection making sure you complete the authorization steps. For details, go to Run a migration.
All required OAuth scopes have not been granted access	Some or all of the required OAuth scopes haven't been granted domain wide delegation. Disconnect the current connection and create a new connection making sure you complete the authorization steps. For details, go to Run a migration.
Error occurred while generating user credential	An internal error that can occur when generating a user credential. It is likely to be transient. Run a delta migration to retry the failed tasks. For details, go to Run a delta migration.
Invalid user provided in migration mapping	A user email ID in the migration map is invalid or is not a Google email ID. Remove the current migration map, correct the map, and upload again. For details, go to Create & upload a migration map.
User provided in migration mapping does not belong to a workspace customer	A user email ID in the migration map is not a Google Workspace email ID. Remove the current migration map, correct the map, and upload again. For details, go to Create & upload a migration map.
User provided in migration mapping does not belong to the source workspace customer	A user email ID in the migration map doesn't belong to the source account. Remove the current migration map, correct the map, and upload again. For details, go to Create & upload a migration map.

Understand the user report

The user report provides a count for each user of the success or failure of their email migration.

User summary report field	Description
Source user	Email address of the user on the source account
Target user	Email address of the user on the target account
Status	Status of the user’s migration: Running—Migration is in progress Failed—Migration didn’t complete because of discovery issues. To troubleshoot, check the migration report for the specified error. Completed—Migration completed successfully. Any messages or labels that didn’t migrate are listed in the migration report.
Emails migrated successfully	Number of messages migrated successfully for the user (including messages that were skipped in an earlier migration)
Emails failed	Number of messages that failed to migrate for the user