OneDrive sync reports in the Apps Admin Center

Use the OneDrive sync health dashboard in the Microsoft 365 Apps Admin Center to get an executive summary of everything happening with OneDrive so that you can resolve common issues quickly and focus on other strategic tasks as an administrator.

Image of the overview page of the sync reports dashboard

Proactively keeping OneDrive healthy helps ensure that your organization's information is protected. The dashboard provides you with sync health reports for tracking relevant health issues and advisories, checking the sync status and app version of individual devices, and monitoring Known Folder Move roll out.

In this article, you'll learn how to set up and navigate the sync health dashboard to better manage your OneDrive users and increase OneDrive adoption.

Requirements

Before getting started, be sure that you're familiar with the requirements needed to access the dashboard:

  • 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 22.087 or later for Windows and macOS.

  • Global Administrator, Office Apps Administrator or Microsoft 365 Administrator role access is required to enable and set up the dashboard for your organization. After the feature is enabled by one of these roles, one can also view the dashboard using Global reader or Reports reader access. To learn more about administrator roles and permissions in Microsoft 365, visit About Admin Roles.

  • Devices in your organization should allow connections to https://clients.config.office.net.

Note

This feature isn’t available to customers who have the following plans: Office 365 operated by 21Vianet, Office 365 GCC, or Office 365 GCC High and DoD.

Set up the OneDrive sync health dashboard

In this section, you'll learn how to set up sync reports on Windows and macOS devices.

This tab provides how-to steps for enabling sync reports on Windows devices.

Note

The previous Group Policy HKLM\SOFTWARE\Policies\Microsoft\OneDrive\SyncAdminReports is still supported and will continue to be supported for 60 days after General Availability is announced. We recommend that admins deploy the GPO now, to ensure a smooth transition at that time.

  1. Ensure you have the required role and app versions listed in the previous section.

  2. Go to Microsoft 365 Apps admin center and sign in as a global admin or Office apps admin.

  3. From the left navigation menu, select Health > OneDrive Sync

  4. Select Enable preview features to accept the license terms.

    Screenshot of enable preview features button.

  5. In the left navigation menu, select Settings

  6. Verify that a Tenant Association Key is present in the text field. If the field is empty, select Generate new key.

    Screenshot of Tenant Association Key under Preview setup.

    Note

    When you generate a new key for the first time, it can take up to 30 seconds for it to appear.

  7. Enable the OneDrive EnableSyncAdminReports Group Policy Object (GPO).

    Important

    You must enable this setting on the devices from which you want to get reports. This setting has does not affect users. 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 > DWORD (32-bit) Value

      c. Name: EnableSyncAdminReports

      d. Type: REG_DWORD

      e. Data: 1

      Screenshot image depicting the creation of a new key in the Registry Editor

    • Run Command Prompt as an administrator, and then run the following command:

      reg.exe add HKLM\Software\Policies\Microsoft\OneDrive /v EnableSyncAdminReports /t REG_DWORD /d 1

    • Use Group Policy

    To apply the setting on a single PC, follow these steps:

    • Open Group Policy Editor (gpedit.exe)

    • Go to Computer Configuration\Administrative Templates\OneDrive.

    • Choose Enable sync health reporting for OneDrive.

    • Select Enabled and then press OK.

Important

When you enable the EnableSyncAdminReports setting on devices, it can take up to three days for reports to be available. Devices will appear in the report after this time. Forcing a specific device to report data is unsupported.

In this section, you'l learn how to successfully navigate the OneDrive Sync health dashboard. Learn about the reporting insights available to you and how they can help you proactively manage OneDrive for your organization.

Jump to:

Note

After you set up the dashboard as described in the previous section, the Global Reader admin role is sufficient to access and view reports.

Overview

The Overview tab (the default view) shows a summary of devices that have at least one sync issue, a percentage of the devices in your organization using Known folder move, and the number of devices running on the current version of OneDrive.

Screenshot of Overview tab of OneDrive sync health dashboard.

Card name Description
Sync errors Shows how many devices have sync errors or not.

Sorting through errors can help you proactively reach out to educate people while resolving common issues and improving user experience. Users may not report OneDrive issues to you immediately. Unreported issues could lead to unwanted problems while they're working on important tasks. With the Sync errors card, you won't have to wait to be notified by users to take action.
Known folders Shows a snapshot of the number of known folders currently in use.

Known Folder Move allows people to keep their Desktop, Documents, and Pictures folders protected by syncing them to the cloud with OneDrive. If you’re rolling out Known Folder Move for your organization, the Known folders card is a great way for you to monitor progress.
Sync app version Shows the number of devices running on the current version of OneDrive.

