Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
After you select Migrate, the progress of your migration task appears. As they complete, you can view either detailed or summary reports of an individual task or a single summary report that includes all migration jobs submitted during this session. To learn more, see Using the SharePoint Migration Tool Reports.
The SharePoint Migration Tool (SPMT) generates log files, summary reports, and task level reports. This information helps you manage, audit, and troubleshoot your migration process.
Monitor your migration
The migration job progress report shows the overall progress of the migration job. Users can:
- Pause and resume all migration tasks
- Check the time elapsed and time remaining
- Observe migration performance suggestions
The migration task progress report shows the progress of individual migration tasks. Users can:
Pause and resume a migration task
Delete a migration task
Check the time elapsed and the time remaining
Watch migration stats
View reports
How to view the reports
These reports can be viewed while the migration is taking place or after the jobs are complete.
Viewing task level reports:
- After the migration begins, select View reports.
- A file folder opens, listing the task-level reports generated for that specific task.
Viewing summary reports:
- After migration completes, select Migration details.
- A folder with the summary reports opens.
Summary Reports
Two types of summary reports are generated. The second type of summary report generated only if there are failures.
- SummaryReport.csv. This report contains a single row of data that gives the total picture total size, number of files migrated, and duration.
- FailureSummary.csv. This report is created only when failures or errors happen during the migration process.
When assessing your migration jobs, we recommend that you first look at these summary reports. If a FailureSummary.csv file wasn't created, then no failures occurred during the task run.
Summary Report
| Column | Description |
|---|---|
| Source | The file path or URL of the location of the data being migrated. |
| Destination | The URL of the Site and library the data is migrated to. |
| Status | Status of each task (Success, Failure, In progress, Not started). |
| Total bytes | The total number of bytes scanned in the source destination. |
| Total GB | The total number of gigabytes scanned in the source destination. |
| Count of files | The total number of scanned items. |
| Migrated bytes | The total number of bytes of data migrated. |
| Migrated GB in current round | The total size of the files migrated, expressed in gigabytes. |
| GB not migrated in current round | The total size of the files not migrated, expressed in gigabytes. |
| Total scanned items | The total number of files and list items, including those files and list items filtered out because of settings or potential scan issues. |
| Total to be migrated in current round | The total number of files that were expected to migrate, excluding those files filtered out based on settings or potential scan issues. |
| Migrated items in current round | The total number of files migrated. |
| Items not migrated in current round | The number of files that didn't migrate. |
| Warning count in current round | The number of warnings generated. |
| Start time | The time the migration task began. |
| End time | The time the migration task ended. |
| Duration | The length of time in minutes that the migration task took to complete. |
| GB/hour | How many gigabytes migrated per hour. |
| Round number | The incremental number of times the report was generated based on the multiple passes the tool made to get all the content it could into the destination. |
| Workflow ID | The ID number of the migration workflow. Many tasks can be in a single workflow. |
| Task ID | The individual task number. |
| Log Path | The location of the log files for each task. |
Failure Summary Report
This report is only generated if a failure occurs during the job run.
| Column | Description |
|---|---|
| Source | The file path or URL of the location of the data being migrated. |
| Destination | The URL of the site and library the data is migrated to. |
| File name | The failed file or folder name or list items. |
| Extension | If it's a folder, then the extension is empty. If it's a file, then the extension is the file extension. |
| File size | The failed file or folder size or item size. |
| Content type | Folder or file. |
| Status | The status of the file or folder that shows as "Failed" in this report. |
| Result category | The failed reason category based on the job process. |
| Message | The failed reason detail description. |
| Error code | The failed reason errorcode. |
| Package number | The package number for the package, including the failed item. |
| Migration job ID | The job ID for the package, including the failed item. |
| Incremental round | The last incremental round number that item failed. |
| Task ID | The individual task number. |
| Device name | The name of the device or computer running the migration job. |
Task Reports
When you need to do a deeper investigation or a thorough verification of your migration task, the task level reports help you drill down into the specific details. The four recommended task level reports to use are:
- ItemSummary.csv: This report is similar to the overall summary report except that it aggregates the data just for a single task.
- ItemFailureReport.csv: The failure report at the item level. This report is a filtered version of the files report, showing only failures.
- ItemReport.csv: A list of all the items this task attempted to do.
- ScanSummary.csv: This report gives statistical totals.
- StructureReport.csv: A structured report at the task level.
- StructureFailureReport.csv: A structured failure report at the task level.
- StructureFailureSummary.csv: This report is an aggregate of all the structural task failure reports. This report is only generated if there are failures.
Item Summary
The ItemSummary.csv report is a summary report at the task level.
| Column | Description |
|---|---|
| Incremental round | The round number added to the end of the report name (RO, R1, etc.). It indicates if the scan or job was rerun. |
| Scanned | Total number of files scanned before migration. |
| Item scan failures | The number of files that failed the scan and don't qualify for the migration. |
| Filtered out items | The number of files not included in migration. |
| Expected migrated file count | The total number of files expected to migrate, excluding those files filtered out based settings or scanned potential issues. |
| Read | The total number of files read. |
| Packaged | The total number of files packaged and ready to upload to the destination. |
| Uploaded | The total number of files attempted to upload. |
| Reuploaded | The total number of files that were reuploaded. |
| Submitted | The total number of files submitted. |
| Resubmitted | The total number of files resubmitted. |
| Migrated | The total number of files migrated. |
| Failed reading | The number of files that encountered an error or failure while being read. |
| Failed packing | The number of files that encountered an error or failure while being packaged. |
| Failed uploading | The number of files that encountered an error or failure while being uploaded. |
| Failed submitting | The number of files that encountered an error or failure while being submitted. |
| Failed querying | The number of files that encountered an error or failure while being queried. |
| Device name | The name of the device or computer running the migration job. |
Item Failure Report
The ItemFailureReport.csv report is only generated if an error resulting in a file being unable to migrate or failing to migrate.
| Column | Description |
|---|---|
| Source | The file path or URL of the location of the data being migrated. |
| Destination | The URL of the tenant and library where the data is migrated to. |
| Item name | The name of the file migrated. |
| Extension | The extension, indicating the file type. |
| Item size | The size of the individual file. |
| Content type | The file type. |
| Status | The status indicating at what stage the file is at. |
| Result category | The general code associated with the item to indicate what happened with that item. |
| Message | A detailed error or informational message. |
| Error code | The failed reason error code. |
| Source item ID | The ID of the item at the source. |
| Destination item ID | The ID of the item at the destination. |
| Package number | The ID generated for the package number during the transition. |
| Migration job ID | The ID number of the job (which could contain one or more tasks). |
| Incremental round | The round number added to the end of the report name (RO, R1, etc.). It indicates if the scan or job was rerun. |
| Task ID | The ID number of the task. |
| Device name | The name of the device or computer running the migration job. |
Item Report
The ItemReport.csv is a detailed report that provides data on each file within the task.
| Column name | Description |
|---|---|
| Source | The file path or URL of the location of the data being migrated. |
| Destination | The URL of the tenant and library the data is migrated to. |
| File name | The name of the file migrated. |
| Extension | The extension, indicating the file type. |
| File size | The size of the individual file. |
| Content type | The file type. |
| Status | The status indicating at what stage the file is at. |
| Result category | The general code associated with the item to indicate what happened with that item. |
| Message | A more detailed error or informational message generated. |
| Source item ID | The ID of the item at the source. |
| Destination item ID | The ID of the item at the destination. |
| Package number | The ID generated for the package number during the transition. |
| Migration job ID | The ID number of the job (which could contain one or more tasks). |
| Incremental round | The round number added to the end of the report name (RO, R1, etc.). It indicates if the scan or job was rerun. |
| Task ID | The ID number of the Task. |
| Device name | The name of the device or computer running the migration job. |
Scan Summary
The ScanSummary.csv report provides the total stats for the scan. The scan process takes place before the migration begins.
| Column | Description |
|---|---|
| Incremental round | The round number added to the end of the report name (RO, R1, etc.). It indicates if the scan or job was rerun. |
| Total scanned items | The total number of folders, list items, and files scanned. |
| Total scanned folders | The total number of folders scanned. |
| Total scanned list items | The total number of list items scanned. |
| Total scanned files | The total number of files scanned. |
| Folders with issues | The number of folders with potential issues for the migration. |
| Items with issues | The number of files with potential issues for migration. |
| Items filtered out | The number of files filtered out based on settings in the tool. |
| Folders to be migrated | The number of folders migrated. |
| Items to be migrated | The number of files migrated. |
| Total items to be migrated | The total number of folders and files migrated. |
| Device name | The name of the device or computer running the migration job. |
Structure report
Structure report at the task level.
| Column | Description |
|---|---|
| Structure type | Site collection, site, list, field, content type, view. |
| Structure title | The display name of the object. |
| Operation | Skipped, created, or updated. |
| Status | Success, partial success, failure. |
| Details | The reason for failure. |
| Source structure URL | Displays the source URL. Site collection, site, and list are going to display the URL. Fields, content types. and views are going to display the URL of their containers. |
| Destination structure URL | Displays the source URL. Site collection, site, and list are going to display the URL. Fields, content types, and views are going to display the UR of their containers. |
| Source structure ID | The ID when available. |
| Destination structure ID | The ID when available. |
| Time stamp | The time the action occurred. |
Hub site report
| Column | Description |
|---|---|
| URL | The URL of the Sharepoint site. |
| HubSiteUrl | The URL of the hub site. This column is empty if the site isn't hub site. |
| Result | Registered/Associated/Failed. |
| Error | The error type. This column is blank if no error occurred. |
| Message | Error message. |
Performance report
This report provides scores ranging from 1 to 100. The greater the number, the higher the speed. While these scores can't predict how fast the migration performs, they can help identify areas that could be impacting your migration performance.
| Column | Recommendation |
|---|---|
| Reading source speed score |
Improving the speed at which the source can be read |
| Local disk performance score |
Improving the migration computer speed |
| Uploading speed score | Improving your connectivity to Office 365 and Azure |
| SharePoint throughput score | Improving your migration performance when using SPMT |