Edit

Share via


Reports and codes for cloud migrations

Migration Manager generates a series of logs and reports for scan/migration tasks in cloud migration scenarios such as Google Drive, Dropbox, Box, and Egnyte.

A scan/migration task presents as a row in the Migration Manager scan/migration list. Normally, a task equals:

  • Google Drive: Personal or Shared Drive
  • Dropbox: Member or Team folder
  • Box: User, Admin, or Co-admin
  • Egnyte: Private or Shared folder

Reports

There are four types of reports to help manage, audit, and troubleshoot your migration process.

Important

These reports are for cloud migrations only. For file share migrations, learn more at: Reports and errors for file share migrations.

These reports expire in 90 days. Microsoft doesn't retain the log files.

Codes

Your reports may reference a status or failure code to provide specific details as to the nature of the issue.

  • Status codes: Provide the final status of the scan and migration tasks. Status codes can be located in scan/migration summary reports.
  • Failure codes: Represent file-level errors during both the scan and migration process. Failure codes can be located in ResultCode column of scan/migration detailed reports.

How to download reports

Detailed and summary reports of your scan and migration tasks can be downloaded individually or in bulk.

There are limits on the number of tasks can be selected for bulk download for each report type:

Report type Number of tasks allowed per download
Scan summary report 5,000
Scan detailed report 500
Migration summary report 5,000
Migration detailed report 500

Note

For each report type, only one can be processed at a time. For example, there can’t be two scan summary reports running simultaneously.

The option to download all summary reports when no drives are selected is disabled. To download multiple summary reports efficiently, use the multi-select or select-all function on tasks.

Download Scan reports

  1. On the Scan tab, select one or more rows listed in the table. Each row in the table represents a scan task.

  2. From the action bar, select Download reports. Then select either Detailed or Summary depending on the type of report you need.

    Dropdown menu for downloading either detailed or summary reports.

  3. You can access reports you've requested by selecting Recent actions icon from the menu bar at the top right of the screen. Reports generated can be accessed for up to seven days.

Download Migration reports

  1. On the Migration tab, select one or more rows from the list of migration tasks. Each row in the table represents a migration task.
  2. From the action bar, select Download reports. Then select either Detailed or Summary depending on the type of report you need.
  3. You can access reports you've requested by selecting Recent actions icon from the menu bar at the top right of the screen. Reports generated can be accessed for up to seven days.

Scan reports

The following reports are downloaded from the Scans tab in Migration Manager.

Scan detailed report

Scan detailed report consists of one csv file:

File name Description
TransactionItem.csv. This file contains the details of the last scan for all items.

Scan TransactionItem.csv

The TransactionItem.csv report details the last scan for all items. Each row in the .csv file represents an item of the selected task.

Column Description
TaskId ID of the selected task, used for debugging.
TransactionId Whenever a task is run, it becomes a transaction. The transaction ID is used for debugging.
Name Display name of the source account.
SourcePath Source path of the selected source account.
OperationStep Operation step of the item.
Status Final scan status of the item. Skipped indicates the scan is complete and the item is ready to be migrated.
ResultCode Failure code of the item. A value of None shows in this column when the item status is Success. For a listing of all result codes, see Failure codes.
FailureReason Description of the failed item. This column is blank if the item status has a value of Success. For a listing of all result codes, see Failure codes.
FullPath Full path of the item in the source.
SourcePathDepth Path depth of the item in the source.
SourceBasename Base name of the item in the source. If the item is a root folder, this column is blank.
SourceExtension File extension of the item in the source. If the item is a root folder, this column is blank.
SourceType Type of folder in the source.
SourceSize Data size of the item in the source.
SourceAclsTotal The number of users and groups with whom the item is shared.
SourceAclsUnique The number of users and groups with whom the item is shared and that is different from its parent.
DestinationPath Full path of the item in the destination.
DestinationPathDepth Path depth of the item in the destination.
DestinationBasename Base name of the item in the destination. If the item is a root folder, this column is blank.
DestinationExtension File extension of the item in the destination. If the item is a root folder, this column is blank.
DestinationLocation The web URI of the item in destination.
DestinationType File or folder in the destination.
DestinationSize Data size of the item in the destination.

Scan summary report

The scan summary report consists of 5 .CSV files:

