OneDrive sync reports in the Apps Admin Center
The new OneDrive sync health dashboard in the Microsoft 365 Apps Admin Center provides IT admins with actionable insights about the OneDrive sync app. For small businesses to large enterprises, the dashboard is the single place to get information and take action on sync app adoption and health.
This feature is in preview and isn't available to everyone. Review the requirements to determine eligibility.
From the Sync health dashboard, admins can check the sync status and sync app version of individual devices, monitor Known Folder Move roll out, and track sync errors. The insights range from a high-level executive summary to a drill-down of sync status per device, to be used in various administrative scenarios.
OneDrive sync apps on the Insiders or Production ring. Devices on the Deferred ring aren't eligible for the preview. Set the sync app update ring.
OneDrive Sync app version 21.078 or later for Windows. Support for Mac isn't available yet.
Devices can reach the endpoint https://config.office.com.
Set up the OneDrive sync health dashboard
Make sure you have the required role and app versions listed in the previous section.
Go to https://config.office.com and sign in as a global admin or Office apps admin.
In the left pane, under Health, select OneDrive Sync. This tab has a "PREVIEW" tag on it.
Select Enable preview features to accept the license terms.
The OneDrive sync health dashboard appears.
In the left pane, select Settings.
Copy the Tenant Association Key. If the key field is empty, select Generate new key.
When you generate a new key for the first time, it can take up to 30 seconds for it to appear.
Enable the OneDrive SyncAdminReports Group Policy Object (GPO) using the Tenant Association Key.
- You must enable this setting on the devices from which you want to get reports. The setting has no impact on users.
- When a new Tenant Association Key is generated, update the registry setting as well.
- We recommend a gradual rollout starting with a few test devices per day, then up to 100 devices per day, then gradually up to 10,000 devices per day until you finish.
You can enable this setting in multiple ways:
Edit the registry
a. Go to HKLM\SOFTWARE\Policies\Microsoft\OneDrive
b. Right-click > New > String Value.
c. Name: SyncAdminReports
d. Type: REG_SZ
e. Data: Paste your Tenant Association Key.
Run Command Prompt as an administrator, and then run the following command:
reg.exe add HKLM\Software\Policies\Microsoft\OneDrive /v SyncAdminReports /t REG_SZ /d <your Tenant Association Key> /f
a. Open Group Policy Editor (gpedit.exe).
b. Go to Computer Configuration\Administrative Templates\OneDrive.
c. Double-click Sync Admin Reports.
d. Select Enabled, paste your Tenant Association Key in the box in the Options pane, and then select OK.
After you enable the SyncAdminReports setting on devices, it takes up to three days for reports to be available.
OneDrive Sync health dashboard
After you set up the dashboard as described in the previous section, the Global Reader admin role is sufficient to access and view reports.
The Overview tab provides aggregated insights on devices that have sync errors, Known Folder Move rollout status, and adoption of sync app versions and update ring.
The Details tab provides detailed info for each user and device to help you understand and troubleshoot sync errors.
The tab reports on the following diagnostic data:
- User: The name of the user
- User email: The email address of the user
- Computer name: The name of the device
- Errors: Details including the counts, and error messages users are seeing
- Known folders: Details including enabled status for each folder (Desktop, Documents, Pictures)
- OneDrive app version: The currently installed OneDrive sync app version
- Operating system version: The current version of the OS running on the device
- Last synced timestamp (UTC): The last time sync app was fully up to date with the cloud
- Last status reported timestamp (UTC): The last time the sync app reported its diagnostic data to the dashboard
Data for the OneDrive sync health dashboard
The sync reports use the required service data and diagnostic data that your OneDrive sync apps send to Microsoft. You are in control of which data and which devices send this data. Use the SyncAdminReports setting to control which devices send data.
Diagnostic data is always under your control. To learn more about diagnostic data and the controls available to you, see Overview of privacy controls for Microsoft 365 Apps. To learn more about required service data, see Required diagnostic data for Office.
Use this section to troubleshoot if the OneDrive sync reports don't appear after three days.
If you enable the SyncAdminReports setting on devices that don't meet the requirements, it will have no effect. The app won't send reports.
Confirm that the sync app is on the Insiders or Production ring. Run Command Prompt as an administrator, and then run the following command:
reg.exe query HKLM\Software\Policies\Microsoft\OneDrive /v GPOSetUpdateRing
If the output from the script is not
dword:00000000, your device is on the Insiders or Production ring.
Confirm that the SyncAdminReports setting is applied to the device. Run Command Prompt as an administrator, and then run the following command:
reg.exe query HKLM\Software\Policies\Microsoft\OneDrive /v SyncAdminReports
The output should look like this:
If the SyncAdminReports setting was not applied, go back and follow the steps under Set up the OneDrive sync health dashboard.
If the device is on the Insiders or Production ring and the setting was applied correctly, wait for 24 hours with the device turned on and signed in to OneDrive. If the device still doesn't appear on the dashboard, open a support ticket with Microsoft. For more information, see the next section, Report a problem.
Report a problem
If you encounter a problem with viewing the report dashboard, first verify that you've completed the steps in the troubleshooting section.
If problems persist after troubleshooting, open a support ticket with Microsoft. Make sure that the device isn't powered off during this period so that the sync app can still run and send a health report.
For quick investigations, be sure to have the date and time when the SyncAdminReports setting was enabled and either the user’s email or the OneDriveDeviceId available in your issue report.
To get the OneDrive Device ID, select the OneDrive sync app in the notification area > Help & Settings > Settings > About.
To make a feature suggestion, use the Feedback button in the top, right corner of the dashboard page.