- Export the reports
- Understand the summary report
- Interpret the migration report
- Resolve common error messages
Export the reports
After you run a chat migration, you can download the 2 reports in the Google Admin console of your target account.
You must be signed in as a super administrator for this task.
-
Sign in with a super administrator account to the Google Admin console.
If you aren’t using a super administrator account, you can’t complete these steps.
- To export the reports to Google Sheets, click Export migration report or Export summary report.
If the amount of data in the report exceeds the limit allowed in Sheets, the report is downloaded as a comma-separated values (CSV) file.
- If the Tasks list doesn't open automatically with the downloaded report, click Tasks
.
- For Your Tasks, click the link to open the file in Sheets.
Understand the summary report
The summary report provides a count of the number of messages that migrated or failed to migrate for each channel.
| Summary report field | Description |
|---|---|
| Team ID | The ID of the team. |
| Channel ID | The ID of the channel. |
| Space ID | The ID of the new Google Chat space. If a Chat space wasn't created, the report value is missing. |
| Migration status | Status of the chat migration:
|
| Messages migrated | Number of messages and replies that migrated successfully. |
| Messages failed | Number of messages and replies that failed to migrate. To troubleshoot, check the migration report. |
| Messages skipped | Number of messages and replies that were skipped and not migrated. |
| Discovery issues | The number of failures encountered by the system when crawling the source channel. |
Interpret the migration report
Use the migration report to identify messages 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 Troubleshoot 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 | The source item (such as, team, channel, channel metadata, channel memberships, or message). |
| Source identifier | ID of the source item. |
| Source URI | URI of the source item. |
| Target type | The target item (such as, space, space metadata, space memberships, or message). |
| Target identifier | ID of the item being migrated to the target account. |
| Target URI | URI of the target item. |
Resolve common error messages
If you get an error that's not mentioned in this table, try running a delta migration.
| Error message | Description & troubleshooting help |
|---|---|
| Can't migrate the entire thread. Google Chat can only migrate the first 500 messages. | The thread exceeds Chat's 500 message limit. Only the first 500 messages were migrated. |
| Can't find [email address] in your Workspace account. |
Verify the following issues:
|
| Can't migrate a team without an owner. Assign an owner in Microsoft Teams then try again. | The source team doesn’t have an owner. Assign an owner to the team and try again. |
| Can't find user's email address. Enter an email for this user in your Microsoft Teams account then try again. | Check that all members of the source team have valid email addresses. |
| Can't complete migration because one or more spaces are no longer available. Start a new migration to create spaces. | This error is likely to occur when the space was not rolled out in the allocated time period. For details, go to Make spaces & messages available to users. |
| Can't match the Microsoft Teams ID to an existing team. Check the ID in your migration map and try again. | Your migration map contains a Teams ID that is not valid. Check the migration map and try again. |
| Google Chat is turned off for your Workspace account. Turn on Chat services and try again. | The Google Chat service is turned on for the users in your target account. For details, go to Turn a service on or off for Google Workspace users. |
Google, Google Workspace, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.