File name Description
FileExtension.csv Provides the statistics of extension types existing in each task.
LargeFileSize.csv Lists all items larger than 15 GB that can't be migrated.
LongPath.csv Lists all items with path lengths larger than 300 characters and that can't be migrated.
ProjectError.csv Lists all item level errors that occurred during the scan process of all tasks.
ScanSummary.csv Task level summary of all scan tasks. You can find the scan results based on the scan status code listed.

FileExtension.csv

The FileExtension.csv report details the extension types in each task.

Column Description
TaskId ID of the selected task, used for debugging. 
Name Display name of the selected task in the source. 
SourcePath Source path of the selected task. 
FullPath Full path of the item in the source. 
SourceExtension Extension type exists in the task. 
TotalSize Total data size of the extension type in the task. 

LargeFileSize.csv

The LargeFileSize.csv report details all items larger than 15 GB that can't be migrated.

Column Description
TaskId ID of the selected task, used for debugging.
Name Display name of the selected task in the source.
SourcePath Source path of the selected task.
FullPath Full path of the item in the source.
SourceSize Data size in Byte of the item in the source.
SourceSizeInGB Data size in GB of the item in the source.

LongPath.csv

The LongPath.csv report details all items with path lengths larger than 300 and that can't be migrated.

Column Description
TaskId ID of the selected task, used for debugging.
Name Display name of the selected task in the source.
SourcePath Source path of the selected task.
FullPath Full path of the item in the source.
SourcePathLength Path length of the item in the source.

Scan ProjectError.csv

The ProjectError.csv report details all item level scan errors.

Column Description
TaskId ID of the selected task, used for debugging.
Name Display name of the selected task in the source.
SourcePath Source path of the selected task.
FullPath Full path of the item in the source.
Action Operation step of the item that goes wrong during the scan process.
ResultCode Failure code of the item. It shows Null when item status is Success. To learn more, see Failure codes.
FailureReason Primary reason for the task failing the scan.

ScanSummary.csv

The ScanSummary.csv report is a task level summary of all scan tasks.

Column Description
TaskId ID of the selected task, used for debugging.
StartTime Start time of the latest scan, expressed in UTC.
EndTime End time of the latest scan, expressed in UTC.
TransactionId Every time when task is run, it's a transaction. Transaction ID is used for debugging.
Name Display name of the selected task in the source.
SourcePath Source path of the selected task.
Tags Predefined tags of the task.
FoldersReadyToBeMigrated Number of folders that are ready to be migrated.
FilesReadyToBeMigrated Number of files that are ready to be migrated.
DataReadyToBeMigrated Data size in Byte that is ready to be migrated.
UniquePermissions Number of users and groups with whom the item is shared and that is different from its parent.
MaximumPathLength The max path length among all the items in the source.
FoldersScanned Number of folders scanned in the source.
FilesScanned Number of files scanned in the source.
DataScanned Data size in Byte that scanned in the source.
ScanStatusCode Scan status code of the scanned task. To learn more, see Status codes.
MostRecentScan The most recent scan time in UTC of the task.

Migration reports

Migration detailed report

Migration detailed report consists of 1 csv file:

File name Description
TransactionItem.csv Lists the final migration status of all items of the selected task.

Migration TransactionItem.csv

The TransactionItem.csv report details the final migration status for all items of the selected task. Each row in the .csv file represents an item of the selected task.

Column Description
TaskId ID of the selected task, used for debugging.
TransactionId Every time when task is run, it becomes a transaction. Transaction ID is used for debugging.
Name Display name of the source account.
SourcePath Source path of the selected source account.
OperationStep Operation step of the item.
Status Final migration status of the item.
ResultCode Failure code of the item. It shows None when item status is Success. To learn more, see Failure codes.
FailureReason Failure description of the failed item. If the item status value is Success, this column is left blank. To learn more, see Failure codes.
FullPath Full path of the item in the source.
SourcePathDepth Path depth of the item in the source.
SourceBasename Base name of the item in the source. If the item is a root folder, this column is blank.
SourceExtension File extension of the item in the source. If the item is a root folder, this column is blank.
SourceType Type of folder in the source.
SourceSize Data size of the item in the source.
SourceAclsTotal The number of users and groups with whom the item is shared.
SourceAclsUnique The number of users and groups with whom the item is shared and that is different from its parent.
DestinationPath Full path of the item in the destination.
DestinationPathDepth Path depth of the item in the destination.
DestinationBasename Base name of the item in the destination. If the item is a root folder, this column is blank.
DestinationExtension File extension of the item in the destination. If the item is a root folder, this column is blank.
DestinationLocation The web URI of the item in destination.
DestinationType File or folder in the destination.
DestinationSize Data size of the item in the destination.

