After you set up a migration with the new data migration service, you can review the data for Data migration log events and Admin log events to verify configuration changes and check if an event occurred. For example, you can review if a connection was created or a migration started.
Check Data migration log events data
- Sign in with an administrator account to the Google Admin console.
If you aren’t using an administrator account, you can’t access the Admin console.
- Go to Menu Reporting > Audit and investigation > Data Migration log events .
Requires having the Audit & Investigation administrator privilege.
- Click Add Condition Attributeand select Event.
For a complete list of events, go to Event descriptions (later on this page). - Click Eventand select an event.
- Click Search.
Check Admin log events data
- Sign in with an administrator account to the Google Admin console.
If you aren’t using an administrator account, you can’t access the Admin console.
- Go to Menu Reporting > Audit and investigation > Admin log events .
Requires having the Audit & Investigation administrator privilege.
- Click Add Condition Attributeand select Event.
- On the side, click Events Migration events.
- Select an event and click Apply.
For a complete list of events, go to Event descriptions (later on this page).
Event descriptions
Data migration log events
The logged event can be one of these event types:
- Migration setup—An action that an administrator takes related to setting up the migration—for example, creating a connection, starting a migration, or exiting a migration.
- Migration—An action taken by the migration tool while the migration is in progress—for example, creating a Gmail label or creating a Google Drive file.
| Event name (Migration setup events) | Description |
|---|---|
| Start migration setup | Details about a target admin starting a new migration |
| Create connection Delete connection |
Details about created or deleted connections |
| Grant consent (source admins only) | Details about authorization consent granted by the source account admin |
| Request connection verification | Details about activating a connection or verification request sent to the source account admin |
| Create migration map | Details about the migration scope or identity map attached to a migration |
| Update migration settings | Details about changes to the migration settings |
| Start migration Stop migration Exit migration |
Details about started, stopped, or exited migrations |
| Start migration report download Start migration summary report download |
Details about downloaded migration reports |
| Event name (Migration events) | Description |
| Create space Create space message Create space membership |
Details about creating or updating a space, space message, or space membership |
| Go live space | Details about a space going live |
| Create gmail label Create gmail message |
Details about creating or updating a Gmail label or a Gmail message |
| Create file Create folder Create file version |
Details about creating or updating a Google Drive file, folder, or file version |
| Create calendar Create calendar event |
Details about creating or updating a calendar or event in Google Calendar |
| Crawl failure | Information about failures that occur while crawling source data such as a Gmail message or a Drive file. |
Admin log events
| Event name (source account admins) | Event description |
|---|---|
| Consent granted | Details about authorization consent granted by the source account admin |
| Event name (target account admins) | Event description |
| Connection created Connection deleted |
Details about created or deleted connections |
| Connection verification requested | Details about connection verification request sent to the source account admin |
| Migration setup started | Details about a target admin starting a new migration |
| Migration map created | Details about the migration map attached to a migration |
| Migration settings updated | Details about changes to the migration settings |
| Migration started Migration stopped Migration exited |
Details about started, stopped, or exited migrations |
| Migration report download started Migration summary report download started |
Details about exported migration reports |
Identifier descriptions
For some events, you see an identifier or metadata about the source or target object. For details about these identifiers, refer to the following tables.
Identifiers for Migration setup events
| Object type | Identifier | URI |
|---|---|---|
| Start migration |
Execution ID |
Wave ID, Execution type |
|
Stop migration
|
Execution ID |
Wave ID, Execution type |
|
Create connection
|
Connection ID |
Connection type, connection status, OAuth scopes (if applicable) |
|
Request connection verification
|
Connection ID |
Not applicable (N/A) |
|
Delete connection
|
Connection ID |
N/A |
|
Create migration map
|
Migration map ID |
Display name, map type (migration scope or identity map) |
|
Update migration settings
|
DataConfig ID |
Display name |
|
Exit migration
|
Wave ID |
N/A |
|
Start migration report download
|
Execution ID |
Wave ID |
|
Start migration summary report download
|
Execution ID |
Wave ID |
|
Start migration setup
|
Wave ID |
N/A |
|
Grant consent
|
Consent ID |
N/A |
Identifiers for Migration events
| Object type |
Identifier | URI |
|---|---|---|
| Channel |
Microsoft Teams channel identifier |
N/A |
| Channel message |
Microsoft Teams channel message identifier |
N/A |
| Channel message reply |
Microsoft Teams channel message reply identifier |
N/A |
| Channel membership |
Microsoft Teams channel membership identifier | N/A |
| Channel crawler |
Identifier for the team in Microsoft Teams whose channels are getting crawled | N/A |
| Channel message crawler |
Identifier for the Microsoft Teams channel that’s being crawled for messages | N/A |
| Channel message reply crawler |
Identifier for Microsoft Teams channel message that's being crawled for replies |
N/A |
| Channel membership crawler |
Identifier for the Microsoft Teams channel message that's being crawled for replies | N/A |
| Space |
Identifier for the space |
N/A |
| Space message |
Identifier for the space message | N/A |
| Space membership |
Identifier for the space membership |
N/A |
| Space disable migration mode |
Identifier for the space that will go live |
N/A |
| Team member crawler |
Identifier for the team in Microsoft Teams whose members are getting crawled |
N/A |
| Team member metadata |
Identifier for the the team in Microsoft Teams for whose members are being crawled |
N/A |
| Channel member metadata crawler |
Identifier for the the team in Microsoft Teams whose members’ metadata is being crawled | N/A |
| Gmail messages crawler |
Email ID of the user whose messages are being crawled | N/A |
| Gmail message |
Gmail user’s email ID and Gmail message ID | Rfc822 message ID |
| Gmail labels crawler |
Email ID of the user whose labels are being crawled | N/A |
| Gmail label |
Identifier containing the Gmail user’s email ID and Gmail label name | Name of the Gmail label |
| IMAP folder crawler |
Email ID of the user whose IMAP folders are being crawled |
N/A |
| IMAP folder |
Identifier containing the source IMAP user’s email ID and the IMAP folder name | N/A |
| IMAP message crawler |
Identifier containing the source IMAP user’s email ID and the name of the IMAP folder that's being crawled | N/A |
| IMAP message |
Identifier for the source IMAP message containing the source user’s email ID and message ID | Rfc822 message ID |
| OneDrive crawler |
Identifier containing the email ID of the Microsoft OneDrive user | N/A |
| OneDrive folder crawler |
Identifier for the OneDrive folder |
Link to source drive folder |
| OneDrive item |
Identifier for the OneDrive file or folder | Link to OneDrive file or folder |
| OneDrive file version |
Identifier for the OneDrive file |
Link to OneDrive file |
| OneDrive item permission crawler |
Identifier for the One Drive file or folder |
Link to OneDrive file or folder |
| OneDrive item permission |
Identifier for the OneDrive file or folder |
Link to OneDrive file or folder |
| Google Drive folder |
Identifier for the Drive folder |
Link to Drive folder |
| Google Drive file |
Identifier for Drive file |
Link to Drive file |
| Google Drive file version |
Identifier for the Drive file version | Link to Drive file |
| Exchange online email folder crawler |
Email ID of the mailbox whose folders are being crawled |
N/A |
| Exchange online email folder |
Identifier containing the Exchange user’s email ID and the Exchange folder name | Exchange folder name |
| Exchange online email message crawler |
Email id of the mailbox whose folders are being crawled |
N/A |
| Exchange online email message |
Identifier containing the Exchange user’s email ID and the Exchange folder name | Rfc822 message ID |
| Sharepoint Drive crawler |
SharePoint drive identifier | Link to SharePoint drive |
| Sharepoint folder crawler |
SharePoint folder identifier |
Link to SharePoint folder |
| Sharepoint item |
SharePoint file or folder identifier |
Link to SharePoint file or folder |
| Sharepoint file version |
SharePoint file identifier |
Link to Sharepoint file |
| Sharepoint item permission crawler |
SharePoint file or folder identifier |
Link to SharePoint file or folder |
| Sharepoint item permission |
SharePoint file or folder identifier | Link to SharePoint file or folder |
| Sharepoint site crawler |
Identifier for the SharePoint site whose subsites are being crawled |
N/A |
| Sharepoint site |
SharePoint site identifier |
Link to SharePoint site |
| Sharepoint document library crawler |
Identifier for the SharePoint site whose drives are being crawled | N/A |
| Sharepoint document library permission crawler |
Identifier for the SharePoint drive whose document library permission is being crawled | N/A |
| Sharepoint document library permission |
Identifier for the SharePoint drive that contains the document library permission migrator | Link to SharePoint drive |
| Sharepoint document library |
SharePoint drive identifier | Link to SharePoint drive |
| Exchange online calendar crawler |
Identifier containing the Exchange user’s email ID |
Calendar name |
| Exchange online calendar |
Identifier containing the Exchange user’s email ID and the source calendar ID | Calendar name |
| Exchange online calendar events crawler |
Identifier containing the Exchange user’s email ID and the source calendar ID | Calendar name |
| Exchange online calendar event |
Identifier containing the Exchange user’s email ID, source calendar ID, and source event ID | Event web URL |
| Google calendar |
Calendar user’s email ID and target Calendar ID | N/A |
| Google calendar event |
Calendar user’s email ID, target Calendar ID, and target event iCalUid | N/A |
Related topics
- Admin log events
- Data migration log events
- Data retention and lag times
- Understand email migration reports
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.
