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.
When an organization migrates their on-premises file shares to Microsoft 365, Migration Manager generates log files, summary and task-level reports, and a performance report. Use these reports to help manage, audit, and troubleshoot your migration process.
Note
These reports are for file share migration only. For cloud migrations, learn more at: Reports and errors for cloud migrations
| Type | Report |
|---|---|
| Task level | Item Summary |
| Task level | Item Failure Report |
| Task level | Item Report |
| Task level | Scan Summary |
| Task level | Structure Report |
| Task level | Structure Failure Report |
| Task level | Structure Failure Summary |
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:
- To see the report on a task, select the task name from the list.
- Select Download task report. The report downloads after the task is complete.
Viewing summary reports:
- Select one or more completed tasks from the list. Select Summary report.
- An aggregate summary report is downloaded to your computer.
Download detailed task level reports via PowerShell
To download task level reports, run the following PowerShell cmdlet.
Download the PowerShell script and extract the files.
Run aggregatereports.ps1.
Enter your tenant credentials.
From the Task Filter pane, select how you want to filter your reports:
.The aggregated report zip file is found in the same folder as the PowerShell cmdlet.
Summary Report
The summary report is an aggregate report that lists all successfully completed, failed, and in-progress tasks.
- Aggregate Summary Report.csv. This report contains a single row of data that gives the total picture; including total size, number of files migrated, duration.
When assessing your migration jobs, we recommend that you first look at these summary reports.
| Column | Description |
|---|---|
| Task name | The friendly name of the migration task. |
| Status | The status of each task (success, failure, in progress, not started). |
| Source | The file path or URL of the ___location of the data being migrated. |
| Destination | The URL of the Site and library to where the data is being migrated. |
| 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 items | The total number of files and list items that were expected to migrate excluding those files and list items filtered out based on settings or potential scan issues. |
| Migrated items | The total number of files migrated. |
| Items not migrated | The number of files that didn't migrate. |
| Total bytes | The total number of bytes scanned in source destination. |
| Total GB | The total number of gigabytes scanned in source destination. |
| Migrated bytes | The total number of bytes of data migrated. |
| Migrated GB | The total size of the files migrated, expressed in gigabytes. |
| Agent | The address of the migration agent (virtual machine or computer) running the migration task. |
| Duration | The length of time in minutes the migration task took to complete. |
| TaskID | The unique ID of the task. |
| Task failure reason | An explanation of task failure. |
| Agent group | The name of agent group the task was assigned to. |
Task Reports
When you need to do a more in-depth investigation or a thorough verification of your migration task, the task level reports help you drill down into the specific details.
- ItemSummary.csv: A report similar to the overall summary report, except that it aggregates the data just for a single task.
- ItemFailureReport.csv: A 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: A report that gives statistical totals.
- StructureReport.csv: A structure report at the task level.
- StructureFailureReport.csv: A structure failure report at the task level.
- StructureFailureSummary.csv: 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, and so on). Indicates if the scan or job was rerun. |
| Scanned | The total number of files scanned before migration. |
| Item scan failures | The number of files that failed the scan and didn'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 on 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 that attempted to upload. |
| Reuploaded | The total number of files 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 umber 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: This report is only generated if an error resulting in a file being unable 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 the data is being 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 | Status indicating at what stage the file is. |
| Result category | General code associated with the item to indicate what happened with that item. |
| Message | A more detailed error or informational message. |
| Error code | 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 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, and so on). Indicates if the scan or job was rerun. |
| Task ID | The ID number of the Task. |
| Device name | Name of the device or computer that is running the migration job. |
Item Report
The ItemReport.csv is a detailed report that provides data on each file within the task.
| Column | 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 being 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 | Status indicating at what stage the file is. |
| Result category | General code associated with the item to indicate what happened with that item. |
| Message | A more detailed error or informational message. |
| 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 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, and so on.) Indicates if the scan or job was rerun. |
| Task ID | The ID number of the Task. |
| Device name | Name of the device or computer that is running the migration job. |
Scan Summary
The ScanSummary.csv report provides the total stats for the scan. This process that takes place before the actual migration begins.
| Column | Description |
|---|---|
| Incremental round | The round number added to the end of the report name (RO, R1, and so on). Indicates if the scan or job was rerun. |
| Total scanned items | Total number of folders, list items, and files scanned. |
| Total scanned folders | Total number of folders scanned. |
| Total scanned list items | Total number of list items scanned. |
| Total scanned files | 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 | Number of files that were filtered out based on settings in the tool. |
| Folders to be migrated | Number of folders to be migrated. |
| Items to be migrated | Number of files to be migrated. |
| Total items to be migrated | Total number of folders and files to be migrated. |
| Device name | Name of the device or computer that is 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 | Display name of the object |
| Operation | Skipped, created, or updated. |
| Status | Success, partial success, failure. |
| Details | Reason for failure. |
| Source structure URL | Displays the source URL. The URL is listed for site collections, sites, and lists. Fields, content types, and views display its container's URL. |
| Destination structure URL | Displays the destination URL. The URL is listed for site collections, sites, and lists. Fields, content types, and views display its container's URL. |
| Source structure ID | ID when available. |
| Destination structure ID | ID when available. |
| Time stamp | The time the action occurred. |
Structure failure report
This report lists the failures at the task level. This report is only generated if there's a failure.
| Column | Description |
|---|---|
| Structure type | Site collection, site, list, field, content type, view. |
| Structure title | Display name of the object |
| Operation | Skipped, created, or updated. |
| Status | Success, partial success, failure. |
| Details | Reason for failure. |
| Source structure URL | Displays the source URL. The URL is listed for site collections, sites, and lists. Fields, content types, and views display its container's URL. |
| Destination structure URL | Displays the destination URL. The URL is listed for site collections, sites, and lists. Fields, content types, and views display its container's URL. |
| Source structure ID | ID when available. |
| Destination structure ID | ID when available. |
| Time stamp | The time the action occurred. |
Structure failure summary
An aggregate of all the task failure reports. This summary is only generated if there are failures.
| Column | Description |
|---|---|
| Structure type | Site collection, site, list, field, content type, view. |
| Structure title | Display name of the object. |
| Operation | Skipped, created, or updated. |
| Status | Success, partial success, failure |
| Details | Reason for failure. |
| Source structure URL | Display the source URL. The URL is listed for site collections, sites, and lists. Fields, content types, and views display its container's URL. |
| Destination structure URL | Display the destination URL. The URL is listed for site collections, sites, and lists. Fields, content types, and views display its container's URL. |
| Source structure ID | ID when available. |
| Destination structure ID | ID when available. |
| Time stamp | The time the action occurred. |