Migration summary report

Migration detailed report consists of two .CSV files:

File name Description
ProjectError.csv Lists all item level errors that ever occurred during the migration process of all tasks.
Migration summary.csv Task level summary of all migration tasks.

Migration ProjectError.csv

The Projecterror.csv report details all item level errors that ever occurred during the migration process of all tasks.

Column Description
TaskId ID of the selected task, used for debugging.
Name Display name of the selected task in the source.
SourcePath Source path of the selected task.
FullPath Full path of the item in the source.
Action Operation step of the item that goes wrong during the migration process.
ResultCode Failure code of the item. It shows Null when item status is Success. To learn more, see Failure codes.
FailureReason Failure description of the failed item. If the item status is Success, this column is blank. To learn more, see Failure codes.

Migration Summary.csv

The Migration Summary.csv report is a task level summary of all migration tasks.

Column Description
TaskId ID of the selected task, used for debugging.
TransactionId Every time when task is run, it's a transaction. Transaction ID is used for debugging.
StartTime Start time of the latest migration, expressed in UTC.
EndTime End time of the latest migration, expressed in UTC.
Name Display name of the selected task in the source.
SourcePath Source path of the selected task.
Tags Predefined tags of the task.
StatusCode Status code of the migration task. To learn more, see Status codes.
FoldersCreated Folder created in the destination for the migration.
FilesTotalCopied To date, the total files migrated to the destination from all migrations ever initiated.
FilesLatestCopied Files that migrated to the destination in the latest migration.
FilesAlreadyCopied Files already migrated to the destination from previous migrations or already exist in the destination.
FilesFiltered Files not migrated due to migration filter setting.
FilesFailed Files that failed in the migrating process.
DataTotalCopied Total data size (in bytes) migrated to the destination from all migrations ever initiated.
DataLatestCopied Data size (in bytes) migrated to the destination in the latest migration.
DataAlreadyCopied Data size (in bytes) already migrated to the destination from previous migrations or already existing in the destination.
DataFiltered Data size (in bytes) not migrated due to migration filter setting.
DataFailed Data size (in bytes) that failed in the migrating process.
FilePermissions File-level permission migration is set to be on or off. The default setting is Off.

Status codes

Status codes provide the final status of the scan and migration tasks. Status codes can be located in scan/migration summary reports.

Status Code Scan/Migration Task Status Message
100 Ready to migrate/Copied to migrate/Completed Success
101 Ready to migrate/Copied to migrate/Completed Success. No files needed copying.
102 Ready to migrate/Copied to migrate/Completed Success. Some files aren't supported by Destination name and weren't transferred.
120 Ready to migrate/Copied to migrate/Completed Success. Some files aren't supported by Source name and weren't transferred.
122 Ready to migrate/Copied to migrate/Completed Success. Some unsupported files existed and weren't transferred.
201 Warning Some upload errors. Download and look up the detailed report before trying again.
202 Warning No files copied. Some upload errors. Download and look up the detailed report before trying again.
210 Warning Some download errors. Download and look up the detailed report before trying again.
220 Warning No files copied. Some download errors. Download and look up the detailed report before trying again.
211 Warning Some download and upload errors. Download and look up the detailed report before trying again.
222 Warning No files copied. Some download and upload errors. Download and look up the detailed report before trying again.
230 Canceled Canceled.
250 Failed Already running. Wait a while and try again.
260 Failed Storage Quota Exceeded on Destination name.
261 Failed Quota API Exceeded on Destination name.
300 In progress Running.
302 In progress Waiting for Microsoft batch processing.
303 In progress Waiting for Forms migration.
400 Failed General failure. Try again.
401 Failed Couldn't upload anything. Try again.
402 Failed Connector authorization failed. Try reauthorizing Source name or Destination name.
403 Failed No status. Try again.
404 Failed Crashed. Try again.
405 Failed Crashed. Try again.
410 Failed Couldn't connect to Source name. Try reauthorizing.
423 Failed Source connector not found. Try again.
430 Failed Microsoft 365 authentication details have changed. Sign out and back in to the Microsoft Admin Center, then restart the task in Migration Manager.
490 Failed Ended by company name Admin. Try again.
491 Failed Microsoft migration reporting communication failure. Try again.
500 Failed Unknown, contact support.
600 Queued Queued to start.
601 Queued Queued to start.
620 In progress Running prechecks.

