Optional diagnostic data for Office

Important

The information in this article applies to Version 1904 or later of the following Office client software installed on a computer running Windows:

  • Office 365 ProPlus and Office 365 Business
  • Office 365 Personal, Office 365 Home, or other versions of Office that are part of an Office 365 subscription.
  • Project and Visio that come with some subscription plans, such as the Project Online Professional plan or Visio Online Plan 2.

The information also applies to Version 16.28 or later of the following Office for Mac applications: Excel, Outlook, OneNote, PowerPoint, and Word.

Diagnostic data is used to keep Office secure and up-to-date, detect, diagnose and fix problems, and also make product improvements. This data does not include a user’s name or email address, the content of the user’s files, or information about apps unrelated to Office.

This diagnostic data is collected and sent to Microsoft about Office client software being used on computers running Windows. Some diagnostic data is required, while some diagnostic data is optional. We give you the ability to choose whether to send us required or optional diagnostic data through the use of privacy controls, such as policy settings for organizations. You can see the diagnostic data being sent to us by using the Diagnostic Data Viewer.

Optional diagnostic data is additional data that helps us make product improvements and provides enhanced information to help us detect, diagnose, and fix issues.

If you choose to send us optional diagnostic data, required diagnostic data is also included.

Examples of optional diagnostic data include data we collect about the shapes users insert into Word documents so we can provide better options, and data we collect about the time it takes for a PowerPoint slide to appear on your screen so we can improve the experience if it’s slow.

For more information about diagnostic data, see the following:

If you’re the admin for your organization, you might also be interested in the following:

Categories of optional diagnostic data

Optional diagnostic data is organized into the following categories:

  • Software setup and inventory
  • Product and service usage
  • Product and service performance
  • Device connectivity and configuration

These categories are shown in the Diagnostic Data Viewer and are the same categories used with required diagnostic data.

The following sections provide a description of each category and examples of events for each category.

Software setup and inventory events

This category includes events that may cover the following areas:

  • Installed product and version and the installation status
  • Software add-ins and their settings​.
  • Document, feature, and add-in error conditions that may compromise security, including product update readiness.

The following table provides examples of events in this category and a description of those events.

Event name Event description
Office.Extensibility.AppCommands.GetRibbonUpdatesForUserId This event indicates whether Word successfully updates the Ribbon in the Word User Interface when the user changes their identity. We use this event to detect incorrect setup and other issues that would affect the Office user interface.
Office.Extensibility.AppCommands.AppCmdInstall This event provides information about the Office add-in that the user has installed, including app ID, operating system build and version, success of installation, and duration of install.

Product and service usage events

This category includes events that may cover the following areas:

  • Success of application functionality. Limited to opening and closing of the application and documents, file editing, and file sharing (collaboration).​
  • Determination if specific feature events have occurred, such as start or stop, and if feature is running​.
  • Office accessibility features

The following table provides examples of events in this category and a description of those events.

Event name Event description
Office.Word.Commanding.Highlight This event indicates Word has executed the command to highlight text. We use this event to detect errors in the text-highlight command.
Office.Translator.AddInLoaded A heartbeat to indicate that the translator feature has been loaded and rendered successfully.
Office.Graphics.GVizInsertShape Tracks the usage of the Insert Shape feature in Word and also reports details of types of shapes inserted and from which source.
Office.PowerPoint.PPT.Desktop.SummaryZoomInsertionRule This event determines if there are any sections present in a document when the user is inserting Summary Zoom and if the user chooses to delete existing sections.
Office.Security.SecureReaderHost.ProtectedViewValidation Tracks when and why a file is opened in Protected View. Used to diagnose conditions where Protected View may not be correctly triggered to ensure the feature is working properly.

Product and service performance events

This category includes events that may cover the following areas:

  • Unexpected application exits (crashes) and the state of the application when that happens​.
  • Poor response time or performance for scenarios such as application start up or opening a file.
  • Errors in functionality of a feature or user experience.

The following table provides examples of events in this category and a description of those events.

Event name Event description
Office.Word.Word.CoreSaveTime100ns This event logs the performance of a document save activity by Word. We use this event to detect errors and performance issues in the Word save document activity.
Office.Identity.SignInForWamAccountAad This event is sent when a user is signed in to an Azure Active Directory account with Web Account Manager (WAM) library. This event sends metadata such as AppName, AppVersion, and ErrorCode if the event failed.
Office.PowerPoint.PPT.Desktop.FileOpen.FirstSlideMasterThumbnailRenderTime This event collects the length of time it takes to render the first slide master thumbnail in PowerPoint.
Office.Extensibility.Diagnostics This event provides general diagnostic information for Office add-ins, such as crash reports for debugging.

Device connectivity and configuration events

This category includes events that may cover the following areas:

  • Network connection state and device settings, such as memory.​

The following table provides examples of events in this category and a description of those events.

Event name Event description
Office.Graphics.ArtViewValidate This event logs validation the results of Graphics View that supports Graphics User Interface. We use the event to collect usage and error data about graphics rendering.
Office.Graphics.ARCExceptionScope This event tracks rendering failures coming from the rendering engine.
Office.Extensibility.ODPLatency This event provides information about the user’s network connection and speed.