Running the current version of OneDrive helps users stay up to date with all the latest and greatest fixes and features from Microsoft. Hover over the Sync app version card for a filtered view of operating systems on the current version. Note: Mac App store devices are excluded from this section and will appear in the count as "devices excluded".

Details

The Details tab shows all users, their current health state, their known folders currently moved in OneDrive, their current app version and operating system version, a timestamp of the last time the app was fully up to date, and a timestamp of the last time the sync app reported health data to the dashboard. An icon and status in the Errors column indicate the state of each device.

Screenshot of OneDrive sync health details tab.

This table provides a summary of the information found in each column of the Details tab:

Column name Description
User The name of the user
User email The user's email address
Device name The device name
Errors The health status of a device
Known folders The name of folders moved to OneDrive
App version The current version of OneDrive running on the device
Operating system The current version of the OS running on the device
Last synced timestamp (UTC) The last time that the sync app was fully up to date with the cloud
Last status reported timestamp (UTC) The last time that the sync app reported health data to the dashboard

Customize your view of which devices show up on the dashboard by using the filter option in the command bar. Standard filters include "all devices" where you can see every device and "devices with errors" where you'll only see devices with errors.

You can easily create a custom filter with your own conditions. From the command bar, select Filter > New filter to open the Custom filter panel. Name your filter and select your desired conditions. If you'd like to filter by app version, be sure that you enter the complete sync app version number including periods. Afterwards, select Create to use your new filter.

Screenshot of the custom filter panel.

When someone in your organization reports a problem with syncing files to OneDrive, you can investigate quickly without having to ask for extra details of the error message via Microsoft Teams chat or Outlook email. Select a user to see more information on their device and sync status. This detailed view lets you see a user's essential OneDrive information including any errors they might be experiencing.

Image depicting Details panel with individual OneDrive user and device information

Issues

The Issues tab shows you a list of OneDrive error messages found in the health report and the number of devices affected by them in your organization. Use this view to see if there are any common patterns between users and the errors present across your organization.

The Issues tab showing a list of errors present in devices.

You can learn more about the error and devices affected by selecting an error message from the list. The Issues panel will appear with a summary of the devices affected, along with a list of users and their current app version and operating system. Partner with your users to fix common OneDrive sync issues.

Image depicting issues panel

To learn more about OneDrive error messages, see What do the OneDrive error codes mean?.

Data for the OneDrive sync health dashboard

The sync reports use health data that your OneDrive sync apps send to Microsoft. You have choices when it comes to the technology you use and the data you share. Use the EnableSyncAdminReports setting to manage which devices send data.

To learn more about the controls available to you, see Overview of privacy controls for Microsoft 365 Apps. To learn more about required service data, see Required service data for Office.

Known limitations and considerations

This section describes known limitations and considerations in sync reporting.

Limitations

Device Records: By default, device records are kept in inventory for 30 days, after which they expire from the report.

Folders in OneDrive: Devices with folders in OneDrive will appear in reports as a device with 0-3 known folders. If a device has not enabled folders in OneDrive, it will appear in reports as a device that is Not eligible in the Known Folders section of the Overview tab. In the Details tab, a hyphen ("-") will appear in the cell value of the Known folders table for devices that aren't applicable devices. This behavior is expected.

Sync app version: Mac App Store edition For devices using the Mac App Store edition of the sync app, the version installed on each device is displayed in the Details tab. The dashboard doesn't currently track whether or not the Mac App Store edition is the latest version of the sync app available in the Mac App Store. If any devices use this edition, they'll be excluded from the Sync app version section of the Overview tab and the number of excluded devices is displayed. This is the expected result.

Considerations:

Network Impact How is my network impacted when my organization enables Sync Reports?

There is negligible impact to a network after enabling the sync reports setting on devices.

Troubleshooting

Use this section to troubleshoot if the OneDrive sync reports don't appear after three days.

Important

If you enable the EnableSyncAdminReports setting on devices that don't meet the requirements, it will have no effect. The app won't send reports.

  1. Confirm that the sync app is on the Insiders or Production ring.

Confirm with Command Prompt:

Windows users should open Command Prompt as an administrator, 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.
  1. Confirm that the EnableSyncAdminReports 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 EnableSyncAdminReports

    The output should look like this:

    Screenshot of expected command prompt output

    If the EnableSyncAdminReports setting wasn't 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 36 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 EnableSyncAdminReports setting was enabled and either the user’s email or the OneDrive device ID available in your issue report.

To get the OneDrive device ID, select the OneDrive sync app in the notification area > Help & Settings > Settings > About.

Send feedback

We value your feedback. To submit feature suggestions and report issues, you can use the Feedback button in the top-right corner of the dashboard page.

Screenshot of Feedback form.