Failure codes

Failure codes represent file-level errors during both the scan and migration process. Failure codes can be located in ResultCode column of scan/migration detailed reports.

Failure code Description User action
MACCESSDENIED User denied access. Check permissions and Try again...
MACCESSTOKENNULL Failed to execute request as connector authorization failed. Unexpected error. Try again.
MAUTHACCESSTOKEN Connector authorization failure. Failed to get access token. In Migration Manager, go to Project Settings > Project Details, disconnect the source, reconnect to the source, and rerun the migration task.
MAUTHACCESSTOKENINVALID Connector authorization failure. The API request failed because the access token is invalid or expired. Go to Google Admin Console, select Apps -> Google Workspace -> Service Status. Then, change the service status of "Drive and Docs" to ON for everyone.
MAUTHCALLERNOTAUTHENTICATED Connector authorization failed. The service isn't allowing to connect as it doesn't recognize the caller. In Migration Manager, go to Project Settings > Project Details, disconnect the source, reconnect to the source, and rerun the migration task.
MAUTHMOVERAPP Microsoft 365 migration app needs to be authorized in source account. In Migration Manager, go to Project Settings > Project Details, disconnect the source, reconnect to the source, and rerun the migration task.
MAUTHNOCODE Connector authorization failed as auth code isn't provided. In Migration Manager, go to Project Settings > Project Details, disconnect the source, reconnect to the source, and rerun the migration task.
MAUTHNOEMAIL Connector authorization failure. Failed to get email from claim. In Migration Manager, go to Project Settings > Project Details, disconnect the source, reconnect to the source, and rerun the migration task.
MAUTHNOIDTOKEN Connector authorization failure. Failed to get ID token from access token. In Migration Manager, go to Project Settings > Project Details, disconnect the source, reconnect to the source, and rerun the migration task.
MAUTHNOTENANT Connector authorization failed; no tenant/enterprise ID found. Tenant = Enterprise. Tenant is the term in MS/Azure and Enterprise is used by Box and others. In Migration Manager, go to Project Settings > Project Details, disconnect the source, reconnect to the source, and rerun the migration task.
MAUTHREFRESHTOKEN Connector authorization failure. Failed to get refresh token. Go to Google Admin Console, select Apps -> Google Workspace -> Service Status. Then, change the service status of "Drive and Docs" to ON for everyone.
MAUTHUSERNOTADMIN Connector authorization failed; user doesn't have admin role. In Migration Manager, go to Project Settings > Project Details, disconnect the source, reconnect to the source, and rerun the migration task.
MAZUREUPLOAD Failed to submit the migration job to Migration API after the files were uploaded to the Azure blob. Try again.
MBADREQUEST Bad request when operating on source or destination item. Unexpected error. Try again.
MCONNECTORNOTFOUND Connector not found in database. Check connector settings. Try again.
MCORRELATE Collection correlates missing source listing. Confirm source ___location, Try again...
MDESTINATIONNOTWRITABLE You don't have write access to the destination. Check permissions and Try again...
MDUPLICATE Duplicate. This file already exists in your destination ___location. Confirm file is in destination already.
MEMPTYMETADATA Unable to find metadata. Try again.
MEXPORTFILERESTRICTED This file is restricted, and can’t be migrated from the source. Check the sharing settings or legal restrictions of this file in the source.
MEXPORTFILEUNSUPPORTED Unsupported file type. You can't migrate this file from the source.
MEXPORTFILEUNSUPPORTEDMIMETYPE Unsupported file type. You can't migrate this file from the source. Check file at source.
MFAILEDGETROOTITEM Failed to get root folder listing. Set in both Google and Office 365 connector. Try again.
MFILEIMPORT This file type isn't supported in the destination ___location. Check source file.
MFILELOCKED File is locked, and can't download or get metadata. Unlock file. Try again.
MFILENAMELENGTH Filename exceeds maximum allowable length. Rename file and Try again...
MFILESIZEINCORRECT Downloaded file is smaller than expected. Check file for size and compare. Try again.
MGETFOLDERACLS Failure to get shared folder membership. Check folder permissions and Try again...
MHTTPCONNECTION Connection failure. Check your network and Try again...
MINVALIDEMAIL Invalid user email; unable to find user with that email. Check user name and Try again...
MINVALIDPAGESIZE The page size for connector pagination must be greater than zero. Try again.
MINVALIDPARENTID Item has no parent ID. ID-based connectors require the item to have a parent ID. Check file and Try again...
MINVALIDPATH Path is invalid. Check path and Try again...
MINVALIDRESPONSE Invalid response from API call. Try again.
MITEMPATHLENGTH Item path exceeds length restrictions. Check file path for length and Try again...
MLARGEFILESIZEEXPORT File exceeds maximum size for export from the source. Check file size.
MLARGEFILESIZEIMPORT File exceeds maximum allowed size for import into destination. Check file size.
MLISTGROUP API request to list groups for connector failed. This request may be caused by an invalid or throttling. Try again.
MLISTING Folder listing failed. Try again.
MLISTUSER Failure to get user listing. May be caused by an invalid requestor throttling. Try again.
MLOCKACQ Failed to acquire lock within time-out period and obtain new access token. Try again.
MNONDESTRUCTIVEOPTIONENABLED Unable to delete file or folder. Try again.
MNOPARENT Item doesn't have a parent item. Check file and Try again...
MNOTAFILE The path refers to something that isn't a file. Check the path and correct as necessary. Try again.
MNOTAFOLDER The path refers to something that isn't a folder. Check the path and correct as necessary. Try again.
MNOTFOUND Item not found. Check file and Try again...
MNOTIMPLEMENTED Method not implemented for connector. Try again.
MNOTPERMITTED Can't go to the folder level; can't perform actions outside a user's folder. Check permissions and Try again...
MNOTUSERORTEAMDRIVE Confirm that the name of the item in the source service matches what you have in the task's source path. Google Suite allows invisible characters to be added to item names. We advise that your rename the item in the source service to ensure there's no invisible characters and then use that same name in the task source path.
MOWNERNOTFOUND The original owner was removed or its information wasn't found. Reassign ownership of the file.
MPATHMALFORMED Invalid path format. Check your source and Try again...
MSERVICENOTAVAILABLE Service unavailable. Try again.
MSETITEMPERMISSION Failed to set permission. Failure may be caused by throttling. Try again.
MSOURCENOTREADABLE Unable to read the source directory. Confirm source ___location. Try again.
MSTORAGEQUOTAREACHED Storage quota exceeded for connector. Increase storage limit and Try again...
MTHROTTLE API requests made by connector are getting throttled. Try again.
MUNVERIFIEDPARENT Item doesn't have a verified parent item. Check file and Try again...
MUPDATEITEMPERMISSION Failed to remove permissions. Try again.
MUSERCOUNT Unexpected failure to get user count. Try again.
MUSERFORBIDDEN The current user doesn't have permission to access the file or folder. Check permissions and Try again...
MUSERINFONOTFOUND User account info not found. Check user info and Try again...
MUSERNOTFOUND User isn't found; User is either disabled or deleted. Check user and correct as necessary. Try again.
MUSERQUOTAREACHED User quota limit reached. Learn more: Microsoft Graph error responses and resource types.
MZEROBYTEFILESIZEIMPORT You can't import a 0-byte file to a connector. Check file and try again.
PFAIL Failed to set permission Check permissions and Try again...
PFAILUNSUP Unsupported file permissions not set. Check permissions and try again.
PSUCCESS Set permission successfully.
PUNSUP Unable to set permissions. Check permission settings and try again.
MJOBNOTCOMPLETED Migration job (upload package) isn't submitted or uploading isn't finished yet. Try again.
MJOBERROR Item level failure when processing the migration job (upload package). Check file name and content. Try again.
MJOBFATALERROR Failed to process the migration job (upload package). All items in the package are marked as failed. Try again.
MNOTSUPPORTED Forms migration under Google shared drives isn't supported.
MEMPTYUSERMAPPPING User identity mapping is empty. Update mapping and try again.
MEXCEEDFORMSQUOTA Failed to create new forms, due to the maximum number of forms reached. Reduce the number of forms to migrate, and try again.
MNOUSERINFO Failed to get Microsoft user info.
MGENERALEXCEPTION An error occurred when migrating forms from Google. Try again.
MQUICKXOR Integrity check failed for the large file. Try again. If the issue persists, submit a support ticket.