OneDrive sync reports in the Apps Admin Center - SharePoint in Microsoft 365 (2023)

  • Article
  • 11 minutes to read

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.

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 app version 22.232 or later for Windows and macOS.

  • OneDrive sync apps on the Insiders or Production ring. Users on Deferred rings can access the dashboard once 22.232 has rolled out to the ring. Set the sync app update ring.

  • 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.

  • Windows
  • macOS

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.

(Video) Taking a Look at OneDrive Sync Health in the Microsoft 365 Apps Admin Center

  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. In the left navigation menu, select Setup.

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

    Note

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

  6. 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

      (Video) OneDrive sync client updates and the new OneDrive Admin Center

      OneDrive sync reports in the Apps Admin Center - SharePoint in Microsoft 365 (1)

    • 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.msc).

    • 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.

Navigate the OneDrive Sync health dashboard

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:

  • Overview
  • Devices
  • Issues

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.

Card nameDescription
Sync errorsShows 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 foldersShows 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 versionShows 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".

Devices

The Devices 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.

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

(Video) Onedrive admin center in office 365 step by step

Column nameDescription
UserThe name of the user
User emailThe user's email address
Device nameThe device name
ErrorsThe health status of a device
Known foldersThe name of folders moved to OneDrive
App versionThe current version of OneDrive running on the device
Operating systemThe 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.

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.

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.

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.

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 Devices 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 Devices 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.

Storage in the EU How is data stored in the EU geo?

Microsoft continues its commitment to meet and exceed the requirements of EU data protection laws. All data storage is EU Data Boundary compliant.

Microsoft Power BI Are there Power BI templates available?

(Video) SharePoint Power Hour: New OneDrive Admin

There are no Power BI templates available for sync reports.

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:

    OneDrive sync reports in the Apps Admin Center - SharePoint in Microsoft 365 (2)

    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.

(Video) Onedrive admin center in office 365 step by step

OneDrive sync reports in the Apps Admin Center - SharePoint in Microsoft 365 (3)

FAQs

What are the OneDrive sync issues in SharePoint? ›

If you're having trouble syncing Office files, the Office Upload cache system may be interfering with SharePoint sync. Try turning off the related setting in OneDrive settings. Select the blue OneDrive cloud icon in the notification area, at the far right of the taskbar.

Can SharePoint admins access OneDrive? ›

An administrator can use the SharePoint Online Admin Center to transfer ownership of a OneDrive or control user access to OneDrive, as follows: Open the “more features” page in the SharePoint Admin Center and sign in with an account that has admin permissions. Under User Profiles, select Open.

How do I sync OneDrive with SharePoint? ›

In your browser, on your SharePoint site, navigate to the library of files you want to sync with. Select Sync in the toolbar. Note: If your browser asks for permission to use OneDrive, confirm that it's OK. Sign in to OneDrive to start syncing your files and finish OneDrive setup.

Does OneDrive automatically sync to SharePoint? ›

OneDrive automatically syncs your data to SharePoint when you're connected to the internet.

What triggers OneDrive to sync? ›

The OneDrive sync app uses Windows Push Notification Services (WNS) to sync files in real time. WNS informs the sync app whenever a change actually happens, eliminating redundant polling and saving on unnecessary computing power.

Videos

1. Microsoft OneDrive | OneDrive Sync Explained
(Collaboration Coach)
2. Cutting Edge Microsoft OneDrive Insight Capabilities explained
(Microsoft 365 Apps Deployment Insiders)
3. OneDrive for Business - Awesome Tips & Tricks for Admins!
(Andy Malone MVP)
4. OneDrive powers intelligent file experiences across Microsoft 365
(Microsoft 365 Community)
5. OneDrive for Business Admin Centre - Sync Settings
(Daniel Anderson)
6. Deployment and configuration of Microsoft OneDrive sync
(Microsoft 365)
Top Articles
Latest Posts
Article information

Author: Patricia Veum II

Last Updated: 02/28/2023

Views: 6188

Rating: 4.3 / 5 (44 voted)

Reviews: 83% of readers found this page helpful

Author information

Name: Patricia Veum II

Birthday: 1994-12-16

Address: 2064 Little Summit, Goldieton, MS 97651-0862

Phone: +6873952696715

Job: Principal Officer

Hobby: Rafting, Cabaret, Candle making, Jigsaw puzzles, Inline skating, Magic, Graffiti

Introduction: My name is Patricia Veum II, I am a vast, combative, smiling, famous, inexpensive, zealous, sparkling person who loves writing and wants to share my knowledge and understanding with you.