Share via


Required diagnostic data for Office

Note

For a list of Office products covered by this privacy information, see Privacy controls available for Office products.

Diagnostic data is used to keep Office secure and up-to-date, detect, diagnose and fix problems, and also make product improvements. This data doesn't 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 running on the user's device. 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.

Required diagnostic data is the minimum data necessary to help keep Office secure, up-to-date, and performing as expected on the device it's installed on.

Required diagnostic data helps to identify problems with Office that may be related to a device or software configuration. For example, it can help determine if an Office feature crashes more frequently on a particular operating system version, with newly introduced features, or when certain Office features are disabled. Required diagnostic data helps us detect, diagnose, and fix these problems more quickly so the impact to users or organizations is reduced.

For more information about diagnostic data, see the following articles:

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

Note

For information about required diagnostic data for Microsoft Teams, see the following articles:

Categories, data subtypes, events, and data fields for required diagnostic data

Required diagnostic data is organized into categories and data subtypes. Within each data subtype are events, which contain data fields that are specific to that event.

The following table provides a list of the categories for required diagnostic data. The data subtypes within each category are listed, along with a description of the focus for that data subtype. There are links to each data subtype section where you'll find the following information:

  • A list of events in that data subtype
  • A description of each event
  • A list of data fields in each event
  • A description of each data field
Category Data subtype Description
Software setup and inventory Office setup and inventory​ Installed product and version and the installation status.
Office add-in configuration​ Software add-ins and their settings​.
Security Document, feature, and add-in error conditions that may compromise security, including product update readiness.
Product and service usage Application feature success Success of application functionality. Limited to opening and closing of the application and documents, file editing, and file sharing (collaboration).​
Application status and boot Determination if specific feature events have occurred, such as start or stop, and if feature is running​.
Office accessibility configuration Office accessibility features​
Privacy Office privacy settings
Product and service performance Unexpected application exit (crash) Unexpected application exits and the state of the application when that happens​.
Application feature performance ​ Poor response time or performance for scenarios, such as application start up or opening a file.
Application activity error Errors in functionality of a feature or user experience.
Device connectivity and configuration Device connectivity and configuration​ Network connection state and device settings, such as memory.​

Note

  • Categories are shown in the Diagnostic Data Viewer, but data subtypes are not shown.
  • A data field marked Obsolete has been or will soon be removed from required diagnostic data. Some of these data fields are duplicates that arose as diagnostic data was modernized and were used to ensure no service disruption to live diagnostic monitoring reports.

Categories and data fields that are common for all events

There's some information about events that is common to all events, regardless of category or data subtype. This common information, which is sometimes referred to as data contracts, is organized into categories. Each category contains fields, and these fields are the metadata and properties of an individual event. You can view this information by using the Diagnostic Data Viewer.

The categories of information that is collected about events can be divided into two groups:

Information common to all events

Information common to all events is collected in the following categories.

App

Information about the application. All fields are constant for all sessions of a given application version.

This category contains the following fields:

  • Branch - The branch that the given build came from. Allows us to determine what type of branch a given build came from so that we can correctly target fixes.
  • InstallType - An enumerator that identifies how the user installed the application. Allows us to determine if specific install mechanisms are creating issues that aren't seen in other installation mechanisms.
  • Name - The name of the application that is providing the data. Allows us to identify which application is showing an issue so we know how to address it.
  • Platform - The broad classification of the platform on which the app is running. Allows us to identify on which platforms an issue may be occurring so that we can correctly prioritize the issue.
  • Version - The version of the application. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

Client

Identifier related to an Office instance on a device. Constant for all sessions of all apps of a given installation version for multi-app suites, or constant for all sessions of a given application version.

This category contains the following fields:

  • Id - Unique identifier assigned to a client at install time of Office. Allows us to identify whether issues are impacting a select set of installs and how many users are impacted.

Information regarding the users consent for diagnostic data and connected experiences.

This category contains the following fields:

  • ControllerConnectedServicesSourceLocation – Indicates how the user's choice for optional connected experiences was made

  • ControllerConnectedServicesState – Indicates whether the user has access to optional connected experiences

  • ControllerConnectedServicesStateConsentTime – Indicates when the user chose the status of optional connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • DiagnosticConsentConsentTime – Indicates when the user provided the consent for diagnostic data. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • DiagnosticConsentLevel – Indicates what level of diagnostic data consent the user has given

  • DiagnosticConsentLevelSourceLocation – Indicates how the user had provided the consent for diagnostic data

  • DownloadContentSourceLocation – Indicates how the user made the choice to enable or disable connected experiences that that download online content

  • DownloadContentState – Indicates whether the user has chosen to enable or disable connected experiences that download online content

  • DownloadContentStateConsentTime – Indicates when the user made the choice to enable or disable connected experiences that download online content. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • ServiceConnectionState – Indicates whether the user has chosen to use or not use all connected experiences

  • ServiceConnectionStateConsentTime – Indicates when the user chose whether to use all connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • ServiceConnectionStateSourceLocation – Indicates how the user provided the choice whether to use all connected experiences

  • UserCategoryValue – Identified the type of user who made the consent. One of MSAUser, AADUser, or LocalDeviceUser

  • UserContentDependentSourceLocation – Indicates how the user's choice to enable or disable was made for connected experiences that analyze content

  • UserContentDependentState – Indicates whether the user has chosen to enable or disable connected experiences that analyze content

  • UserContentDependentStateConsentTime – Indicates when the user chose to enable or disable connected experiences that analyze content was made. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

Device

Information about the operating system and build.

This category contains the following fields:

  • Model - string containing the physical model for the device running the app. iOS only. For example, iPhone13.3 or iPad11.6.

  • OsBuild - The build number of the operating system installed on the device. Allows us to identify whether issues are impacting individual service packs or versions of a given operating system differently than others so we can prioritize issues.

  • OsVersion - The major version of the operating system installed on the device. Allows us to determine if issues are impacting a particular operating system version more than other so we can prioritize issues.

Legacy

Provides an App ID and OS version for compatibility with existing legacy collection practices.

This category contains the following fields:

  • AppId - An enumerator value representing which application is sending the data. Allows us to identify which application is showing an issue so we know how to address it.

  • OsEnv - An enumerator indicating which operating system the session is running on. Allows us to identify which operating system an issue happening on so we can prioritize issues.

Release

Information related to the release channel. All fields are constant for all sessions of all apps of a given installation version. Identifies a group of devices all in one phase of a product release cycle.

This category contains the following fields:

  • Audience - Identifies a sub-audience of a given audience group. Allows us to track subsets of audience groups to evaluate prevalence and prioritization of issues.

  • AudienceGroup - Identifies the ring where data is coming from. Allows us to roll out features in a staged fashion and identify potential issues before they reach most users.

  • Channel - The channel that the product is being released through. Allows us to identify if an issue is impacting one of our rollout channels differently than others.

  • Fork - Identifies the fork of the product. Allows a mechanism to aggregate data across a set of build numbers to identify issues related to a given release.

Session

Information about the process session. All fields are constant for this session.

This category contains the following fields:

  • ABConfigs - Identifies the set of flights that are running in a given session. Allows us to identify which individual flights are running on a session so that we can determine if a flight is the source of an issue impacting users.

  • EcsETag - An indicator from the flighting system that represents the flights sent to the machine. Allows us to identify what flights might be impacting a given session.

  • Flags - Bitmask tracking flags applicable to an entire session, currently primarily focused on sampling and diagnostic data options. Allows us to control how a given session behaves in relation to the diagnostic data that the session generates.

  • HostAppName - Identifies the host app name that launches a sub-app. Apps like Microsoft 365 mobile app (Android) can launch Word, Excel, and PowerPoint sub-apps. For such sub-apps, the host app is OfficeMobile

  • HostSessionId - Uniquely identifies the host app session for a sub-app

  • Id - Uniquely identifies a given session of data. Allows us to identify the impact of issues by evaluating the number of sessions that are impacted and if there are common features of those sessions.

  • ImpressionId - Identifies the set of flights that are running in a given session. Allows us to identify which individual flights are running on a session so that we can determine if a flight is the source of an issue impacting users.

  • MeasuresEnabled - Flag indicating if the current sessions data is sampled or not. Allows us to determine how to statistically evaluate the data that is gathered from the given session.

  • SamplingClientIdValue - The ID of the client used to determine if it's part of sampling. Allows us to determine why an individual session was included or excluded from sampling.

  • SubAppName - For Microsoft 365 mobile app, this field represents the underlying application being used to open a document. For example, if you open a Word document in Office app, this field reports the value of "Word."

  • VirtualizationType - Type of virtualization if Office is running in one. The possible values are:

    • 0 = None
    • 1 = Windows Virtual Desktop
    • 2 = Windows Defender Application Guard
    • 3 = Windows Core OS

User

Provides tenant information for commercial software SKUs.

This category contains the following fields:

  • PrimaryIdentityHash – A pseudonymous identifier that represents the current user.

  • PrimaryIdentitySpace – The type of identity contained in the PrimaryIdentityHash. One of MASCID, OrgIdCID, or UserObjectId.

  • TenantGroup - The type of the tenant that the subscription belongs to. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users.

  • TenantId - The tenant that a user's subscription is tied to. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant.

Information that specifically supports diagnostic data collection

Information that specifically supports diagnostic data collection is collected in the following categories.

Activity

Information to understand the success of the collection event itself.

This category contains the following fields:

  • AggMode - Tells the system how to aggregate activity results. Allows us to reduce the amount of information uploaded from a user's machine by aggregating activity results into a single event that gets sent periodically.

  • Count - The number of times the activity happened if the count is from an aggregated event. Allows us to determine how often an activity succeeded or failed based on the aggregation mode of the activity.

  • CV - A value that identifies the relationship between activities and sub-activities. Allows us to rebuild the relationship between nested activities.

  • Duration - The length of time the activity took to execute. Allows us to identify performance issues that are negatively impacting the user's experience.

  • Result.Code - An application defined code to identify a given result. Allows us to determine more specific details of a given failure such as a failure code that can be used to classify and fix issues.

  • Result.Tag - An integer tag that identifies the location in code where the result was generated. Allows us to distinctly identify the location in code where a result was generated which enables classification of failures.

  • Result.Type - The type of the result code. Identifies what type of result code was sent so that the value can be correctly interpreted.

  • Success - A flag indicating if the activity succeeded or failed. Allows us to determine if actions the user takes in the product are succeeding or failing. This allows us to identify issues that are impacting the user.

Application

Information about the installation of the application from which the events are being gathered.

This category contains the following fields:

  • Architecture - The architecture of the application. Let's us classify errors that might be specific to an architecture of the application.

  • Click2RunPackageVersion - The version number of the Click-To-Run package that installed the app. Allows us to identify which version of the installer was used to install Office so we can identify setup-related issues.

  • DistributionChannel - The channel where the app was deployed. Allows us to partition incoming data so we can determine if issues are impacting audiences.

  • InstallMethod - Whether the current build of Office was upgraded from an older build, rolled back to an older build, or a fresh install.

  • IsClickToRunInstall - Flag indicating if install was a click to run install. Allows us to identify issues that might be specific to the Click-To-Run install mechanism.

  • IsDebug - Flag indicating if the Office build is a Debug build. Allows us to identify if issues are coming from Debug builds, which may behave differently.

  • IsInstalledOnExternalStorage - Flag indicating if Office was installed on an external storage device. Let's us determine if issues can be traced to an external storage location.

  • IsOEMInstalled - Flag indicating if Office was installed by an original equipment manufacturer (OEM). Let's us determine if the application was installed by an OEM, which can help us classify and identify issues.

  • PreviousVersion - The version of Office that was previously installed on the machine. Allows us to roll back to a previous version if the current one has an issue.

  • ProcessFileName - The name of the application filename. Allows us to identify the name of the executable that is generating the data as there may be several different process filenames reporting as the same app name.

Client

Information about the Office client.

This category contains the following fields:

  • FirstRunTime - The first time the client was run. Allows us to understand how long the client has had Office installed.

Device

Information about device configuration and capabilities.

This category contains the following fields:

  • DigitizerInfo - Information on the digitizer used by the machine. Allows us to classify data based on device pivot.

  • FormFactor - Identifies what form factor the device sending the info is. Allows us to classify data based on device pivot.

  • FormFactorFamily - Identifies what form factor the device sending the info is. Allows us to classify data based on device pivot.

  • HorizontalResolution - The horizontal resolution of the devices screen. Allows us to classify data based on device pivot.

  • Id - A unique identifier for the device. Allows us to identify the distribution of issues across a set of devices.

  • IsEDPPolicyEnabled - Flag to indicate if enhanced data protection is enabled on the machine. Allows us to classify data based on device pivot.

  • IsTerminalServer - Flag to determine if the machine is a terminal server. Allows us to classify data based on device pivot.

  • Manufacturer - The manufacturer of the device. Allows us to classify data based on device pivot.

  • Model - The model of the device. Allows us to classify data based on device pivot.

  • MotherboardUUIDHash - A hash of a unique identifier for the motherboard. Allows us to classify data based on device pivot.

  • Name - The name of the device. Allows us to classify data based on device pivot.

  • NetworkCost - Indicates network cost or type, such as metered or metered above cap.

  • NetworkCountry - The country or region code of the sender, based on the unscrubbed client IP address.

  • NumProcPhysCores - The number of physical cores on the machine. Allows us to classify data based on device pivot.

  • OsLocale - The locale of the operating system that is running. Allows us to classify data based on device pivot.

  • ProcessorArchitecture - The architecture of the processor. Allows us to classify data based on device pivot.

  • ProcessorCount - The number of processors on the machine. Allows us to classify data based on device pivot.

  • ProcSpeedMHz - The speed of the processor. Allows us to classify data based on device pivot.

  • RamMB - The amount of memory the device has. Allows us to classify data based on device pivot.

  • ScreenDepth - Allows us to classify data based on device pivot.

  • ScreenDPI - The DPI value of the screen. Allows us to classify data based on device pivot.

  • SusClientId - The Windows Update ID of the device Office is run on.

  • SystemVolumeFreeSpaceMB - The amount of free space on the system volume. Allows us to classify data based on device pivot.

  • SystemVolumeSizeMB - The size of the system volume on the machine. Allows us to classify data based on device pivot.

  • VerticalResolution - The vertical resolution of the devices screen. Allows us to classify data based on device pivot.

  • WindowErrorReportingMachineId - A unique machine identifier provided by Windows error reporting. Allows us to classify data based on device pivot.

  • WindowSqmMachineId - A unique identifier for the machine provided by Windows SQM. Allows us to classify data based on device pivot.

Event

Event-specific information, including its unique identifier in the session.

This category contains the following fields:

  • Contract - A list of any contracts that the event is implementing. Allows us to evaluate what data is part of the individual event so that we can process it effectively.

  • CV - A value that allows us to identify events that are related to one another. Used for diagnostics to allow us to identify patterns of related behavior or related events.

  • Flags - Information used to alter how a given event responds. Used to manage how a given event is treated for the purposes of uploading the data to Microsoft.

  • Id - A unique identifier for the event. Allows us to uniquely identify the events that are being received.

  • IsExportable - A field to denote if this event needs further processing by export pipeline.

  • Level - denotes the type of event.

  • Name - The name of the event. Allows us to identify the event that was being sent from the client.

  • Rule - An identifier of the rule that generated the data if it was generated by a rule. Allows us to identify the source of a piece of data so that we can validate and manage that events parameters

  • RuleId - The identifier of the rule that generated the data if it was generated by a rule. Allows us to identify the source of a piece of data so that we can validate and manage that events parameters.

  • RuleInterfaces - Any interfaces that are implemented by the specific rule. Allows us to classify and import the data based on its structure, which simplifies data processing.

  • RuleVersion - The identifier of the rule that generated the data if it was generated by a rule. Allows us to identify the source of a piece of data so that we can validate and manage that events parameters.

  • SampleRate - An indication of what percentage of users are sending this piece of data. This allows us to do statistical analysis of the data and for very common data points not require that to be sent by all users.

  • SchemaVersion - The version of the schema used to generate diagnostic data. Required to manage data being sent from the client. This allows changes over time in what data is being sent from each client.

  • Sequence - A counter that identifies the order that an event was generated on the client. Allows the data being received to be ordered so that we can identify what steps may have led to an issue that is impacting clients.

  • Source - The source pipeline that was used to upload the data. Required to monitor each of our upload pipelines for overall health and to help identify issues with the upload pipeline. This allows us to monitor individual upload pipelines to make sure they remain compliant.

  • Time - The time that the event was generated on the client. Allows us to synchronize and validate the order of events generated on the client and establish performance metrics for user instructions. 

Host

Information about an application that hosts an embedded application

This category contains the following fields:

  • Id - The unique identifier attributed to the host application by the embedded application.

  • SessionId - The globally unique identifier for the host's session.

  • Version - The version identifier of the host's primary executable.

Legacy

Information needed for legacy system compatibility.

This category contains the following fields:

  • OsBuild - The specific build number of the operating system. Allows us to determine which version of the operating system the diagnostic data is coming from in order to prioritize issues.

  • OsBuildRevision - The revision number of the build of the operating system. Allows us to determine which version of the operating system the diagnostic data is coming from in order to prioritize issues.

  • OsMinorVersion - The minor version of the operating system. Allows us to determine which version of the operating system the diagnostic data is coming from in order to prioritize issues.

  • OsVersionString - A unified string representing the operating system build number. Allows us to determine which version of the operating system the diagnostic data is coming from in order to prioritize issues.

Session

Information about the process session.

This category contains the following fields:

  • ABConfigsDelta - Tracks the difference between the current ABConfigs data and the previous value. Allows us to track what new flights are on the machine to help identify if a new flight is responsible for an issue.

  • CollectibleClassification - The classes of information the session can collect. Allows filtering of sessions based on the data they would have.

  • DisableTelemetry - Flag indicating if the DisableTelemetry key is set. Allows us to know if a session wasn't reporting diagnostic data other than EssentialServiceMetadata.

  • SamplingClientIdValue - The value of the key used to determine sampling. Allows us to determine why a session was sampled or not.

  • SamplingDeviceIdValue - The value of the key used to determine sampling. Allows us to determine why a session was sampled or not.

  • SamplingKey - The key used to determine whether the session is sampled or not. Allows us to understand how individual sessions are making their choice of whether they're sampled or not.

  • SamplingMethod - The method used to determine sampling policy. Allows us to understand what data is coming from a session.

  • SamplingSessionKValue - Advanced sampling metadata. Used to help evaluate statistical meaning of data that is received.

  • SamplingSessionNValue - Advanced sampling metadata. Used to help evaluate statistical meaning of data that is received.

  • Sequence - A unique numeric identifier for the session. Allows the ordering of sessions for analysis of the issues might have occurred.

  • Start - The boot time of the process session. Allows us to establish when the session started.

  • TelemetryPermissionLevel - Value indicating what level of diagnostic data the user has opted into. Allows us to understand what level of diagnostic data to expect from a session.

  • TimeZoneBiasInMinutes - The difference in minutes between UTC and the local time. Allows normalization of UTC times back to the local time.

Data fields that are common for OneNote events

The following data fields are common for all events for OneNote on Mac, iOS, and Android.

Note

When using the Diagnostic Data Viewer, events for OneNote on Mac, iOS, and Android will appear to have a name of Activity, ReportData, or Unexpected. To find the actual event name, select the event, and then look at the EventName field.

  • Activity_ActivityType - Indicates the type of this activity event. An activity can be a normal activity or a high value activity.

  • Activity_AggMode - Tells the system how to aggregate activity results. Allows us to reduce the amount of information uploaded from a user's machine by aggregating activity results into a single event that gets sent periodically.

  • Activity_Count - The number of times the activity happened if the count is from an aggregated event. Allows us to determine how often an activity succeeded or failed based on the aggregation mode of the activity.

  • Activity_CV - A value that identifies the relationship between activities and sub-activities. Allows us to rebuild the relationship between nested activities.

  • Activity_DetachedDurationInMicroseconds - The length of time an activity is idle and not doing any real work, but the time is still count towards the total activity's time.

  • Activity_DurationInMicroseconds - The length of time the activity took to execute. Allows us to identify performance issues that are negatively impacting the user's experience.

  • Activity_Expiration - A date in numerical format indicates when this event will be stop sending from clients

  • Activity_FailCount - The number of times this activity has failed

  • Activity_Name - A short name of an event. Allows us to identify the event that was being sent from the client.

  • Activity_Namespace - A namespace of an event. Allows us to group the event into groups.

  • Activity_Reason - A string indicating the reason causing an activity to ends with a particular result.

  • Activity_Result - A flag indicating if the activity succeeded, failed, or unexpectedly failed. Allows us to determine if actions the user takes in the product are succeeding or failing. This allows us to identify issues that are impacting the user.

  • Activity_State - A flag indicates whether an event is a start of a user activity or an end of a user activity.

  • Activity_SucceedCount - The number of times this activity succeeded.

  • ErrorCode - Indicates an error code if available.

  • ErrorCode2 - Indicates a second error code if available.

  • ErrorCode3 - Indicates a third error code if available.

  • ErrorTag - Indicates the tag associated in code of an error if available.

  • ErrorType - Indicates the type of an error if available.

  • EventName - A unique name of a OneNote's event. OneNote events use this custom field to specify a unique name due to an engineering limitation in the past.

  • ExpFeatures - Indicates whether a user has turn-on an experimental-feature switch in OneNote app or not.

  • ExpirationDate - A date in numerical format indicates when this event will be stop sending from clients

  • IsConsumer - Indicates whether a user is consumer or not

  • IsEdu - Indicates whether a user is a user in education tenant or not

  • IsIW - Indicates whether a user is an enterprise user or not

  • IsMsftInternal - Indicates whether a user is a Microsoft employee or not

  • IsPremiumUser - Indicates whether a user has premium license or not

  • Namespace - A namespace of the event. Allows us to group the event into groups.

  • Release_AppStore - A flag indicates whether a build is coming from an app store or not.

  • Release_Audience - Identifies a sub-audience of a given audience group. Allows us to track subsets of audience groups to evaluate prevalence and prioritization of issues.

  • Release_AudienceGroup - Identifies the ring where data is coming from. Allows us to roll out features in a staged fashion and identify potential issues before they reach most users.

  • Release_Channel - The channel that the product is being released through. Allows us to identify if an issue is impacting one of our rollout channels differently than others.

  • RunningMode - Indicates how the app is launched either by user or by system process.

  • SchemaVersion - Indicates a current telemetry schema version in OneNote's telemetry pipeline.

  • Session_EcsETag - An indicator from the flighting system that represents the flights sent to the machine. Allows us to identify what flights might be impacting a given session.

  • Session_ImpressionId - Identifies the set of flights that are running in a given session. Allows us to identify which individual flights are running on a session so that we can determine if a flight is the source of an issue impacting users.

  • SessionCorrelationId - The globally unique identifier for the host's session.

  • SH_ErrorCode - Indicates an error code if available when an activity fails.

  • Tag - An integer tag that identifies the location in code where the telemetry event is generated.

  • UserInfo_IdType - A string indicates the type of a user's account

  • UserInfo_OMSTenantId - The tenant that a user's subscription is tied to. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant.

  • UserInfo_OtherId - A list of non-primary pseudonymous identifiers representing user's accounts.

  • UserInfo_OtherIdType - A list of non-primary account types.

Data fields that are common for Outlook mobile events

Outlook mobile collects common fields for each of our events so that we can ensure the app is up-to-date, secure, and functioning as expected.

The following data fields are common for all events for Outlook for iOS and Android.

  • aad_tenant_id - The tenant ID of the customer if available

  • account_cid - A pseudonymous identifier that represents the current user

  • account_domain - Domain name of the account

  • account_puid - The globally unique user identifier for a consumer Microsoft account

  • account_type - Tracks the account type such as Office 365, Google Cloud Cache, Outlook.com, etc.

  • action - The event action name (such as archive, delete, etc.) so we can detect issues with specific actions taken

  • ad_id - The unique advertising identifier [This field has been removed from current builds of Office, but might still appear in older builds.]

  • app_version - Current version of the app installed to help us detect issues affecting certain app version

  • AppInfo.ETag - A unique identifier for managing release of our features to help us detect issues affecting certain features being released

  • AppInfo.Language - Currently language setting of the device to help us detect issues affecting certain languages

  • AppInfo.Version - Current version of the app installed to help us detect issues affecting certain app versions

  • ci - a pseudonymous app-specific device unique identifier

  • cid_type - indicates what type of account it's, such as a commercial account or Outlook.com account.

  • cloud - Where the mailbox resides for the account on this device to help detect issues specific to a specific mailbox cloud, like Office 365 or GCC.

  • customer_type - Indicates the type of customer (consumer, commercial, third party, etc.) to help us detect issues affecting certain customer types

  • device_category - Indicates what type of device it's (phone, tablet, etc.) to help us detect device category-specific issues

  • DeviceInfo.Id - A unique device identifier to help us detect device-specific issues

  • DeviceInfo.Make - The make of the device (for example, Apple, Samsung, etc.) to help us detect device make specific issues

  • DeviceInfo.Model - The device model (for example, iPhone 6s) to help us detect device model specific issues

  • DeviceInfo.NetworkType - The current device network being used (WiFi, cellular, etc.) to help us detect device network specific issues

  • DeviceInfo.OsBuild - The current OS build of the device to help us detect issues affecting certain OS builds

  • DeviceInfo.OsName - The name of the OS (for example, iOS) to help us detect issues affecting certain platforms

  • DeviceInfo.OsVersion - The current OS version of the device to help us detect issues affecting certain OS versions

  • DeviceInfo.SDKUid - The device unique identifier (similar to DeviceInfo.Id)

  • EventInfo.InitId - ID used as part of sequencing for event ordering through our telemetry pipeline to help us detect the root cause of a pipeline issue

  • EventInfo.SdkVersion - The SDK version we're using to send our telemetry to help us detect the root cause of a pipeline issue

  • EventInfo.Sequence - The sequence is for event ordering through our telemetry pipeline to help us detect the root cause of a pipeline issue

  • EventInfo.Source - Tells us what part of the code sent the event to help us detect the root cause of an issue

  • EventInfo.Time - The time and date the event was emitted from the device so our systems can successfully manage events coming in

  • eventpriority - The priority of the telemetry event relative to other events so our systems can successfully manage events coming in

  • first_launch_date - The first time the app was launched so helps us understand when an issue first began

  • hashed_email - A pseudonymous identifier that represents the current user email

  • hx_ecsETag - A unique identifier for managing release of features of our new mail syncing service to help the service detect issues affecting its features being released.

  • is_first_session - Tracks if this is the first session of the app for debugging purposes

  • is_shared_mail - Whether the account is a shared mail account, such as shared mailbox, delegate mailbox, etc.

  • origin - The origination of an action. For example marking a message read can originate from message list or a new mail notification, this helps us detect issues based on action origination

  • PipelineInfo.AccountId - A pseudonymous identifier that represents the current user

  • PipelineInfo.ClientCountry - The current country or region of the device to detect country or region-specific issues and outages

  • PipelineInfo.ClientIp - The IP address the device is connected to debug connection issues

  • PipelineInfo.IngestionTime - Timestamp of when our telemetry ingestion happens for this event

  • sample_rate - The percentage of devices that collect instances of the event. Helps calculate the original number of instances of the event.

  • Session.Id - A unique identifier for the app session to help identify session-related issues

  • Session.ImpressionId - A unique identifier for managing release of our features to ensure features are successfully released to all users and devices

  • ui_mode - Is the user in light or dark mode, helps us triage UX bugs with dark mode

  • UserInfo.Language - The user's language to help debug translation text issues

  • UserInfo.TimeZone - The user's time zone to help debug calendar issues

In addition, the following fields are common for all events for Outlook for iOS.

  • DeviceInfo.NetworkProvider - The network provider of the device (for example, Verizon)

  • gcc_restrictions_enabled - Tells us if GCC restrictions have been applied to the app so we can ensure our GCC customers are using our app securely

  • multi_pane_mode - Tells us if the user on the iPad is using their inbox with multiple panes turned on where they can see their folder list while triaging email. This is needed to help us detect issues specific to those using their inbox with multiple panes open.

  • multi_window_mode – Tells us if the user on the iPad is using multiple windows to help us detect issues related to multi-window usage.

  • office_session_id - A unique ID tracking the session for connected Office services to help detect issues specific an Office service integration in Outlook like Word

  • state - Whether the app was active when this event was sent to help detect issues specific to active or inactive app states

  • user_sample_rate - The sample rate this device is sending this event, which can be different from the event default (sent in the common field ‘sample_rate’). We use this to confirm when a sample rate different from the event default is applied for certain groups.

In addition, the following fields are common for all events for Outlook for Android.

  • aad_id - a pseudonymous Microsoft Entra identifier

  • DeviceInfo.NetworkCost - Indication of devices current network cost, which reflects the status of WiFi/Cellular/Roaming to help detect issues specific to device network

  • is_app_in_duo_split_view_mode - This lets us know that the app was in Duo split-screen mode. This property is set only for Duo (Android only) devices.

  • is_app_local - This property helps to identify whether the account is of type app_local or not. App local is a non syncable account on Hx platform, which helps in persisting storage/local calendar accounts into HxStorage.

  • is_dex_mode_enabled - Whether Samsung DeX mode is enabled to help detect issues specific to DeX mode with Samsung devices

  • is_preload_install – Tells us if our app was pre-loaded on device (Android 11 or later devices)

  • is_sliding_drawer_enabled - Whether Sliding Drawer interface is enabled to help detect issues caused by our sliding drawer interface

  • message_list_version - The internal version name of the code that displays the message list. This helps us attribute bugs and performance issues to new versions of the message list implementation.

  • oem_preinstall - Tells us if our app was pre-installed on the device

  • oem_preload_property – Tells us if our app was pre-loaded as part of a specific agreement with the OEM

  • orientation - Physical orientation of the screen (portrait/landscape) to help detect issues specific to device orientation

  • os_arch - Operating System architecture for the device to help detect issues specific to device operation systems

  • process_bitness - Process bitness (32 bit or 64 bit) for the application to help detect issues specific to device bitness

  • webview_kernel_version: The Chromium kernel version of webview on the device to help us detect compatibility issues related to the version of webview.

  • webview_package_name: The package name of webview on the device to help us detect compatibility issues related to the version of webview.

  • webview_package_version: The package version of webview on the device to help us detect compatibility issues related to the version of webview.

Software setup and inventory data events

The following are the data subtypes in this category:

Office setup and inventory subtype

Installed product and version and the installation status.

add.sso.account

This alerts Microsoft to the success or failure of a user adding an account through single sign-on (SSO).

The following fields are collected:

  • account_type – the type of the account added using the SSO.

  • action_origin – from where this event was generated. (for example, values: sso_drawer, sso_add_account, sso_add_account_prompt, sso_settings, sso_oobe).

  • provider - the identifier for the provider software package for the SSO.

  • state – current state of the account, (example value: FAILED, PENDING, ADDED etc.)

install.referral

This event is triggered at the initial install of the app and records from where the user was referred (if available).

The following fields are collected:

  • install_referrer - Product or experience from where the user was referred

Office.Android.EarlyTelemetry.ProcessStartedForPDFFileActivation

This event is triggered when the user launches the Microsoft 365 mobile app for file activations. This data helps identify the type of activation before the app boots so that the correct sequence of start-up tasks is selected for file activation.

The following fields are collected:

  • appTaskInfo - Details of task that got created, including the intent captured by the app.

  • appTaskSize - depicts the number of tasks currently on stack for OM app.

  • exceptionReceived - populated if there was an exception in determining the type of file activation

  • isPdfActivation - true if its detected as a pdf activation and false if any other launch type

Office.ClickToRun.UpdateStatus

Applicable to all Win32 applications. Helps us understand the status of the update process of the Office suite (Success or failure with error details).

The following fields are collected:

  • build - Currently installed Office version

  • channel - The channel by which Office was distributed

  • errorCode - Error code indicating the failure

  • errorMessage - Additional error information

  • status - Current status of the update

  • targetBuild - Version Office is updating to

Office.Compliance.FileFormatBallotDisplayedOnFirstBoot

Indicates whether the Office File Format choice dialog box was shown to the user on first/second boot of Word, Excel, PowerPoint on Win32. Tracks whether the FileFormat Ballot dialog box is displayed - event is sent at the first/second boot of Word, Excel, or PPT Win32.

The following fields are collected.

  • CountryRegion – The user's country or region setting in Windows system

  • FileFormatBallotBoxAppIDBootedOnce – In which app (Word, Excel, PPT) the file format ballot display logic was processed.

  • FileFormatBallotBoxDisplayedOnFirstBoot – What is the display result for file format ballot (displayed/not displayed as unexpected/not displayed due to license/not displayed due to location).

Office.Compliance.FileFormatBallotOption

Tracks whether the FileFormat Ballot dialog box is displayed - event is sent at the first/second boot of Word, Excel, or PPT Win32. Indicates whether the Office File Format choice dialog box is displayed on first or second boot of Word, Excel, or PowerPoint on Win32.

The following fields are collected:

  • FileFormatBallotSelectedOption – Identifies the file format option (OOXML/ODF) that was selected by the user through the file format ballot dialog box.

Office.CorrelationMetadata.UTCCorrelationMetadata

Collects Office metadata through UTC to compare with equivalent data collected through the Office telemetry pipeline to check correctness and completeness of data.

The following fields are collected:

  • abConfigs - A list of feature IDs to identify which features are enabled on the client or empty when this data isn't being collected.

  • abFlights - "NoNL:NoFlights" when the feature flights aren't set. Otherwise "holdoutinfo=unknown".

  • AppSessionGuid - An identifier of a particular application session starting at process creation time and persisting until process end. It's formatted as a standard 128-bit GUID but constructed of four parts. Those four parts in order are (1) 32-bit Process ID (2) 16-bit Session ID (3) 16 bit Boot ID (4) 64-bit Process creation time in UTC 100 ns

  • appVersionBuild - The app build version number.

  • appVersionMajor - The app major version number.

  • appVersionMinor - The app minor version number.

  • appVersionRevision - The app revision version number.

  • audienceGroup - The release audience group name

  • audienceId - The release audience name

  • channel - The channel by which Office was distributed

  • deviceClass - Device form factor from the OS

  • ecsETag - An experiment identifier for the process

  • impressionId - A guid indicating the current set of features.

  • languageTag - The current Office UI IETF language tag

  • officeUserID - Randomly generated guid for this Office install

  • osArchitecture - Operating system architecture

  • osEnvironment - An integer indicating the operating system (Windows, Android, iOS, Mac, etc.).

  • osVersionString - Operating system version

  • sessionID - Randomly generated guid to identify the app session

  • UTCReplace_AppSessionGuid - Constant boolean value. Always true.

Office.OneNote.Android.App.OneNoteLaunchedNonActivated

[This event was previously named OneNote.App.OneNoteLaunchedNonActivated.]

Records information about activation state of the App. The data is monitored to ensure we identify spikes in activation issues. We also analyze the data to find areas of improvement.

The following fields are collected:

  • INSTALL_LOCATION - Indicates if the app is pre-installed or is downloaded from Store

Office.OneNote.Android.ResetStatus

[This event was previously named OneNote.ResetStatus.]

The signal used to record any issues encountered when a user tries to reset the App. The telemetry is used to monitor, detect, and fix any issues caused during reset.

The following fields are collected:

  • Accounts - Indicates the types if accounts used for signing-into the App

  • Generic String Type - Returns if it's full reset of a notes_light_data reset

  • LaunchPoint - The point from where Reset is initiated. Possible values: Sign Out Button, Sign out failure, Intune Triggered

  • Pass - Indicates if the Reset was successful

Office.OneNote.Android.SignIn.SignInCompleted

[This event was previously named OneNote.SignIn.SignInCompleted.]

The signal is used to ensure sign-in successful or not. The data is collected to ensure critical regression detection for OneNote app and service health.

The following fields are collected:

  • CompletionState - Final state of sign in - Succeeded or failed. And failure cases

  • EntryPoint - Indicates from where Sign-In was initiated

  • Hresult - Error code

  • IsSignInCompleteFGEnabled - [Yes/ No] Status of feature gate during first boot

  • Provider Package ID - In case of Auto sign in

  • Result - Succeeded, Failed, Unknown, Canceled

  • ServerType - Returns the type of the server offering the service

  • SignInMode - Sign in or Sign up or Auto Sign-in or Sign up accelerated or AccountSignIn

Office.OneNote.Android.SignIn.SignInStarted

[This event was previously named OneNote.SignIn.SignInStarted.]

The signal is used to indicate any issues encountered while using Message Bar. The data is used to monitor, detect, and fix any issues caused during interaction with Message Bar.

The following fields are collected:

  • EntryPoint - Indicates from where Sign-In was initiated

  • Result - Result of the sign-in flow

  • ServerType - Returns the type of the server offering the service

  • SignInMode - Sign in or Sign up or Auto Sign in or Sign up accelerated or AccountSignIn

Office.OneNote.FirstRun.FirstRun

The critical signal used to ensure new users can successfully launch and run OneNote for the first time. The telemetry is collected to ensure critical regression detection for OneNote app and service health. If users can't launch the app for the first time, this would trigger a high severity incident.

  • AfterOneDriveFrozenAccountError - Indicates an error from OneDrive when an account is frozen.

  • Attempt - The number of times that the first run experience needs to retry.

  • IsDefaultNotebookCreated - Indicates whether OneNote has created a user's default notebook or not.

  • IsDelayedSignIn - Indicates whether the first run is in delayed sign-in mode where a user isn't required to signed-in.

  • IsMSA - Indicates whether an account is Microsoft account or not.

Office.OneNote.FirstRun.FirstRunForMSA

The critical signal used to ensure new consumer users (Microsoft Account) can successfully launch and use OneNote for the first time.

Telemetry used to ensure critical regression detection for OneNote app and service health. If users can't launch the app for the first time, this would trigger a high severity incident.

The following fields are collected:

  • Attempt - The number of times that the first run experience needs to retry.

  • Error A - OneNote's error object indicates an error during the first run if any.

  • FAllowAddingGuide - Indicates whether OneNote allows creating a guide notebook or not.

  • FrozenOneDriveAccount - Indicates whether a OneDrive account is frozen or not.

  • IsDefaultNotebookCreated - Indicates whether OneNote has created a user's default notebook or not.

  • NoInternetConnection - Indicates whether a device doesn't have internet connection.

  • ProvisioningFailure - A OneNote error object indicating a provisioning error if any.

  • ProvisioningFinishedTime - Indicates the end time when OneNote finishes provisioning a notebook during first run experience.

  • ProvisioningStartedTime - Indicates the start time when OneNote starts provisioning a notebook during first run experience.

  • ShowSuggestedNotebooks - Indicates whether OneNote will show a suggested notebook feature or not.

Office.OneNote.FirstRun.FirstRunForOrgId

The critical signal used to ensure new enterprise users (Microsoft Entra ID/OrgID) can successfully launch and run OneNote for the first time. Telemetry used to ensure critical regression detection for OneNote app and service health. If users can't launch the app for the first time, this would trigger a high severity incident.

  • Attempt - The number of times that the first run experience needs to retry.

  • Error - A OneNote's error object indicates an error during the first run if any.

  • FAllowAddingGuide - Indicates whether OneNote allows creating a guide notebook or not.

  • IsDefaultNotebookCreated - Indicates whether OneNote has created a user's default notebook or not.

  • ProvisioningFailure - A OneNote's error object indicates a provisioning error if any.

  • ProvisioningFinishedTime - Indicates the end time when OneNote finishes provisioning a notebook during first run experience.

  • ProvisioningStartedTime - Indicates the start time when OneNote starts provisioning a notebook during first run experience.

Office.OneNote.FirstRun.MruReaderNoteBookEntries

The signal used to record any issues encountered when loading Notebooks during First Run. The telemetry is used to monitor, detect, and fix any issues in First run.

The following fields are collected:

  • OnPremNBCount - Count of notebooks in on-premises Server

  • TotalNBCount - Total count of notebooks associated with the User Account

Office.OneNote.System.AppLifeCycle.UserAccountInfo

This event is triggered for shared code and records values for type of accounts signed in via isEdu, isMsftInternal, isIW, isMSA. The data is collected the first time the queue becomes idle after launch. This marker is used to track the types of accounts that have been signed in on the device. This helps us identify EDU users in OneNote.

The following fields are collected:

  • IsEdu - Possible values - true/false

  • IsMSA - Possible values - true/false

  • IsIW - Possible values – true/false

  • IsMsftInternal - Possible values – true/false

Office.Programmability.Addins.OnStartupCompleteEnterprise

This event is generated when a Legacy or COM Add-in is loaded on an enterprise device. The data is used to determine adoption and performance of Office add-ins.

The following fields are collected:

  • AddinConnectFlag - represents load behavior

  • AddinDescriptionV2 - the add-in description

  • AddinFileNameV2 - the add-in file name, excluding file path

  • AddinFriendlyNameV2 - the add-in friendly name

  • AddinIdV2 - the add-in Class ID

  • AddinProgIdV2 - the add-in prog ID

  • AddinProviderV2 - the add-in provider

  • AddinTimeDateStampV2 - the add-in timestamp from the DLL metadata

  • AddinVersionV2 - the add-in version

  • IsBootInProgress - whether the Office application is in the process of booting

  • LoadDuration - duration of the add-in load

  • LoadResult - success state of the load

  • OfficeArchitecture - Architecture of the Office client

Office.Taos.Hub.Windows.DiscoveredApps

This event gets triggered whenever the app gets booted. This event is used to record the number of installed apps in Office hub for the current user.

The following fields are collected:

  • ApiVersion - The API version.

  • AppInfo_Id - The App ID.

  • AppInfo_Version - Office desktop app version.

  • AppType - The type of the container, from which logs are emitted.

  • BridgeInstanceId - A unique ID given to the Office Windows app instance, used to corelate all the events from a single app session. We can't derive any PII from this ID.

  • Count - The count of installed apps in Office Hub.

  • DeviceInfo_Id - A unique device ID calculated by 1DS SDK.

  • DeviceInfo_Make - The device make.

  • DeviceInfo_Model - The device model.

  • DeviceInfo_NetworkCost - Network cost type of the user (Unmetered, metered, etc.)

  • DeviceInfo_NetworkType - The type of network (Wi-Fi, Wired, Unknown).

  • DeviceInfo_OsName - OS name installed in the user's Device.

  • DeviceInfo_OsVersion - The OS version installed in the user's device.

  • DeviceInfo_SDKUid - Unique identifier for the SDK.

  • EventInfo_BaseEventType - The event type.

  • EventInfo_BaseType - The type of the event.

  • EventInfo_Level - The event level.

  • EventInfo_Name - The name of the event.

  • EventInfo_PrivTags - The event tags.

  • EventInfo_Source - The source of the event. For example, OneCollector

  • EventInfo_SdkVersion - 1DS SDK Version.

  • EventInfo_Time - The time of the event.

  • Feature - The name of the feature.

  • M365aInfo_EnrolledTenantId - The Enrollment TenantID.

  • Method - The name of the calling method.

  • PerformanceMarkerTimestamp - The Performance Timestamp.

  • PipelineInfo_AccountId - Aria Pipeline account ID

  • PipelineInfo_ClientCountry - The device country or region (based on IP address).

  • PipelineInfo_ClientIp - The first three octets of the IP address.

  • PipelineInfo_IngestionTime - Ingestion time of the event.

  • UserInfo_TimeZone - Time zone of the user.

Office.Taos.Hub.Windows.InstalledSuites

This event gets triggered on app boot. This event is used to record the details of the installed Office apps.

The following fields are collected:

  • ApiVersion - The version of API.

  • AppInfo_Id - The App ID.

  • AppInfo_Version - Office desktop app version.

  • AppType - The type of the container, from which logs are emitted.

  • BridgeInstanceId - A unique ID given to the Office windows app instance, used to corelate all the events from a single app session. We can't derive any PII from this ID.

  • Count - Count of the installed apps.

  • DeviceInfo_Id - A unique device ID calculated by 1DS SDK.

  • DeviceInfo_Make - The device make.

  • DeviceInfo_Model - The device model.

  • DeviceInfo_NetworkCost - Network cost type of the user (Unmetered, metered, etc.)

  • DeviceInfo_NetworkType - The type of network (Wi-Fi, Wired, Unknown).

  • DeviceInfo_OsName - OS name installed in the user's device.

  • DeviceInfo_OsVersion - The OS version installed in the user's device.

  • DeviceInfo_SDKUid - Unique identifier for the SDK.

  • Duplicate - A boolean value indicating whether the app is duplicate or not.

  • EventInfo_BaseEventType - The event type.

  • EventInfo_BaseType - The type of the event.

  • EventInfo_Level - The event level.

  • EventInfo_Name - The name of the event.

  • EventInfo_PrivTags - The event tags.

  • EventInfo_Source - The source of the even. For example, OneCollector

  • EventInfo_SdkVersion - 1DS SDK Version.

  • EventInfo_Time - The time of the event.

  • Feature - The name of the feature.

  • IsO365 - A Boolean value indicating whether the app belongs to Office 365 suite or not.

  • M365aInfo_EnrolledTenantId - The Enrollment TenantID.

  • Method - The name of the calling method.

  • O365ProductId - Product ID of the Office 365 app.

  • Path - Hash of the path of the app.

  • PerformanceMarkerTimestamp - The Performance Timestamp.

  • PipelineInfo_AccountId - Aria Pipeline account ID

  • PipelineInfo_ClientCountry - The device country or region (based on IP address).

  • PipelineInfo_ClientIp - The first three octets of the IP address.

  • PipelineInfo_IngestionTime - Ingestion time of the event.

  • ProductCode - O365 product code.

  • ProductId - Product ID of the Office 365 app.

  • UserInfo_TimeZone - Time zone of the user.

  • Version - Version of the app.

Office.Taos.Hub.Windows.LocalDocuments

This event gets triggered whenever user opens MyContent app in Office desktop. This event is used to record the number of local documents supported by the installed apps in the Office desktop hub app like Word, Excel, PowerPoint, etc.

The following fields are collected:

  • AppInfo_Id - The App ID.

  • AppInfo_Version - Office desktop app version.

  • AppType - The type of the container, from which logs are emitted.

  • BridgeInstanceId - A unique ID given to the Office Windows app instance, used to corelate all the events from a single app session. We can't derive any PII from this ID.

  • DeviceInfo_Id - A unique device ID calculated by 1DS SDK.

  • DeviceInfo_Make - The device make.

  • DeviceInfo_Model - The device model.

  • DeviceInfo_NetworkCost - Network cost type of the user (Unmetered, metered, etc.)

  • DeviceInfo_NetworkType - The type of network (Wi-Fi, Wired, Unknown).

  • DeviceInfo_OsName - OS name installed in the user's device.

  • DeviceInfo_OsVersion - The OS version installed in the user's device.

  • DeviceInfo_SDKUid - Unique identifier for the SDK.

  • EventInfo_BaseEventType - The event type.

  • EventInfo_BaseType - The type of the event.

  • EventInfo_Level - The event level.

  • EventInfo_Name - The name of the event.

  • EventInfo_PrivTags - The event tags.

  • EventInfo_Source - The source of the event. For example, OneCollector

  • EventInfo_SdkVersion - 1DS SDK Version.

  • EventInfo_Time - The time of the event.

  • Feature - The name of the Feature.

  • M365aInfo_EnrolledTenantId - The Enrollment TenantID.

  • Method - The name of the calling method.

  • PerformanceMarkerTimestamp - The Performance Timestamp.

  • PipelineInfo_AccountId - Aria Pipeline account ID

  • PipelineInfo_ClientCountry - The device country or region (based on IP address).

  • PipelineInfo_ClientIp - The first three octets of the IP address.

  • PipelineInfo_IngestionTime - Ingestion time of the event.

  • Removed - The count of total number of local document removed.

  • Total - The count of total number of local document.

  • UserInfo_TimeZone - Time zone of the user.

Office.Taos.Hub.Windows.NewWindowRequest

This event gets triggered whenever user clicks on a valid hyperlink in the desktop app. This event is used to record a new window request by user from the desktop app.

The following fields are collected:

  • AppInfo_Id - The App ID.

  • AppInfo_Version - Office desktop app version.

  • AppType - The type of the container, from which logs are emitted.

  • BridgeInstanceId - A unique ID given to the Office windows app instance, used to corelate all the events from a single app session. We can't derive any PII from this ID.

  • DeviceInfo_Id - A unique device ID calculated by 1DS SDK.

  • DeviceInfo_Make - The device make.

  • DeviceInfo_Model - The device model.

  • DeviceInfo_NetworkCost - Network cost type of the user (Unmetered, metered, etc.)

  • DeviceInfo_NetworkType - The type of network (Wi-Fi, Wired, Unknown).

  • DeviceInfo_OsName - OS name installed in the user's device.

  • DeviceInfo_OsVersion - The OS version installed in the user's device.

  • DeviceInfo_SDKUid - Unique identifier for the SDK.

  • EventInfo_BaseEventType - The event type.

  • EventInfo_BaseType - The type of the event.

  • EventInfo_Level - The event level.

  • EventInfo_Name - The name of the event.

  • EventInfo_PrivTags - The event tags.

  • EventInfo_Source - The source of the event. For example, OneCollector

  • EventInfo_SdkVersion - 1DS SDK Version.

  • EventInfo_Time - The time of the event.

  • Feature - The name of the feature.

  • IsUserInitiated - A Boolean value indicating whether the action is initiated by user or not.

  • KnownWindowType - The name of the Window type. For example, MsalAuthWindow, MOSHubSdkAuthWindow, etc.

  • M365aInfo_EnrolledTenantId - The Enrollment TenantID.

  • PerformanceMarkerTimestamp - The Performance Timestamp.

  • PipelineInfo_AccountId - Aria Pipeline account ID

  • PipelineInfo_ClientCountry - The device country or region (based on IP address).

  • PipelineInfo_ClientIp - The first three octets of the IP address.

  • PipelineInfo_IngestionTime - Ingestion time of the event.

  • PolicyAction - An Integer which denoted policy action type.

  • UriProtocol - Protocol of the URI.

  • UriSuspicious - A Boolean value indicating whether the URI is suspicious or not.

  • UserInfo_TimeZone - Time zone of the user.

Office.Taos.Hub.Windows.Proxy

This event gets triggered on opening any URI from Office desktop. This event is used to record the trust level of the opened URI from Office desktop app.

The following fields are collected:

  • AppInfo_Id - The App ID.

  • AppInfo_Version - Office desktop app version.

  • AppType - The type of the container, from which logs are emitted.

  • BridgeInstanceId - A unique ID given to the Office Windows app instance, used to corelate all the events from a single app session. We can't derive any PII from this ID.

  • DeviceInfo_Id - A unique device ID calculated by 1DS SDK.

  • DeviceInfo_Make - The device make.

  • DeviceInfo_Model - The device model.

  • DeviceInfo_NetworkCost - Network cost type of the user (Unmetered, metered, etc.)

  • DeviceInfo_NetworkType - The type of network (Wi-Fi, Wired, Unknown).

  • DeviceInfo_OsName - OS name installed in the user's device.

  • DeviceInfo_OsVersion - The OS version installed in the user's device.

  • DeviceInfo_SDKUid - Unique identifier for the SDK.

  • EventInfo_BaseEventType - The event type.

  • EventInfo_BaseType - The type of the event.

  • EventInfo_Level - The event level.

  • EventInfo_Name - The name of the event.

  • EventInfo_PrivTags - The event tags.

  • EventInfo_Source - The source of the event. For example, OneCollector

  • EventInfo_SdkVersion - 1DS SDK Version.

  • EventInfo_Time - The time of the event.

  • Feature - The name of the feature.

  • Level - Trust Level of the URI which is targeted to open.

  • M365aInfo_EnrolledTenantId - The Enrollment TenantID.

  • PerformanceMarkerTimestamp - The Performance Timestamp.

  • PipelineInfo_AccountId - Aria Pipeline account ID

  • PipelineInfo_ClientCountry - The device country or region (based on IP address).

  • PipelineInfo_ClientIp - The first three octets of the IP address.

  • PipelineInfo_IngestionTime - Ingestion time of the event.

  • Uri - URI which is tried to open in the WebView of the Office desktop app.

  • UserInfo_TimeZone - Time zone of the user.

Office.Taos.Hub.Windows.Resource

This event gets triggered on app boot. This event is used to record the static image/resource loading metadata for loading icons in Office desktop app, for example, Back button.

The following fields are collected:

  • AppInfo_Id - The App ID.

  • AppInfo_Version - Office desktop app version.

  • AppType - The type of the container, from which logs are emitted.

  • BridgeInstanceId - A unique ID given to the Office Windows app instance, used to corelate all the events from a single app session. We can't derive any PII from this ID.

  • DeviceInfo_Id - A unique device ID calculated by 1DS SDK.

  • DeviceInfo_Make - The device make.

  • DeviceInfo_Model - The device model.

  • DeviceInfo_NetworkCost - Network cost type of the user (Unmetered, metered, etc.)

  • DeviceInfo_NetworkType - The type of network (Wi-Fi, Wired, Unknown).

  • DeviceInfo_OsName - OS name installed in the user's device.

  • DeviceInfo_OsVersion - The OS version installed in the user's device.

  • DeviceInfo_SDKUid - Unique identifier for the SDK.

  • EventInfo_BaseEventType - The event type.

  • EventInfo_BaseType - The type of the event.

  • EventInfo_Level - The event level.

  • EventInfo_Name - The name of the event.

  • EventInfo_PrivTags - The event tags.

  • EventInfo_Source - The source of the event. For example, OneCollector

  • EventInfo_SdkVersion - 1DS SDK Version.

  • EventInfo_Time - The time of the event.

  • Feature - The name of the feature.

  • M365aInfo_EnrolledTenantId - The Enrollment TenantID.

  • PipelineInfo_AccountId - Aria Pipeline account ID

  • PipelineInfo_ClientCountry - The device country or region (based on IP address).

  • PipelineInfo_ClientIp - The first three octets of the IP address.

  • PipelineInfo_IngestionTime - Ingestion time of the event.

  • Resource - It's the name of the static images/icons we load in windows app. For example, BackButton.

  • UserInfo_TimeZone - Time zone of the user.

Office.TargetedMessaging.EnsureCached

Tracks if a package for Dynamic Canvas was downloaded. Considered a software configuration because the package must be successfully downloaded to enable the client to render the right experience. Is especially critical in consumer subscriptions where we use canvas to communicate to the user that the license has expired. Used to track metadata of a dynamic content package downloaded and cached by the product and results of operations performed on the package: download failures, unpacking failures, consistency checks failures, cache hits, package usages, download sources.

The following fields are collected:

  • Data_CacheFolderNotCreated - Boolean flag indicating if cache folder creation succeeded

  • Data_CdnPath – source address of the package-

  • Data_EnsureCached - Boolean flag indicating if content package was cached

  • Data_ExistsAlready - Boolean flag indicating that the package was already downloaded before and there was another attempt

  • Data_GetFileStreamFailed - source package not available in source

  • Data_GetFileStreamFailedToCreateLocalFolder - local disk issues causing failure in directory creation

  • Data_GetFileStreamFromPackageFailed - flag indicating if package was downloaded, but the client can't read it

  • Data_GetFileStreamFromPackageSuccess - successful attempts to read the package

  • Data_GetFileStreamSuccess - no disk issues nor configuration issues that don't let the file stream to be read

  • Data_GetRelativePathsFailed - relative path doesn't point to accessible location

  • Data_HashActualValue - hash value extracted from file name when the package was used

  • Data_HashCalculationFailed - error with calculation of a hash

  • Data_HashMatchFailed - hash mismatch between the package name and registry values cached

  • Data_HashMatchSuccess - hash consistency check success

  • Data_PackageDownloadRequestFailed - can't download the package

  • Data_PackageDownloadRequestNoData - downloaded package contains no data

  • Data_PackageDownloadRequestSuccess - successful download of a package

  • Data_PackageExplodedSuccess - unpacking attempts statuses

  • Data_PackageOpenFailed - failed attempts to open the package file

  • Data_PackageOpenSuccess - successful attempts to open the package file

  • Data_SuccessHashValue - hash value extracted from file name when the package was downloaded

  • Data_SuccessSource - surface for which the package was downloaded

Office.Visio.VisioSKU

Captures Visio SKU whether it's standard or professional. Essential to categorize issues based on SKU.

The following fields are collected:

  • Data_VisioSKU:integer - 0 for Standard SKU and 1 for Professional SKU

onboarding.flow

This event is used to track users’ success while setting up Outlook Mobile. It's critical to detecting errors in user experience and processing that could prevent successful completion.

The following fields are collected:

  • accounts_found - an integer indicating how many accounts are found during the SSO (Single Sign On) process.

  • accounts_selected - an integer indicating how many SSO accounts the user has selected to add as Outlook accounts.

  • action – The step the user has taken (page_load, a button was pressed (next button, skip button), filled in an input field)

  • page_title – Which page of the onboarding flow the user is on

  • page_version – What version of the page is shown (1 for current version, greater numbers for redesign and experiments)

Office add-in configuration subtype

Software add-ins and their settings​.

Excel.AddinDefinedFunction.CustomFunctionsAllInOne

Collects information about runtime behavior of custom add-in functions. Maintains counters of execution attempts, successful completions, infrastructure errors, and user code errors. This is used to identify reliability issues in the product and fix user-impacting problems.

The following fields are collected:

  • AsyncBegin - number of async functions that begin

  • AsyncEndAddinError - number of async functions that end in error

  • AsyncEndInfraFailure - number of async functions that end with in infra failure

  • AsyncEndSuccess - number of async functions that end successfully

  • AsyncRemoveCancel - number of async functions that were canceled

  • AsyncRemoveRecycle - number of async functions that were removed due to recycle

  • StreamingCycles1 - streaming cycle counter

Office.Extensibility.AppCommands.AppCmdProjectionStatus

Collects information to track which Office add-in installations successfully updated the ribbon vs failed.

Used to fix common registration issues where add-ins aren't installed properly and never show up resulting in them being unusable.

The following fields are collected:

  • None

Office.Extensibility.AppCommands.AddSolution

Collects install information for Office add-ins that customize the ribbon. Used to detect issues with how custom add-ins modify the Office ribbon.

The following fields are collected:

  • AppVersion - version of the app

  • SolutionId - ID of the solution

  • StoreType - indicates the origin of the app

Office.Extensibility.Catalog.ExchangeGetEntitlements

Data regarding the success for failure of retrieving add-in entitlement data for the Office 365 tenant admin assigned add-ins. Used for health metrics, charts, and analysis of customer problems.

The following fields are collected:

  • CachingResult - the result of the attempt to save the service call return value

  • ClientParameter - client identifier sent in the service call

  • EntitlementsCount - The number of entitlements expected in the call response

  • EntitlementsParsed - the number of entitlements parsed from the response

  • IsAllEntitlementsParsed - whether expected entitlements count matches parsed entitlements count

  • ServiceCallHResult - the result returned by the service call API

  • TelemetryId - a GUID representing a unique user

  • UsedCache - whether the cached response was used instead of making a service call

  • VersionParameter - Office version number sent in the service call

Office.Extensibility.Catalog.ExchangeGetLastUpdate

Data regarding the success for failure of retrieving the need for updated data regarding the Office 365 tenant admin assigned add-ins. Used for health metrics, charts, and analysis of customer problems. ExchangeGetLastUpdate will always run on boot as part of the host code and determine whether add-in assignments have changed for a user.  If so then osf.DLL will be loaded so we can call ExchangeGetEntitlements to get the specific assignments (and ExchangeGetManifests will be called to retrieve any new manifests that are needed). ExchangeGetEntitlements (and ExchangeGetManifests) could also be called on demand after host application has been running. The idea is to not load the large DLL if we don't need to. Without this event in Required, we wouldn't be able to tell if users are failing to get add-ins assigned to them if that first service call fails. It's also the main signal for any auth problems we face talking to our service.

The following fields are collected:

  • Abort - whether the host was shut down during the service call

  • AllowPrompt - whether auth prompting was allowed

  • AuthScheme - the auth scheme requested by exchange

  • BackEndHttpStatus - http code reported when talking to exchange back end

  • BackupUrl - the secondary exchange URL to call

  • BEServer - the back-end exchange server name

  • CalculatedBETarget - The full name of the exchange back end machine

  • Call(n)_TokenAuthError - the auth error of the nth service call attempt

  • Call(n)_TokenIsValid - whether the auth token on the nth service attempt was valid

  • CallMethod - a string indicating which path the code took

  • ConfigSvcReady - whether the config service had been initialized yet

  • Date - value returned by exchange server

  • DiagInfo - information returned by exchange server

  • End_TicketAuthError - any error in getting the auth ticket after service call

  • End_TokenIsValid - whether the auth ticket is valid after the service call

  • EndingIdentityState - identity objects reported state after making the service calls

  • EwsHandler - value returned from exchange

  • FEServer - the exchange front end servicing the request

  • HResult - the result code

  • HttpStatus - Http status code returned from exchange

  • IsSupportedAuthResponse - whether the auth type is one we can use

  • LastUpdateValueRegistry - hash value retrieved from the registry

  • LastUpdateValueRetrieved - hash value returned from the service call

  • MSDiagnostics - value returned from exchange

  • MsoHttpResult - the enumerator value returned from the http API

  • NeedRefresh –- This is a true or false field indicating whether the add-in data was stale and we needed to update it.

  • PrimaryUrl - the main URL to make the service call to

  • RequestId - value returned from exchange

  • RequestTryCount - the number of times we attempted to make the service call

  • RequestTryCount - the number of times we tried to talk to exchange

  • ResultChain - the series of result code from each of the service call attempts

  • StartingIdentityState - identity objects reported state before making service calls

  • TelemetryId - a GUID representing a unique user whether we need to make other service calls

Office.Extensibility.Catalog.ExchangeGetManifests

Data regarding the success for failure of retrieving add-in manifests data for the Office 365 tenant admin assigned add-ins. Used for health metrics, charts, and analysis of customer problems.

The following fields are collected:

  • CachedManifestsParsed – the number of manifests found in the cache

  • IsAllReturnedManifestsParsed – whether all the manifests that were returned were able to be parsed

  • ManifestsRequested – the number of manifests needed

  • ManifestsReturned – the number of manifest returned from the server

  • ManifestsToRetrieve – the number of manifests to get from the server

  • ReturnedManifestsParsed – the number of manifests returned from the server that were successfully parsed

  • TelemetryId – a GUID representing a unique user

Office.Extensibility.UX.FEnsureLoadOsfDLL

Tracks failure to load Osf.DLL. Detect DLL load failure that prevents feature from running.

The following fields are collected:

  • None

Office.Extensibility.UX.FEnsureLoadOsfUIDLL

Tracks failure to load OsfUI.DLL. Detect DLL load failure that prevents feature from running.

The following fields are collected:

  • None

Office.Extensibility.UX.FEnsureOsfSharedDLLLoad

Tracks failure to load OsfShared.DLL. Detect DLL load failure that prevents feature from running.

The following fields are collected:

  • None

Office.Extensibility.VBATelemetryComObjectInstantiated

Collects information about invocation of automation server or client in VBA solutions. Used to understand interaction between VBA and COM Objects.

The following fields are collected:

  • ComObjectInstantiatedCount – number of COM Object instantiations

  • HashComObjectInstantiatedClsid – hash of COM Object Class Identifier

  • HashProjectName – hash of the VBA project name

  • TagId – unique tag

Office.Extensibility.VBATelemetryDeclare

Collects information about invocation of Win32 APIs in VBA solutions. Used to understand interaction between VBA and usage and to supplement security investigations.

The following fields are collected:

  • DeclareCount – number of declarations

  • HashDeclare – hash of the DLL name

  • HashEntryPoint – hash of the API Name

  • HashProjectName – hash of the VBA project name

  • IsPtrSafe – whether the declaration statement is compatible for different architecture

  • TagId – unique tag

Office.Outlook.Desktop.Add-ins.Add-inLoaded

Collects the success and failure of Outlook loading of an add-in. This data is actively monitored in order to ensure Outlook is correctly working with customer add-ins. This data is used to detect and investigate issues.

The following fields are collected:

  • Standard HVA activity with no custom payload

Office.Outlook.Mac.AddinAPIUsage

Collects success and failure of add-in execution in Outlook. This data is actively monitored to ensure Outlook is correctly working with add-ins. This data is used to detect and investigate issues.

The following fields are collected:

  • AccountType - type of account associated with the add-in

  • Cookie - cookie used by add-in

  • DispId - dispatch identifier

  • EndTime - time when add-in ended

  • ExecutionTime - time elapsed during execution of add-in

  • Result - result of using the add-in in Outlook

  • StartTime - time when add-in started

Office.Outlook.Mac.AddinEventAPIsUsage

Collects success or failure of add-in execution in Outlook. This data is actively monitored to ensure Outlook is correctly working with add-ins. This data is used to detect and investigate issues.

The following fields are collected:

  • AddinType - type of add-in

  • EventAction - action performed by the add-in

  • EventDispid - dispatch identifier

  • EventResult - result of the action performed by the add-in

Office.Outlook.Mac.AddInInstallationFromInClientStore

Collects success or failure of add-in installation in Outlook. This data is actively monitored to ensure Outlook is correctly working with add-ins. This data is used to detect and investigate issues.

The following fields are collected:

  • AccountType - type of account associated with add-in

  • FailureReason - reason add-in failed to install

  • MarketplaceAssetId - store add-in identifier

  • Status - status of add-in installation

Office.Programmability.Addins.InternalSetConnectEnterprise

Event generated when a COM Add-in is loaded on an enterprise device. Used to determine adoption, performance, and reliability issues with Office add-ins.

The following fields are collected:

  • Activity Result - Success state of the connection [This field has been removed from current builds of Office, but might still appear in older builds.]

  • AddinConnectFlag – represents load behavior

  • AddinDescriptionV2 - the add-in description

  • AddinFileNameV2 - the add-in file name, excluding file path

  • AddinFriendlyNameV2 - the add-in friendly name

  • Add-inId – the add-in Class ID [This field has been removed from current builds of Office, but might still appear in older builds.]

  • AddinIdV2 - the add-in Class ID

  • AddinProgIdV2 - the add-in prog ID

  • AddinProviderV2 - the add-in provider

  • Add-inTimeDateStamp – the add-in timestamp from the DLL metadata [This field has been removed from current builds of Office, but might still appear in older builds.]

  • AddinTimeDateStampV2 - the add-in timestamp from the DLL metadata

  • AddinVersionV2 - the add-in version

  • IsAppClosedWhileLoadingInBoot- Whether the add-in was loaded during boot cancellation

  • IsBootInProgress – whether the Office application is in the process of booting

  • LoadDuration - duration of the add-in load

  • LoadResult - success state of the load

  • OfficeArchitecture - Architecture of the Office client

Office.Programmability.Addins.RibbonButtonClick

The event is generated the first time in a session the user clicks a button added to the ribbon by a specific add-in. If the session spans multiple days, this telemetry will be sent once per day instead. The data is used in two ways: 1. When an add-in breaks, knowing how much users truly use the add-in helps us triage the issue. 2. To display to admins as part of COM add-in management scenarios in add-in Inventory and as part of planned add-in health scenarios in Microsoft 365 Apps health. Admins will be able to monitor add-in usage per device, letting them disable or uninstall unused COM add-ins.

The following fields are collected:

  • Add-inTimeDateStamp - The add-in timestamp from the DLL metadata

  • CLSID - The add-in class identifier

  • Description - The add-in description

  • FileName - The add-in file name, excluding the file path

  • FriendlyName - The add-in friendly name

  • OfficeApplication - The Office application currently executing

  • ProgID - The add-in Prog identifier

Office.Visio.Visio.AddonLoad

Captures errors when a solution fails to load. Essential to debug addon load errors in Visio.

The following fields are collected:

  • Data_Load1Error:integer - Error value during the load of Visio add-on

Office.Visio.Visio.AddonUsage

Captures errors when there's an error in solution functionality. Essential to debug addon errors in add-ons.

The following fields are collected:

  • Data_DocumentSessionLogID:string - Document session identifier

  • Data_IsEnabled:bool - true if solution is enabled

  • Data_TemplateID:string - GUID of template in which solution was loaded. Logged as 0 for custom solution

  • Data_AddOnID:string - GUID to identify addon loaded

  • Data_Error:integer - Error ID

Security subtype

Document, feature, and add-in error conditions that may compromise security, including product update readiness.

Office.AppGuard.CreateContainer

We collect error codes and whether the container already existed or not. We also collect error codes for a reset event in case we fail to create the container on our first attempt. Data is used identify the percentage of sessions we successfully create the container for launching Office Application Guard apps. Data will also allow Microsoft to identify and address error codes from the container creation.

The following fields are collected:

  • ErrorCode1 - Type of container setup error code.

  • ErrorCode2 - Error code from executing the creation.

  • ErrorCode3 - Additional error code.

  • Id - A unique identifier (GUID) for the container creation.

  • ResetError - Error code from trying to reset the container after a failed attempt.

  • ResetErrorCode1 - Type of Container Setup Error code after reset command.

  • ResetErrorCode2 - Error code from executing the creation after reset command.

  • ResetErrorCode3 - Additional error code after reset command.

  • ResetErrorType - Type of error during reset: Creation, Preparing File or Launch.

  • WarmBoot - Identifies whether the container was already created or not.

Office.AppGuard.LaunchFile

This event denotes the result of an Application Guard launch file execution. We'll be able to define the percentage of sessions we successfully launched a Word, Excel, or PowerPoint file and the error codes for the failed attempts.

The following fields are collected:

  • AppId – Identifies which App is being launched.

  • DetachedDuration – Identifies the total time the merged activity took.

  • ErrorCode1 – Type of container setup error code.

  • ErrorCode2 – Error code from executing the creation.

  • ErrorCode3 - Additional error code.

  • FileId - A unique identifier (GUID) returned from the Windows API after launching a file.

  • Id – A unique identifier (GUID) for the launching and creating a file. This ID is used to correlate events from Office and Windows.

  • LaunchBootType - The actions required to launch the container. For example, existing container used, existing container terminated and new container created.

  • LockFile - Whether the file to be opened was locked by the Application Guard process.

  • Reason - Indicates why the file was opened in Application Guard. For example, file has mark of the web, file is in unsafe location.

  • ResetError - Error code from trying to reset the container after a failed attempt.

  • ResetErrorCode1 – Type of container setup error code after reset command.

  • ResetErrorCode2 – Error code from executing the creation after reset command.

  • ResetErrorCode3 - Additional error code after reset command.

  • ResetErrorType - Type of error: Creation, PrepFile, or Launch.

Office.AppGuard.OpenInContainer

This event is triggered when the Office application running in the Application Guard container signals that the request to open a file has been received. The data is used to diagnose failures during the initialization of the Office application in the Application Guard container.

The following fields are collected:

  • FileId - A unique identifier (GUID) for the file in the Application Guard container. Used to correlate Application Guard events that occur inside and outside the container.

Office.Security.ActivationFilter.CLSIDActivated

Tracks when a specific Class Identifier (Flash, Silverlight etc.) is activated in Office. Used to track impact of blocking Flash, Silverlight, and Shockwave controls on end users.

The following fields are collected:

  • ActivationType - Type of activation for the control

  • Blocked - was the control blocked by Office

  • CLSID - class identifier of the control

  • Count - how many times the control was activated

Office.Security.ActivationFilter.FailedToRegister

Tracks an error condition in security mitigation that blocks activation of dangerous controls in Office.

Used to diagnose error conditions in security mitigation that could impact security of end users.

The following fields are collected:

  • None

Office.Security.ComSecurity.FileExtensionListFromService

Tracks if packager block extensions were read from config service or we used client default list. Used to ensure effectiveness of security mitigation that protects end users of Office.

The following fields are collected:

  • RetrievedFromServiceStatus - were we able to retrieve the list of file extensions to block if not then what was the error reason

Office.Security.ComSecurity.Load

Tracks when an OLE object is loaded in a document. Used to ensure effectiveness of security mitigation that protects end users of Office.

The following fields are collected:

  • Clsid - class identifier of the OLE control

  • Count - how many times the OLE control was loaded

  • DocUrlHash - a hash representing the document uniquely. (Note – no way to find out the actual details of the document from this. It's just a unique representation of the document.)

  • IsCategorized – was the OLE control categorized to load in Office

  • IsInsertable – is the OLE control insertable or not

Office.Security.ComSecurity.ObjDetected

Tracks when an OLE object is detected in a document. Used to ensure effectiveness of security mitigation that protects end users of Office.

The following fields are collected:

  • Clsid - class identifier of the OLE control

  • Count - how many times this OLE object was detected

  • DocUrlHash - a hash representing the document uniquely. (Note – no way to find out the actual details of the document from this. It's just a unique representation of the document.)

  • IsCategorized - is the OLE control categorized to load in Office

  • IsInsertable - is the OLE control insertable or not

Office.Security.ComSecurity.PackagerActivation

Tracks the outcome of security mitigation that blocks dangerous extensions embedded in Office documents. Used to ensure effectiveness of security mitigation that protects end users of Office.

The following fields are collected:

  • FromInternet - was the document from internet

  • PackagerSetting - what was the current packager setting

  • TrustedDocument - was the document a trusted document

Office.Security.ComSecurity.PackagerActivationErrors

Tracks error conditions in security mitigation that blocks dangerous extensions embedded in Office documents. Used to ensure effectiveness of security mitigation that protects end users of Office.

The following fields are collected:

  • Error - error code

  • Extension - what was the file extension

  • FromInternet - was the document from internet

  • LinkedDocument - was it a linked document or not

  • PackagerSetting - what was the current packager setting

  • TrustedDocument - was the document trusted

Office.Security.Macro.InternetVBABlockEnabled

Tracks whether the Block Macro from Internet setting is enabled in a client. Assess use of security mitigation to protect against malicious macros.

The following fields are collected:

  • None

Office.Security.Macro.PolicyDigSigTrustedPublishers

Tracks if the macro was verified to be from a trusted publisher. Used to ensure effectiveness of security mitigation that protects end users of Office.

The following fields are collected:

  • Policy - is the policy set, not set, or not available

Office.Security.Macro.Prompted

Tracks when a user is prompted to enable VBA Macros. Used to assess prevalence of VBA Macros and drive future security mitigations that restrict macro execution in response to security incidents.

The following fields are collected:

  • PromptType - what type of prompt was shown

  • VBAMacroAntiVirusHash - antivirus hash of the macro

  • VBAMacroAntiVirusHRESULT - result of the antivirus assessment

Office.Security.Macro.VBASecureRuntimeSessionEnableState

Tracks each AMSI runtime verification performed when a macro executes. Tracks effectiveness of the AMSI runtime verification of Macro execution and identify errors that could impact security of end users.

The following fields are collected:

  • IsRegistry - did admin set some override in registry

  • State - what is the state to for secure runtime

Office.Security.Macro.XL4Prompted

Tracks when a user is prompted to enable XL4 Macros. Used to assess prevalence of XL4 Macros in Excel to drive future security mitigations that block XL4 by default in response to security incidents that involve abusing XL4 macros.

The following fields are collected:

  • PromptType - what type of prompt was shown

Office.Security.OCX.UFIPrompt

Tracks when a security prompt is shown to the user when loading an ActiveX control that is marked Unsafe for Initialization. Used to track prevalence of UFI ActiveX controls in Office documents to drive mitigations (for example, killbitting controls) in response to security incidents.

The following fields are collected:

  • IsFromInternet - is the document opened from internet

  • IsSecureReaderMode - is the document opened in secure reader

  • OcxTrustCenterSettings - what is the current ActiveX setting

Office.Security.SecureReaderHost.OpenInOSR

Tracks completion of an open in Protected View. Used to diagnose conditions that lead to failures when opening files in Protected View impacting security and productivity of customers.

The following fields are collected:

  • None

Product and service usage data events

The following are the data subtypes in this category:

Application feature success subtype

Success of application functionality. Limited to opening and closing of the application and documents, file editing, and file sharing (collaboration).​

account.action

The event is triggered when the user creates, adds, resets, or deletes their account. The data is needed to ensure account configuration is operating successfully and is used to monitor health of account creation, ability to add new email accounts, and monitor soft account resets.

The following fields are collected:

  • account_calendar_count - how many calendars the account has

  • account_state - The current error state of the account

  • action - type of action performed, for example, create_account, delete_account.

  • auth_framework_type – type of auth framework used during this session. (for example, ADAL, OneAuth)

  • duration_seconds - duration of the action

  • entry_point - entry point of the action, how the user started the action

  • has_hx - whether the device has an account that is using our new mail syncing service, not necessarily the account that the action was performed upon

  • is_hx - is the account using our new mail syncing service

  • is_shared_mailbox - whether the action pertains to a shared mailbox

  • number_of_accounts - total number of accounts that the action is performed on

  • policy_did_change - If the Intune policy on the account changed and caused this account action

  • result - result for the action, for example, success, failure.

  • scope - the scope of the action; for delete account, this_device or all_devices

  • server_type - the server type for the account, similar to account_type

  • shared_type - type of shared account (if the account is shared)

  • source - Identifies the initial point when the account action started.

  • total_calendar_accounts - count of calendar accounts in the app at time of action

  • total_email_accounts - count of email accounts in the app at time of action

  • total_file_accounts - count of file accounts in the app at time of action

account.lifecycle

This event is collected to ensure account configuration is operating successfully and is used to monitor health of account creation, ability to add new email accounts, and monitor soft account resets.

The following fields are collected:

  • account_creation_source – optional property that is used to find and diagnose any issues that happen during account creation when the action type is add. It can have values like single sign-on (SSO), create_new_account, manual, etc.

  • action - The type of action performed on the account, such as add, remove, or reset

  • auth_framework_type - optional property to track what type of framework was used to add the account. It can have values such as oneauth, adal, or none.

add.new.account.step

This event lets us detect how far the user has gotten in the create new account form. It indicates when the user has moved to another step or if they have dropped off. We need this information to detect if any steps are failing and to ensure user account creation was successful.

The following fields are collected:

  • OTAddAccountCurrentStep - That can have the following values: profile_form, redirect_mobile_check, mobile_check_success

app.error

Tracks critical app errors used so that we can prevent issues that could cause your app to crash or prevent you from reading email.

The following fields are collected:

  • clientName - The name of the client for the cloud file where the error occurred, if applicable.

  • cloudfile_error_type - The type of error that occurred for the cloud file, if applicable.

  • cloudfile_response_name - The response name for the error that occurred for the cloud file, if applicable.

  • component_name - The name of the component of the app where the error occurred, such as mail or calendar.

  • debug_info - Information on the error that occurred for the cloud file in order to be able to determine why the error happened.

  • error_origin_identifier - Origin of the error that occurred on the draft that the error occurred, if applicable.

  • error_type - The type of error that occurred. Some examples include save draft, send draft, and cloud file error.

  • exdate - the extended rule date (only applies to appointment recurrence errors) [This field has been removed from current builds of Office, but might still appear in older builds.]

  • exrule - the extended rule value (only applies to appointment recurrence errors) [This field has been removed from current builds of Office, but might still appear in older builds.]

  • has_attachments - Reflects if the draft the error occurred on has attachments, if applicable.

  • is_IRM_protected - Reflects if the draft the error occurred on is protected by information rights management, if applicable.

  • is_legitimate - Reflects if the error comes from a programming error or not. Programming errors are considered non-legitimate.

  • is_local - Reflects if the draft the error occurred on has synced to the server, if applicable.

  • is_recoverable - Reflects if the error can be recovered from or if it's a fatal error.

  • load_media_error_code - The code of the error that occurred when loading media. This helps us understand the cause of the error.

  • load_media_source - The source of the loading media when error occurred.

  • rdate - the date of the recurrence rule (only applies to appointment recurrence errors) [This field has been removed from current builds of Office, but might still appear in older builds.]

  • rrule - the recurrence rule itself (only applies to appointment recurrence errors) [This field has been removed from current builds of Office, but might still appear in older builds.]

  • rrule_error_message - recurrence rule parsing error message (only applies to appointment recurrence errors) [This field has been removed from current builds of Office, but might still appear in older builds.]

  • rrule_error_type - recurrence rule parsing error type (only applies to appointment recurrence errors) [This field has been removed from current builds of Office, but might still appear in older builds.]

  • shared_type - Shared email account type, shared/delegate/none. When collecting draft send error, we need to know the account type.

  • status_code - The status code of the error that occurred. This helps us understand the cause of the error.

All characters are also possible properties. This helps us understand the characters in the body of the draft message when the error occurred. For example, "a", "b", "c" are possible properties.

app.launch.report

This event is triggered when Outlook starts slowly or incompletely. The data collected provides information on the specific features that were enabled and how long parts of the startup took. It allows us to detect and fix the cause of the issues.

The following fields are collected:

  • aad_tenant_id - Tells us the Microsoft Entra tenant ID for the primary account so that we can identify tenants with slow launches.

  • is_agenda_widget_active - Tells us if the agenda widget is active.

  • is_alert_available - Tell us if the app has been configured to allow alerts in notifications.

  • is_background_refresh_available - Tells if the app has been configured to be able to refresh in the background.

  • is_badge_available - Tell us if the app has been configured to allow badges in notifications.

  • is_intune_managed - Tell us if the app is managed by Intune.

  • is_low_power_mode_enabled - Tells us if the device has low power mode turned on

  • is_registered_for_remote_notifications - Tell us if the app has been registered for remote notifications.

  • is_sound_available - Tell us if the app has been configured to allow sounds in notifications.

  • is_watch_app_installed - Tells us if the watch Outlook app has been installed.

  • is_watch_paired - Tell us if the watch Outlook app is paired with the main Outlook app.

  • launch_to_db_ready_ms - Tell us the amount of time the Outlook app spent from launch to the database being ready.

  • num_calendar_accounts - Tells us the number of calendar accounts in the app.

  • num_cloud_file_accounts - Tells us the number of storage accounts in the app.

  • num_hx_calendar_accounts - Tells us the number of calendar accounts in the app that connect to our new mail syncing service.

  • num_hx_mail_accounts - Tells us the number of mail accounts in the app that connect to our new mail syncing service.

  • num_mail_accounts - Tells us the number of mail accounts in the app.

calendar.action

This event reports part of the calendar event data after creating event or editing events. This is used for monitoring any possible negative impact on your ability to perform core calendar actions.

The event could also include a series of property names and if they have changed or not. For example, "title_changed", "online_meeting_changed", and "description_changed" are property names that are included to help us understand if there are any issues with editing certain properties.

The following fields are collected:

  • account_sfb_enabled - Helps us make sure that Skype for Business is configured correctly.

  • action - The type of action that was performed on the calendar. This includes things like open, editing, adding shortcut, snooze, etc. Helps us ensure our calendar experience is functioning as expected and nothing has broken

  • action_result - Result of the action taken on calendar components. This can include values such as success, failure, unknown, and timeout. Used to track the success rate of actions and determine if there's a widespread issue with calendar actions.

  • attachment_count - Number of attachments of this calendar event. Helps us understand the user preference for adding event attachments.

  • attendee_busy_status - The free/busy status of the attendee that the action is related to. This value can be free, busy, or tentative. Helps us understand if there's an issue with actions related to a certain busy status.

  • availability - The availability value if the free/busy value has changed on the meeting. Helps us understand if there are issues with setting a certain availability value.

  • calendar_onlinemeeting_default_provider - Contains the default online meeting provider for use with server-supported online meeting creation. This includes types of Skype, Skype for Business, Hangout, and Teams for Business. Helps us diagnose potential issues with creating online meetings on certain providers.

  • calendar_onlinemeeting_enabled - True if the calendar supports server-supported online meeting creation based on a default online meeting provider. Helps us understand if there are any issues with online meeting enabled calendars.

  • calendar_type - The type of calendar an event is on after the user has edited the meeting. Possible values include primary, secondary, shared, and group. Helps us understand if there are issues with a certain calendar type.

  • classification - The classification of the calendar event. Possible values include none, focus, time_away, lunch, exercise, homeschooling, class, doctor_visit, travel_time, meeting_preparation, no_meeting_time. Helps us understand the classification of the event user creating/editing. For example, whether the user is creating a focus event.

  • create_poll_card_shown - Whether the create poll card was shown in the UI when the user was creating an event. This allows us to understand how often users opt into creating a poll.

  • delete_action_origin - The origin of the delete action performed. This includes values such as navigation bar toolbar and capsule toolbar. Helps us understand if there are any issues with deleting a meeting from a certain location.

  • distribution_list_count - Number of attendees that are on distribution lists. Helps us track if there are issues with attendees that are on distribution lists.

  • emo_default_meeting_provider - The type of default meeting provider used by the user while creating the meeting. Helps us to understand the user’s engagement with the "Every meeting online" feature.

  • guest_count - The number of guests on the meeting. Helps us make sure that the guests are being added correctly.

  • is_all_day - Used along with "meeting_duration" to specify if this is an all-day meeting. Helps us understand if there are any issues with actions performed on all-day meetings.

  • is_every_meeting_online_on - True if the users account is set to have online meetings on by default. Helps us understand if there are any issues with online meeting enabled calendars.

  • is_external_data - Captures if an added event is internal (that is, added in Outlook-to-Outlook calendar) or external (that is, added from another email app such as Gmail to Outlook calendar).

  • is_forwarding_allowed - True by default. Used to check if user is allowing event to be forwarded and determine usage of response options for events.

  • is_hide_attendees - False by default. Used to check if user is hiding attendees on an event and determine usage of response options for events.

  • is_location_permission_granted – Whether user has granted system location permission to the app. If location permission is granted, the app can show extra utility information in the user interface. Knowing if location permission is granted will allow us to know how often the extra utility information is being shown to users.

  • is_mip_label_applied - Whether the event has MIP label applied or not. Help us understand the number of events read with MIP label.

  • is_mute_notifications_on - Whether user toggled mute notifications on or off. Helps us understand how and when mute notifications being used.

  • is_new_time_proposal_allowed - True by default. Used to check if user is allowing time proposals for event and determine usage of response options for events.

  • is_organizer - Helps us understand if meetings are able to be edited and created by the organizer correctly.

  • is_recurring - Helps us understand if there's an issue that specifically impacts recurring meetings.

  • is_response_requested - True by default. Used to check if user is requesting responses from attendees and determine usage of response options for events.

  • launch_point - The launch point of the action. Can be values such as widget header, widget footer, widget all day, and calendar shortcut. Helps us understand the context that the action was started from.

  • location_count - Number of locations that are set on event create and edit. Helps us understand if there are any issues with creating or editing events with a certain number of locations.

  • location_selection_source_type - Type of the location selection source. This can include values such as location suggestion, custom, and existing. Helps us diagnose any issues with selecting a location from a certain source.

  • location_session_id - ID of the meeting location chooser session. Helps us diagnose any issues with choosing a location to add to the meeting.

  • location_type - The type of location selected. Contains types such as custom location, conference room, and Bing. Helps us understand issues with adding certain location types to the meeting.

  • meeting_duration - The length of the meeting. Helps us make sure that the meetings are being configured with the correct times.

  • meeting_insights_type - The type of meeting insights in the event details. This includes file and message. Helps us understand the number of meeting insights that are being shown.

  • meeting_type - The type of online meeting associated with the action. This includes types of Skype, Skype for Business, Hangout, and Teams for Business. Helps us understand if the online meetings are configured correctly.

  • online_meeting_provider_switch_type - The type of switch done by the user between the online meeting providers. Helps us to understand the user’s engagement with the feature.

  • origin - The origin of the calendar action. This includes types like agenda, calendar, widget agenda, etc. Helps us better ensure the interaction within the calendar components are working correctly

  • recurrence_scope - The type of recurrence of the meeting, either occurrence or series. Helps us understand if there are any issues with editing different meeting recurrence types.

  • reminder_time - The reminder time of the meeting if it has changed. Used to make sure the reminder time of the meeting is saved correctly.

  • reminders_count - Number of reminders on the event if the reminders have changed. Helps us diagnose any issues with multiple reminders on an event.

  • sensitivity - The sensitivity of the meeting. This includes types of normal, personal, private, and confidential. Helps us understand if the sensitivity of the meeting is being configured correctly.

  • session_duration - The length that the session lasted in milliseconds. Helps us understand if there are issues that are increasing the amount of time needed to perform the calendar action.

  • shared_calendar_result - The result of an action performed on a shared calendar. Possible values include ok, no permission, unknown, owner on-prem, and owner is group. Helps us understand the reliability of actions performed on shared calendars.

  • time_picker_origin - Origin of the time picker for a save action. Includes values such as more options and fewer options. Helps us understand how the user navigated the flow to save the meeting and ensure that is functioning correctly

  • title - The auto-suggested title from app-defined values. This includes values such as "Call", "Lunch", and "Skype". Helps us understand if the title auto-suggestion is configured correctly.

  • txp - The type of booking or reservation on the event, if any. This includes types like event reservation, flight reservation, car rental reservation, etc. Helps us understand if the booking/reservation cards are performing correctly.

  • upcoming_event_count - The number of upcoming events displayed in the upcoming events view. Helps us understand if there are issues with the upcoming events view.

  • upcoming_event_dismiss_swipe_direction - The direction a user swiped to dismiss an upcoming event reminder. The possible directions are left to right and right to left. Helps us understand how users are dismissing upcoming events.

  • upcoming_event_seconds_until_event - The number of seconds until the next upcoming event starts. Helps us understand the typical events that are shown in the upcoming events view.

  • value - Action-specific detail such as alert delay length or repeat-until category. Helps us understand the context that the action was performed.

combined.search.use

This event is triggered when a user enters or exits search mode or interacts with search entities such as results, suggestions, or filters. Used for monitoring possible negative impact on your ability to perform key search functionality such as searching for mail, contacts, or events.

The following fields are collected across iOS and Android:

  • account_switcher_action_type - This action type tracks if the user used the account switcher either in simply discovery or if they decided to switch the account

  • action - the type of action that was performed for search. This identifies if a search has been started, in occurring, or ended and what actions were happening during the search, for example, was the mic used. This is instrumental in ensuring accurate and helpful searches.

  • action_type - The type of action that was performed for search. This identifies if a search has been started, in occurring, or ended and what actions were happening during the search, for example, was the mic used. This is instrumental in ensuring accurate and helpful searches. [This field has been removed from current builds of Office, but might still appear in older builds.]

  • calendar_paging_gesture_count - Tracks how many search paging gestures were performed in the Events tab within the combined search session.

  • calendar_paging_timeout_count - Tracks how many paging search requests were blocked due to Hx session timeout in the Events tab within the combined search session.

  • conversation_id - Unique ID for every search session (for example, every time the user enters the search box)

  • entrance_type - This determines how the user started the search query, from the search tab, zero query, search heading, or search result.

  • has_contact_results - Simple whether contact results are shown or not in the search query

  • include_deleted - whether the search is showing deleted options in the search results

  • is_best_match_suggestion - whether the search suggestion selected is a best match.

  • is_ics_external_data - Captures if an added event is internal (for example, added in Outlook to Outlook calendar) or external (for example, added from another email app such as Gmail to Outlook calendar).

  • is_network_fully_connected - This is to get a hint of the reason behind the offline search. If the network is connected and the search is offline, then the reason is likely to be the server timeout

  • is_offline_search - whether the search session is offline search based on search results returned by hx

  • is_people_slab_displayed - Whether the search suggestion selected was displaying the people slab.

  • is_query_empty - Whether the user search or suggestion query is empty.

  • position - Zero-based index of the position of a search result in the results list.

  • re_enter_search_tab - Boolean to indicate whether a user has switched tabs before selecting a search result

  • result_selected_type - What type of data that was displayed is the user interacting with, for example, see all contact, conversations, event, etc.

  • search_conversation_result_data - This contains data about the conversation selected from a search result including account type (hx, ac, etc.), whether the message is held by a cloud service, and whether the page offset shown is the same page as the first message.

  • search_origin - Where did the search originate from, for example, voice assistant, Cortana, keyboard input, etc.

  • search_scope - A string indicating what type of account the user was searching in (for example, Exchange, Gmail, etc.) or if it was in All Accounts.

  • search_suggestion_treatment - Shares the current search suggestion treatment used to display the suggestions, by relevance or type.

  • search_suggestion_type - indicates what is behind the search suggestion, for example, is a spell correction? Based on history? Autocomplete?

  • search_request_reason - Indicates the reason a search request was sent from the app, in effect indicating the component or user action that invoked a search.

  • search_result_filter_type - Indicates what type of filter was applied to search, show all or attachments only

The following fields are collected across iOS applications of Outlook Mobile:

  • all_paging_gesture_count - Tracks how many search paging gestures were performed in the All tab within the combined search session.

  • all_paging_timeout_count - Tracks how many paging search requests were blocked due to Hx session timeout in the All tab within the combined search session.

  • answer_result_selected_count - tracks how many times the search was "successful", for example, did the user find the person they wanted? Composed an email? Bookmarked the message?

  • contact_result_in_full_list_selected_count - tracks how many times the user asked to "see all contacts" in full list was selected during the combined search session

  • contact_result_selected_count - tracks how many contact results were selected during the combined search session

  • conversation_result_selected_count - tracks how many conversations were selecting during the combined search session

  • mail_paging_gesture_count - tracks how many mail search paging gestures were performed within the combined search session

  • mail_paging_timeout_count - Tracks how many paging search requests were blocked due to Hx session timeout in the Mail tab within the combined search session.

  • mail_requests_count - tracks how many mail search requests were sent within the combined search session

  • people_filter_selected_contacts_count - tracks how many contacts were selected in the people filter

  • search_session_ended_type - Indicates where a search ended because it was canceled or the updated was the query

  • search_suggestion_type - indicates what is behind the search suggestion, for example, is a spell correction? Based on history? Autocomplete?

  • see_all_contacts_selected_count - tracks how many times "see all contacts" was selected during the combined search session

  • subtab_type - tracks where the user has selected the result from which result tab

  • top_mail_result_selected_count - tracks how many times a user selects the top results provided to them.

  • ui_reload_result_count - records the times of reloading UI because of result set update (during the corresponding query)

  • ui_reload_result_time - records the total time spent on reloading UI because of result set update (during the corresponding query)

  • ui_reload_status_count - records the times of reloading UI because of status update (during the corresponding query)

  • ui_reload_status_time - records the total time spent on reloading UI because of status update (during the corresponding query)

component.family.start

This event is sent when an app component is loaded. For example, the Focused Inbox, Other Inbox, etc. It allows us to understand usage and whether users are seeing ads in expected cases.

The following fields are collected:

  • account - which account is viewing the component (if there are multiple accounts)

  • ads_eligible - Indicates whether the user is expected to be eligible to see ads (only free users)

  • ads_not_eligible_reason - reason why use won't be shown ads (if ads_eligible is false)

  • ads_not_eligible_sub_error_type - detailed error related to requesting ads (if ads_eligible is false)

  • app_instance - Outlook has two entry points for Duo. One is for Calendar and one is for Mail and both can be launched side by side in multi instance environment. This lets us know which instance is making this reporting call, either Mail or Calendar.

  • component_name - the name of the component/view that is active. For example, "Other inbox"

  • Days_Since_Last_Ad_Seen - Days since last ad seen.

  • Days_Since_Last_Ad_Seen_Excl_Focused - Days since last ad seen, excluding ad placements in Focused inbox.

  • taskId - TaskId gives us the current instance’s taskId. This will be required in multi-instance environment if user wants to launch same instances (Calendar, Calendar or Mail, Mail) side by side

compose.mail.accessory

This event helps detect and fix issues with key mail compose actions to prevent the user from running into issues with attaching a file, taking a photo as an attachment, or sending availability.

The following fields are collected:

  • action - Tells us the action that was attempted when the action is logged. Some examples include attaching a file and presenting more options.

  • icon_name - Tells us the name of the icon that is being shown when the action is logged.

  • origin – Tells us the origin of the action. Possible values are quick_reply and full_screen.

  • toolbar_type – Tell us the toolbar type that is presenting on compose page. Possible values are compose_actions and formatting.

  • trigger - Tell us the path of how user starts a compose feature. For example, for the Text Elaborate feature, our users could either start it by clicking the toolbar icon, or by clicking the placeholder within compose area.

compose.mail.rearrange

This event is triggered when the user uses the new Customizable Toolbar feature in Compose to move an action between the toolbar pinned area and the drawer. The data is used to ensure that the feature is functioning as expected and to plan for future improvements.

The following fields are collected:

  • Action_Movement - changes in the position of an action on the toolbar, where positive values represent a move towards the start, and negative values represent a move towards the end of the list.

  • rearrange_action - type of rearrange action performed by the user, including pin_to_toolbar, move_to_drawer, move_within_toolbar, and move_within_drawer. [This field has been removed from current builds of Office, but might still appear in older builds.]

  • toolbar_action - toolbar action that is being moved, which has the same type as the action property in compose_mail_accessory event.

conversation.view.action

This event is triggered when a user interacts with the conversation view. For example, attempting to load more conversations or opening quick reply. The data is used for monitoring possible negative impact on the ability to view and reply to email messages as well as for determining issues related to conversation features such as reactions, suggested replies, pinning, etc.

The following fields are collected:

  • attachment_origin - The origin of the attachment

  • contains_mention - Tells us if the conversation had an @ mention applied to help us detect issues with email mentions

  • conversation_type - Tells us what type of email message view was rendered, such as a single message view or multiple message views. Helps us detect issues related to a specific message type in our email conversation view.

  • from_message_reminder - If the action taken was on a message from a message reminder

  • hx_error_type - tells us what error occurred that prohibited the service from completing a remove, update, or add reaction on a message.

  • hx_string_tag - tells us the tag of the error in the service's codebase

  • is_pinned - Tells us if the conversation is pinned. This is to assess if users are interacting with pin messages and if the pinning feature is behaving as expected.

  • reaction_origin – Tells us origin from where the user reacted

  • reaction_skin_tone - Tells us the reaction skin tone of the user

  • reaction_type – Tells us the reaction type of the user

  • suggested_file_selected - Report a Boolean value representing if the user selected a file from the mini-picker

  • suggested_file_shown - Report a Boolean value representing if file suggestions were shown in the mini-picker

  • suggested_file_time_to_select - Report the time in ms from when the user clicks the suggested file pill to when they're returned to the compose canvas

  • suggested_reply_char_count - Tells us how many characters the suggested replies we offer (if available) to help us detect anomalies and issues related to our suggestions

  • suggested_reply_click_pos - Tells us which position the suggested reply (if available) is rendered so we can detect issues with a specific suggestion

  • suggested_reply_type - indicates type of suggested reply for this action. Possible values are text, send_avail, and create_meeting.

  • suggested_reply_with_file_shown - Log whether smart reply with file attachment has been shown

  • use_default_quick_reply_mode - Tells us if the default quick reply mode was used to help us detect issues related to the quick reply experience for email

draft.action

The event is triggered when the user closes by tapping the top left button at the full compose view or save some drafts from quick reply view. The data is used for monitoring possible negative impact on the ability to create and save mail drafts.

The following fields are collected:

  • action - the type of action, for example, save, discard.

  • choose_from_email_menu_clicked_count - the number of times user chooses to attach an email from the attach menu during the draft.

  • draft_contains_inking - this is an optional property, which will tell if this draft has an inking data in it or not. If it has, then the value of this property will be true, otherwise false.

  • draft_message_id - message ID of the draft

  • eml_attachment_count - the number of eml files being sent as attachments to the draft.

  • is_groups - whether the draft is being sent to/from a group folder

  • is_request_delivery_receipt - if the draft message was selected to request delivery receipt.

  • is_request_read_receipt - if the draft message was selected to request read receipt.

  • mail_importance_type - the message’s importance type that user selected to mark the draft priority (for example, high/low/normal)

  • origin - where draft was initiated, for example, message detail, compose.

  • smart_compose_model_version - tracks which version of smart compose model is being used

  • suggestions_requested - indicates how many smart compose suggestions requested

  • suggestions_results - smart compose suggestions’ result, that is, accepted, rejected

  • suggestions_returned - indicates how many smart compose suggestions returned from server

  • suggestions_shown - indicates how many smart compose suggestions shown to the user

  • thread_id - thread ID of the conversation draft is associated with

  • video_message_default_thumbnail_count - the number of video thumbnails that have been unfurled with default thumbnail while sending a message

  • video_message_deleted_thumbnail_count - the number of video thumbnails being deleted that have been unfurled through sharing link while sending a message

  • video_message_link_count - the number of video links that could be unfurled while sending a message

drag.and.drop

This event lets us detect if the drag and drop action was successful or not. It's used to ensure that drag-and-drop experiences are working correctly across applications both as a drop event into Outlook and a drag event that leaves Outlook. With this data, we're able to ensure that the end-to-end experience with other applications is working as expected.

The following fields are collected:

  • action - Action will be either drag or drop

  • location - In case of a drag action, this lets us know from which location the user started the drag. In case of a drop action, this lets us know where the user dropped the file that was being dragged.

  • source – In the case of a drop action, this lets us know from which location the user started the drag. This helps us better discover issues with a specific source like OneDrive or Files into a specific drop location, such as a new email.

drawer.event

Used for monitoring possible negative impact on your ability to access folders in your inbox

The following fields are collected:

  • add_calendar_option - Indicates the type of calendar being added from the drawer that is, interesting calendar, mail calendar, shared calendar, to help us detect issues related to specific calendar types

  • calendar_accounts_count - Indicates the number of calendar accounts to help us detect issues related to number of accounts you have

  • calendar_apps_count - Indicates the number of calendar apps present on the user's device to help us detect issues related to calendar apps

  • drawer_type - Indicates the drawer type: calendar, mail, or zero query to help us detect issues related to the drawer type

  • dwell_time - Indicates the amount of time the user spent navigating the drawer before taking an action such as selecting the folder.

  • from_favorites - Indicates if the action was taken from favorites to help us detect issues related to favorites

  • group_calendar_count - Indicates the number of calendars for the account to help us detect issues related to group calendars

  • inbox_unread_count - Indicates the number of unread messages in the inbox to help us detect issues with displaying inbox unread counts.

  • interesting_calendar_accounts_count - Indicates the number of accounts that are eligible for interesting calendars on the device to help us detect issues related to interesting calendars

  • is_group_calendar - Indicates if the calendar is a group calendar to help us detect issues related to group calendars

  • mail_folder_type - Indicates the mail folder type that is, inbox, drafts, etc. to help us detect issues related to folder types.

  • mail_accounts_count - indicates the number of mail accounts to help us detect issues related to mail accounts.

  • selected_group_calendar_count - Indicates the number of group calendars that are selected and active in the UI

  • visibility_toggle - indicates if the user is turning on or off a given calendar to help us detect issues related to showing or hiding calendars

FREiOS

The event is triggered when Office apps on iOS are launched for the first time. The data is used to monitor the health of our applications’ First Run Experience (FRE) flow, determine its success state, and whether users get stuck in the process of using the app for the first time.

The following fields are collected:

  • None

IpcCreateRepublishingLicense

Collected when a user attempts to open an IRM protected doc or apply IRM protections. It contains the information needed to be able to properly investigate and diagnose issues that happen when the IpcCreateRepublishingLicense API call is made.

The following fields are collected:

  • AppInfo.ClientHierarchy - Client hierarchy, which indicates the application runs in production environment or developer environment

  • AppInfo.Name - Application name

  • AppInfo.Version - Application version

  • iKey - Logging service server ID

  • RMS.Duration - Total time for API call to complete

  • RMS.DurationWithoutExternalOps - Total time minus external operations consumed, such as network latency.

  • RMS.ErrorCode - The error code returned if any from the API call

  • RMS.HttpCall - indicate if there's HTTP operation

  • RMS.Result - Success or fail of the API call

  • RMS.ScenarioId - Scenario ID defined by the API

  • RMS.SDKVersion - The version of Rights Management Service Client

  • RMS.StatusCode - Status code of the returned result

IpcGetLicenseProperty

Collected when a user attempts to open an IRM protected doc or apply IRM protections. It contains the information needed to be able to properly investigate and diagnose issues that happen when the IpcGetLicenseProperty API call is made.

The following fields are collected:

  • AppInfo.ClientHierarchy - Client hierarchy, which indicates the application runs in production environment or developer environment

  • AppInfo.Name - Application name.

  • AppInfo.Version - Application version

  • iKey - Logging service server ID

  • RMS.Duration - Total time for API call to complete

  • RMS.DurationWithoutExternalOps - Total time minus external operations consumed, such as network latency.

  • RMS.ErrorCode - The error code returned if any from the API call

  • RMS.HttpCall - Indicates if there's HTTP operation

  • RMS.LicensePropertyType - license property type

  • RMS.Result - Success or fail of the API call

  • RMS.ScenarioId - Scenario ID defined by the API

  • RMS.SDKVersion - The version of Rights Management Service Client

  • RMS.StatusCode - Status code of the returned result

IpcGetSerializedLicenseProperty

Collected when a user attempts to open an IRM protected doc or apply IRM protections. It contains the information needed to be able to properly investigate and diagnose issues that happen when the IpcGetSerializedLicenseProperty API call is made.

The following fields are collected:

  • AppInfo.ClientHierarchy - Client hierarchy, which indicates the application runs in production environment or developer environment

  • AppInfo.Name - Application name.

  • AppInfo.Version - Application version

  • iKey- Logging service server ID

  • RMS.Duration - Total time for API call to complete

  • RMS.DurationWithoutExternalOps - Total time minus external operations consumed, such as network latency.

  • RMS.ErrorCode - The error code returned if any from the API call

  • RMS.HttpCall - Indicates if there's HTTP operation

  • RMS.LicensePropertyType - License property type

  • RMS.Result - Success or fail of the API call

  • RMS.ScenarioId - Scenario ID defined by the API

  • RMS.SDKVersion - The version of Rights Management Service Client

  • RMS.StatusCode - Status code of the returned result

IpcGetTemplateIssuerList

Collected when a user attempts to open an IRM protected doc or apply IRM protections. It contains the information needed to be able to properly investigate and diagnose issues that happen when the IpcGetTemplateIssuerList API call is made.

The following fields are collected:

  • AppInfo.ClientHierarchy - Client hierarchy, which indicates the application runs in production environment or developer environment

  • AppInfo.Name - Application name.

  • AppInfo.Version - Application version

  • iKey - Logging service server ID

  • RMS.AuthCallbackProvided - Indicate if provides the authentication callback as input of the API call or not

  • RMS.ConnectionInfo.ExtranetUrl - extranet URL of connection info

  • RMS.ConnectionInfo.IntranetUrl - intranet URL of connection info

  • RMS.ConnectionMode - The connection mode between Rights Management Service client and server: online or offline

  • RMS.Duration - Total time for API call to complete

  • RMS.DurationWithoutExternalOps - Total time minus external operations consumed, such as network latency.

  • RMS.ErrorCode - The error code returned if any from the API call

  • RMS.GuestTenant - Guest tenant ID for the user

  • RMS.HomeTenant - Home tenant ID for the user

  • RMS.HttpCall - indicate if there's HTTP operation

  • RMS.Identity.ExtranetUrl - The extranet URL of Rights Management service server for the user, collected while getting a new Rights Account Certificate from the server

  • RMS.Identity.IntranetUrl - The intranet URL of Rights Management service server for the user, collected while getting a new Rights Account Certificate from the server

  • RMS.Identity.Status - The first time to get Rights Account Certificate from the server or renew the Rights Account Certificate

  • RMS.Identity.Type - The type of the user account such as windows account or live account

  • RMS.Identity.UserProvided - Indicate if the user email address provided or not while getting new Rights Account Certificate from the server

  • RMS.IssuerId - The ID of the Rights Management Service server that issues Rights Account Certificate

  • RMS.LicenseFormat - The license Format: Xrml or Json

  • RMS.RACType - The type of Rights Accounts Certificate

  • RMS.Result - Success or fail of the API call

  • RMS.ScenarioId - Scenario ID defined by the API

  • RMS.SDKVersion - The version of Rights Management Service Client

  • RMS.ServerType - The type of Rights Management Service Server

  • RMS.StatusCode - Status code of the returned result

  • UserInfo.UserObjectId - The user object ID

IpcGetTemplateList

Collected when a user attempts to open an IRM protected doc or apply IRM protections. It contains the information needed to be able to properly investigate and diagnose issues that happen when the IpcGetTemplateList API call is made.

The following fields are collected:

  • AppInfo.ClientHierarchy - Client hierarchy, which indicates the application runs in production environment or developer environment

  • AppInfo.Name - Application name.

  • AppInfo.Version - Application version

  • iKey - Logging service server ID

  • RMS.AuthCallbackProvided - Indicate if provides the authentication callback as input of the API call or not

  • RMS.ConnectionInfo.ExtranetUrl - extranet URL of connection info

  • RMS.ConnectionInfo.IntranetUrl - intranet URL of connection info

  • RMS.ConnectionMode - The connection mode between Rights Management Service client and server: online or offline

  • RMS.Duration - Total time for API call to complete

  • RMS.DurationWithoutExternalOps - Total time minus external operations consumed, such as network latency.

  • RMS.ErrorCode - The error code returned if any from the API call

  • RMS.GuestTenant - Guest tenant ID for the user

  • RMS.HomeTenant - Home tenant ID for the user

  • RMS.HttpCall - indicate if there's http operation

  • RMS.Identity.ExtranetUrl - The extranet URL of Rights Management service server for the user, collected while getting a new Rights Account Certificate from the server

  • RMS.Identity.IntranetUrl - The intranet URL of Rights Management service server for the user, collected while getting a new Rights Account Certificate from the server

  • RMS.Identity.Status - The first time to get Rights Account Certificate from the server or renew the Rights Account Certificate

  • RMS.Identity.Type - The type of the user account such as windows account or live account

  • RMS.Identity.UserProvided - Indicate if the user email address provided or not while getting new Rights Account Certificate from the server

  • RMS.IssuerId - The ID of the Rights Management Service server that issues Rights Account Certificate

  • RMS.LicenseFormat - The license Format: Xrml or Json

  • RMS.RACType - The type of Rights Accounts Certificate

  • RMS.Result - Success or fail of the API call

  • RMS.ScenarioId - Scenario ID defined by the API

  • RMS.SDKVersion - The version of Rights Management Service Client

  • RMS.ServerType - The type of Rights Management Service Server

  • RMS.StatusCode - Status code of the returned result

  • RMS.TemplatesCount - The number of the templates

  • UserInfo.UserObjectId - The user object ID

IpcpCreateLicenseFromScratch

Collected when a user attempts to open an IRM protected doc or apply IRM protections. It contains the information needed to be able to properly investigate and diagnose issues that happen when the IpcpCreateLicenseFromScratch API call is made.

The following fields are collected:

  • AppInfo.ClientHierarchy - Client hierarchy, which indicates the application runs in production environment or developer environment

  • AppInfo.Name - Application name.

  • AppInfo.Version - Application version

  • iKey - Logging service server ID

  • RMS.Duration - Total time for API call to complete

  • RMS.DurationWithoutExternalOps - Total time minus external operations consumed, such as network latency.

  • RMS.ErrorCode - The error code returned if any from the API call

  • RMS.GuestTenant - Guest tenant ID for the user

  • RMS.HomeTenant - Home tenant ID for the user

  • RMS.HttpCall - indicate if there's HTTP operation

  • RMS.Identity.ExtranetUrl - The extranet URL of Rights Management service server for the user, collected while getting a new Rights Account Certificate from the server

  • RMS.Identity.IntranetUrl - The intranet URL of Rights Management service server for the user, collected while getting a new Rights Account Certificate from the server

  • RMS.Identity.UserProvided - Indicate if the user email address provided or not while getting new Rights Account Certificate from the server

  • RMS.IssuerId - The ID of the Rights Management Service server that issues Rights Account Certificate

  • RMS.LicenseFormat - The license Format: Xrml or Json

  • RMS.RACType - The type of Rights Accounts Certificate

  • RMS.Result - Success or fail of the API call

  • RMS.ScenarioId - Scenario ID defined by the API

  • RMS.SDKVersion - The version of Rights Management Service Client

  • RMS.ServerType - The type of Rights Management Service Server

  • RMS.StatusCode - Status code of the returned result

  • RMS.TokenProvided - Indicate if provides the token as input of the API call or not

  • RMS.UserProvided - Indicate if provides the consumer as input of the API call or not

  • UserInfo.UserObjectId - The user object ID

IpcpCreateLicenseFromTemplate

Collected when a user attempts to open an IRM protected doc or apply IRM protections. It contains the information needed to be able to properly investigate and diagnose issues that happen when the IpcpCreateLicenseFromTemplate API call is made.

The following fields are collected:

  • AppInfo.ClientHierarchy - Client hierarchy, which indicates the application runs in production environment or developer environment

  • AppInfo.Name - Application name.

  • AppInfo.Version - Application version

  • iKey - Logging service server ID

  • RMS.AuthCallbackProvided - Indicate if provides the authentication callback as input of the API call or not

  • RMS.ConnectionMode - The connection mode between Rights Management Service client and server: online or offline

  • RMS.Duration - Total time for API call to complete

  • RMS.DurationWithoutExternalOps - Total time minus external operations consumed, such as network latency.

  • RMS.ErrorCode - The error code returned if any from the API call

  • RMS.HttpCall - indicate if there's http operation

  • RMS.Result - Success or fail of the API call

  • RMS.ScenarioId - Scenario ID defined by the API

  • RMS.SDKVersion - The version of Rights Management Service Client

  • RMS.StatusCode - Status code of the returned result

  • RMS.TokenProvided - Indicate if provides the token as input of the API call or not

  • RMS.UserProvided - Indicate if provides the consumer as input of the API call or not

IpcpGetTemplateListForUser

Collected when a user attempts to open an IRM protected doc or apply IRM protections. It contains the information needed to be able to properly investigate and diagnose issues that happen when the IpcpGetTemplateListForUser API call is made.

The following fields are collected:

  • AppInfo.ClientHierarchy - Client hierarchy, which indicates the application runs in production environment or developer environment

  • AppInfo.Name - Application name.

  • AppInfo.Version - Application version

  • iKey - Logging service server ID

  • RMS.ApplicationScenarioId - Scenario ID provided by the application

  • RMS.AuthCallbackProvided - Indicate if provides the authentication callback as input of the API call or not

  • RMS.ConnectionInfo.ExtranetUrl - extranet URL of connection info

  • RMS.ConnectionInfo.IntranetUrl - intranet URL of connection info

  • RMS.ConnectionMode - The connection mode between Rights Management Service client and server: online or offline

  • RMS.Duration - Total time for API call to complete

  • RMS.DurationWithoutExternalOps - Total time minus external operations consumed, such as network latency.

  • RMS.ErrorCode - The error code returned if any from the API call

  • RMS.GuestTenant - Guest tenant ID for the user

  • RMS.HomeTenant - Home tenant ID for the user

  • RMS.HttpCall - Indicates if there's HTTP operation

  • RMS.Identity.ExtranetUrl - The extranet URL of Rights Management service server for the user, collected while getting a new Rights Account Certificate from the server

  • RMS.Identity.IntranetUrl - The intranet URL of Rights Management service server for the user, collected while getting a new Rights Account Certificate from the server

  • RMS.Identity.Status - The first time to get Rights Account Certificate from the server or renew the Rights Account Certificate

  • RMS.Identity.Type - The type of the user account such as windows account or live account

  • RMS.Identity.UserProvided - Indicate if the user email address provided or not while getting new Rights Account Certificate from the server

  • RMS.IssuerId - The ID of the Rights Management Service server that issues Rights Account Certificate

  • RMS.LicenseFormat - The license Format: Xrml or Json

  • RMS.RACType - The type of Rights Accounts Certificate

  • RMS.Result - Success or fail of the API call

  • RMS.ScenarioId - Scenario ID defined by the API

  • RMS.SDKVersion - The version of Rights Management Service Client

  • RMS.ServerType - The type of Rights Management Service Server

  • RMS.StatusCode - Status code of the returned result

  • RMS.TemplatesCount - The number of the templates

  • RMS.TokenProvided - Indicate if provides the token as input of the API call or not

  • RMS.UserProvided - Indicate if provides the consumer as input of the API call or not

  • UserInfo.UserObjectId - The user object ID

IpcpSerializeLicense

Collected when a user attempts to apply IRM protections on the doc. It contains the information needed to be able to properly investigate and diagnose issues that happen when the IpcpSerializeLicense API call is made.

The following fields are collected:

  • AppInfo.ClientHierarchy - Client hierarchy, which indicates the application runs in production environment or developer environment

  • AppInfo.Name - Application name.

  • AppInfo.Version - Application version

  • iKey - Logging service server ID

  • RMS.ApplicationScenarioId - Scenario ID provided by the application

  • RMS.AuthCallbackProvided - Indicate if provides the authentication callback as input of the API call or not

  • RMS.ConnectionMode - The connection mode between Rights Management Service client and server: online or offline

  • RMS.ContentId - Content ID of the document

  • RMS.Duration - Total time for API call to complete

  • RMS.DurationWithoutExternalOps - Total time minus external operations consumed, such as network latency.

  • RMS.ErrorCode - The error code returned if any from the API call

  • RMS.GuestTenant - Guest tenant ID for the user

  • RMS.HomeTenant - Home tenant ID for the user

  • RMS.HttpCall - indicate if there's http operation

  • RMS.Identity.ExtranetUrl - The extranet URL of Rights Management service server for the user, collected while getting a new Rights Account Certificate from the server

  • RMS.Identity.IntranetUrl - The intranet URL of Rights Management service server for the user, collected while getting a new Rights Account Certificate from the server

  • RMS.Identity.Status - The first time to get Rights Account Certificate from the server or renew the Rights Account Certificate

  • RMS.Identity.Type - The type of the user account such as windows account or live account

  • RMS.Identity.UserProvided - Indicate if the user email address provided or not while getting new Rights Account Certificate from the server

  • RMS.IssuerId - The ID of the Rights Management Service server that issues Rights Account Certificate

  • RMS.KeyHandle - The memory address of key handle

  • RMS.LicenseFormat - The license Format: Xrml or Json

  • RMS.PL.KeyType – Values of 'Single' or 'Double.' Indicates whether the PL was protected with Single Key Protection or Double Key Protection.

  • RMS.RACType - The type of Rights Accounts Certificate

  • RMS.Result - Success or fail of the API call

  • RMS.ScenarioId - Scenario ID defined by the API

  • RMS.SDKVersion - The version of Rights Management Service Client

  • RMS.ServerType - The type of Rights Management Service Server

  • RMS.StatusCode - Status code of the returned result

  • RMS.TokenProvided - Indicate if provides the token as input of the API call or not

  • RMS.UserProvided - Indicate if provides the consumer as input of the API call or not

  • UserInfo.UserObjectId - The user object ID

IpcSetLicenseProperty

Collected when a user attempts to open an IRM protected doc or apply IRM protections. It contains the information needed to be able to properly investigate and diagnose issues that happen when the IpcSetLicenseProperty API call is made.

The following fields are collected:

  • AppInfo.ClientHierarchy - Client hierarchy, which indicates the application runs in production environment or developer environment

  • AppInfo.Name - Application name.

  • AppInfo.Version - Application version

  • iKey - Logging service server ID

  • RMS.Duration - Total time for API call to complete

  • RMS.DurationWithoutExternalOps - Total time minus external operations consumed, such as network latency.

  • RMS.ErrorCode - The error code returned if any from the API call

  • RMS.HttpCall - indicate if there's http operation

  • RMS.LicensePropertyType - license property type

  • RMS.Result - Success or fail of the API call

  • RMS.ScenarioId - Scenario ID defined by the API

  • RMS.SDKVersion - The version of Rights Management Service Client

  • RMS.StatusCode - Scenario ID defined by the API

link.clicked.action

The event is used to track users' success in viewing a URL in the Microsoft Edge web view and completing standard web scenarios in that web view without facing errors.

The following fields are collected:

  • account_type – if the Microsoft Edge web view was launched from an email or event in Outlook, type of the account where the URL came from

  • action – action performed by the user inside Outlook from the moment they tap on a URL to when they exit that flow (opened the link in the Microsoft Edge web view, page failed to load in the web view, performed a search in the web view, exit the Microsoft Edge web view to open the link in a web browser application, etc.)

  • duration – duration of the user session

  • launch_type – if the Microsoft Edge web view was launched, was it from Outlook, from a widget, or from an OS component

  • origin – if the user performed an action in the Microsoft Edge web view, origin of that action

  • referrer – the location of the URL the user tapped on (email, calendar event, TXP card, etc.)

  • search_scope – if the user performed a search in the Microsoft Edge web view, scope of that search (All, Images, Videos, etc.)

  • search_subtype – if the user performed a search in the Microsoft Edge web view, was it an initial search or a refined search

  • session_summary_page_loaded_count – number of pages loaded by the user during their session in the Microsoft Edge web view

  • session_summary_search_count - number of Bing searches performed by the user during their session in the Microsoft Edge web view

  • session_summary_session_id – identifier for the present user session in the Microsoft Edge web view

  • txp – if the Microsoft Edge web view was launched from a TXP card, event type for that card (dining, flight, etc.)

  • txp_component - if the Microsoft Edge web view was launched from a TXP card, UI component type for that card

log.event.appointment.attendee

This event is triggered when the user clicks on any add-in on their calendar page. The data is used to detect the usage of add-ins and determine if the feature is performing correctly.

The following fields are collected:

  • addin_id – Identifier of the add-in

  • addin_type – Type of the add-in, for example, available either without a user interface (UI-less) or through task pane

  • event_button_label – Label of the button clicked by the user.

  • total_addin_count – Count of all add-ins with MobileLogEventAppointmentAttendee surface

mail.action

Used for monitoring possible negative impact on your ability to perform critical mail actions (like running mail threaded mode, ensuring mail triage actions work) to ensure our app is functioning properly for mail.

The following fields are collected:

  • account - the account that performed the action [This field has been removed from current builds of Office, but might still appear in older builds.]

  • action - tracks what type of action was taking, that is, archive, delete, mark as read, etc.

  • attachment_content_type - the content type of the downloaded attachment

  • attachment_content_type_with_count - tracks the number of attachments in email

  • attachment_download_result - the result (that is, success/failure) for an attachment download action

  • attachment_download_time - the time for an attachment download action

  • attachment_extn - the file extension of the downloaded attachment [This field has been removed from current builds of Office, but might still appear in older builds.]

  • attachment_id - the system identifier for the downloaded attachment

  • attachment_size - the size of downloaded attachment

  • domain - domain of the document being opened

  • duration - tracks how long the action took as human-readable English string (for example, 1s, 4h)

  • error - error message associated with the action

  • event_mode - what type of event mode it was in, groups or others.

  • Extension - four characters of file extension of link or attachment associated with this action [This field has been removed from current builds of Office, but might still appear in older builds.]

  • internet_message_id - tracking message ID

  • is_group_escalation - indicates whether the message the action was taken on was sent to the user's mailbox because of an escalation (subscribed to group)

  • is_pinned - Tells us if the conversation is pinned. This is to assess if users are interacting with pin messages and if the pinning feature is behaving as expected.

  • is_rule - indicates if the mail action done is resetting a focused/other classification

  • is_threaded_mode - indicates whether the message was in threaded mode or not, that is, how are the messages grouped

  • is_unread - indicates whether message is unread that the action was taken on

  • left_swipe_setting - indicates what action was a set to be the left swipe

  • message_id - server message ID targeted for action, or comma-separated list if more than one item was in action.

  • message_type - indicates what type of message type the action was taken on - group or other

  • number_selected - the number of items the user selected on the message list and took action on during multiple selection mode.

  • origin - source of action, that is, cell swipe, zero-query, deep link, email view, email list, etc.

  • origin_view - source view of action, for example, conversation, message, etc.

  • reported_to_msft - after sending an email to junk (spam) or trash (phishing) they can choose to report their action to Microsoft.

  • retry - whether the action was retried

  • right_swipe_setting - indicates what action was a set to be the right swipe

  • shortcut - indicates if a shortcut was used and what shortcut was used for scheduling a message that is, later, tomorrow, choose time, etc.

  • size - size of link or attachment associated with this action

  • source_folder - tracks source folder type when action is indicating to move from one folder to other, that is, to inbox, trash etc.

  • source_inbox - indicates which inbox the mail action is taking place (that is, focused, other, etc.) state - state of the action, that is, success or point of failure

  • state - state of the action, that is, success or point of failure

  • target_folder - indicates target folder type when moving emails from one folder to other

  • thread_id - thread ID of the conversation targeted for action, or comma-separated list if more than one item was targeted

  • time_taken_to_fetch_access_token - time taken to fetch a system access token to use for opening a link

  • time_taken_to_fetch_drive_item - time taken to fetch a OneDrive resource when clicked

  • time_taken_to_fetch_embed_viewer_resource - time taken to initialize the embedded viewer when opening links

  • time_taken_to_load_embed_viewer - time taken to initialize the embedded viewer when opening links

  • time_taken_to_load_link - time a load link action takes to complete

  • time_taken_to_tap_attachment - the time between opening the message and clicking on the attachment

  • time_taken_to_tap_link - time the user took between viewing message and clicking a link

  • txp - indicates if there's a txp type of item associated with the mail that action was taken on, that is, event reservation, flight reservation, etc.

  • type - document type being opened via link

mail.compose

Used for monitoring possible negative impact on your ability to compose and reply to emails such as running into issues with reply-all, formatting your email, or sending your emails.

The following fields are collected:

  • draft_message_id - The draft ID of the conversation being created as a draft to help us detect issues related to draft emails

  • from_context_menu - Tells us whether the compose is originated from context menu actions.

  • from_message_reminder - Tells us if the message we're writing is in response to a message reminder

  • message_id - The message ID of the conversation being replied to or forwarded from to help us detect issues related to a specific message

  • origin - Tells us where the compose originated from, such as from a reply all, a new compose, or quick reply. Helps us detect issues associated with a specific reply origin type.

  • is_group_escalation - Whether the message is an escalated group message so we can detect compose issues related to groups.

  • is_link - Tells us if the new draft that was created was done from a link. Helps us detect issues associated with drafts created from links.

  • is_force_touch - Tells us if the new draft that was created was done from a force touch action. Helps us detect issues associated with drafts created from this specific action.

  • is_groups - Whether the event was started from the groups' space so we can detect compose issues related to groups.

  • source_inbox - Tells us the source inbox, such as whether it was a focused or other inbox

  • thread_id - The thread ID of the conversation being replied to or forwarded from to help us detect issues related to a specific thread

meeting.call.to.action

Used for monitoring possible negative impact on your ability to perform critical meeting actions like creating, editing, and responding to meetings.

The following fields are collected:

  • event_mode - Indicates whether this event was from a group or not to help us detect issues with group events

  • meeting_id - A meeting ID that helps us track issues throughout the lifetime of a meeting to help us detect issues with specific meetings

  • meeting_provider - Indicates the provider for an online meeting, for example, Teams, Skype for Business to help us detect issues with specific online meeting providers

  • notify_type - Indicates the response type for other account types to help us detect issues with different account types

  • recurrence - Indicates how often this meeting occurs that is, occurrence or series to help us detect issues with reoccurring meeting series

  • response - Indicates response type such as accept or decline on certain account types to help us detect issues with responding to events

  • response_message_length - Indicates how long the message length was to help us detect issues with meeting responses

  • response_mode - Indicates response mode such as in person or virtually to help us detect issues with meeting response modes

  • review_time_proposal_action_type - Indicates a user response new time proposal to help us detect issues with proposing a new time

  • send_response - Indicates whether a response was sent to help us detect issues sending meeting invite responses

  • txp - Indicates what type of meeting it was generated from flight reservations and deliveries to help us detect issues with this type of meeting

  • with_message_enabled - Indicates whether a user can respond with a message to help us detect issues with responding to meeting invites

message.reminder

This event is triggered when a user interacts with a message reminder. A message reminder is a User Interface (UI) element that prompts the user to interact with a message they might have forgotten about and should follow up on. The data is used to determine the optimal UI for showing message reminders and for monitoring the success and impact of the feature.

The following fields are collected across iOS and Android:

  • action - The type of action taken on the message reminder. This includes actions such as opening the message, dismissing the reminder, turning off the feature, and when the reminder was rendered.

  • dismiss_swipe_direction - The direction a user swiped to dismiss a message reminder. The possible directions are left to right and right to left. This helps us better understand how users are dismissing message reminders.

  • internet_message_id - The internet message ID of a message. This allows us to link telemetry events to other sources of data such as the logs from our API.

  • mailbox_uuid - The UUID (universally unique identifier) of the mailbox containing the related message. This allows us to link telemetry events to other sources of data such as the logs from our API.

  • message_id - The server ID of a message. This is sent with many other message-related telemetry events and allows us to link message reminder events to those.

  • origin - Which view is the message reminder is on

multi.window.launch

This event captures when the user takes action that involves multi-window launch on foldable devices, for example, compose mail, event, open calendar window. It uses the action to remember such action, for example, to keep getting the prompt or always launch in new window. The data collected by this event will be used to assess discoverability, effectiveness as well as general user preferences to drive current and future developments of multi window related functionalities.

The following fields are collected:

  • is_remembered - whether the preference to launch in a new window from the reported location has been saved by user.

  • multi_window_origin - the location within the app where the interaction to launch another app screen in a new window happens.

notification.center

This event allows us to track when users enter and exit the notification center in addition to the count of unseen notifications. This helps us make sure that the notification center is consistent with all other clients. We also track when a user taps on a notification so we can tell what type it's.

The following fields are collected:

  • action - the action taken by the user (closed, opened, notification_tapped)

  • file_type - The file type if the notification is about a file (Word, Excel, PowerPoint, Fluid)

  • message_reminder_available - True if there's a message reminder available and will be displayed when the notification center is opened

  • type - the notification type, either reaction or message_reminder as of now (not always collected)

  • unseen_count - how many notifications in the current view haven't been seen before (not always collected)

Office.Ads.SDX.ImageAction

This event is triggered when a user interacts with advertisement content displayed in Office applications. This event is used to verify user interaction is behaving as expected and ad content is inducing desired user behavior.

The following fields are collected:

  • Data_Action - The UI element interacted with

  • Data_AdRequestId - A unique identifier for ad retrieval attempts

  • Data_AuctionId - A unique identifier for ad placement auction

  • Data_CreativeId - A unique identifier for shown ad content

  • Data_Height - The height of the advertisement image

  • Data_OfficeLanguage - The current language of the Office application

  • Data_Width - The width of the advertisement image

Office.Android.AdsMobile.Wxpu.ShowAdEvent

This event is triggered when an ad is about to be shown to the user. The data is used to measure advertisement performance metrics.

The following fields are collected:

  • None

Office.Android.DocsUI.FileOperations.OpenDocumentMeasurements

This event is collected for Office applications running under Android platform and records when a file open operation takes place. The event helps in keeping the file open operation secure, up- to- date and performing properly. The goal of collecting this data is to continuously improve the file open performance.

The following fields are collected:

  • Data_AppBootPhaseStats - The breakup of different stages involved in boot phase on file open process. Example value: {PostAppInitTimeInMs=186, PreAppInitWXPTimeInMs=1547, PostCommonLibraryLoadPhaseTime=38, PreMinimumLibraryLoadPhaseTime=1, MinimumLibraryLoadPhaseTime=40, "TotalLockDurationDuringNativeLibLoad": "0", LibrarySharingPhaseTime=252, CommonLibraryLoadPhaseTime=435, InitialBootPhaseTime=252, PreAppInitTimeInMs=1805, ApplicationBootTimeWXP=3779, PreCommonLibraryLoadPhaseTime=267, ActivityTransitionTime=480, ApplicationObjectCreationTime=532, ApplicationBootTime=3748, AppActivationWXPTimeInMs=187, "TotalLockDurationDuringMinLibLoad": "0", PostOfficeActivityTimeInMs=274, AppActivationTimeInMs=218, ExtractionTime=22, OfficeActivityTime=244, PostAppInitWXPTimeInMs=201}

  • Data_AppDocsOperationDuration - The duration spent in sub- layer during a file open operation.

  • Data_AppDuration - The duration spent in application processing during a file open operation.

  • Data_AppObjectCreationDuration - The duration spent in application object creation (pre-boot stage) in process of file open. This isn't part of boot duration.

  • Data_AppWarmUpGain - The gain in application boot duration we get because of pre-booting a part of the application beforehand.

  • Data_BootDuration - The duration of application boot in process of the file open.

  • Data_BootDurationWithPreAppActivate - Duration of the boot until preappactivate marker

  • Data_BootMarkers – A string value logging the time duration between some function calls when booting the application, in a format with function ID and duration.

  • Data_BootToDocumentOpBegin - The duration of boot to appdocs begin.

  • Data_ClosePreviouslyOpenedMarkers – In some file open scenarios, closing of a previously opened document takes place before the opening of the current document. This time duration between some of the operations that take place in this case is captured in a string value that has the format <functionId><functionValue><functionId><functionValue>...

  • Data_Doc_AccessMode - An enumeration indicating the access mode of the file, for example, read only, read write.

  • Data_Doc_AsyncOpenKind - An enumeration indicating the type of asynchronous flow used to open the file.

  • Data_Doc_ChunkingType - An enumeration indicating the type of chunking algorithm of a file.

  • Data_Doc_EdpState - An enumeration indicating the enterprise data protection state of a file.

  • Data_Doc_Ext - File extension of the file.

  • Data_Doc_Fqdn - The server host name of the file.

  • Data_Doc_FqdnHash - A Globally Unique Identifier (GUID) that uniquely identifies server host name.

  • Data_Doc_IdentityTelemetryId - A GUID that uniquely identifies the identity used to open a file.

  • Data_Doc_InitializationScenario - An enumeration indicating the detailed scenario type of a file open operation.

  • Data_Doc_IOFlags - An enumeration indicating the IO flags of a file open operation, for example, if the file is cached or not.

  • Data_Doc_IsCloudCollabEnabled - Whether or not the cloud collaboration is enabled for the file.

  • Data_Doc_IsIncrementalOpen - Whether or not the file was opened via incremental open.

  • Data_Doc_IsOcsSupported - Whether or not a file supports Office Collaboration Service.

  • Data_Doc_IsOpeningOfflineCopy - Whether or not a file is opened from an offline cached copy.

  • Data_Doc_IsPrefetched - Whether or not the file was prefetched before open operation happened.

  • Data_Doc_IsSyncBacked - Whether or not a cloud file exists locally and is synchronized with the server.

  • Data_Doc_Location - An enumeration indicating where the file is located, for example, locally or in cloud.

  • Data_Doc_ReadOnlyReasons - An enumeration indicating the read only reason of a file.

  • Data_Doc_ResourceIdHash - A GUID that uniquely identifies server resource ID of the file.

  • Data_Doc_RtcType - An enumeration indicating type of real-time channel (RTC) used by the file.

  • Data_Doc_ServerDocId - A GUID that uniquely identifies server document ID.

  • Data_Doc_ServerProtocol - An enumeration indicating the server protocol of a cloud file.

  • Data_Doc_ServerType - An enumeration indicating the server type of a cloud file.

  • Data_Doc_ServerVersion - An enumeration indicating the server version of a cloud file.

  • Data_Doc_SessionId - An integer that is incremented by 1 for each file open operation in a session.

  • Data_Doc_SharePointServiceContext - A string used to correlate client- side and server- side logs, typically it's a kind of ID.

  • Data_Doc_SizeInBytes - File size in bytes.

  • Data_Doc_SpecialChars - An enumeration indicating which kind of special character the file URL has.

  • Data_Doc_UrlHash - A GUID that uniquely identifies the file URL.

  • Data_Doc_UsedWrsDataOnOpen - Whether or not the file was opened incrementally using pre- cached WRS data.

  • Data_Doc_WopiServiceId - A string indicating which service a Web Application Open Platform Interface Protocol (WOPI) file is from.

  • Data_ErrorId_Code - An error code indicating a failure in the data collection operation

  • Data_ErrorId_Tag - A tag in the code to help find the point of failure

  • Data_FGFlags - A number indicating whether the user is selected for performance related experimentation.

  • Data_FileOpenFlowMarkers – Before the file open process begins, there's some pre-processing involved. This time taken for this pre-processing is captured in a string value that has the format <functionId><functionValue><functionId><functionValue>...

  • Data_FirstPartyProviderApp - If a file open on Word, Excel, or PowerPoint or Office apps is invoked from another Microsoft app, then the name of that provider app is captured here.

  • Data_IdocsEndToInspaceDuration - The duration between idocend to and inspace animation.

  • Data_InclusiveMeasurements - A string value logging the time duration spent in some function calls, in a format with function tag and duration that includes the duration of sub- function calls.

  • Data_InitializationReason - An enumeration indicating how the file is opened, for example, UI element, triggered by another app, etc.

  • Data_IsAppUpgradeSession - A Boolean value indicating if current session is app upgrade session. 1 = true, 0 = false

  • Data_IsBackgroundActivationComplete - The state (true/false) to identify if pre-booting of application is done through background activation or not.

  • Data_IsFRESession - A Boolean value indicating if the file open is the first action the user did after installing the app. 1 = true, 0 = false

  • Data_Measurements - A string value logging the time duration spent in some function calls, in a format with function tag and duration that excludes the duration of sub- function calls.

  • Data_OfficeMobileInitReason - An enumeration indicating the entry point of file open.

  • Data_PostRenderToInspaceDuration - The duration between post render end and the inspace animation. [This field has been removed from current builds of Office, but might still appear in older builds.]

  • Data_PreAppActivateToDocumentOpBegin - The duration of boot with preappactivate to appdocs begin.

  • Data_RenderToInSpaceDuration – The duration between render end and the silhouette/canvas animation.

  • Data_SilhouetteDuration - The duration of rendering of the file open.

  • Data_SilhouetteDurationTillPostRender - The duration of document end to post render.

  • Data_TimeSplitMeasurements - A string value logging the time duration spent in some function calls, in a format with function tag, start timestamp and duration.

Office.Android.DocsUI.PaywallControl.PreSignInFRE

[This event was previously named Office.DocsUI.PaywallControl.PreSignInFRE.]

This is critical usage telemetry for the upsell in the First Run Experience for unsigned users. This event captures the first-run sign-in metrics. The data will be used to infer insights for the pre sign-in and understand if the user is continuing to the next stage in the user flow.

The following fields are collected:

  • EventDate - Timestamp of the event occurrence

  • FunnelPoint - Enumerator to indicate where user is in this experiment funnel. The enumerator will tell if user sees the treatment and drops off or not.

  • SessionID - Globally Unique Identifier to connect events by session

Office.Android.DocsUI.PaywallControl.SkuChooserToggled

Usage telemetry to view how many times user switches between different SKUs before attempting a purchase. Used to understand usage of the SKU chooser and optimize the in app purchase experience in future versions.

The following fields are collected:

  • EventDate – Timestamp of the event occurrence

  • SessionID – GUID to connect events by session

Office.Android.DocsUI.PaywallControl.UserImageClicked

[This event was previously named Office.DocsUI.PaywallControl.UserImageClicked.]

This event measures telemetry to see if users are trying to complete an action by clicking on a user avatar. This data is used to measure how many users interact with the avatar icon to assess the need for a follow-up experience upon tap.

The following fields are collected:

  • EventDate -Timestamp of the event occurrence

  • SessionID - Globally Unique Identifier to connect events by session

Office.Android.DocsUI.Views.SignInBottomSheetExp

This event is triggered whenever an unsigned user boots the app and is presented with a sign in. The event is collected to identify potential issues in the sign in flow, whether it's Single Sign-On (SSO), manual sign in, or sign up.

The following fields are collected:

  • mBottomSheetState - Indicates the mode of user signing in the app.

  • mDiscoveredSSOAccountInfos.size - Indicates the number of valid accounts found via SSO.

  • mSignInBottomSheetAccountsSearchBeginTime - Indicates time taken by user to click any CTA since app launch.

  • mSignInBottomSheetADALSSOAccountsCount - Indicates the number of valid ADAL accounts found via SSO.

  • mSignInBottomSheetDismissTime - Indicates time taken in dismissal of SignInBottomSheet UI post signin completion since app launch.

  • mSignInBottomSheetMSASSOAccountsCount - Indicates the number of valid MSA accounts found via SSO.

  • mSignInBottomSheetNonSSOFlowBeginTime - Indicates time taken to start Non-SSO flow post Account discovery since app launch.

  • mSignInBottomSheetOnSSOAccountDiscoveryTime - Indicates time taken in account discovery for SSO since app launch.

  • mSignInBottomSheetOnSSOCompletionTime - Indicates time taken in for SSO since app launch.

  • mSignInBottomSheetShowTime - Indicates time taken by SignInBottomSheet UI to load since app launch.

  • mSignInBottomSheetSISUStartTime - Indicates time taken to start Non-SSO flow since app launch.

  • mSignInBottomSheetValidSSOAccountsCount - Indicates the number of accounts found via SSO.

Office.Android.EarlyTelemetry.AdInfraEvent

[This event was previously named Office.Android.AdInfraEvent.]

This event is triggered when an ad request is sent, and a response is received from the ad network. This event doesn't collect any user related data from the online platform. This data is logged to understand:

  • Type of ads sent by the ad network
  • Error messages sent by the ad network (request failed)
  • No-response events from the ad network

The following fields are collected:

  • Data_AuctionId - Unique ID sent by Ad network to map a sell transaction to a specific ad response

  • Data_Operation_Metadata - Additional information regarding the ad related operation performed by the ad infra

  • Data_Operation_Result - The result of the ad related operation performed by the ad infra

  • Data_Operation_Type - The kind of ad related operation performed by the ad infra

  • Data_PlacementId - Unique identifier used by Ad network service to associate an ad to a surface

Office.Android.EarlyTelemetry.DocsUIControllerFailure

This event is triggered when the user launches Office Mobile application and triggers sign in or authentication. This data helps us to identify the failures of the authentication/sign in.

The following fields are collected:

  • Data_ErrorCode - class name where failure occurred.

  • Data_ErrorDescription - description of the error.

  • Data_FailureMethod - method name where failure occurred.

Office.Android.EarlyTelemetry.ExpansionFilesAvailability

We're enabling Android Package Kit (APK) expansion files for the Microsoft 365 mobile app. APK Expansion files are supplementary resource files that Android app developers can publish along with their app. To understand the reliability of the expansion files, we log a flag indicating whether expansion files are available or not at every boot.

The following fields are collected:

  • Data_ExpansionFilesAvailable - A Boolean flag that indicates whether APK Expansion files are available on the device at the time of app boot.

Office.Android.EarlyTelemetry.ExpansionFilesDownloader

We're enabling Android Package Kit (APK) expansion files for the Microsoft 365 mobile app. APK Expansion files are supplementary resource files, that Android app developers can publish along with their app. To understand the reliability of our expansion file download mechanism, we're logging a flag indicating whether we're successfully able to download expansion files.

The following fields are collected:

  • Data_DownloadSuccess - A Boolean flag that indicates whether APK Expansion files download is successful, whenever we attempt a download during app boot.

Office.Android.EarlyTelemetry.NoteCreated

Critical signal that is used to monitor the ability of Sticky Notes users to create notes in the app. Telemetry is used to ensure critical regression detection for OneNote app and service health. If users can’t create a note, this would trigger a high severity incident.

The following fields are collected:

  • IsExportable - A flag indicating whether this event was a result of a user action or not. Should be set to True as NoteCreated is a user-triggered action.

  • NoteLocalId - Distinguishable unique identifier assigned to a note at the time of a user creates the note within the app.

  • StickyNotes-SDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

Office.Android.EarlyTelemetry.NoteViewed

Critical signal that is used to monitor the ability of Sticky Notes users to view notes in the app. Telemetry is used to ensure critical regression detection for OneNote app and service health. If users can’t view their notes, this would trigger a high severity incident.

The following fields are collected:

  • HasImages - A flag indicating whether the note viewed has images stored in it.

  • IsExportable - A flag indicating whether this event was a result of a user action or not. Should be set to True as NoteViewed is a user-triggered action.

  • NoteLocalId - Distinguishable unique identifier assigned to a note at the time a user creates the note within the app.

  • StickyNotes-SDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

Office.Android.Intune.IntuneComplianceRequest

This event is collected for Office applications running on Android, including Microsoft 365 mobile app, Word, Excel, PowerPoint, and OneNote. The event indicates an attempt to sign in to an Intune licensed organization account where the organization administrator has configured policy to enforce app conditional access. It's used to understand the number of end users who are attempting to use apps under this policy configuration, and is combined with another event, Office.Android.Intune.IntuneComplianceStatus, to ensure the configured policy is enforced.

No data fields are collected.

Office.Android.Intune.IntuneComplianceStatus

This event is collected for Office applications running on Android, including Microsoft 365 mobile app, Word, Excel, PowerPoint, and OneNote. The event indicates an attempt to sign in to an Intune licensed organization account where the organization administrator has configured policy to enforce app conditional access. This event indicates the compliance status of the application to which the user has signed-in and is used to investigate failures. It's combined with another event, Office.Android.Intune.IntuneComplianceRequest, to ensure the configured policy is enforced.

The following fields are collected:

  • Data_ComplianceStatus - Indicates the compliance status of the application during sign-in with a success or failure error code.
    • -1 – Unknown error
    • 0 – The application is compliant with the organization policies
    • 1 – The application isn't compliant with the organization policies
    • 2 – Service-related failures
    • 3 – Network-related failures
    • 4 – Application failed to retrieve authentication token
    • 5 – The response hasn't been yet received from the service
    • 6 – The company portal application needs to be installed

Office.Android.ODWXPSSO.Telemetry

This event helps in understanding with which other Microsoft app in the device, our app got silent single sign on, from which entry point and so on. Also helps in understanding the failure reason for not getting silent single sign on. We get better insights like from which Microsoft app in the device, we're getting single sign on experience. Act upon failures, where single sign on isn't working as expected.

The following fields are collected:

  • AccountType - Indicates the account type with which single sign on is happening, like personal Microsoft account or work account.

  • EntryPoint - Indicates the entry point in the app, from where single sign on attempt was initiated.

  • ErrorCode - Indicates the error code of the single sign on attempt.

  • ErrorDescription - Indicates the error message of the single sign on attempt.

  • HResult - Indicates result status code of the single sign on attempt.

  • ProviderPackageId - Other Microsoft app in the device from which single sign on is happening.

Office.Android.PhoneNumberSignIns

This event helps in understanding if user signed in or signed up with phone number-based account or email based personal Microsoft account. This event helps in knowing count of users signing in or signing up with phone number based personal Microsoft account.

The following fields are collected:

  • EntryPoint - Indicates the entry point in the app, from where sign-in attempt was initiated.

  • IsEmailMissing - Is email missing in the account profile information?

  • IsPhoneNumberMissing - Is phone number missing in the account profile information?

  • UserDecision - Indicates the choice made by user like sign-in or sign-up or sign in later.

Office.Android.UserSignInDecision

This event helps in understanding at which stage user is dropping in sign in flow, why sign in is failing, how many users are getting signed in successfully from which entry point in the app and so on. This event helps with sign-in funnel data, which helps in understand at which stage users are getting dropped more and so on.

The following fields are collected:

  • AccountType - Indicates the account type with which sign-in is attempted like personal account or work account.

  • AfterLicensingState - Indicates the app licensing state after sign-in completed.

  • AllowedEditsWithoutSignIn - Indicates how many free edits have lapsed before sign-in was attempted.

  • BeforeLicensingState - Indicates the app licensing state before sign-in attempted.

  • CompletionState - Indicates the stage of sign-in completion.

  • EntryPoint - Indicates the entry point in the app, from where sign-in attempt was initiated.

  • HRDAutoAcceleratedSignUpAttemptCount - Indicates the count of accelerated sign-ups attempted.

  • HRDAutoAcceleratedSignUpQuitCount - Indicates the count of accelerated sign-ups canceled.

  • HResult - Indicates result status code of the sign-in operation.

  • IsPhoneOnlyAuthFeatureEnabled - Is phone number-based sign-in allowed or not?

  • LicenseActivationHResult - Indicates the status code of license activation attempt.

  • LicenseActivationMessageCode - Indicates the message code from licensing service.

  • NoFreeEditsTreatmentValue - Is free edits allowed or not?

  • SignUpAttemptCount - Indicates the count of sign-ups attempted.

  • StartMode - Indicates the mode in which sign-in attempt was started.

  • UserDecision - Indicates the choice made by user like sign-in or sign-up or sign in later.

Office.AppCompat.AppCompat.AgentScanAndUpload

Only collected when end user has enabled Office Telemetry Dashboard. It collects information on when the Office Telemetry Agent is executed. This is only collected when Office Telemetry Dashboard is enabled and is used to determine the health of Office Telemetry agent.

The following fields are collected:

  • Data.AgentExit - Timestamp of when the Telemetry agent exits successfully

  • Data.AgentScan - Timestamp of when the Telemetry agent completed a scan successfully

  • Data.AgentUpload - Timestamp of when the Telemetry agent completes the upload successfully

Office.AppCompat.AppCompat.AgentUpload

Generated on client startup when end user has enabled Office Telemetry Dashboard. It collects information on when the Office Telemetry Agent has uploaded data to the share folder. The primary use of this event is to monitor the health of the Office Telemetry agent and the secondary use of the event is to estimate usage of the Office Telemetry Dashboard.

The following fields are collected:

  • UploadTime - the timestamp of the last successful upload performed by the Telemetry Agent.

Office.AppCompat.AppCompat.TelemetryDashboardResiliencyCrashLog

Only collected when Office Telemetry Dashboard has been enabled by end user (most likely an admin). It collects the occurrence of Office Add-ins and documents crashes. This is only collected when user has enabled Office Telemetry Dashboard and is used to determine if there's an increased occurrence of add-in or document crashes.

The following fields are collected:

  • Data.CollectionTime - Timestamp of when a crash event was logged

Office.AppDocs.AppDocs.DocumentOperation

This event is collected for Office applications running on Android, iOS, Universal, or Windows platforms. The event records when a file operation (create/open/save/export/etc.) takes place and it's used to understand and prioritize user-experiences based on the file operation information.

The following fields are collected:

  • Data_AppIdForReportEndBeforeAppKnown – App ID when not known before report end called on the operation.

  • Data_CanContinueFromOnBeforeOperationBegins – CanContinue state, before the begin handler is invoked.

  • Data_DetachedDuration – The duration of detach process of an event.

  • Data_Doc_AccessMode – An enumeration indicating the access mode of the file, for example, read only, read write.

  • Data_Doc_AsyncOpenKind – An enumeration indicating the type of asynchronous flow used to open the file.

  • Data_Doc_ChunkingType – An enumeration indicating the type of chunking algorithm of a file.

  • Data_Doc_EdpState – An enumeration indicating the enterprise data protection state of a file.

  • Data_Doc_Ext – The first four characters of the file extension of the file.

  • Data_Doc_Fqdn – The server host name of the file.

  • Data_Doc_FqdnHash – A GUID that uniquely identifies server host name.

  • Data_Doc_IdentityTelemetryId – A one-way hash of the user identity used to perform the open.

  • Data_Doc_InitializationScenario – An enumeration indicating the detailed scenario type of a file open operation.

  • Data_Doc_IOFlags – An enumeration indicating the IO flags of a file open operation, for example, if the file is cached or not.

  • Data_Doc_IsCloudCollabEnabled – Whether or not the cloud collaboration is enabled for the file.

  • Data_Doc_IsIncrementalOpen – Whether or not the file was opened via incremental open.

  • Data_Doc_IsOcsSupported – Whether or not a file supports Office Collaboration Service.

  • Data_Doc_IsOpeningOfflineCopy – Whether or not a file is opened from an offline cached copy.

  • Data_Doc_IsPrefetched – Whether or not the file was prefetched before open operation happened.

  • Data_Doc_IsSyncBacked – Whether or not a cloud file exists locally and is synchronized with the server.

  • Data_Doc_Location – An enumeration indicating where the file is located, for example, locally or in cloud.

  • Data_Doc_ReadOnlyReasons – An enumeration indicating the read only reason of a file.

  • Data_Doc_ResourceIdHash – A GUID that uniquely identifies server resource ID of the file.

  • Data_Doc_RtcType – An enumeration indicating type of real-time channel (RTC) used by the file.

  • Data_Doc_ServerDocId – A GUID that uniquely identifies server document ID.

  • Data_Doc_ServerProtocol – An enumeration indicating the server protocol of a cloud file.

  • Data_Doc_ServerType – An enumeration indicating the server type of a cloud file.

  • Data_Doc_ServerVersion – An enumeration indicating the server version of a cloud file.

  • Data_Doc_SessionId – An integer that is incremented by 1 for each file open operation in a session.

  • Data_Doc_SharePointServiceContext – A string used to correlate client-side and server-side logs, typically it's a kind of ID.

  • Data_Doc_SizeInBytes – File size in bytes.

  • Data_Doc_SpecialChars – An enumeration indicating which kind of special character the file URL has.

  • Data_Doc_UrlHash – A GUID that uniquely identifies the file URL.

  • Data_Doc_UsedWrsDataOnOpen – Whether or not the file was opened incrementally using pre-cached WRS data.

  • Data_Doc_WopiServiceId – A string indicating which service a WOPI (Web Application Open Platform Interface Protocol) file is from.

  • Data_DocumentInputCurrency – Type of document input used by the operation.

  • Data_DocumentOperation_AppId – Enumeration value representing the ID of an app.

  • Data_DocumentOperation_EndEventId – Tag that represents where the operation ended.

  • Data_DocumentOperation_EndReason – Enumeration value representing the end reason.

  • Data_DocumentOperation_IsReinitialized – Is reinitializing a document already open.

  • Data_DocumentOperation_isTargetECBeginEC – Is the target execution context the same as the context opened from.

  • Data_DocumentOperation_ParamsFlags – Enumeration flags used to start the operation.

  • Data_DocumentOperation_TelemetryReason – Enumeration representation of the entry point for the open event. Eg- open from MRU or browse, file activation, etc.

  • Data_FileIOInclusiveMeasurements – A string value logging the time duration spent in some function calls, in a format with function tag and duration that includes the duration of sub-function calls.

  • Data_FileIOMeasurements – A string value logging the time duration spent in some function calls, in a format with function tag and duration that excludes the duration of sub-function calls.

  • Data_InitializationReason – Enumeration representation of the specific reason for the operation. Eg- open from a URL or a local file path, create with file picker, copy to file path, export to URL, etc.

  • Data_IsDisambiguateCsiNetworkConnectivityErrorEnabled.

  • Data_IsNameMissingInUrl – Indicates if the name wasn't parsed from the URL.

  • Data_IsPathMissingForLocalFile – Indicates if this is a local file without a path.

  • Data_IsUnpackedLinkSupportedForOpen – Indicates if unpackable link is supported for open.

  • Data_LinksOpenRightScenario – Enumeration value for the links open right scenario.

  • Data_OpEndEventId – Tag that represents where the operation ended.

  • Data_OperationType – Enumeration representation of the generic type of operation. Eg- create, open, copy, save, etc.

  • Data_RelatedPrevOpTelemetryReason – Is operation related to previous operation.

  • Data_StopwatchDuration – Total time for the event.

  • Data_UnpackLinkHint – Enumeration representing potential user action based on unpack link.

  • Data_UnpackLinkPromptResult – Enumeration representing response of unpack link prompt.

Office.Apple.AccountTransferIOS

The event is triggered when the application shows the Account Transfer flow on mobile devices. Data is used to determine the cause of sign-in failures and identify errors.

The following fields are collected:

  • ErrorCode - An enumerator value indicating the error (if any) that occurred during the Account Transfer execution.

  • ErrorDomain - A string that identifies the domain (class of error) from the error that occurred during the execution.

  • EventCode - An enumerator value indicating the ending event for the Account Transfer execution.

  • IsFirstRun - Boolean flag indicating if Account Transfer was executed the first time the app is launched. Allows us to identify if the execution during the first app launch is contributing to errors.

  • IsFREInterrupt - Boolean flag indicating if Account Transfer was executed while the First Run Experience flow was in progress. Allows us to identify if the First Run Experience flow is contributing to errors.

Office.Apple.ActivatePerpetual

This event is collected for Office applications running under Apple platforms. The event is used to monitor the health of the perpetual activation flow as well as investigating causes of failures by reviewing the FailedAt values.

The following fields are collected:

  • Data_FailedAt - We collect a string representing where in the activate perpetual license flow we failed.

Office.Apple.ActivateSubscription

This event is collected for Office applications running under Apple platforms. We collect information related to the migration from the legacy licensing code stack to the vNext licensing code tack. This is used to monitor the health of the subscription activation flow as well as tracking if this is a migration to licensing vNext and if the primary identity was used.

The following fields are collected:

  • Data_ActivatingPrimaryIdentity - A true/false value denoting if the primary identity was used.

  • Data_NULSubscriptionLicensed - A true/false value denoting the state of subscription

Office.Apple.CISAuthTicketWithIdentity

This event is collected for Office applications running under Apple platforms. The event is used for capturing auth token generation failures during InAppPurchase on the Mac (the event logs the error code received). This event is used for detecting and helping troubleshoot auth token generation failures.

The following fields are collected:

  • Data_EmptyAuthToken - We collect a string representing where in the activate perpetual license flow we failed.

  • Data_TicketAuthError - Error code that indicates the cause of failure

  • Data_ValidIdentity - If the client has a valid identity

Office.Apple.FirstRunCompleted

The event is triggered when Office apps on Mac are launched for the first time and complete the First Run Experience. The data is used to monitor the health of our applications’ First Run Experience (FRE) flow, determine its success state, and whether users get stuck in the process of using the app for the first time.

The following fields are collected:

  • IsCompleted - Indicates whether First Run completed or not.

Office.Apple.FirstRunPanelAppear

The event is triggered when Office apps on Mac are launched for the first time and go through the different First Run Experience panels. The data is used to monitor the health of our applications’ First Run Experience (FRE) flow, determine its success state, and whether users get stuck in the process of using the app for the first time.

The following fields are collected:

  • Panel - Indicates the type of First Run panel that appeared.

Office.Apple.FirstRunPanelDisappear

The event is triggered when Office apps on Mac are launched for the first time and go through the different First Run Experience panels. The data is used to monitor the health of our applications’ First Run Experience (FRE) flow, determine its success state, and whether users get stuck in the process of using the app for the first time.

The following fields are collected:

  • Panel - Indicates the type of First Run panel that disappeared.

Office.Apple.FirstRunStarted

The event is triggered when Office apps on Mac are launched for the first time and begin the First Run Experience flow. The data is used to monitor the health of our applications’ First Run Experience (FRE) flow, determine its success state, and whether users get stuck in the process of using the app for the first time.

The following fields are collected:

  • None

Office.Apple.InAppAssociationActivity

This event is collected for Office applications running under Apple platforms. We collect information related to product association after an in-app purchase. We log which subscription SKU we're associating. This is used to monitor the health of the in-app purchase product associations.

The following fields are collected:

  • Data_ProductID - The subscription SKU we're trying to associate the product to.

Office.Apple.InAppPurchaseActivity

This event is collected for Office applications running under Apple platforms.

We collect information related to product purchases on the AppStore. We track the result of the purchase (Failure, success, payment issue, etc.), the type of the purchase request (restore, purchase) and the SKU/product being purchased (Microsoft 365 Family, etc.). This data is used for monitoring the health of the in-app purchase flows.

The following fields are collected:

  • Data_ Data_PurchaseResult - The result of the purchase operation

  • Data_ProductID - The product being purchased

  • Data_PurchaseRequestType - The type of purchase request

Office.Apple.InTune

This event is collected for Office applications running under Apple platforms. We collect whether the current session is Intune-managed. This is used to pivot/filter on Intune managed sessions and allows us to investigate potential issues related to Office being run as an Intune-managed application.

The following fields are collected:

  • Data_EventID - We collect a string representing a code that indicates whether the session is intune-managed.

Office.Apple.Licensing.FetchCopilotServicePlanSucceed

The event is triggered when the application succeeds to retrieve a Copilot license plan. Event is used to understand Copilot license success rates and keep the feature working as expected.

The following fields are collected:

  • RetryAttempt - Integer that specifies the number of attempts used to retrieve a Copilot license.

Office.Apple.Licensing.Mac.LicensingState

This event is collected for Office applications running under Apple platforms. The event captures the current state of the license for a session in a machine (OLS license ID, SKU being used, grace-period or not, RFM, etc.). The data collected is used for detecting errors and investigating causes of failures.

The following fields are collected:

  • Data_DidRunPreview - A string indicating if this session is run under preview

  • Data_LicensingACID - A string representing a licensing system internal identifier

  • Data_LicensingType - A string representing the type of license

  • Data_OLSLicenseId - A string representing a license identifier

  • Data_State - A string representing the current state of the license

Office.ConnectDevice.Activity.Start

Allows us to know if a connection to a device or application was successful. Used for feature health and monitoring. This event is generated by Microsoft Data Streamer for Excel Add-in.

The following fields are collected:

  • Datasource_Type - Serial device, or App Service information

  • DataSource_Name - Name of connected data source

  • Activity_Name = Name of the activity "ConnectDevice"

  • Activity_CV = ID to correlate the events across the connection session

  • Activity_StartStopType = Start

  • Activity_DateTimeTicks = Data Time for the activity

Office.ConnectDevice.Activity.Stop

Allows us to know if a connection to a device or application was successful. Used for feature health and monitoring This event is generated by Microsoft Data Streamer for Excel Add-in.

The following fields are collected:

  • Datasource_Type - Serial device, or App Service information

  • DataSource_Name - Name of connected data source

  • Activity_Name - Name of the activity "ConnectDevice"

  • Activity_CV - ID to correlate the events across the connection session

  • Activity_StartStopType - Stop

  • Activity_DateTimeTicks - Data Time for the activity

Office.DesignerApp.App.SubmitPromptTemplate

The event log captures essential data regarding if the submit template event has occurred, it captures only the start and stop of the functionalityand& if the feature is running or not. This information is used to create map of users and figure out where the traffic is moving or struggling so that the Designer functionality could be enhanced and made more effective.

The following fields are collected:

  • CorrelationId - GUID used to correlate activities.

  • EndPoint - Used to identify the appropriate Designer screen in which design/image creation was performed.

  • flowId - GUID used to identify current app flow started on home screen.

  • Host - Identifies the host app name that launches Designer.

  • HostAppSessionId - Uniquely identifies the host app session for a sub-app.

  • Locale - Locale of user.

  • MiniAppsConfigVersion - Configuration version of mini apps supported on home screen.

  • MiniAppsEnabled - Identifies if sub apps are enabled on Designer home screen.

  • SDKLaunchCorrelationId - GUID used to correlate Designer SDK activities.

  • SdkVersion - Version of Designer SDK.

  • Source - Logs source of Designer SDK launch.

  • SystemLocale - System locale of the device.

  • TimeZone - The user's time zone relative to UTC.

  • UserAgeGroup - Logs age group of user like minor or adult.

  • UserIntent - Indicates whether some operation is to be considered as active operation or not.

Office.Docs.AppDocs.OperationOpenFromMruByPath

This event is collected for Office applications running on Android, iOS, Universal, or Windows platforms. The event records when a file open operation takes place from the path provided in the most recently used list and is used to understand and prioritize user-experience errors based on file open operation information.

The following fields are collected:

  • Data_AppIdForReportEndBeforeAppKnown – App ID when not known before report end called on the operation.

  • Data_CanContinueFromOnBeforeOperationBegins – CanContinue state, before the begin handler is invoked.

  • Data_DetachedDuration – The duration of detach process of an event.

  • Data_Doc_AccessMode – An enumeration indicating the access mode of the file, for example, read only, read write.

  • Data_Doc_AsyncOpenKind – An enumeration indicating the type of asynchronous flow used to open the file.

  • Data_Doc_ChunkingType – An enumeration indicating the type of chunking algorithm of a file.

  • Data_Doc_EdpState – An enumeration indicating the enterprise data protection state of a file.

  • Data_Doc_Ext – First 4 characters of the extension of the file.

  • Data_Doc_Fqdn – The server host name of the file.

  • Data_Doc_FqdnHash – A GUID that uniquely identifies server host name.

  • Data_Doc_IdentityTelemetryId – A one-way hash of the user identity used to perform the open.

  • Data_Doc_InitializationScenario – An enumeration indicating the detailed scenario type of a file open operation.

  • Data_Doc_IOFlags – An enumeration indicating the IO flags of a file open operation, for example, if the file is cached or not.

  • Data_Doc_IsCloudCollabEnabled – Whether or not the cloud collaboration is enabled for the file.

  • Data_Doc_IsIncrementalOpen – Whether or not the file was opened via incremental open.

  • Data_Doc_IsOcsSupported – Whether or not a file supports Office Collaboration Service.

  • Data_Doc_IsOpeningOfflineCopy – Whether or not a file is opened from an offline cached copy.

  • Data_Doc_IsPrefetched – Whether or not the file was prefetched before open operation happened.

  • Data_Doc_IsSyncBacked – Whether or not a cloud file exists locally and is synchronized with the server.

  • Data_Doc_Location – An enumeration indicating where the file is located, for example, locally or in cloud.

  • Data_Doc_ReadOnlyReasons – An enumeration indicating the read only reason of a file.

  • Data_Doc_ResourceIdHash – A GUID that uniquely identifies server resource ID of the file.

  • Data_Doc_RtcType – An enumeration indicating type of real-time channel (RTC) used by the file.

  • Data_Doc_ServerDocId – A GUID that uniquely identifies server document ID.

  • Data_Doc_ServerProtocol – An enumeration indicating the server protocol of a cloud file.

  • Data_Doc_ServerType – An enumeration indicating the server type of a cloud file.

  • Data_Doc_ServerVersion – An enumeration indicating the server version of a cloud file.

  • Data_Doc_SessionId – An integer that is incremented by 1 for each file open operation in a session.

  • Data_Doc_SharePointServiceContext – A string used to correlate client-side and server-side logs, typically it's a kind of ID.

  • Data_Doc_SizeInBytes – File size in bytes.

  • Data_Doc_SpecialChars – An enumeration indicating which kind of special character the file URL has.

  • Data_Doc_UrlHash – A GUID that uniquely identifies the file URL.

  • Data_Doc_UsedWrsDataOnOpen – Whether or not the file was opened incrementally using pre-cached WRS data.

  • Data_Doc_WopiServiceId – A string indicating which service a WOPI (Web Application Open Platform Interface Protocol) file is from.

  • Data_DocumentInputCurrency – Type of document input used by the operation.

  • Data_DocumentOperation_AppId – Enumeration value representing the ID of an app.

  • Data_DocumentOperation_EndEventId – Tag that represents where the operation ended.

  • Data_DocumentOperation_EndReason – Enumeration value representing the end reason.

  • Data_DocumentOperation_IsReinitialized – Is reinitializing a document already open.

  • Data_DocumentOperation_ParamsFlags – Enumeration flags used to start the operation.

  • Data_DocumentOperation_TelemetryReason – Enumeration representation of the entry point for the open event. Eg- open from MRU or browse, file activation, etc.

  • Data_DocumentOperation_isTargetECBeginEC – Is the target execution context the same as the context opened from.

  • Data_FileIOInclusiveMeasurements – A string value logging the time duration spent in some function calls, in a format with function tag and duration that includes the duration of sub-function calls.

  • Data_FileIOMeasurements – A string value logging the time duration spent in some function calls, in a format with function tag and duration that excludes the duration of sub-function calls.

  • Data_IsNameMissingInUrl – Indicates if the name wasn't parsed from the URL.

  • Data_IsPathMissingForLocalFile – Indicates if this is a local file without a path.

  • Data_IsUnpackedLinkSupportedForOpen – Indicates if unpackable link is supported for open.

  • Data_LinksOpenRightScenario – Enumeration value for the links open right scenario.

  • Data_OpEndEventId – Tag that represents where the operation ended.

  • Data_RelatedPrevOpTelemetryReason – Is operation related to previous operation.

  • Data_StopwatchDuration – Total time for the event.

  • Data_UnpackLinkHint – Enumeration representing potential user action based on unpack link.

  • Data_UnpackLinkPromptResult – Enumeration representing response of unpack link prompt.

Office.Docs.AppDocs.OperationOpenFromMruByUrl

This event is collected for Office applications running on Android, iOS, Universal, or Windows platforms. The event records when a file open operation takes place from the URL provided in the most recently used list and is used to understand and prioritize user-experiences based on file open operation information.

The following fields are collected:

  • Data_AppIdForReportEndBeforeAppKnown – App ID when not known before report end called on the operation.

  • Data_CanContinueFromOnBeforeOperationBegins – CanContinue state, before the begin handler is invoked.

  • Data_DetachedDuration – The duration of detach process of an event.

  • Data_Doc_AccessMode – An enumeration indicating the access mode of the file, for example, read only, read write.

  • Data_Doc_AsyncOpenKind – An enumeration indicating the type of asynchronous flow used to open the file.

  • Data_Doc_ChunkingType – An enumeration indicating the type of chunking algorithm of a file.

  • Data_Doc_EdpState – An enumeration indicating the enterprise data protection state of a file.

  • Data_Doc_Ext – First 4 characters of the extension of the file.

  • Data_Doc_Fqdn – The server host name of the file.

  • Data_Doc_FqdnHash – A GUID that uniquely identifies server host name.

  • Data_Doc_IdentityTelemetryId – A one-way hash of the user identity used to perform the open.

  • Data_Doc_InitializationScenario – An enumeration indicating the detailed scenario type of a file open operation.

  • Data_Doc_IOFlags – An enumeration indicating the IO flags of a file open operation, for example, if the file is cached or not.

  • Data_Doc_IsCloudCollabEnabled – Whether or not the cloud collaboration is enabled for the file.

  • Data_Doc_IsIncrementalOpen – Whether or not the file was opened via incremental open.

  • Data_Doc_IsOcsSupported – Whether or not a file supports Office Collaboration Service.

  • Data_Doc_IsOpeningOfflineCopy – Whether or not a file is opened from an offline cached copy.

  • Data_Doc_IsPrefetched – Whether or not the file was prefetched before open operation happened.

  • Data_Doc_IsSyncBacked – Whether or not a cloud file exists locally and is synchronized with the server.

  • Data_Doc_Location – An enumeration indicating where the file is located, for example, locally or in cloud.

  • Data_Doc_ReadOnlyReasons – An enumeration indicating the read only reason of a file.

  • Data_Doc_ResourceIdHash – A GUID that uniquely identifies server resource ID of the file.

  • Data_Doc_RtcType – An enumeration indicating type of real-time channel (RTC) used by the file.

  • Data_Doc_ServerDocId – A GUID that uniquely identifies server document ID.

  • Data_Doc_ServerProtocol – An enumeration indicating the server protocol of a cloud file.

  • Data_Doc_ServerType – An enumeration indicating the server type of a cloud file.

  • Data_Doc_ServerVersion – An enumeration indicating the server version of a cloud file.

  • Data_Doc_SessionId – An integer that is incremented by 1 for each file open operation in a session.

  • Data_Doc_SharePointServiceContext – A string used to correlate client-side and server-side logs, typically it's a kind of ID.

  • Data_Doc_SizeInBytes – File size in bytes.

  • Data_Doc_SpecialChars – An enumeration indicating which kind of special character the file URL has.

  • Data_Doc_UrlHash – A GUID that uniquely identifies the file URL.

  • Data_Doc_UsedWrsDataOnOpen – Whether or not the file was opened incrementally using pre-cached WRS data.

  • Data_Doc_WopiServiceId – A string indicating which service a WOPI (Web Application Open Platform Interface Protocol) file is from.

  • Data_DocumentInputCurrency – Type of document input used by the operation.

  • Data_DocumentOperation_AppId – Enumeration value representing the ID of an app.

  • Data_DocumentOperation_EndEventId – Tag that represents where the operation ended.

  • Data_DocumentOperation_EndReason – Enumeration value representing the end reason.

  • Data_DocumentOperation_IsReinitialized – Is reinitializing a document already open.

  • Data_DocumentOperation_ParamsFlags – Enumeration flags used to start the operation.

  • Data_DocumentOperation_TelemetryReason – Enumeration representation of the entry point for the open event. Eg- open from MRU or browse, file activation, etc.

  • Data_DocumentOperation_isTargetECBeginEC – Is the target execution context the same as the context opened from.

  • Data_FileIOInclusiveMeasurements – A string value logging the time duration spent in some function calls, in a format with function tag and duration that includes the duration of sub-function calls.

  • Data_FileIOMeasurements – A string value logging the time duration spent in some function calls, in a format with function tag and duration that excludes the duration of sub-function calls.

  • Data_IsNameMissingInUrl – Indicates if the name wasn't parsed from the URL.

  • Data_IsPathMissingForLocalFile – Indicates if this is a local file without a path.

  • Data_IsUnpackedLinkSupportedForOpen – Indicates if unpackable link is supported for open.

  • Data_LinksOpenRightScenario – Enumeration value for the links open right scenario.

  • Data_OpEndEventId – Tag that represents where the operation ended.

  • Data_RelatedPrevOpTelemetryReason – Is operation related to previous operation.

  • Data_StopwatchDuration – Total time for the event.

  • Data_UnpackLinkHint – Enumeration representing potential user action based on unpack link.

  • Data_UnpackLinkPromptResult – Enumeration representing response of unpack link prompt.

Office.Docs.AppDocs.OperationOpenFromPath

This event is collected for Office applications running on Android, iOS, Universal, or Windows platforms. The event records when a file open operation takes place from a path and is used to understand and prioritize user-experiences based on file open operation information.

The following fields are collected:

  • Data_AppIdForReportEndBeforeAppKnown – App ID when not known before report end called on the operation.

  • Data_CanContinueFromOnBeforeOperationBegins – CanContinue state, before the begin handler is invoked.

  • Data_DetachedDuration – The duration of detach process of an event.

  • Data_Doc_AccessMode – An enumeration indicating the access mode of the file, for example, read only, read write.

  • Data_Doc_AsyncOpenKind – An enumeration indicating the type of asynchronous flow used to open the file.

  • Data_Doc_ChunkingType – An enumeration indicating the type of chunking algorithm of a file.

  • Data_Doc_EdpState – An enumeration indicating the enterprise data protection state of a file.

  • Data_Doc_Ext – First 4 characters of the extension of the file.

  • Data_Doc_Fqdn – The server host name of the file.

  • Data_Doc_FqdnHash – A GUID that uniquely identifies server host name.

  • Data_Doc_IdentityTelemetryId – A one-way hash of the user identity used to perform the open.

  • Data_Doc_InitializationScenario – An enumeration indicating the detailed scenario type of a file open operation.

  • Data_Doc_IOFlags – An enumeration indicating the IO flags of a file open operation, for example, if the file is cached or not.

  • Data_Doc_IsCloudCollabEnabled – Whether or not the cloud collaboration is enabled for the file.

  • Data_Doc_IsIncrementalOpen – Whether or not the file was opened via incremental open.

  • Data_Doc_IsOcsSupported – Whether or not a file supports Office Collaboration Service.

  • Data_Doc_IsOpeningOfflineCopy – Whether or not a file is opened from an offline cached copy.

  • Data_Doc_IsPrefetched – Whether or not the file was prefetched before open operation happened.

  • Data_Doc_IsSyncBacked – Whether or not a cloud file exists locally and is synchronized with the server.

  • Data_Doc_Location – An enumeration indicating where the file is located, for example, locally or in cloud.

  • Data_Doc_ReadOnlyReasons – An enumeration indicating the read only reason of a file.

  • Data_Doc_ResourceIdHash – A GUID that uniquely identifies server resource ID of the file.

  • Data_Doc_RtcType – An enumeration indicating type of real-time channel (RTC) used by the file.

  • Data_Doc_ServerDocId – A GUID that uniquely identifies server document ID.

  • Data_Doc_ServerProtocol – An enumeration indicating the server protocol of a cloud file.

  • Data_Doc_ServerType – An enumeration indicating the server type of a cloud file.

  • Data_Doc_ServerVersion – An enumeration indicating the server version of a cloud file.

  • Data_Doc_SessionId – An integer that is incremented by 1 for each file open operation in a session.

  • Data_Doc_SharePointServiceContext – A string used to correlate client-side and server-side logs, typically it's a kind of ID.

  • Data_Doc_SizeInBytes – File size in bytes.

  • Data_Doc_SpecialChars – An enumeration indicating which kind of special character the file URL has.

  • Data_Doc_UrlHash – A GUID that uniquely identifies the file URL.

  • Data_Doc_UsedWrsDataOnOpen – Whether or not the file was opened incrementally using pre-cached WRS data.

  • Data_Doc_WopiServiceId – A string indicating which service a WOPI (Web Application Open Platform Interface Protocol) file is from.

  • Data_DocumentInputCurrency – Type of document input used by the operation.

  • Data_DocumentOperation_AppId – Enumeration value representing the ID of an app.

  • Data_DocumentOperation_EndEventId – Tag that represents where the operation ended.

  • Data_DocumentOperation_EndReason – Enumeration value representing the end reason.

  • Data_DocumentOperation_IsReinitialized – Is reinitializing a document already open.

  • Data_DocumentOperation_ParamsFlags – Enumeration flags used to start the operation.

  • Data_DocumentOperation_TelemetryReason – Enumeration representation of the entry point for the open event. Eg- open from MRU or browse, file activation, etc.

  • Data_DocumentOperation_isTargetECBeginEC – Is the target execution context the same as the context opened from.

  • Data_FileIOInclusiveMeasurements – A string value logging the time duration spent in some function calls, in a format with function tag and duration that includes the duration of sub-function calls.

  • Data_FileIOMeasurements – A string value logging the time duration spent in some function calls, in a format with function tag and duration that excludes the duration of sub-function calls.

  • Data_IsNameMissingInUrl – Indicates if the name wasn't parsed from the URL.

  • Data_IsPathMissingForLocalFile – Indicates if this is a local file without a path.

  • Data_IsUnpackedLinkSupportedForOpen – Indicates if unpackable link is supported for open.

  • Data_LinksOpenRightScenario – Enumeration value for the links open right scenario.

  • Data_OpEndEventId – Tag that represents where the operation ended.

  • Data_RelatedPrevOpTelemetryReason – Is operation related to previous operation.

  • Data_StopwatchDuration – Total time for the event.

  • Data_UnpackLinkHint – Enumeration representing potential user action based on unpack link.

  • Data_UnpackLinkPromptResult – Enumeration representing response of unpack link prompt.

Office.Docs.AppDocs.OperationOpenFromProtocolHandler

This event is collected for Office applications running on Android, iOS, Universal, or Windows platforms. The event records when a file open operation takes place from another application using the protocol handler interface and is used to understand and prioritize user-experiences based on file open operation information.

The following fields are collected:

  • Data_AppIdForReportEndBeforeAppKnown – App ID when not known before report end called on the operation.

  • Data_CanContinueFromOnBeforeOperationBegins – CanContinue state, before the begin handler is invoked.

  • Data_DetachedDuration – The duration of detach process of an event.

  • Data_Doc_AccessMode – An enumeration indicating the access mode of the file, for example, read only, read write.

  • Data_Doc_AsyncOpenKind – An enumeration indicating the type of asynchronous flow used to open the file.

  • Data_Doc_ChunkingType – An enumeration indicating the type of chunking algorithm of a file.

  • Data_Doc_EdpState – An enumeration indicating the enterprise data protection state of a file.

  • Data_Doc_Ext – First 4 characters of the extension of the file.

  • Data_Doc_Fqdn – The server host name of the file.

  • Data_Doc_FqdnHash – A GUID that uniquely identifies server host name.

  • Data_Doc_IdentityTelemetryId – A one-way hash of the user identity used to perform the open.

  • Data_Doc_InitializationScenario – An enumeration indicating the detailed scenario type of a file open operation.

  • Data_Doc_IOFlags – An enumeration indicating the IO flags of a file open operation, for example, if the file is cached or not.

  • Data_Doc_IsCloudCollabEnabled – Whether or not the cloud collaboration is enabled for the file.

  • Data_Doc_IsIncrementalOpen – Whether or not the file was opened via incremental open.

  • Data_Doc_IsOcsSupported – Whether or not a file supports Office Collaboration Service.

  • Data_Doc_IsOpeningOfflineCopy – Whether or not a file is opened from an offline cached copy.

  • Data_Doc_IsPrefetched – Whether or not the file was prefetched before open operation happened.

  • Data_Doc_IsSyncBacked – Whether or not a cloud file exists locally and is synchronized with the server.

  • Data_Doc_Location – An enumeration indicating where the file is located, for example, locally or in cloud.

  • Data_Doc_ReadOnlyReasons – An enumeration indicating the read only reason of a file.

  • Data_Doc_ResourceIdHash – A GUID that uniquely identifies server resource ID of the file.

  • Data_Doc_RtcType – An enumeration indicating type of real-time channel (RTC) used by the file.

  • Data_Doc_ServerDocId – A GUID that uniquely identifies server document ID.

  • Data_Doc_ServerProtocol – An enumeration indicating the server protocol of a cloud file.

  • Data_Doc_ServerType – An enumeration indicating the server type of a cloud file.

  • Data_Doc_ServerVersion – An enumeration indicating the server version of a cloud file.

  • Data_Doc_SessionId – An integer that is incremented by 1 for each file open operation in a session.

  • Data_Doc_SharePointServiceContext – A string used to correlate client-side and server-side logs, typically it's a kind of ID.

  • Data_Doc_SizeInBytes – File size in bytes.

  • Data_Doc_SpecialChars – An enumeration indicating which kind of special character the file URL has.

  • Data_Doc_UrlHash – A GUID that uniquely identifies the file URL.

  • Data_Doc_UsedWrsDataOnOpen – Whether or not the file was opened incrementally using pre-cached WRS data.

  • Data_Doc_WopiServiceId – A string indicating which service a WOPI (Web Application Open Platform Interface Protocol) file is from.

  • Data_DocumentInputCurrency – Type of document input used by the operation.

  • Data_DocumentOperation_AppId – Enumeration value representing the ID of an app.

  • Data_DocumentOperation_EndEventId – Tag that represents where the operation ended.

  • Data_DocumentOperation_EndReason – Enumeration value representing the end reason.

  • Data_DocumentOperation_IsReinitialized – Is reinitializing a document already open.

  • Data_DocumentOperation_ParamsFlags – Enumeration flags used to start the operation.

  • Data_DocumentOperation_TelemetryReason – Enumeration representation of the entry point for the open event. Eg- open from MRU or browse, file activation, etc.

  • Data_DocumentOperation_isTargetECBeginEC – Is the target execution context the same as the context opened from.

  • Data_FileIOInclusiveMeasurements – A string value logging the time duration spent in some function calls, in a format with function tag and duration that includes the duration of sub-function calls.

  • Data_FileIOMeasurements – A string value logging the time duration spent in some function calls, in a format with function tag and duration that excludes the duration of sub-function calls.

  • Data_IsNameMissingInUrl – Indicates if the name wasn't parsed from the URL.

  • Data_IsPathMissingForLocalFile – Indicates if this is a local file without a path.

  • Data_IsUnpackedLinkSupportedForOpen – Indicates if unpackable link is supported for open.

  • Data_LinksOpenRightScenario – Enumeration value for the links open right scenario.

  • Data_OpEndEventId – Tag that represents where the operation ended.

  • Data_RelatedPrevOpTelemetryReason – Is operation related to previous operation.

  • Data_StopwatchDuration – Total time for the event.

  • Data_UnpackLinkHint – Enumeration representing potential user action based on unpack link.

  • Data_UnpackLinkPromptResult – Enumeration representing response of unpack link prompt.

Office.Docs.AppDocs.OperationOpenFromShell

This event is collected for Office applications running on Android, iOS, Universal, or Windows platforms. The event records when a file open operation takes place from the shell and is used to understand and prioritize user-experiences based on file open operation information.

The following fields are collected:

  • Data_AppIdForReportEndBeforeAppKnown – App ID when not known before report end called on the operation.

  • Data_CanContinueFromOnBeforeOperationBegins – CanContinue state, before the begin handler is invoked.

  • Data_DetachedDuration – The duration of detach process of an event.

  • Data_Doc_AccessMode – An enumeration indicating the access mode of the file, for example, read only, read write.

  • Data_Doc_AsyncOpenKind – An enumeration indicating the type of asynchronous flow used to open the file.

  • Data_Doc_ChunkingType – An enumeration indicating the type of chunking algorithm of a file.

  • Data_Doc_EdpState – An enumeration indicating the enterprise data protection state of a file.

  • Data_Doc_Ext – First 4 characters of the extension of the file.

  • Data_Doc_Fqdn – The server host name of the file.

  • Data_Doc_FqdnHash – A GUID that uniquely identifies server host name.

  • Data_Doc_IdentityTelemetryId – A one-way hash of the user identity used to perform the open.

  • Data_Doc_InitializationScenario – An enumeration indicating the detailed scenario type of a file open operation.

  • Data_Doc_IOFlags – An enumeration indicating the IO flags of a file open operation, for example, if the file is cached or not.

  • Data_Doc_IsCloudCollabEnabled – Whether or not the cloud collaboration is enabled for the file.

  • Data_Doc_IsIncrementalOpen – Whether or not the file was opened via incremental open.

  • Data_Doc_IsOcsSupported – Whether or not a file supports Office Collaboration Service.

  • Data_Doc_IsOpeningOfflineCopy – Whether or not a file is opened from an offline cached copy.

  • Data_Doc_IsPrefetched – Whether or not the file was prefetched before open operation happened.

  • Data_Doc_IsSyncBacked – Whether or not a cloud file exists locally and is synchronized with the server.

  • Data_Doc_Location – An enumeration indicating where the file is located, for example, locally or in cloud.

  • Data_Doc_ReadOnlyReasons – An enumeration indicating the read only reason of a file.

  • Data_Doc_ResourceIdHash – A GUID that uniquely identifies server resource ID of the file.

  • Data_Doc_RtcType – An enumeration indicating type of real-time channel (RTC) used by the file.

  • Data_Doc_ServerDocId – A GUID that uniquely identifies server document ID.

  • Data_Doc_ServerProtocol – An enumeration indicating the server protocol of a cloud file.

  • Data_Doc_ServerType – An enumeration indicating the server type of a cloud file.

  • Data_Doc_ServerVersion – An enumeration indicating the server version of a cloud file.

  • Data_Doc_SessionId – An integer that is incremented by 1 for each file open operation in a session.

  • Data_Doc_SharePointServiceContext – A string used to correlate client-side and server-side logs, typically it's a kind of ID.

  • Data_Doc_SizeInBytes – File size in bytes.

  • Data_Doc_SpecialChars – An enumeration indicating which kind of special character the file URL has.

  • Data_Doc_UrlHash – A GUID that uniquely identifies the file URL.

  • Data_Doc_UsedWrsDataOnOpen – Whether or not the file was opened incrementally using pre-cached WRS data.

  • Data_Doc_WopiServiceId – A string indicating which service a WOPI (Web Application Open Platform Interface Protocol) file is from.

  • Data_DocumentInputCurrency – Type of document input used by the operation.

  • Data_DocumentOperation_AppId – Enumeration value representing the ID of an app.

  • Data_DocumentOperation_EndEventId – Tag that represents where the operation ended.

  • Data_DocumentOperation_EndReason – Enumeration value representing the end reason.

  • Data_DocumentOperation_IsReinitialized – Is reinitializing a document already open.

  • Data_DocumentOperation_ParamsFlags – Enumeration flags used to start the operation.

  • Data_DocumentOperation_TelemetryReason – Enumeration representation of the entry point for the open event. Eg- open from MRU or browse, file activation, etc.

  • Data_DocumentOperation_isTargetECBeginEC – Is the target execution context the same as the context opened from.

  • Data_FileIOInclusiveMeasurements – A string value logging the time duration spent in some function calls, in a format with function tag and duration that includes the duration of sub-function calls.

  • Data_FileIOMeasurements – A string value logging the time duration spent in some function calls, in a format with function tag and duration that excludes the duration of sub-function calls.

  • Data_IsNameMissingInUrl – Indicates if the name wasn't parsed from the URL.

  • Data_IsPathMissingForLocalFile – Indicates if this is a local file without a path.

  • Data_IsUnpackedLinkSupportedForOpen – Indicates if unpackable link is supported for open.

  • Data_LinksOpenRightScenario – Enumeration value for the links open right scenario.

  • Data_OpEndEventId – Tag that represents where the operation ended.

  • Data_RelatedPrevOpTelemetryReason – Is operation related to previous operation.

  • Data_StopwatchDuration – Total time for the event.

  • Data_UnpackLinkHint – Enumeration representing potential user action based on unpack link.

  • Data_UnpackLinkPromptResult – Enumeration representing response of unpack link prompt.

Office.Docs.AppDocs.OperationOpenFromUrl

This event is collected for Office applications running on Android, iOS, Universal, or Windows platforms. The event records when a file open operation takes place from a URL and is used to understand and prioritize user-experiences based on file open operation information.

The following fields are collected:

  • Data_AppIdForReportEndBeforeAppKnown – App ID when not known before report end called on the operation.

  • Data_CanContinueFromOnBeforeOperationBegins – CanContinue state, before the begin handler is invoked.

  • Data_DetachedDuration – The duration of detach process of an event.

  • Data_Doc_AccessMode – An enumeration indicating the access mode of the file, for example, read only, read write.

  • Data_Doc_AsyncOpenKind – An enumeration indicating the type of asynchronous flow used to open the file.

  • Data_Doc_ChunkingType – An enumeration indicating the type of chunking algorithm of a file.

  • Data_Doc_EdpState – An enumeration indicating the enterprise data protection state of a file.

  • Data_Doc_Ext – First 4 characters of the extension of the file.

  • Data_Doc_Fqdn – The server host name of the file.

  • Data_Doc_FqdnHash – A GUID that uniquely identifies server host name.

  • Data_Doc_IdentityTelemetryId – A one-way hash of the user identity used to perform the open.

  • Data_Doc_InitializationScenario – An enumeration indicating the detailed scenario type of a file open operation.

  • Data_Doc_IOFlags – An enumeration indicating the IO flags of a file open operation, for example, if the file is cached or not.

  • Data_Doc_IsCloudCollabEnabled – Whether or not the cloud collaboration is enabled for the file.

  • Data_Doc_IsIncrementalOpen – Whether or not the file was opened via incremental open.

  • Data_Doc_IsOcsSupported – Whether or not a file supports Office Collaboration Service.

  • Data_Doc_IsOpeningOfflineCopy – Whether or not a file is opened from an offline cached copy.

  • Data_Doc_IsPrefetched – Whether or not the file was prefetched before open operation happened.

  • Data_Doc_IsSyncBacked – Whether or not a cloud file exists locally and is synchronized with the server.

  • Data_Doc_Location – An enumeration indicating where the file is located, for example, locally or in cloud.

  • Data_Doc_ReadOnlyReasons – An enumeration indicating the read only reason of a file.

  • Data_Doc_ResourceIdHash – A GUID that uniquely identifies server resource ID of the file.

  • Data_Doc_RtcType – An enumeration indicating type of real-time channel (RTC) used by the file.

  • Data_Doc_ServerDocId – A GUID that uniquely identifies server document ID.

  • Data_Doc_ServerProtocol – An enumeration indicating the server protocol of a cloud file.

  • Data_Doc_ServerType – An enumeration indicating the server type of a cloud file.

  • Data_Doc_ServerVersion – An enumeration indicating the server version of a cloud file.

  • Data_Doc_SessionId – An integer that is incremented by 1 for each file open operation in a session.

  • Data_Doc_SharePointServiceContext – A string used to correlate client-side and server-side logs, typically it's a kind of ID.

  • Data_Doc_SizeInBytes – File size in bytes.

  • Data_Doc_SpecialChars – An enumeration indicating which kind of special character the file URL has.

  • Data_Doc_UrlHash – A GUID that uniquely identifies the file URL.

  • Data_Doc_UsedWrsDataOnOpen – Whether or not the file was opened incrementally using pre-cached WRS data.

  • Data_Doc_WopiServiceId – A string indicating which service a WOPI (Web Application Open Platform Interface Protocol) file is from.

  • Data_DocumentInputCurrency – Type of document input used by the operation.

  • Data_DocumentOperation_AppId – Enumeration value representing the ID of an app.

  • Data_DocumentOperation_EndEventId – Tag that represents where the operation ended.

  • Data_DocumentOperation_EndReason – Enumeration value representing the end reason.

  • Data_DocumentOperation_IsReinitialized – Is reinitializing a document already open.

  • Data_DocumentOperation_ParamsFlags – Enumeration flags used to start the operation.

  • Data_DocumentOperation_TelemetryReason – Enumeration representation of the entry point for the open event. Eg- open from MRU or browse, file activation, etc.

  • Data_DocumentOperation_isTargetECBeginEC – Is the target execution context the same as the context opened from.

  • Data_FileIOInclusiveMeasurements – A string value logging the time duration spent in some function calls, in a format with function tag and duration that includes the duration of sub-function calls.

  • Data_FileIOMeasurements – A string value logging the time duration spent in some function calls, in a format with function tag and duration that excludes the duration of sub-function calls.

  • Data_IsNameMissingInUrl – Indicates if the name wasn't parsed from the URL.

  • Data_IsPathMissingForLocalFile – Indicates if this is a local file without a path.

  • Data_IsUnpackedLinkSupportedForOpen – Indicates if unpackable link is supported for open.

  • Data_LinksOpenRightScenario – Enumeration value for the links open right scenario.

  • Data_OpEndEventId – Tag that represents where the operation ended.

  • Data_RelatedPrevOpTelemetryReason – Is operation related to previous operation.

  • Data_StopwatchDuration – Total time for the event.

  • Data_UnpackLinkHint – Enumeration representing potential user action based on unpack link.

  • Data_UnpackLinkPromptResult – Enumeration representing response of unpack link prompt.

Office.Docs.Apple.DocsUXiOSSaveAsThroughFileMenu

This event is collected for Office applications running under Apple platforms. The event records when a "Save as" operation takes place and is used to understand and prioritize user-experiences based on file operation information such as location categories. A "Save as" operation occurs whenever a user creates a new file and saves it for the first time or saves a copy of an existing file to a new location.

The following fields are collected:

  • Data_OriginServiceType - An abstract categorization of the original location of a file like "SharePoint", "OneDrive", "Local", "WOPI", etc., and explicitly not the actual location of the file.

  • Data_ServiceType - An abstract categorization of the new location of a file after the save is completed like "SharePoint", "OneDrive", "Local", "WOPI", etc., and explicitly not the actual location of the file.

Office.Docs.Apple.DocsUXMacAtMentionInsertedAtMention

This event is collected for Office applications running under Apple platforms. This event records when a user "@" mentions another user and is used to understand and prioritize user-experiences based on how users collaborate with other users.

The following fields are collected:

  • Data_CharactersTyped - A numerical value that indicates the total number of characters typed in the "@" mention text.

Office.Docs.Apple.DocsUXMacODSPSharingWebViewSharingCompleted

This event is collected for Office applications running under Apple platforms. This event records when a user chooses to share a cloud document using the OneDrive sharing experience and is used to better understand and prioritize user-experiences based on sharing documents.

The following fields are collected:

  • Data_ShareType - A hardcoded string that indicates what kind of share operation was completed including but not limited to "Copy Link", "More apps", "Teams".

  • Data_ShareWebViewMode - A hardcoded string that indicates what kind of share mode was active when the share was completed including but not limited to "ManageAccess", "AtMentions", "Share".

Office.DocsUI.Collaboration.CoauthorGalleryRowTapped

This event is collected for Office applications running under Apple platforms. This event records when a user selects to look at the list of current co-authors. This data is used to better understand and prioritize user-experiences relating to co-authoring a document at the same time.

The following fields are collected:

  • Data_CoauthorCount - A numerical value that represents the total number of people who are currently editing the same document as the user.

Office.DocsUI.Collaboration.CollabCornerPeopleGalleryCoauthorsUpdated

This event is collected for Office applications running under Apple platforms. The event records when the number of active co-authors in a cloud document changes. This data is used to better understand and prioritize user-experiences relating to co-authoring a document at the same time.

The following fields are collected:

  • Data_CoauthorsJoined - The number of co-authors that joined the document.

  • Data_CoauthorsLeft - The number of co-authors that left the document.

  • Data_NewCoauthorCount - The new count of active co-authors in the document.

  • Data_OldCoauthorCount - The previous count of active co-authors before the update.

  • Data_ServiceType - An abstract categorization of the location of a file like "SharePoint", "OneDrive", "Local", "WOPI", etc., and explicitly not the actual location of the file.

Office.DocsUI.DocStage.DocStageCreateNewFromTemplate

This event is collected for Office applications running under Apple platforms. The event records when a new file is created from the "New from template" experience and is used to better understand and prioritize user-experiences based on document creation information.

The following fields are collected:

  • Data_InHomeTab - A Boolean value that indicates whether the new file from template was created from the Home tab of the file new experience.

  • Data_InSearch - A Boolean that indicates whether the file was created when the user was searching for a template.

  • Data_IsHomeTabEnabled - A Boolean value that indicates if the Home tab is currently available to the user.

  • Data_IsRecommendedEnabled - A Boolean value that indicates if the "Recommended" experience is currently available to the user.

  • Data_TemplateIndex - The numerical index of the template file as it's displayed visually to the user.

  • Data_TemplateType - A classification to help distinguish the type of template like, but not limited to, "Online" templates, "Online search" templates, "Local" templates.

Office.DocsUI.DocStage.RecommendedOpen

This event is collected for Office applications running under Apple platforms. The event records when a file-open operation takes place from the recommended files section of the document gallery and is used to understand and prioritize user-experiences based on file open operation information.

The following fields are collected:

  • Data_Success - A Boolean value to indicate whether the operation succeeded.

Office.DocsUI.DocStage.ShowDocStage

The event is triggered when Office apps on iOS are launched and successfully land on the Document Stage. The data is used to monitor the health of the application's launch and First Run Experience (FRE) flow, determine its success state, and whether users get stuck in the process of using the app for the first time.

The following fields are collected:

  • Experience - Indicates the type of Document Stage experience where the user landed.

  • IsPhone - Indicates whether the event comes from iPhone or iPad.

Office.DocsUI.FileOperations.DocsUIFileOpenMacRequired

This event is collected for Office applications running under Apple platforms. The event records when a file open operation takes place and is used to understand and prioritize user-experiences based on file open operation information such as location categories "ServiceType" and the first four characters of the extension.

The following fields are collected:

  • Data_Ext - The file extension limited to the first four characters of the extension or less.

  • Data_ServiceType - An abstract categorization of the location of a file like "SharePoint", "OneDrive", "Local", "WOPI", etc.

Office.DocsUI.FileOperations.OpenDocumentMeasurements

This event is collected for Office applications running under iOS platform. The event records when a file open operation takes place and is used to understand and prioritize user-experiences based on file open operation information, especially performance information.

The following fields are collected:

  • Data_AppDuration - The duration spent in application processing during a file open operation.

  • Data_BootDuration - The duration of boot process of the file open.

  • Data_ClickOrigin - A string indicating which part the link was from when user clicked a link in iOS Outlook to open a file in Office app.

  • Data_ClickTime - The Unix epoch time when the user clicked a link in iOS Outlook to open the file in Office app.

  • Data_ClosePreviouslyOpenedMarkers – A string value logging the time duration between some function calls, in a format with function ID and duration.

  • Data_DetachedDuration - The duration of detach process of an event.

  • Data_Doc_AccessMode - An enumeration indicating the access mode of the file, for example, read only, read write.

  • Data_Doc_AsyncOpenKind - An enumeration indicating the type of asynchronous flow used to open the file.

  • Data_Doc_ChunkingType - An enumeration indicating the type of chunking algorithm of a file.

  • Data_Doc_EdpState - An enumeration indicating the enterprise data protection state of a file.

  • Data_Doc_Ext - File extension of the file.

  • Data_Doc_Fqdn - The server host name of the file.

  • Data_Doc_FqdnHash - A GUID that uniquely identifies server host name.

  • Data_Doc_IdentityTelemetryId - A GUID that uniquely identifies the identity used to open a file.

  • Data_Doc_InitializationScenario - An enumeration indicating the detailed scenario type of a file open operation.

  • Data_Doc_IOFlags - An enumeration indicating the IO flags of a file open operation, for example, if the file is cached or not.

  • Data_Doc_IsCloudCollabEnabled - Whether or not the cloud collaboration is enabled for the file.

  • Data_Doc_IsIncrementalOpen - Whether or not the file was opened via incremental open.

  • Data_Doc_IsOcsSupported - Whether or not a file supports Office Collaboration Service.

  • Data_Doc_IsOpeningOfflineCopy - Whether or not a file is opened from an offline cached copy.

  • Data_Doc_IsPrefetched - Whether or not the file was prefetched before open operation happened.

  • Data_Doc_IsSyncBacked - Whether or not a cloud file exists locally and is synchronized with the server.

  • Data_Doc_Location - An enumeration indicating where the file is located, for example, locally or in cloud.

  • Data_Doc_ReadOnlyReasons - An enumeration indicating the read only reason of a file.

  • Data_Doc_ResourceIdHash - A GUID that uniquely identifies server resource ID of the file.

  • Data_Doc_RtcType - An enumeration indicating type of real-time channel (RTC) used by the file.

  • Data_Doc_ServerDocId - A GUID that uniquely identifies server document ID.

  • Data_Doc_ServerProtocol - An enumeration indicating the server protocol of a cloud file.

  • Data_Doc_ServerType - An enumeration indicating the server type of a cloud file.

  • Data_Doc_ServerVersion - An enumeration indicating the server version of a cloud file.

  • Data_Doc_SessionId - An integer that is incremented by 1 for each file open operation in a session.

  • Data_Doc_SharePointServiceContext - A string used to correlate client-side and server-side logs, typically it's a kind of ID.

  • Data_Doc_SizeInBytes - File size in bytes.

  • Data_Doc_SpecialChars - An enumeration indicating which kind of special character the file URL has.

  • Data_Doc_UrlHash - A GUID that uniquely identifies the file URL.

  • Data_Doc_UsedWrsDataOnOpen - Whether or not the file was opened incrementally using pre-cached WRS data.

  • Data_Doc_WopiServiceId - A string indicating which service a WOPI (Web Application Open Platform Interface Protocol) file is from.

  • Data_HWModel – A string value logging the model of iPad or iPhone device.

  • Data_InclusiveMeasurements - A string value logging the time duration spent in some function calls, in a format with function tag and duration that includes the duration of sub-function calls.

  • Data_InitializationReason - An enumeration indicating how the file is opened, for example, from which UI element or triggered by another app.

  • Data_IsDocumentAlreadyOpen – Whether or not the file is already open.

  • Data_IsInterrupted – Whether or not the file open operation was interrupted by app transitioning to background.

  • Data_Measurements - A string value logging the time duration spent in some function calls, in a format with function tag and duration that excludes the duration of sub-function calls.

  • Data_OpenInPlace - Whether or not a file must be copied to the Office's sandboxed container before user can open it.

  • Data_OpenStartTime - The Unix epoch time when the file open started.

  • Data_PrefetchSourceOptions - An enumeration indicating how the file is made available offline for cloud documents. For example, from recent and recommended files.

  • Data_SilhouetteDuration - The duration of rendering of the file open.

  • Data_SourceApplication - A string indicating the bundle ID of the source application when a file open was triggered by another app.

  • Data_StopwatchDuration - The duration from beginning of the event to the end of the event.

  • Data_TimeSplitMeasurements - A string value logging the time duration spent in some function calls, in a format with function tag, start timestamp and duration.

Office.DocsUI.FileOperations.OpenFileWithReason

This event is collected for Office applications running under Apple platforms. The event records when a file open operation takes place and is used to understand and prioritize user-experiences based on file open operation information such as location categories "ServiceType" and from where within Application the user requested to open a file.

The following fields are collected:

  • Data_IsCandidateDropboxFile - This is a Boolean value that is logged if by inspecting the path of the file we think it might be from a folder that is synched by Drop Box.

  • Data_IsSignedIn - Whether or not a user is signed in when the file is saved.

  • Data_OpenReason - The open reason is a numerical value that indicates from where within the application a user opened a file.

  • Data_ServiceType - An abstract numerical categorization of the location of a file like "SharePoint", "OneDrive", "Local", "WOPI", etc., and explicitly not the actual location of the file.

Office.DocsUI.FileOperations.SaveToURL

This event is collected for Office applications running under Apple platforms. The event records when a "save as" operation takes place and is used to understand and prioritize user-experiences based on file operation information such as location categories and the first four characters of the extension. A "save as" operation occurs whenever a user creates a new file and saves it for the first time or saves a copy of an existing file to a new location.

The following fields are collected:

  • Data_FileExtension - The first four characters of the new file's extension.

  • Data_IsNewFileCreation - Indicates if the save operation is for a new file or a copy of an existing file.

  • Data_IsSignedIn - Whether or not a user is signed in when the file is saved.

  • Data_SaveErrorCode - A numerical value that is set if there's an error to help identify the kind of error.

  • Data_SaveErrorDomain - Specifies the domain of the SaveErrorCode as defined by Apple SaveErrorDomains "are arbitrary strings used to differentiate groups of codes".

  • Data_SaveLocation - An abstract categorization of the location of a file like "SharePoint", "OneDrive", "Local", "WOPI", etc., and explicitly not the actual location of the file.

  • Data_SaveOperationType - A numerical value defined by Apple's NSSaveOperationType group of values.

Office.DocsUI.SharingUI.CloudUpsellShown

This event is collected for Office applications running under Apple platforms. This event records when a user goes through the document upsell to cloud flow. This data is used to better understand and prioritize user-experiences relating to moving documents to cloud locations.

The following fields are collected:

  • Data_FileStyle - A numerical value that indicates from what scenario the upsell experience was shown like from an autosave toggle or a share button.

  • Data_FileType - The first four characters of the current file's extension.

  • Data_InDocStage - A Boolean that indicates if the upsell experience is shown from the Document Gallery or from within a document window.

  • Data_IsDocumentOpened - A Boolean that indicates if the current document for which the upsell experience is being shown is also open.

  • Data_IsDraft - A Boolean that indicates if the current file has ever been saved.

  • Data_IsSheetModal - A Boolean that indicates if the upsell experience was presented modally or not.

Office.DocsUI.SharingUI.CloudUpsellUpload

This event is collected for Office applications running under Apple platforms. This event records when a user chooses to upload a new or local file to the cloud and the result of that operation. This data is used to better understand and prioritize user-experiences relating to moving documents to cloud locations.

The following fields are collected:

  • Data_FileStyle - A numerical value that indicates from what scenario the upsell experience was shown like an autosave toggle or a share button.

  • Data_FileType - The first four characters of the current file's extension.

  • Data_InDocStage - A Boolean that indicates if the upsell experience is shown from the Document Gallery or from within a document window.

  • Data_IsDefaultServiceLocation - A Boolean value that indicates if the selected location to upload the document to is the default location.

  • Data_IsDocumentOpened - A Boolean that indicates if the current document for which the upsell experience is being shown is also open.

  • Data_IsDraft - A Boolean that indicates if the current file has ever been saved.

  • Data_IsSheetModal - A Boolean that indicates if the upsell experience was presented modally or not.

  • Data_LocationServiceType - An abstract categorization of the location of a file like "SharePoint", "OneDrive", "Local", "WOPI", etc., and explicitly not the actual location of the file.

  • Data_UploadAction - A hard-coded string that indicates whether the upload was a move or a copy operation.

  • Data_UploadResult - A hard-coded string that indicates the result of the attempt to upload including but not limited to "Success", "UserCancelledUpload", and "PreAuthFailed".

Office.DocsUI.SharingUI.CopyLinkOperation

This event is collected for Office applications running under Apple platforms. This event records when a user chooses to share a document by generating a link to a cloud document and is used to better understand and prioritize user-experiences based on sharing documents.

The following fields are collected:

  • Data_ ServiceType - An abstract categorization of the location of a file like "SharePoint", "OneDrive", "Local", "WOPI", etc., and explicitly not the actual location of the file.

  • Data_LinkType - A hard-coded string that describes the kind of invite operation performed like "ViewOnly" and "ViewAndEdit".

  • Data_ShareScenario - A hard-coded string description of where within the application's user interface the file is being shared from including but not limited to, "FileMenu", "OpenTabShareActionMenu", "RecentTabShareActionMenu".

Office.DocsUI.SharingUI.DocsUIOneDriveShare

This event is collected for Office applications running under Apple platforms. This event records when a user chooses to share a cloud document using the OneDrive sharing experience and is used to better understand and prioritize user-experiences based on sharing documents.

The following fields are collected:

  • Data_ODSPShareWebviewShareError - If the sharing experience experiences an error this is a numerical value to help identify the reason for the failure.

  • Data_ODSPShareWebviewShareGrantAccessResult - A Boolean value that when true indicates that a lightweight sharing operation successfully completed.

  • Data_ODSPShareWebviewShareSuccessType - When a share operation successfully completes this is a numerical value used to determine what kind of sharing operation was completed.

  • Data_WebViewInfoResult - If the user interface fails to load this is a numerical value to help identify the reason for the failure.

  • Data_WebViewLoadTimeInMs - A numerical value that records the amount of time it took for the web user interface to load.

Office.DocsUI.SharingUI.InvitePeople

This event is collected for Office applications running under Apple platforms. This event records when a user chooses to invite people to a cloud document and is used to better understand and prioritize user-experiences based on sharing documents.

The following fields are collected:

  • Data_ ServiceType - An abstract categorization of the location of a file like "SharePoint", "OneDrive", "Local", "WOPI", etc., and explicitly not the actual location of the file.

  • Data_InviteeCount - The total number of contacts invited to a document in one invite action.

  • Data_LinkType - A hard-coded string that describes the kind of invite operation performed like "ViewOnly" and "ViewAndEdit".

  • Data_MessageLength - A numerical count of the total number of characters sent in the invite message.

  • Data_ShareScenario - A hard-coded string description of where within the application's user interface the file is being shared from including but not limited to, "FileMenu", "OpenTabShareActionMenu", "RecentTabShareActionMenu".

Office.DocsUI.SharingUI.SendACopyOperation

This event is collected for Office applications running under Apple platforms. The event records when a user chooses to send a copy of a document and is used to better understand and prioritize user-experiences based on sharing documents.

The following fields are collected:

  • Data_IsHomeTabEnabled - A Boolean value that indicates if the Home tab is currently available to the user.

  • Data_IsRecommendedEnabled - A Boolean value that indicates if the "Recommended" experience is currently available to the user.

  • Data_OperationType - A numerical value to indicate what kind of send a copy operation is taking place like sending a copy in an email or sending a copy through Apple's share control.

  • Data_ServiceType - An abstract categorization of the location of a file like "SharePoint", "OneDrive", "Local", "WOPI", etc., and explicitly not the actual location of the file.

  • Data_ShareFileType - A hard-coded string description of what type of object is being shared including but not limited to, "Document", "PDF", "Picture".

  • Data_ShareScenario - A hard-coded string description of where within the application's user interface the file is being shared from including but not limited to, "FileMenu", "OpenTabShareActionMenu", "RecentTabShareActionMenu".

  • Data_SharingService - A Boolean that indicates whether the file was created when the user was searching for a template.

Office.DocsUI.SharingUI.UpsellShare

This event is collected for Office applications running under Apple platforms. This event records when a user goes through the document upsell to cloud flow when trying to share a document. This data is used to better understand and prioritize user experiences relating to moving documents to cloud locations.

The following fields are collected:

  • Data_FileOperationResult - A numerical value to indicate whether the operation succeeded.

  • Data_HostedFromDocStage - A Boolean to indicate if a user is going through the upsell to cloud flow from the DocStage experience or from an open document.

  • Data_isLocalCopyOn - A Boolean to indicate if the use chose to keep a local copy of the document being uploaded to a cloud location or move the existing document to a cloud location.

  • Data_NewFileType - An abstract categorization of the location of the new location of the file like "SharePoint", "OneDrive", "Local", "WOPI", etc., and explicitly not the actual location of the file.

  • Data_OriginalFileType - An abstract categorization of the location of a file like "SharePoint", "OneDrive", "Local", "WOPI", etc., and explicitly not the actual location of the file.

  • Data_UploadButtonPressed - A Boolean to indicate if the user chose to upload the current document to a cloud location.

  • Data_UploadError - A numerical value that indicates the kind of error that occurred if an upload operation fails.

  • Data_UpsellAppearsFromDelegate - A Boolean value to indicate if the view was shown from the share menu.

Office.Excel.Command.ShowPythonCenterTaskPane

This event is triggered when Python Center is launched. This data is used to ensure that Python Center is launched in the correct scenarios as expected.

The following fields are collected:

  • Data_CorrelationGuid - A unique ID for the launch event.

  • Data_ErrorTags - A value indicating which error has occurred.

  • Data_GeneralTags - A list of code markers indicating which potential error(s) occurred

  • Data_PythonCenterLaunchSource - An enum value indicating type of source launching Python center such as click ribbon button, =PY, ctrl+shift+alt+P, a teaching callout.

  • Data_WorkbookId - A unique GUID associated with a workbook

Office.Excel.Python.CalcAggregation

This event is triggered when users execute Python formula in an Excel session. This data is used to confirm the successful execution of Python code in order to provide the desired experience to the user while running Python in Excel.

The following fields are collected:

  • Data_InitPyExecutions - The count of times executing initialization script of Python in Excel per Excel session.

  • Data_ScriptExecutions - The count of times executing Python formula per Excel session.

  • Data_SystemErrors - The count of times error occurs when execute Python formula per Excel session.

  • Data_WorkbookId - A unique GUID associated to an Excel workbook.

Office.Excel.Python.ExecuteCode

This event is triggered when users execute Python formula in Excel. This data is used to confirm the successful execution of Python code in order to provide the desired experience to the user while running Python in Excel.

The following fields are collected:

  • Data_BuildCodeDuration - Duration of how long it took to build the Python code for a PY formula.

  • Data_ClientNull - A flag indicating a particular error state related to OC.8061799.

  • Data_CodeCacheHit - A flag indicating the code cache hit for a PY formula or not

  • Data_CodeLinesCount - Count of lines of code in Python script.

  • Data_CodeSize - Size of the Python code built for a PY formula.

  • Data_CorrelationId - GUID used to correlate activities.

  • Data_EnvironmentType - Type of Jupyter client environment. Set by “Office.Excel.OEP.JupyterEnvironmentType”. Default is OfficePy::JupyterClientEnvironmentType::WebService.

  • Data_ExecutionsCountPerWorkbook - Count of executions of Python scripts (excluding init.py) in a given session.

  • Data_IsRetry - Boolean indicating whether the code execution is the retry effort after a code execution failure.

  • Data_hasLargeRangeDataUpload - Boolean indicating whether there's any large range data upload scenario.

  • Data_hasPowerQueryDataUpload - Boolean indicating whether there's any Power Query data upload scenario.

  • Data_hasTableReference - Boolean indicating whether there's any reference to an existing Excel table.

  • Data_JsonMarshalingDuration - The duration of marshaling the result returned by the Python service into data to be returned from the PY formula.

  • Data_MarshalResult - HRESULT from the process of marshaling the result returned by the Python service into data to be returned from the PY formula.

  • Data_Measurements - A string of measurements from Excel code involved in sending and receiving the Python script.

  • Data_Python_DataUpload_ByteCount - Total bytes uploaded.

  • Data_Python_DataUpload_ChunkCount - Total number of chunks.

  • Data_Python_DataUpload_ClientCacheHitCount - The number of uploads that were found in the client-side cache.

  • Data_Python_DataUpload_ETagMillisecondCount - Total milliseconds to do the GetETag requests.

  • Data_Python_DataUpload_FinishMillisecondCount - Total milliseconds to do the FinishUpload requests.

  • Data_Python_DataUpload_ReadMillisecondCount - Total milliseconds to read from PowerQuery.

  • Data_Python_DataUpload_ServerCacheHitCount - The number of uploads that weren't found in the client-side cache, but had the same server ETag.

  • Data_Python_DataUpload_StartMillisecondCount - Total milliseconds to do the StartUpload requests.

  • Data_Python_DataUpload_TotalMillisecondCount - Total milliseconds.

  • Data_Python_DataUpload_UploadCount - The number of uploads for a PY formula.

  • Data_Python_DataUpload_UploadMillisecondCount - Total milliseconds to do the UploadData requests.

  • Data_Python_Jupyter_EnforceInitPyRunBeforePyFormulaMilliseconds - Time it took to make sure that init.py had been run before this script.

  • Data_Python_Jupyter_RuntimeWaitingMillisecondsWithUpload - Time it took to upload PowerQuery data.

  • Data_PythonErrorDescriptionEmpty - Flag indicating whether the Python service returned an error message from an exception.

  • Data_PythonReturnedError - HRESULT returned from the Python service if it’s an error.

  • Data_ReferenceCacheHitCellsCount - The number of cells uploaded to the Python service which were available in an LRU cache and so didn’t need to be marshaled multiple times.

  • Data_ReferenceCacheHitDataSize - Size of the data uploaded to the Python service which was available in an LRU cache and so didn’t need to be marshaled multiple times.

  • Data_ReferenceCellsCount - The number of cells referenced by the PY formula.

  • Data_ReferenceDataSize - Size of the data uploaded to the Python service for cells referred to the PY formula.

  • Data_SuccessfulExecution - Boolean flag indicating successful execution of the Python script.

  • Data_TimeInclusiveMeasurements - A string of time inclusive measurements from Excel code involved in sending and receiving the Python script.

  • Data_TimeSplitMeasurements - A string of time split measurements from Excel code involved in sending and receiving the Python script.

  • Python_Jupyter_EnsureJupyterClientSource - Integer denoting the source that initiated the preload Python service environment (for example, Python center taskpane, Python editor taskpane, etc.)

  • Python_Jupyter_EnterOfficepyTimepointMilliseconds - Integer indicating the time point to call officepy method to handle execute python script.

  • Python_Jupyter_EnvironmentCreationBeginTimepointMilliseconds - Integer indicating the time point to begin creating jupyter environment.

  • Python_Jupyter_EnvironmentPreloadStartTimepointMilliseconds - Integer denoting the time point at which the preload Python service environment starts.

  • Python_Jupyter_GetEnvironmentDefinitionsEndTimepointMilliseconds - Integer denoting the time point at which the OfficePy has fetched the environment options.

  • Python_Jupyter_GetEnvironmentDefinitionsStartTimepointMilliseconds - Integer denoting the time point at which the process to obtain environment options begins.

  • Python_Jupyter_InitPyBeginTimepointMilliseconds - Integer indicating the time point to start init.py execution.

  • Python_Jupyter_InitPyEndTimepointMilliseconds - Integer indicating the time point to finish init.py execution.

  • Python_Jupyter_RuntimeCreationBeginTimepointMilliseconds - Integer indicating the time point to begin creating jupyter runtime.

  • Python_Jupyter_RuntimeCreationEndTimepointMilliseconds - Integer indicating the time point to finish runtime creation.

  • Python_Jupyter_RuntimeWaitingMilliseconds - Time it took to run before the PY formula (irrespective of a PowerQuery data upload or init.py code enforcement)

  • Python_Jupyter_ScriptCommitTimepointMilliseconds - Integer indicating the time point to commit python script.

  • Python_Request_IsThrottled - Boolean indicating whether the code execution service session is throttled or not.

  • Python_Request_Zone - Integer indicating the security zone in sever side.

Office.Excel.Python.RichedPythonTelemetry

This event is triggered when the user edits Python formula in Excel. This data is used to ensure that a user gets the expected experience while creating/editing/running Python inside Excel.

The following fields are collected:

  • Data_CloseInPythonEditMode -Count indicating how many times Excel application is closed in a single session while editing Python cell.

  • Data_EntryModeAutocomplete - Count indicating how many times a user starts editing Python formula in a cell by auto complete in a single session

  • Data_EntryModeExistingPythonCell - Count indicating how many times a user edits Python in a single session

  • Data_EntryModeRibbon - Count indicating how many times a user starts editing Python formula in a cell by clicking ribbon button in a single session

  • Data_EntryModeShortcut - Count indicating how many times a user starts editing Python formula in a cell by shortcut in a single session

  • Data_EntryModeTypePy - Count indicating how many times a user starts editing Python formula in a cell by =PY() in a single session.

  • Data_ExitWithNoCode - Count indicating how many times a user completes editing Python formula without code in a single session.

  • Data_PastePythonCell - Count indicating how many times a user pastes Python formula in a single session.

  • Data_SetMarshallMode - Count indicating how many times a user changes the marshal mode of a Python formula in a single session.

  • Data_WorkbookId - A unique GUID associated to a workbook.

Office.Excel.Python.WorkbookContainsPython

This event is triggered to identify if an Excel workbook opened by a user contains Python formula or not. This data is used to ensure the expected user experience was provided depending on the availability of Python code inside Excel workbook.

The following fields are collected:

  • Data_MayContainPython - A flag containing if opened Excel sheet contains Python formula.

  • Data_WorkbookId - A unique GUID associated to an Excel workbook

Office.Excel.PythonCenter.PythonSamplesPane

This event is triggered when a user inserts Python formula example from Python Center. This data is used to verify successful execution of sample Python code and validate expected user experience.

The following fields are collected:

  • Data_Action - Default value "Click"

  • Data_ChildAction - A value indicating what button user clicks while interacting with UI

  • Data_OTelJS_Version - The version number of telemetry API used.

Office.Excel.XlEditSession

Collected when the user starts editing a spreadsheet. The data collected allows Microsoft to evaluate the feature health of actions that change the spreadsheet. It's also used to calculate monthly active users and devices.

The following fields are collected:

  • None

Office.Extensibility.Catalog.ExchangeProcessEntitlement

Data regarding the processing of an individual entitlement of and Office 365 tenant admin assigned add-in.

Used in charting (requested by team management) of customer success and analysis of customer problems.

The following fields are collected:

  • AppVersion – the version of the add-in host application

  • SolutionId – a GUID representing a unique add-in

  • TelemetryId – a GUID representing a unique user

Office.Extensibility.Catalog.ExchangeProcessManifest

Data regarding the processing of an individual manifest for an Office 365 tenant admin assigned add-in. Used in analysis of customer problems and charting of customer success.

The following fields are collected:

  • AppVersion - version of the app

  • IsAllReturnedManifestsParsed - bool indicating we parsed all returned manifests

  • IsAppCommand - bool indicating if this is an app command app

  • ReturnedManifestsParsed - count of the parsed manifests

  • SolutionId - ID of the solution

  • TelemetryId - telemetry ID based on the signed in identity

Office.Extensibility.DiscoverTryBuy.Py.LicenseInfo

This event is triggered when checking for a valid license to use Python in Excel. This data is used to ensure that the user gets the expected experience for Python in Excel based on the availability of a valid license.

The following fields are collected:

  • Data_DurationForFetchInfoFromLicensing - number of milliseconds it takes to fetch license information from server.

  • Data_FUserHasValidPythonLicense - A Boolean value indicating if user has a valid license to use Python in Excel.

  • Data_IsMultiAccountsSignedIn - boolean value indicating if more than one user accounts is signed in.

  • Data_PythonUserIdentityGUID - GUID string of user's identity used to fetch license. [This field was previously named Data_PythonUserIdentity.]

  • Data_TrialStatusReseted - boolean value indicating if reseting of license status happened in this session.

  • Data_UseLicenseForTrialPreview - boolean value indicating if the license is granted by trail preview technology.

  • Data_UsePythonLicenseTestOverride - boolean value indicating if the license is granted by test framework.

  • Data_UserLicenseState - A state of a license such as Active, Undefined, EligibleNeedsOptin

Office.Extensibility.DiscoverTryBuy.Py.PremiumHubExperience

This event is triggered when a launches Premium Hub dialog or user interact with it. This data is used to gain insight into the premium hub errors and how often it's successful or dismissed.

The following fields are collected:

  • Data_Action - An enum value indicating UI behavior or user interaction.

  • Data_ChildAction - An enum value indicating user choice on a dialog such as user selecting "Try Preview", "Show me how it works".

  • Data_DetachedDuration - The time user interacts with UI.

  • Data_ErrorCode - A value indicating which error encountered.

  • Data_PythonCenterLaunchSource - An enum value indicating the source of Python Center launch such as “=PY(“ , ctrl+shift+alt+P).

  • Data_UIType - An enum value with a default of "Dialog"

Office.Extensibility.DiscoverTryBuy.Py.PythonTakerExperienceJourney

This event is triggered when a user selects or tries to edit an Excel cell with Python formula. This data is used to make a user aware that they don't have access to edit a Python cell and provide them with an opportunity to learn more about how they can obtain access.

The following fields are collected:

  • Data_Action - An enum value indicating type of different messages displayed to the user.

  • Data_ChildAction - An enum value indicating the user choice with UI such as clicking on "Try Preview", "No Thanks", "Learn More", "OK" buttons.

  • Data_ChildUIType - An enum value with a default "Message box"

  • Data_DetachedDuration - The time a user interacts with UI.

  • Data_UIType - An enum value with a default "Message box"

Office.Extensibility.DiscoverTryBuy.Py.PythonTakerFREJourney

This event is triggered when a user gets a license to use Python in Excel. This data is used to confirm that the first run experience of Python in Excel is successful and runs as expected.

The following fields are collected:

  • Data_Action - Indicates UI is shown

  • Data_ChildAction - Type of user interaction such as Start Tour, Skip Tour

  • Data_DetachedDuration - The time a user interacts with UI

  • Data_LastAction - Type of user interaction in sequence callouts such as user seeing first/second/third teaching callout, user dismissing first/second/third teaching callout

  • Data_UIType - Type of UI such as Sequence teaching callout, Dialog

Office.Extensibility.DiscoverTryBuy.Py.ServerDrivenNotification

When using Python in Excel, the user may receive a notification based on their license status or usage. The notification should be displayed as a business bar. When such notification is displayed, this event will be triggered. This event is used to ensure that the Python in Excel licensing notification is performing as expected.

The following fields are collected:

  • ClientSettings - Specific client setting of the feature that is configured by the service.

  • EventType - EventType is an identifier of notification displayed.

  • NotificationLevel – This is an enum value, means how important the notification is. 1 is the lowest level (means informational), 3 is the highest lever (means error)

  • NotificationPartType – This value is either 0 or 1. 0 means this notification is for current session. 1 means this notification is for current workbook.

Office.Extensibility.DiscoverTryBuy.Py.ServerDrivenNotificationUserAction

When using Python in Excel, the user may receive a notification based on their license status or usage. The notification should be displayed as business bar. There will be some buttons for user to interact with on the business bar. When user clicks one of the buttons or dismisses the business bar, this event will be triggered. This event is used to ensure that the Python in Excel licensing notification is performing as expected.

The following fields are collected:

  • ChildAction - This is an enum value, means what type of interaction user made with the notification. The value could be 40, 41 or 42. 40 means user click button which opens a hyper link in browser. 41 means user click button that trigger software behavior (for example: display a dialog). 42 means the notification is dismissed.

  • EventType - EventType is an identifier of notification user interacted with.

  • NotificationLevel – This is an enum value, means how important the notification is. 1 is the lowest level (means informational), 3 is the highest lever (means error)

  • NotificationPartType – This value is either 0 or 1. 0 means this notification is for current session. 1 means this notification is for current workbook.

  • SDXAction - This value specific which button user clicked if ChildAction is 40.

  • TimeSpan - This value is the time span from the notification is displayed to user interacted with it.

Office.Extensibility.ODPAppCommandsRibbonClick

Collects whether clicking the custom add-in control succeeded or not. Used to detect issues in user interaction with add-in controls.

The following fields are collected:

  • CommandActionType - type of the add-in command

  • CommandLabel - label of the command clicked

  • SolutionId - ID of the solution

Office.Feed.Events.Initializing

This event is collected when the feed has started initializing. This event is used to indicate that the feed is starting and to diagnose reliability issues in launching the feed.

  • AppInfo.Language - Language of the App in IETF language tag format.

  • AppInfo.Name - Name of the component in use (Office Feed).

  • AppInfo.Version - The version of the App.

  • clientCorrelationId - The globally unique identifier for the application's session.

  • clientType - The application on which the component runs.

  • DeviceInfo.Make - The Device manufacturer or device OEM name.

  • DeviceInfo.NetworkProvider - The network or mobile operator, such as "AT&T".

  • DeviceInfo.NetworkType - The type of network connectivity of the device in use, such as "Wired", "Wifi" or "WWAN" (data/cellular).

  • DeviceInfo.OsName - The name of the device OS.

  • DeviceInfo.SDKUid - Uniquely identifies the device from the telemetry SDK's perspective.

  • eventId - Name identifier of the event.

  • EventInfo.SdkVersion - The version of the telemetry SDK used by the client to generate the event.

  • eventpriority - An enumeration value for the priority of sending the event.

  • feature - Used to group various events of the same feature.

  • hostAppRing - The population of users to whom the application was distributed.

  • properties - Contains additional metadata properties collected for each event.

    • ClientTimeStamp - Timestamp of when the event was logged in the client.
  • publicEventName - Public facing event name.

  • region - The country or region of the feed service that the user is connected to.

  • tenantAadObjectId - A globally unique identifier for the user's enterprise tenant.

  • type - Type of the logged event, for example, Trace, Error, Event, QoS.

  • userAadObjectId - The globally unique user identifier for an enterprise Microsoft account.

  • UserInfo.Id - The globally unique user identifier for an enterprise Microsoft account.

  • UserInfo.IdType - Specifies the type of a user ID.

  • UserInfo.Language - The user's language in IETF language tag format.

  • UserInfo.MsaId - The globally unique user identifier for a consumer Microsoft account.

  • UserInfo.OMSTenantId - The tenant that a user's subscription is tied to. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant.

  • UserInfo.TimeZone - The user's time zone relative to UTC.

  • userPuid - The globally unique user identifier for a consumer Microsoft account.

  • version - The version of the feed client.

Office.Feed.Events.OfficeFeedDidAppear

This event is collected when the feed is shown to the user. The event is used to verify that the feed completed initialization step and to diagnose reliability issues in launching the feed.

  • AppInfo.Language - Language of the App in IETF language tag format.

  • AppInfo.Name - Name of the component in use (Office Feed).

  • AppInfo.Version - The version of the App.

  • bridgeWaitingTime - Metric to diagnose performance in rendering of the feed.

  • clientCorrelationId - The globally unique identifier for the application's session.

  • clientScenario - Scenario discriminator for different variants of the feed.

  • ClientTimeStamp - Timestamp of when the event was logged in the client.

  • clientType - The application on which the component runs.

  • DeviceInfo.Make - The Device manufacturer or device OEM name.

  • DeviceInfo.NetworkProvider - The network or mobile operator, such as "AT&T".

  • DeviceInfo.NetworkType - The type of network connectivity of the device in use, such as "Wired", "Wifi" or "WWAN" (data/cellular).

  • DeviceInfo.OsName - The name of the device OS.

  • DeviceInfo.SDKUid - Uniquely identifies the device from the telemetry SDK's perspective.

  • eventId - Name identifier of the event.

  • EventInfo.SdkVersion - The version of the telemetry SDK used by the client to generate the event.

  • eventpriority - An enumeration value for the priority of sending the event.

  • feature - Used to group various events of the same feature.

  • hostAppRing - The population of users to whom the application was distributed.

  • properties - Contains additional metadata properties collected for each event. [This field has been removed from current builds of Office, but might still appear in older builds.]

  • publicEventName - Public facing event name.

  • region - The country or region of the feed service that the user is connected to.

  • renderTime - Metric to diagnose performance in rendering of the feed.

  • tenantAadObjectId - A globally unique identifier for the user's enterprise tenant.

  • type - Type of the logged event, for example, Trace, Error, Event, QoS.

  • userAadObjectId - The globally unique user identifier for an enterprise Microsoft account.

  • UserInfo.Id - The globally unique user identifier for an enterprise Microsoft account.

  • UserInfo.IdType - Specifies the type of a user ID.

  • UserInfo.Language - The user's language in IETF language tag format.

  • UserInfo.MsaId - The globally unique user identifier for a consumer Microsoft account.

  • UserInfo.OMSTenantId - The tenant that a user's subscription is tied to. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant.

  • UserInfo.TimeZone - The user's time zone relative to UTC.

  • userPuid - The globally unique user identifier for a consumer Microsoft account.

  • version - The version of the feed client.

Office.Feedback.Survey.FloodgateClient.GetDecisionForActionPreStart

In Office apps we control the frequency of in-product and push messages through a governance layer. This event gets logged in error conditions when we try to apply governance to in-app messages before the module that is handling governance is fully activated. This telemetry helps make our governance logic more robust by collecting details of the scenarios in which the governance isn't being applied.

The following fields are collected:

  • Data_EventId - Unique identifier of the log statement.

  • Data_SurveyId - Name of the message that we're trying to show when this error is generated.

Office.Feedback.Survey.FloodgateClient.SurveyTracked

Tracks when a device that is eligible for a survey starts an app. Used to assess the health of the survey user selection process and to ensure the signal used to analyze customer issues and health is working properly.

The following fields are collected:

  • ExpirationTimeUTC – date/time the survey will expire

  • SurveyName – name of survey shown

  • SurveyId – Unique instance of a campaign

  • UniqueId – ID to identify the individual piece of telemetry

Office.Feedback.Survey.FloodgateClient.TriggerMet

Tracks when a device has met the criteria to show a survey. Used to assess the health of the survey triggering process and to ensure the signal used to analyze customer issues and health is working properly.

The following fields are collected:

  • ExpirationTimeUTC – date/time the survey will expire

  • SurveyName – name of survey shown

  • SurveyId – Unique instance of a campaign

  • UniqueId – ID to identify the individual piece of telemetry

Office.Feedback.Survey.FloodgateClient.UserSelected

Tracks when a device has been selected for a survey. Used to assess the health of the survey user selection process and to ensure the signal used to analyze customer issues and health is working properly.

The following fields are collected:

  • ExpirationTimeUTC – date/time the survey will expire

  • SurveyName – name of survey shown

  • SurveyId – Unique instance of a campaign

  • UniqueId – ID to identify the individual piece of telemetry

Office.Feedback.Survey.UI.Android

On an Android device, it tracks when a user on a device interacts with the survey prompt and survey UI. Used to assess the health of the end-to-end survey experience and to ensure the signal used to analyze customer issues and health is working properly.

The following fields are collected:

  • ExpirationTimeUTC – date/time the survey will expire

  • SurveyName – name of survey shown

  • SurveyId – Unique instance of a campaign

  • UniqueId – ID to identify the individual piece of telemetry

Office.Feedback.Survey.UI.IOS

On an iOS device, it tracks when a user on a device interacts with the survey prompt and survey UI. Used to assess the health of the end-to-end survey experience and to ensure the signal used to analyze customer issues and health is working properly.

The following fields are collected:

  • ExpirationTimeUTC – date/time the survey will expire

  • SurveyName – name of survey shown

  • SurveyId – Unique instance of a campaign

  • UniqueId – ID to identify the individual piece of telemetry

Office.Feedback.Survey.UI.Mac

On a Mac device, it tracks when a user on a device interacts with the survey prompt and survey UI. Used to assess the health of the end-to-end survey experience and to ensure the signal used to analyze customer issues and health is working properly.

The following fields are collected:

  • ExpirationTimeUTC – date/time the survey will expire

  • SurveyName – name of survey shown

  • SurveyId – Unique instance of a campaign

  • UniqueId – ID to identify the individual piece of telemetry

Office.Feedback.Survey.UI.Win32

On a Win32 device, it tracks when a user on a device interacts with the survey prompt and survey UI. Used to assess the health of the end-to-end survey experience and to ensure the signal used to analyze customer issues and health is working properly.

The following fields are collected:

  • ExpirationTimeUTC – date/time the survey will expire

  • SurveyName – name of survey shown

  • SurveyId – Unique instance of a campaign

  • UniqueId – ID to identify the individual piece of telemetry

Office.Feedback.Survey.UI.Win32.Toast

Tracks when survey prompt is shown. Used to assess the health of the survey prompt process and to ensure the signal used to analyze customer issues and health is working properly.

The following fields are collected:

  • ExpirationTimeUTC – date/time the survey will expire

  • SurveyName – name of survey shown

  • SurveyId – Unique instance of a campaign

  • UniqueId – ID to identify the individual piece of telemetry

Office.FileIO.CSI.CCachedFileCsiLoadFileBasic

Allows us to know if a file successfully opened from the FIO Layer. Used for feature health and monitoring.

The following fields are collected:

  • Activity.Group - tag that allows a set of monitoring events to be grouped to manage overall success

  • Activity.IsHVA - flag to indicate that event is critical to user success

  • Data.AsyncOpen - flag to indicate the open had content that arrived after the main body was opened

  • Data.CacheFileId - connects to Office Document Cache telemetry to enable impact analysis of cache issues on the user experience

  • Data.CFREnabled - Indicates that CacheFileRuntime is enabled for the session.

  • Data.CFRFailure - Indicated that CacheFileRuntime ran into error.

  • Data.CoauthStatus - reports collaborative status of the document on Open

  • Data.CountOfMultiRoundTripsDownload - Count of round trips to the server used to troubleshoot performance and network issues

  • Data.CountOfMultiRoundTripsUpload - Count of round trips to the server used to troubleshoot performance and network issues

  • Data.DialogId - Set if a UI dialog was displayed during Open, indicating that a warning message was displayed to the user

  • Data.DidFallbackToDAV - Set if the document was opened using an older file transfer protocol

  • Data.Doc.AccessMode - Document is read only/editable

  • Data.Doc.AssistedReadingReasons - Set if the document has electronic data protection in place

  • Data.Doc.AsyncOpenKind – Indicates whether a cached version of the cloud document was opened and which asynchronous refresh logic was used.

  • Data.Doc.ChunkingType - Units used for incremental document open

  • Data.Doc.EdpState - Electronic Data Protection setting for the document

  • Data.Doc.Ext - Document extension (docx/xlsb/pptx, etc.)

  • Data.Doc.Extension - Obsolete

  • Data.Doc.FileFormat - File format protocol version

  • Data.Doc.Fqdn - OneDrive or SharePoint Domain Name

  • Data.Doc.FqdnHash - One-way hash of customer identifiable domain name

  • Data.Doc.IdentityTelemetryId - A one-way hash of the user identity used to perform the open

  • Data.Doc.IdentityUniqueId - Obsolete

  • Data.Doc.InitializationScenario - Records how the document was opened

  • Data.Doc.IOFlags - Reports on the cached flags used to set request options

  • Data.Doc.IrmRights - Actions permitted by the Electronic Data Protection policy that has been applied to the document/user

  • Data.Doc.IsCloudCollabEnabled - Flag indicating that the service supports Cloud Collaboration

  • Data.Doc.IsIncrementalOpen - Flag indicating that the document has been incrementally opened

  • Data.Doc.IsOcsSupported - Flag indicating that the document is supported in the collaboration service

  • Data.Doc.IsOpeningOfflineCopy - Flag indicating that the offline copy of a document was opened

  • Data.Doc.IsSyncBacked - Flag indicating that an auto synced copy of the document exists on the computer

  • Data.Doc.Location - Indicates which service provided the document (OneDrive, File Server, SharePoint etc.)

  • Data.Doc.LocationDetails - Indicates which Known Folder provided a locally stored document

  • Data.Doc.NumberCoAuthors - Count of the number of fellow users in a collaborative editing session

  • Data.Doc.PasswordFlags - Indicates read or read/write password flags set

  • Data.Doc.ReadOnlyReasons - Reasons why the document was opened read only

  • Data.Doc.ResourceIdHash - An anonymized document identifier used to diagnose problems

  • Data.Doc.ServerDocId - An immutable anonymized document identifier used to diagnose problems

  • Data.Doc.ServerProtocol - the protocol version used to communicate with the service

  • Data.Doc.ServerType - the type of the server offering the service (SharePoint, OneDrive, WOPI etc.)

  • Data.Doc.ServerVersion - the server version offering the service

  • Data.Doc.SessionId - Identifies a specific document edit session within the full session

  • Data.Doc.SharePointServiceContext - Diagnostic information from SharePoint requests

  • Data.Doc.SizeInBytes - Indicator of document size

  • Data.Doc.SpecialChars - Indicator of special chars in the document's URL or Path

  • Data.Doc.StorageProviderId - Obsolete

  • Data.Doc.StreamAvailability - Indicator if document stream is available/disabled

  • Data.Doc.SyncBackedType - Indicator as to the type of document (local or service based)

  • Data.Doc.UrlHash - One-way hash to create a naïve document identifier

  • Data.Doc.UsedWrsDataOnOpen - Diagnostic indicator for incremental document open

  • Data.Doc.WopiServiceId - Contains unique identifier of WOPI service provider

  • Data.DocumentLoadEndpoint - obsolete/redundant duplicate of (Data.Doc.Location and Data.Doc.IsSyncbacked)

  • Data.DocumentSizeInBytes - Obsolete/redundant supplanted by Data.Doc. SizeInBytes

  • Data.DocumentSizeOnDisk - Obsolete

  • Data.DoesBaseHaveContentOnOpen - Change tracking diagnostic making sure we have the latest version of a shared file

  • Data.DoesWorkingBranchHaveExcludedDataOnOpen - Change tracking diagnostic making sure we have the latest version of a shared file

  • Data.DownloadFragmentSize - Size of data sent in a sub request for diagnosing network issues

  • Data.DsmcStartedTooEarly - Indicates an error starting a collaborative edit session

  • Data.EditorsCount - A count of other collaborators editing the document

  • Data.ExcludedDataThresholdInBytes - File size required for Asynch open to be used

  • Data.FileIOResult.Code - Cache of last Open return code from protocol layer

  • Data.FileIOResult.Success - Cache of last Open success indicator from protocol layer

  • Data.FileIOResult.Tag - Cache of last Open error tag from protocol layer

  • Data.FileIOResult.Type - Cache of last Open error type from protocol layer

  • Data.FqdnHash - Obsolete, replaced by Data_Doc_FqdnHash

  • Data.FullIError - Cache of all Open error codes from the protocol layer

  • Data.FullyQualifiedDomainName - Obsolete, replaced by Data_Doc_Fqdn

  • Data.Input.FileOpenState - State requested by app (Read/ReadWrite etc.)

  • Data.Input.OpenAsync - Async open requested by app

  • Data.Input.OpenOfflineCopy - Open from offline copy requested by add

  • Data.IOFlags - Obsolete

  • Data.IsBaseBranchEmptyOnOpen - Change tracking diagnostic making sure we have the latest version of a shared file

  • Data.IsCachedHistoricalVersion - Cache contains an older version of the document

  • Data.IsDocEnterpriseProtected - Document has been protected by encryption (Electronic Document Protection / EDP)

  • Data.IsDocInODC - Document has been opened before and is already in the cache

  • Data.IsMapUnMapCase - Part of state of cached file

  • Data.IsMapUnMapCase.End - Part of state of cached file

  • Data.IsOfficeHydrationInProgress - The document is being restored from offline storage by Windows

  • Data.isOfficeHydrationRequired - The document is currently in offline storage

  • Data.isOpenFromCollab - The latest copy of the document was retrieved from the shared collaboration service

  • Data.isPendingNameExist - Document rename is in progress

  • Data.IsStubFile - The document hasn't been saved to the cloud service yet

  • Data.IsSyncBackedStateDifferentThanOnLastOpen - the document state has changed, changes may have arrived while the document wasn't open

  • Data.isTaskCanceledAfterOpenComplete - Obsolete

  • Data.IsWorkingBranchAvailableOnOpen - Change tracking diagnostic making sure we have the latest version of a shared file

  • Data.LicenseStatus - Diagnostic product license status, used to validate that appropriate product features are enabled for the user's license type

  • Data.LicenseType - Indicates state of license (free/paid/trial etc.)

  • Data.Location - Indicates storage media type/location (USB, Cloud, etc.)

  • Data.LockRequestDocMode - Indicates if the document is available to others

  • Data.MyDeferredValue - Obsolete

  • Data.Network.BytesReceived - Obsolete

  • Data.Network.BytesSent - Obsolete

  • Data.Network.ConnectionsCreated - Obsolete

  • Data.Network.ConnectionsEnded - Obsolete

  • Data.OcsDisableReasons - Reason why the shared collaboration service wasn't available for the document

  • Data.OcsHostOnOpen - Flag indicating that control will switch to the shared collaboration service during Open

  • Data.OpeningOfflineCopy - Flag indicating that the local copy of the document will be opened

  • Data.Partition - Obsolete

  • Data.RequestTime - Obsolete

  • Data.ResourceIdHash - Obsolete

  • Data.ResumedIncrementalOpen - Obsolete

  • Data.RTCEnabled - the fast change distribution protocol has started

  • Data.SaveOnOpen - unsaved changes in the local document were saved to the service during Open

  • Data.ServerProtocol - Obsolete, replaced by Data_Doc_ServerProtocol

  • Data.ServerType - Obsolete, replaced by Data_Doc_ServerType

  • Data.ServerVersion - Obsolete, replaced by Data_Doc_ServerVersion

  • Data.ServiceId - Obsolete, replaced by Data_Doc_WopiServiceId

  • Data.SessionId - Obsolete

  • Data.ShouldSwitchToServerOnly - the local copy of the document can't be used, and the server version must be used

  • Data.SpecialChars - Obsolete

  • Data.StopwatchDuration - Obsolete

  • Data.SyncBackedFileTelemetrySessionId - Obsolete

  • Data.SyncElapsedTime - Obsolete

  • Data.SyncRequestId - Obsolete

  • Data.TestProperty - Obsolete

  • Data.TransitionToHostOnOpen - flag indicating that the session will connect to the service hosting the document

  • Data.TransitionToHostOnOpenResult - status of the transition to the host service

  • Data.UseCachedNetworkConnection - flag to indicate if a connection was reused or a new connection created

  • Data.UseClientIdAsSchemaLockId - flag to control how documents are locked in the service

  • Data.VersionType - Indicate which version type the current open operation is.

  • Data.WopiServiceId - Obsolete, replaced by Data_Doc_WopiServiceId

Office.FileIO.CSI.CCachedFileCsiSaveFileBasic

This event allows us to know if a file was successfully saved from the FIO Layer. Used for Feature Health and monitoring.

The following fields are collected:

  • Activity.Group - tag that allows a set of monitoring events to be grouped to manage overall success

  • Activity.IsHVA - flag to indicate that event is critical to user success

  • Data.AsyncOpen - flag to indicate that the document was opened with content that arrived after the main body was opened

  • Data.BaseDownloadTriggered - Change tracking diagnostic indicating that the base version of the document was requested

  • Data.BlockAutoUploadReasons - Reason codes for blocked upload state (for example, Autosave is turned off, the document is transitioning)

  • Data.BlockUploadDueToFailedSaveAsOverExisting - Upload is blocked as it would fail if retried

  • Data.CacheFileId - connects to Office Document Cache telemetry to enable impact analysis of cache issues on the user experience

  • Data.ChartType - Obsolete

  • Data.CoAuthStatus - reports collaborative status of the document on Save

  • Data.CoauthUpdatesContext - reports context (Merge/Incremental Open)

  • Data.CountOfMultiRoundTripsDownload - Count of round trips to the server used to troubleshoot performance and network issues

  • Data.CountOfMultiRoundTripsUpload - Count of round trips to the server used to troubleshoot performance and network issues

  • Data.CFREnabled - Indicates that CacheFileRuntime is enabled for the session.

  • Data.CFRFailure - Indicated that CacheFileRuntime ran into error.

  • Data.DialogChoice - Records choice made in any error dialogs

  • Data.DialogId - Records the DialogId of any error dialogs that display during save

  • Data.Dmc.IsOcsSupported - Obsolete

  • Data.Doc.AccessMode - Document is read only

  • Data.Doc.AssistedReadingReasons - Set if the document has electronic data protection in place

  • Data.Doc.AsyncOpenKind – Indicates whether a cached version of the cloud document was opened and which asynchronous refresh logic was used.

  • Data.Doc.ChunkingType - Units used for incremental document open

  • Data.Doc.EdpState - Electronic Data Protection setting for the document

  • Data.Doc.Ext - Document extension (docx/xlsm/pptx etc.)

  • Data.Doc.Extension - Obsolete

  • Data.Doc.FileFormat - File format protocol version

  • Data.Doc.Fqdn - OneDrive or SharePoint Domain name

  • Data.Doc.FqdnHash - One-way hash of the customer identifiable domain name

  • Data.Doc.FqdnHasi - Obsolete

  • Data.Doc.IdentityTelemetryId - A one-way hash of the user identity used to perform the save

  • Data.Doc.IdentityUniqueId - Obsolete

  • Data.Doc.IKFlags - Obsolete

  • Data.Doc.InitializationScenario - Records how the document was opened

  • Data.Doc.IOFlags - Reports on the cached flags used to set request options

  • Data.Doc.IrmRights - Actions permitted by the Electronic Data Protection policy that has been applied to the document/user

  • Data.Doc.IsCloudCollabEnabled - Flag indicating that the application supports Cloud Collaboration

  • Data.Doc.IsIncrementalOpen - Flag indicating that the document was opened incrementally

  • Data.Doc.IsOcsSupported - Flag indicating that the document supports Cloud Collaboration

  • Data.Doc.IsOpeningOfflineCopy - Flag indicating that the offline copy of a document was opened

  • Data.Doc.IsSyncBacked - Flag indicating that an auto synced copy of the document exists on the computer

  • Data.Doc.Location - Indicates which service provided the document (OneDrive, File Server, SharePoint etc.)

  • Data.Doc.LocationDetails - Indicates which Known Folder provided a locally stored document

  • Data.Doc.NumberCoAuthors - Count of the number of fellow users in a collaborative editing session

  • Data.Doc.PasswordFlags - Indicates read or read/write password flags set

  • Data.Doc.ReadOnlyReasons - Reasons why the document was opened read only

  • Data.Doc.ResourceIdHash - An anonymized document identifier used to diagnose problems

  • Data.Doc.ServerDocId - An immutable anonymized document identifier used to diagnose problems

  • Data.Doc.ServerProtocol - the protocol version used to communicate with the service

  • Data.Doc.ServerType - the type of the server offering the service (SharePoint, OneDrive, WOPI etc.)

  • Data.Doc.ServerVersion - the server version offering the service

  • Data.Doc.SessionId - Identifies a specific document edit session within the full session

  • Data.Doc.SharePointServiceContext - Diagnostic information from SharePoint requests

  • Data.Doc.SizeInBytes - Indicator of document size

  • Data.Doc.SpecialChars - Indicator of special chars in the document's URL or Path

  • Data.Doc.StorageProviderId - Obsolete

  • Data.Doc.StreamAvailability - Indicator if document stream is available/disabled

  • Data.Doc.SussionId - Obsolete

  • Data.Doc.SyncBackedType - Indicator as to the type of document (local or service based)

  • Data.Doc.UrlHash - One-way hash to create a naïve document identifier

  • Data.Doc.UsedWrsDataOnOpen - Diagnostic indicator for incremental document open

  • Data.Doc.WopiServiceId - Contains unique identifier of WOPI service provider

  • Data.DocnReadOnlyReasons - Obsolete

  • Data.DocumentSaveEndpoint - Obsolete, replaced by Data_Doc_Location

  • Data.DocumentSaveType - Type of Save (Normal, Create, SaveAs)

  • Data.DocumentSizeOnDisk - Obsolete, replaced by Data_Doc_SizeInBytes

  • Data.DoesBaseHaveContentOnOpen - Change tracking diagnostic making sure we have the latest version of a shared file

  • Data.DoesWorkingBranchHaveExcludedDataOnOpen - Change tracking diagnostic making sure we have the latest version of a shared file

  • Data.DstDoc.AccessMode - New document is read only/editable

  • Data.DstDoc.EdpState - Electronic Data Protection setting for the new document

  • Data.DstDoc.Extension - New document's extension (docx/xlsm/pptx, etc.)

  • Data.DstDoc.FileFormat - New document's file format protocol

  • Data.DstDoc.Fqdn - New document's OneDrive or SharePoint domain name

  • Data.DstDoc.FqdnHash - One-way hash of new document's customer identifiable domain name

  • Data.DstDoc.IdentityUniqueId - Obsolete

  • Data.DstDoc.IOFlags - New document's cached options flags used when opening

  • Data.DstDoc.IsOpeningOfflineCopy - Flag indicating that an offline copy of the new document was opened

  • Data.DstDoc.IsSyncBacked - Flag indicating that an auto synced copy of the document exists on the computer

  • Data.DstDoc.Location - Indicates which service provided the new document (OneDrive, File Server, SharePoint, etc.)

  • Data.DstDoc.NumberCoAuthors - Count of the number of fellow users in a collaborative editing session on the new document

  • Data.DstDoc.ReadOnlyReasons - Reasons why the new document was opened read only

  • Data.DstDoc.ResourceIdHash - An anonymized document identifier used to diagnose problems with the new document

  • Data.DstDoc.ServerDocId - An immutable anonymized document identifier used to diagnose problems with the new document

  • Data.DstDoc.ServerProtocol - the protocol version used to communicate with the service when creating the new document

  • Data.DstDoc.ServerType - the type of the server offering the service (SharePoint, OneDrive, WOPI etc.) for the new document

  • Data.DstDoc.ServerVersion - the server version offering the service for the new document

  • Data.DstDoc.SessionId - Identifies a specific document edit session within the full session for the new document

  • Data.DstDoc.SharePointServiceContext - Diagnostic information from SharePoint requests for the new document

  • Data.DstDoc.SizeInBytes - Indicator of document size of new document

  • Data.DstDoc.UrlHash - One-way hash to create a naïve document identifier for the new document

  • Data.EditorsCount - A count of other collaborators editing the document

  • Data.FullIError - Cache of all error codes from the protocol layer

  • Data.HasFilteredCategories - Obsolete

  • Data.HasFilteredCategoryNames - Obsolete

  • Data.HasFilteredSeries - Obsolete

  • Data.HasFilteredSeriesNames - Obsolete

  • Data.HasPendingSaveAs - Indicates that a request Save As/Save a Copy is in progress

  • Data.Input.FileOpenState - State requested by app (Read/ReadWrite, etc.)

  • Data.Input.FileSaveState - State requested by app (Save on Open, Save As, etc.)

  • Data.Input.NetworkCost - Indicates network cost/type (metered, metered above cap, etc.)

  • Data.Input.OpenAsync - Flag indicates app requested an async open

  • Data.Input.OpenOfflineCopy - Flag indicates app requested an offline open

  • Data.IsCachedHistoricalVersion - Indicates that this cached file isn't the latest version

  • Data.IsHtml - Indicates that HTML format text was pasted

  • Data.IsLegacyCode - Indicates that Legacy code format text was pasted

  • Data.IsLocalOnlyFile - Indicates that the file was opened from local storage only

  • Data.IsLocalOrSyncBackedFile - Indicates that the file was opened locally and mapped through to the service

  • Data.IsMapUnMapCase - Part of state of cached file

  • Data.isOpenFromCollab - Indicates that the file was opened from the shared collaboration service

  • Data.IsStubFile - The document hasn't been shared to the cloud service yet

  • Data.IsSyncBackedFile - the document is in a folder that is auto sync updated

  • Data.IsSyncBackedStateDifferentThanOnLastOpen - the document state has changed, changes may have arrived while the document wasn't open

  • Data.IsWorkingBranchAvailableOnOpen - change tracking diagnostic making sure we have the latest version of a shared file

  • Data.Location - Indicates storage media type/location (USB; Cloud, etc.)

  • Data.LockRequestDocMode - Indicates if the document is available to others

  • Data.MruRequestResult - Obsolete

  • Data.NewDataNotAvailableReason - Obsolete

  • Data.OcsDisableReasons - Not used by Save

  • Data.OcsHostOnOpen - Not used by Save

  • Data.Output.FileSaveState - State on save completion

  • Data.PivotChart - Obsolete

  • Data.resolveConflictState - Reason codes for a request to resolve merge conflicts

  • Data.RTCEnabled - the fast change distribution protocol has started

  • Data.SaveAsToCurrent - Indicates that the active document will overwrite the stored file

  • Data.ServiceId - Obsolete, replaced by Data_Doc_WopiServiceId

  • Data.SessionId - Obsolete

  • Data.SizeInBytes - Obsolete, replaced by Data_Doc_SizeInBytes

  • Data.StopwatchDuration - Obsolete

  • Data.SyncBackedFileRequiresOnlineTransition - Flag indicating that Save action is temporarily blocked by online transition

  • Data.SyncBackedFileSaveOnOpen - Flag indicating that changes made by auto sync require a save on open

  • Data.TelemetryId - Obsolete

  • Data.TriggerSaveAfterBaseDownload - change tracking diagnostic making sure we have the latest version of a shared file

  • Data.UploadBlockedDueToCoherencyFailure - Save to service blocked pending user resolution of conflicting changes

  • Data.UploadBlockedDueToFailedSaveAsOverExisting - Save to service blocked due to failed attempt to overwrite an existing file

  • Data.UploadPreemptedForCoherency - Save to service abandoned as more changes are being made by the user

  • Data.UploadPreemptedForSaveAsOverExistingFailure - Save to service abandoned due to earlier SaveAsOverExisting failure

  • Data.UploadScheduled - file is ready to be asynchronously uploaded to the service

  • Data.UseClientIdAsSchemaLockId - flag to control how documents are locked in the service

  • Data.WorkingCopySaved - change tracking diagnostic making sure we have the latest version of a shared file

  • Data.ZrtSaveAsforSyncBackedBusinessEnabled - flag indicating fast save enabled for SharePoint

  • Data.ZrtSaveAsforSyncBackedConsumerEnabled - flag indicating fast save enabled for OneDrive Consumer

  • Data.ZrtSaveAsforSyncBackedCTBusinessEnabled - flag indicating fast save content types enabled for SharePoint

  • Data.ZrtSaveAsforSyncBackedCTConsumerEnabled - flag indicating fast save content types enabled for OneDrive Consumer

  • Data.ZrtSaveAsforSyncBackedMetaDataBusinessEnabled - flag indicating fast file metadata save enabled for SharePoint

  • Data.ZrtSaveAsforSyncBackedMetaDataConsumerEnabled - flag indicating fast file metadata save enabled for OneDrive Consumer-

Office.FindTime.AppFailedToStart

Collected when app fails to start due to an unexpected error during startup. Used to track exceptions & crashes. Helps monitor & debug app health.

The following fields are collected:

  • DateTime - Timestamp of when the event is logged

  • EventName - The name of the event being logged

Office.FirstRun.Apple.ActivationResult

This event is collected for Office applications running under Apple platforms. The event is used to monitor the health of our application activation flow. We collect data to figure out the outcome of the Office 365 subscription activation along with the flow used to activate (First Run Experience, In-App-Flow, Purchase, etc.).

The following fields are collected:

  • Data_ActivationStatusCollectionTime – A timestamp

  • Data_ActivationStatusError – An activation error code.

  • Data_ActivationStatusFlowType – A numeric value indicating the type of activation flow

Office.FirstRun.Apple.ActivationStatus

This event is collected for Office applications running under Apple platforms. The event is used to figure out the outcome of the Office 365 subscription activation along with the flow used to activate (FRE, InApp, Purchase, etc.). We collect data containing the Activation type, flow type (FRE/DocStage/Purchase) and Office Licensing Service ID.

The following fields are collected:

  • Data_ActivationTypeCollectionTime – A timestamp

  • Data_ActivationTypeFlowType – A numeric value indicating the type of activation flow

  • Data_ActivationTypeOLSLicense – An identifier of the License

  • Data_ActivationTypeStatus – An activation status code.

Office.FirstRun.Apple.FirstRunComplete

This event is collected for Office applications running under Apple platforms. The event lets us know if the user running in freemium, the flow type being run (FRE/DocStage/Purchase), and the identity type (MSA/OrgID). We use this event to figure out if the First Run-Experience (FRE) was completed and type of identity used to sign in (MSA/OrgID).

The following fields are collected:

  • Data_FirstRunCompletedCollectionTime - A timestamp registering the time at which the flow was completed

  • Data_FirstRunCompletedFlowType - A code denoting the type of user flow that was completed

  • Data_FirstRunCompletedFreemiumStatus - A code representing the status of completion for a freemium user flow

  • Data_FirstRunCompletedIdentityType - The type of identity of the user that completed the flow

Office.FirstRun.Apple.FirstRunStart

This event is collected for Office applications running under Apple platforms. The event lets us know a user has entered first run experience and the flow type being run (FRE/DocStage/Purchase). We use this event to figure out if the First Run-Experience (FRE) was started successfully.

The following fields are collected:

  • Data_FirstRunStartedCollectionTime - A timestamp registering the time at which the flow was completed

  • Data_FirstRunStartedFlowType - A code denoting the type of user flow that was completed

Office.FirstRun.Apple.FirstRunStartedAndCompleted

This event is collected for Office applications running under Apple platforms. The event lets us know if the user running in freemium, the flow type being run (FRE/DocStage/Purchase), and the identity type (MSA/OrgID). We use this event to figure out the health and effectiveness of our First-Run Experience (FRE) flow.

The following fields are collected:

  • Data_FirstRunCompletedCollectionTime - A timestamp registering the time at which the flow was completed

  • Data_FirstRunCompletedFlowType - A code denoting the type of user flow that was completed

  • Data_FirstRunCompletedFreemiumStatus - A code representing the status of completion for a freemium user flow

  • Data_FirstRunCompletedIdentityType - The type of identity of the user that completed the flow

  • Data_FirstRunStartedCollectionTime - A timestamp registering the time at which the flow was started

  • Data_FirstRunStartedFlowType - A code denoting the type of user flow that was started

Office.FirstRun.Apple.InAppPurchaseActivationFail

This event is collected for Office applications running under Apple platforms. The event is used to monitor the health of our application activation flow. We collect data to figure out the outcome of the In-App purchase activation along with the flow used to activate (First Run Experience, In-App-Flow, Purchase, etc.).

The following fields are collected:

  • Data_ActivationFailCollectionTime - A timestamp registering the time at which the activation failure occurred

  • Data_ActivationFailFlowType - A code denoting the type of user flow that was exercised

  • Data_AssoicatedSuccessfullyCollectionTime - A timestamp registering the time at which the association occurred

  • Data_AssoicatedSuccessfullyFlowType - A code denoting the type of user flow that was exercised

Office.FirstRun.Apple.InAppPurchaseActivationSuccess

This event is collected for Office applications running under Apple platforms. The event is used to monitor the health of our application activation flow. We collect data to figure out the outcome of the In-App purchase activation along with the flow used to activate (First Run Experience, In-App-Flow, Purchase, etc.).

The following fields are collected:

  • Data_ActivatedSuccessfullyCollectionTime - A timestamp registering the time at which the activation occurred

  • Data_ActivatedSuccessfullyFlowType - A code denoting the type of user flow that was exercised

  • Data_AssoicatedSuccessfullyCollectionTime - A timestamp registering the time at which the association occurred

  • Data_AssoicatedSuccessfullyFlowType - A code denoting the type of user flow that was exercised

Office.FirstRun.Apple.InAppPurchaseAssociationFailed

This event is collected for Office applications running under Apple platforms. The event is used to monitor the health of our application activation flow. We collect data to figure out the outcome of the In-App purchase activation along with the flow used to activate (First Run Experience, In-App-Flow, Purchase, etc.).

The following fields are collected:

  • Data_AppChargedSuccessfullyCollectionTime - A timestamp registering the time at which the purchase was charged

  • Data_AppChargedSuccessfullyFlowType - A code denoting the type of user flow that was exercised

  • Data_AssoicationFailedCollectionTime - A timestamp registering the time at which the app association failed

  • Data_AssoicationFailedFlowType - A code denoting the type of user flow that was exercised

  • Data_AssoicationFailedResult - A code denoting type of failure observed

Office.FirstRun.Apple.InAppPurchaseAssociationSuccess

This event is collected for Office applications running under Apple platforms. The event is used to monitor the health of our application activation flow. We collect data to figure out the outcome of the In-App purchase activation along with the flow used to activate (First Run Experience, In-App-Flow, Purchase, etc.).

The following fields are collected:

  • Data_AppChargedSuccessfullyCollectionTime - A timestamp registering the time at which the purchase was charged

  • Data_AppChargedSuccessfullyFlowType - A code denoting the type of user flow that was exercised

  • Data_AssoicatedSuccessfullyCollectionTime - A timestamp registering the time at which the app association failed

  • Data_AssoicatedSuccessfullyFlowType - A code denoting the type of user flow that was exercised

Office.FirstRun.Apple.InAppPurchaseFailures

This event is collected for Office applications running under Apple platforms. The event is used to monitor the health of our application activation flow. We collect data on the outcome of the In-App purchase flow.

The following fields are collected:

  • Data_AppStoreFailureFlowType - A code denoting the type of user flow that was exercised

  • Data_AppStoreFailureResult - The failure result observed

  • Data_CancelRequestFlowType - A code denoting the type of user flow that was exercised

  • Data_EventId - A code denoting type of failure observed

Office.FirstRun.Apple.InAppPurchasesAttempted

This event is collected for Office applications running under Apple platforms. The event is used to monitor the health of our application in-app purchase flow. We collect data to track the attempted In-App purchases and their Type of SKU being purchased (Monthly/Annual/Home/Personal).

The following fields are collected:

  • Data_EventId - A code denoting type of result observed

  • Data_PurchasedClickedOfferType - The type of SKU attempted to purchase

  • Data_PurchaseSuccessfulFlowType - A code denoting the type of user flow that was exercised

Office.FirstRun.Apple.InAppRestoreAttempted

This event is collected for Office applications running under Apple platforms. The event is used to monitor the health of our application in-app purchase flow. We collect data to track the attempted In-App restorations.

The following fields are collected:

  • Data_EventId - A code denoting the type of outcome of the attempt

  • Data_RestoreAttemptFlowType - A code denoting the type of user flow that was exercised

Office.FirstRun.Apple.InAppRestoreAttemptFailed

This event is collected for Office applications running under Apple platforms. The event is used to monitor the health of our application in-app purchase flow. We collect data to track the attempted In-App restorations and their associated flows and errors.

The following fields are collected:

  • Data_RestoreButtonFlowType - A code denoting the type of user flow that was exercised

  • Data_RestoredFailedPaymentCancelledFlowType - A code denoting the type of payment cancellation flow that was exercised

  • Data_RestoredFailedUnKnownFlowType - Whether the attempt failed due to the exercise of an unexpected user flow

  • Data_RestoredFailedUnKnownResult - Whether the attempt failed due to unknown reasons

Office.FirstRun.Apple.MacFirstRunCompleted

This event is collected for Office applications running under Apple platforms. The event lets us know a user has gone through first run experience. We use this event to figure out if the First Run-Experience (FRE) was completed successfully.

The following fields are collected:

  • Data_FirstRunCollectionTime - A timestamp registering the time at which the flow was completed.

Office.FirstRun.Apple.MacWXPFirstRunStarted

This event is collected for Office applications running under Apple platforms. The event lets us know a user has entered first run experience. We use this event to figure out if the First Run-Experience (FRE) was started successfully.

The following fields are collected:

  • Data_FirstRunPanelName - The name of the panel from which the experience started

Office.Floodgate.UserFact.AppUsage

This indicates when a user has used high value features within the product. It may indicate if the user discovered the feature or used it. The signal will feed feature usage product insights that help make the product better.

The following fields are collected:

  • FeatureAction - A label indicating the high value feature and action performed by the user, for example, ContentPickerTried, TemplatesSeen.

Office.Fluid.LoopMobile.Activity.ScenarioAddExistingPageToWorkspace

Event occurs when user adds an existing Loop page to a workspace. Event is used to capture success and error rates of the Add Existing Page To Workspace core scenario, and gauge overall health state of the Loop app.

The following fields are collected:

  • Activity_Duration - Duration it took to add a Loop page to a workspace.

  • Activity_Success - A flag indicating if adding a Loop page to a workspace succeeded or not.

  • Data_ErrorDescription - Description of the error if adding a Loop page to a workspace failed.

  • Data_FeatureName - Name of this activity: Add Existing Page To Workspace.

Office.Fluid.LoopMobile.Activity.ScenarioCreatePage

The event occurs when creating a Loop page and allows capturing success and error rates of the Create Page core scenario and gauge overall health state of the Loop app.

The following fields are collected:

  • Activity_Duration - Duration it took to create a Loop page.

  • Activity_Success - A flag indicating if creating a Loop page succeeded or not.

  • Data_ErrorDescription - Description of the error if creating a Loop page failed.

  • Data_FeatureName - Name of this activity: Create Loop Page.

Office.Fluid.LoopMobile.Activity.ScenarioCreateWorkspace

The event occurs when creating a Loop workspace and allows capturing success and error rates of the Workspace core scenario and gauge overall health state of the Loop app.

The following fields are collected:

  • Activity_Duration - Duration it took to create a Loop workspace.

  • Activity_Success - A flag indicating if creating a Loop workspace succeeded or not.

  • Data_ErrorDescription - Description of the error if creating a Loop workspace failed.

  • Data_FeatureName - Name of this activity: Create Loop Workspace.

Office.Fluid.LoopMobile.Activity.ScenarioOpenPage

The event occurs when opening a Loop page and allows capturing success and error rates of the Open Page core scenario and gauge overall health state of the Loop app.

The following fields are collected:

  • Activity_Duration - Duration it took to open a Loop page.

  • Activity_Success - A flag indicating if opening a Loop page succeeded or not.

  • Data_ErrorDescription - Description of the error if opening a Loop page failed.

  • Data_FeatureName - Name of this activity: Open Loop Page.

Office.Fluid.LoopMobile.Activity.ScenarioSharePage

The event occurs when sharing a Loop page and allows capturing success and error rates of the Share Page core scenario and gauge overall health state of the Loop app.

The following fields are collected:

  • Activity_Duration - Duration it took to share a Loop page.

  • Activity_Success - A flag indicating if sharing a Loop page succeeded or not.

  • Data_ErrorDescription - Description of the error if sharing a Loop page failed.

  • Data_FeatureName - Name of this activity: Share Loop Page.

Office.Fluid.LoopMobile.Activity.ScenarioSwitchPage

The event occurs when switching Loop pages and allows capturing success and error rates of the Switch Page core scenario and gauge overall health state of the Loop app.

The following fields are collected:

  • Activity_Duration - Duration it took to switch a Loop page.

  • Activity_Success - A flag indicating if switching a Loop page succeeded or not.

  • Data_ErrorDescription - Description of the error if switching a Loop page failed.

  • Data_FeatureName - Name of this activity: Switch Loop Page.

Office.Fluid.LoopMobile.Generic.AppLifecycle

This event is triggered when launching the Loop app. This data is used to collect lifecycle events at the start and end of the session to determine whether it was successful and ensure that app is running as expected.

The following fields are collected:

  • LifecycleEvent - Indicates the type of application lifecycle event.

  • VisionOSCompatibilityMode - flag that determines whether the app is running in VisionOS compatibility mode or not.

Office.Fluid.LoopMobile.UserAction.FRE

The event is triggered when Loop Android is launched for the first time and goes through the First Run Experience flow. The data is used to monitor the health of Loop Android’s First Run Experience (FRE) flow, determine its success state, and whether users get stuck in the process of using the app for the first time.

The following fields are collected:

  • FREActionType - The type of First Run Experience Screen presented.

Office.Fluid.LoopMobile.UserAction.Launch

The event is triggered when Loop Android is launched for the first time and goes through the First Run Experience flow. The data is used to monitor the health of Loop Android’s First Run Experience (FRE) flow, determine its success state, and whether users get stuck in the process of using the app for the first time.

The following fields are collected:

  • LaunchActionType - The type of action that triggered the First Run Experience.

  • LaunchEntryPoint - The entry point that triggered the First Run Experience.

Office.Klondike.MobileAttribution.AppInstall

This event is triggered at the initial install of the app, and records from where the user was referred (if available). The data helps us measure app performance and ensure it's performing as expected.

The following fields are collected:

  • EventPropertyNameAdId - The Device ID on which the app is installed

  • EventPropertyNameClickTime - The time the referral link was clicked

  • EventPropertyNameInstallTime - The time when the App is installed

  • EventPropertyNameInstallVersion - App version of the App installed

  • EventPropertyNameIsAdTrackingLimited - Captures whether the referrer link was clicked

  • EventPropertyNameReferrer - Product or experience from where the user was referred

  • EventPropertyNameUserAgent - Captures the OS details

Office.Klondike.MobileAttribution.Login

This event is triggered when the user logs in. The data is used to measure app performance and ensure it's performing as expected.

The following fields are collected:

  • EventPropertyNameAdId - The Device ID on which the app is installed

  • EventPropertyNameClickTime - The time the referral link was clicked

  • EventPropertyNameInstallTime - The time when the App is installed

  • EventPropertyNameInstallVersion - App version of the App installed

  • EventPropertyNameIsAdTrackingLimited - Captures whether the referrer link was clicked

  • EventPropertyNameReferrer - Product or experience from where the user was referred

  • EventPropertyNameUserAgent - Captures the OS details

  • EventPropertyNameUserId - The Account ID logged into the App

Office.Lens.LensSdk.CloudConnectorLaunch

When the user crops the image and taps confirm on the final image selection for using OCR, this event is collected. This is user-to-request record for the service as there's no user-to-service-job mapping on the service. UserId is required to fulfill GDPR requirements as service isn't directly exposed to users, but through clients and identify the total number of people using the service, helping the service track the volume of users using the product, as well as identifying changes in trends, help look for and rectify issues in the product.

The following fields are collected:

  • CallType - String to identify if the API call was synchronous or asynchronous.

  • CloudConnectorRequestId - String that identifies the service request that was made to convert images via service.

  • CloudConnectorTarget - String that confirms which type of conversion the service will do on images, like converting to PDF, Docx, text, etc.

  • CustomerId - String that identifies the user who owns the images being processed.

  • CustomerType - String that identifies the customer as an enterprise or individual user. This distinction affects the number of images (quota) the client can convert at a time.

  • RelationId - String, which identifies correlation between Lens and the service used to process files.

Office.Lens.LensSdk.CloudConnectorUploadError

In Image to Table, when the user taps either Share, Copy or Open, the corrections in the table made by the user are shared with the service to improve the OCR. This event is collected on the error response of that service and contains the relevant identifiers to troubleshoot various issues on the service.

The following fields are collected:

  • CloudConnectorRequestId - String identifier to link the service job to the current service request for which the improvement data was shared.

  • CorrelationId - String that contains the identifier of the current service job instance.

  • Reason - String that contains the error code and description of the error.

  • TargetType - String that identifies the endpoint on the service.

  • TaskType - String that identifies the intent of the service call.

Office.Lens.LensSdk.CloudConnectorUploadSuccess

In Image to Table, when the user taps either Share, Copy or Open, the corrections in the table made by the user are shared with the service to improve the OCR. This event is collected on the successful response of that service and contains the relevant identifiers to troubleshoot the process. It also helps analyze the usage of service improvement pipeline.

The following fields are collected:

  • CloudConnectorRequestId - String identifier to link the service job to the current service request for which the improvement data was shared.

  • CorrelationId - String that contains the identifier of the current service job instance.

  • TargetType - String that identifies the endpoint on the service.

  • TaskType - String that identifies the intent of the service call.

Office.Lens.LensSdk.SaveMedia

This event is invoked when the user clicks on the done button and saves images on Android and iOS. It helps measure the level of user engagement by quantifying users who end up saving images through our app.

The following fields are collected on Android:

  • Data_FileSizeAfterCleanUp - Size of the file after it's cleaned by app, to understand how much compression was achieved after cleanup.

  • Data_FileSizeAfterSave - Size of the file after it's saved by user, to understand how much compression was achieved after saving.

  • Data_FileSizeBeforeCleanUp - Size of the file before it's cleaned by app, to understand how much captured size was

  • Data_Filter - The filter applied to the image.

  • Data_ImageHeightAfterCleanUp - Height of the image after it was cleaned by app.

  • Data_ImageHeightBeforeCleanUp - Height of the image before it was cleaned by app.

  • Data_ImageWidthAfterCleanUp - Width of the image before it was cleaned by app.

  • Data_ImageWidthBeforeCleanUp - Width of the image before it was cleaned by app.

  • Data_MediaId - Identifier for images to help track operation success.

  • Data_ProcessMode - Mode of the user at the time of the saving the image by the user.

  • Data_Source - Defines where the image was sourced from, example captured via camera, imported from gallery, etc.

The following fields are collected on iOS:

  • Data_filter - The filter applied to the image.

  • Data_imageDPI - Image reduction applied to the saved file image

  • Data_imageSize - Size of the image after user has saved the image

  • Data_mediaId - Identifier for images to help track operation success.

  • Data_mode - Mode of the user at the time of the saving the image by the user.

  • Data_sizeinPixel - Size of the image in the form of pixel

  • Data_source - Defines where the image was sourced from, example captured via camera, imported from gallery, etc.

Office.Lens.LensSdk.ServiceIDMapping

This event is collected when Lens SDK interacts with Microsoft’s Image-to-document (or I2D) service. This means that the event is called:

  • When an image is uploaded to our I2D service for file conversion and extraction (OCR).
  • When the user needs to correct the service’s output, we send feedback to improve quality.

The data is used to analyze the usage and troubleshoot issues on the service side.

The following fields are collected:

  • CloudConnectorRequestId - String that identifies the service-requests on the client app for both conversion and feedback scenarios.

  • CustomerId - This string helps map users to service requests and help us track usage. UserId is required to fulfill GDPR requirements as service isn't directly exposed to users, but through clients and identify the total number of people using the service, helping the service track the volume of users using the product.

  • I2DFeedbackAPICorrelationId - String that identifies the feedback-request in I2D service when user corrects the service output.

  • I2DServiceProcessID - String that identifies the service-request in I2D service when user is uploading images for conversion.

Office.LivePersonaCard.ConfigurationSetAction

We log when the user is in an app that loads a Persona Card in anticipation of the user opening the Live Persona Card. The data is used to determine whether the card loaded correctly.

The following fields are collected:

  • Data.accountType - Whether the user belongs to an organization or a consumer

  • Data.appContextId - A randomly generated ID used to identify different accounts in the same app

  • Data.AppInfo.Name - Name of the service in use (Profile card)

  • Data.AppInfo_Id - Name of the host application

  • Data.AppInfo_Version - Version of the host application

  • Data.cardCorrelationId - The globally unique identifier for a persona card

  • Data.cardPersonaCorrelationId - The globally unique identifier for a specific persona shown in a card

  • Data.clientCorrelationId - The globally unique identifier for the app's session

  • Data.clientType - The type of device the app is run on

  • Data.contextType - What context (app) the card was launched from

  • Data.ecsConfigIds - Version identifiers for the features enabled in the card

  • Data.ecsTagId - Tag ID for features

  • Data.eventId - Name identifier of the event, for example "LivePersonaCardRenderedAction"

  • Data.eventpriority - An enumeration value for the priority of sending the event.

  • Data.feature - Used to group various events of the same feature (Profile card)

  • Data.flights - The features enabled in the card

  • Data.fromCache - Whether data was fetched from memory

  • Data.hasFinePointer - Whether the device has mouse-pointer capability

  • Data.hasHoverEvents - Whether the device has mouse-hover capability

  • Data.immersiveProfileCorrelationId - A globally unique identifier for the expanded profile view session

  • Data.offlineResolved - Whether data was fetched while offline

  • Data.OTelJS.Version - Version of OTel logger

  • Data.personaCorrelationId - A globally unique identifier for unique personas in a session

  • Data.properties - Additional metadata collected for each event as follows: [This field has been removed from current builds of Office, but might still appear in older builds.]

    • cardCorrelationId - Duplicate of Data.appContextId above

    • cardPersonaCorrelationId - Duplicate of Data.cardCorrelationId above

    • ClientTimeStamp - Time on the application when the event was logged

    • consumerCorrelationId - Duplicate of Data.clientCorrelationId above

    • externalAppSessionCorrelationId - A globally unique identifier for the app to identify all persona cards opened in the same sub-session

  • Data.region -The country or region of the profile card backend service to which user is connected

  • Data.tenantAadObjectId - The tenant to which a user's subscription is tied. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant

  • Data.type -Type of the logged event, for example, Trace, Error, Event

  • Data.userAadObjectId -The globally unique user identifier for an enterprise Microsoft account (duplicate of Data.UserInfo.Id)

  • Data.UserInfo.Id - The globally unique user identifier for an enterprise Microsoft account

  • Data.UserInfo.MsaId - The globally unique user identifier for a consumer Microsoft account

  • Data.UserInfo.OMSTenantId - The tenant that a user's subscription is tied to. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant

  • Data.userPuid - The globally unique user identifier for a consumer Microsoft account (duplicate of Data.UserInfo.MsaId)

  • Data.version - The version of the service (Profile Card)

  • Data.workloadCulture - Culture set in the host application

  • DeviceInfo_Id - The globally unique device identifier for a device

  • DeviceInfo_Make - The brand of the operating system

  • DeviceInfo_Model - The model of the device

  • DeviceInfo_OsName - The name of the device OS

  • DeviceInfo_OsVersion - The version of the operating system

  • DeviceInfo_SDKUid - Uniquely identifies the device from the telemetry SDK's perspective

Office.LivePersonaCard.UserActions.ClosedExpandedPersonaCard

Logged when the user closes an expanded Persona Card. It's used to observe critical anomalies in failure rates of closing the Live Persona Card.

The following fields are collected:

  • AppInfo_Id – Name of the host application

  • AppInfo_Version – Version of the host application

  • Data.appContextId - A randomly generated ID used to identify different accounts in the same app

  • Data.AppInfo.Name - Name of the service in use (Profile card)

  • Data.cardCorrelationId - The globally unique identifier for a persona card

  • Data.cardPersonaCorrelationId - The globally unique identifier for a specific persona shown in a card

  • Data.clientCorrelationId - The globally unique identifier for the app's session

  • Data.clientType - The type of device the app is run on, for example “Outlook_Win32”

  • Data.eventId - Name identifier of the event, for example "LivePersonaCardRenderedAction"

  • Data.exportName - Human readable name of the user action event, for example "ClosedExpandedPersonaCard"

  • Data.exportType - Category of the event for GDPR export request

  • Data.externalAppSessionCorrelationId - A globally unique identifier for the app to identify all persona cards opened in the same sub-session

  • Data.feature - Used to group various events of the same feature (Profile card)

  • Data.immersiveProfileCorrelationId - A globally unique identifier for the expanded profile view session

  • Data.OTelJS.Version - Version of OTel logger

  • Data.personaCorrelationId - A globally unique identifier for unique personas in a session

  • Data.properties - Additional metadata collected for each event as follows: [This field has been removed from current builds of Office, but might still appear in older builds.]

    • cardCorrelationId - Duplicate of Data.appContextId above
    • cardPersonaCorrelationId - Duplicate of Data.cardCorrelationId above
    • ClientTimeStamp - time that the event occurred in Unix epoch time
    • consumerCorrelationId - Duplicate of Data.clientCorrelationId above
  • Data.region -The country or region of the profile card backend service to which user is connected

  • Data.tenantAadObjectId - The tenant to which a user’s subscription is tied. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant

  • Data.type -Type of the logged event, for example, Trace, Error, Event

  • Data.userAadObjectId -The globally unique user identifier for an enterprise Microsoft account (duplicate of Data.UserInfo.Id)

  • Data.UserInfo.Id - The globally unique user identifier for an enterprise Microsoft account

  • Data.UserInfo.MsaId - The globally unique user identifier for a consumer Microsoft account

  • Data.UserInfo.OMSTenantId - The tenant that a user’s subscription is tied to. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant.

  • Data.userPuid -The globally unique user identifier for a consumer Microsoft account (duplicate of Data.UserInfo.MsaId)

  • Data.version -The version of the service (Profile Card)

  • DeviceInfo_Id – The globally unique device identifier for a device

  • DeviceInfo_Make – The brand of the operating system

  • DeviceInfo_Model – The model of the device

  • DeviceInfo.NetworkCost - Indicates network cost/type (metered, metered above cap, etc.)

  • DeviceInfo_OsName - The name of the device OS

  • DeviceInfo_OsVersion – The version of the operating system

  • PipelineInfo.ClientCountry - The country or region code of the sender, based on the unscrubbed Client IP Address

Office.LivePersonaCard.UserActions.ClosedPersonaCard

We log when the user closes a Persona Card. The data is used to determine whether the card closed correctly.

The following fields are collected:

  • BatchId - Globally unique identifier if a set of requests was made

  • Data.appContextId - A randomly generated ID used to identify different accounts in the same app

  • Data.AppInfo.Name - Name of the service in use (Profile card)

  • Data.AppInfo_Id - Name of the host application

  • Data.AppInfo_Version - Version of the host application

  • Data.cardCorrelationId - The globally unique identifier for a persona card

  • Data.cardPersonaCorrelationId - The globally unique identifier for a specific persona shown in a card

  • Data.clientCorrelationId - The globally unique identifier for the app's session

  • Data.clientType - The type of device the app is run on

  • Data.eventId - Name identifier of the event, for example "LivePersonaCardRenderedAction"

  • Data.externalAppSessionCorrelationId - A globally unique identifier for the app to identify all persona cards opened in the same sub-session.

  • Data.feature - Used to group various events of the same feature (Profile card)

  • Data.immersiveProfileCorrelationId - A globally unique identifier for the expanded profile view session

  • Data.OTelJS.Version - Version of OTel logger

  • Data.personaCorrelationId - A globally unique identifier for unique personas in a session

  • Data.properties - Additional metadata collected for each event as follows: [This field has been removed from current builds of Office, but might still appear in older builds.]

    • ClientTimeStamp - Time on the application when the event was logged
    • cardCorrelationId - Duplicate of Data.appContextId above
    • cardPersonaCorrelationId - Duplicate of Data.cardCorrelationId above
    • consumerCorrelationId - Duplicate of Data.clientCorrelationId above
  • Data.region -The country or region of the profile card backend service to which user is connected

  • Data.tenantAadObjectId - The tenant to which a user's subscription is tied. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant

  • Data.type -Type of the logged event, for example, Trace, Error, Event

  • Data.userAadObjectId -The globally unique user identifier for an enterprise Microsoft account (duplicate of Data.UserInfo.Id)

  • Data.UserInfo.Id - The globally unique user identifier for an enterprise Microsoft account

  • Data.UserInfo.MsaId - The globally unique user identifier for a consumer Microsoft account

  • Data.UserInfo.OMSTenantId - The tenant that a user's subscription is tied to. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant

  • Data.userPuid -The globally unique user identifier for a consumer Microsoft account (duplicate of Data.UserInfo.MsaId)

  • Data.version -The version of the service (Profile Card)

  • Data_hostAppRing - The rollout ring of the persona card

  • Event_ReceivedTime - The time the event was logged in the service

Office.LivePersonaCard.UserActions.OpenedExpandedPersonaCard

Logged when the user opens an expanded Persona Card. It's used to observe critical anomalies in failure rates of launching the Live Persona Card.

The following fields are collected:

  • AppInfo_Id – Name of the host application

  • AppInfo_Version – Version of the host application

  • Data.appContextId - A randomly generated ID used to identify different accounts in the same app

  • Data.AppInfo.Name - Name of the service in use (Profile card)

  • Data.cardCorrelationId - The globally unique identifier for a persona card

  • Data.cardPersonaCorrelationId - The globally unique identifier for a specific persona shown in a card

  • Data.clientCorrelationId - The globally unique identifier for the app's session

  • Data.clientScenario - To identify the feature in the app from where the persona card was opened

  • Data.clientType - The type of device the app is run on

  • Data.eventId - Name identifier of the event, for example "LivePersonaCardRenderedAction"

  • Data.externalAppSessionCorrelationId - A globally unique identifier for the app to identify all persona cards opened in the same sub-session.

  • Data.exportName - Human readable name of the user action event, for example "OpenedPersonaCard"

  • Data.exportType - Category of the event for GDPR export request

  • Data.feature - Used to group various events of the same feature (Profile card)

  • Data.hasPersonaInsightRing - Insights from Office or LinkedIn could be available for the user

  • Data.hostAppRing - The ring by which the app was distributed

  • Data.immersiveProfileCorrelationId - A globally unique identifier for the expanded profile view session

  • Data.OTelJS.Version - Version of OTel logger

  • Data.personaCorrelationId - A globally unique identifier for unique personas in a session

  • Data.properties - Additional metadata collected for each event as follows: [This field has been removed from current builds of Office, but might still appear in older builds.]

    • cardCorrelationId - Duplicate of Data.appContextId above
    • cardPersonaCorrelationId - Duplicate of Data.cardCorrelationId above
    • consumerCorrelationId - Duplicate of Data.clientCorrelationId above
  • Data.region -The country or region of the profile card backend service to which user is connected

  • Data.section – The active section of the expanded card

  • Data.tenantAadObjectId - The tenant to which a user's subscription is tied. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant

  • Data.type -Type of the logged event, for example, Trace, Error, Event

  • Data.userAadObjectId -The globally unique user identifier for an enterprise Microsoft account (duplicate of Data.UserInfo.Id)

  • Data.UserInfo.Id - The globally unique user identifier for an enterprise Microsoft account

  • Data.UserInfo.MsaId - The globally unique user identifier for a consumer Microsoft account

  • Data.UserInfo.OMSTenantId - The tenant that a user's subscription is tied to. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant

  • Data.userPuid -The globally unique user identifier for a consumer Microsoft account (duplicate of Data.UserInfo.MsaId)

  • Data.version -The version of the service (Profile Card)

  • DeviceInfo_Id – The globally unique device identifier for a device

  • DeviceInfo_Make – The brand of the operating system

  • DeviceInfo_Model – The model of the device

  • DeviceInfo_OsName - The name of the device OS

  • DeviceInfo_OsVersion – The version of the operating system

  • DeviceInfo_SDKUid – Uniquely identifies the device from the telemetry SDK's perspective

  • NetworkCost - Indicates network cost/type (metered, metered above cap, etc.)

  • NetworkCountry - The country or region code of the sender, based on the unscrubbed Client IP Address

Office.LivePersonaCard.UserActions.OpenedPersonaCard

Logged when the user opens a Persona Card. It's used to observe critical anomalies in failure rates of launching the Live Persona Card.

The following fields are collected:

  • Data.appContextId - A randomly generated ID used to identify different accounts in the same app

  • Data.AppInfo.Name - Name of the service in use (Profile card)

  • Data.bandwidthEstimateMbps - Effective bandwidth estimate in Mbps

  • Data.cardCorrelationId - The globally unique identifier for a persona card

  • Data.cardPersonaCorrelationId - The globally unique identifier for a specific persona shown in a card

  • Data.clientCorrelationId - The globally unique identifier for the app's session

  • Data.clientType - The type of device the app is run on.

  • Data.eventId - Name identifier of the event, for example "LivePersonaCardRenderedAction"

  • Data.exportName - Human readable name of the user action event, for example "OpenedPersonaCard"

  • Data.exportType - Category of the event for GDPR export request

  • Data.externalAppSessionCorrelationId - A globally unique identifier for the app to identify all persona cards opened in the same sub-session

  • Data.feature - Used to group various events of the same feature (Profile card)

  • Data.hasPersonaInsightRing - Insights from Office or LinkedIn could be available for the user

  • Data.hostAppRing - The ring by which the app was distributed

  • Data.immersiveProfileCorrelationId - A globally unique identifier for the expanded profile view session

  • Data.OTelJS.Version - Version of OTel logger

  • Data.personaCorrelationId - A globally unique identifier for unique personas in a session

  • Data.properties - Additional metadata collected for each event as follows. [This field has been removed from current builds of Office, but might still appear in older builds.]

    • cardCorrelationId - Duplicate of Data.appContextId above
    • cardPersonaCorrelationId - Duplicate of Data.cardCorrelationId above
    • consumerCorrelationId - Duplicate of Data.clientCorrelationId above
    • networkEffectiveType - The effective type of network connection, for example "slow-2g Online" to identify whether the user is connected to the internet at the time of showing the persona card
    • networkType - The type of network connectivity of the device in use
    • roundTripEstimateMs - Estimated effective round trip of the current connection in milliseconds
  • Data.region -The country or region of the profile card backend service to which user is connected

  • Data.tenantAadObjectId - The tenant to which a user's subscription is tied. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant

  • Data.type -Type of the logged event, for example, Trace, Error, Event

  • Data.userAadObjectId -The globally unique user identifier for an enterprise Microsoft account (duplicate of Data.UserInfo.Id)

  • Data.UserInfo.Id - The globally unique user identifier for an enterprise Microsoft account

  • Data.UserInfo.MsaId - The globally unique user identifier for a consumer Microsoft account

  • Data.UserInfo.OMSTenantId - The tenant that a user's subscription is tied to. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant

  • Data.userPuid -The globally unique user identifier for a consumer Microsoft account (duplicate of Data.UserInfo.MsaId)

  • Data.version -The version of the service (Profile Card)

  • Data.viewType -Defines the type of the Profile card displayed

  • Data.wasOpenedAsCompactCard - Used to identify if the card was opened as a compact view initially

  • NetworkCost - Indicates network cost/type (metered, metered above cap, etc.)

  • NetworkCountry - The country or region code of the sender, based on the unscrubbed Client IP Address.

Office.Manageability.Client Fetch.PolicyPreChecks

Critical telemetry to track failure\success for cloud policy fetch precheck validation. ExitReason contains an enumerator map to the pre-check condition that failed.

The following fields are collected:

  • Data.ExitReason - An enumerator value telling the exit reason, if the Precheck failed

  • Data.Log - Custom log message indicating the precheck success or failure

Office.Manageability.Client.Fetch.AndApplyPolicy

Critical telemetry to track failure\success for cloud policy fetch initiation from app. Exit Reason contains an enumerator Map to the failure reason.

The following fields are collected:

  • Data.ExitReason - An enumerator value telling the exit reason, if the Precheck failed

  • Data.Log - Custom log message indicating the precheck success or failure

Office.OfficeMobile.Fluid.FluidFileOperations

This event is collected for Office applications when a fluid file operation takes place. Data is used to track feature health and understand user-experience based on the operation information.

The following fields are collected:

  • FailureReason - If the operation was a failure. Contains the error code of the failure.

  • Result - A boolean value that indicates the end result of the operation.

  • Type - The operation type (for example, Open).

Office.OfficeMobile.Lens.LensRequiredUsage

This event is triggered when one of the following things happens:

  • The user launches Lens to capture or import images in any workflow. This helps Microsoft determine the volume of users launching the app and further understand feature usage, changes in trends, and to identify and rectify issues in the product.
  • The user completes the Lens workflow. For example, creating images or copying extracted data from image. This helps Microsoft to understand engagement metrics for the Lens App and to calculate the completion rate in any Lens workflow.
  • Lens Software Developer Kit interacts with Microsoft’s Image-to-document (I2D) service. This means that the event is called when an image is uploaded to our I2D service for file conversion and extraction (OCR) and when the user needs to correct the service’s output, we send feedback to improve quality.

The following fields are collected:

  • Data_Action - integer value to identify action, such as lensLaunch, LensFlowCompletion, or ServiceIDMapping.

  • Data_CloudConnectorRequestID - String that identifies the service requests on the client app for both conversion and feedback scenarios.

  • Data_CustomerID - This string helps map users to service requests and help us track usage. UserId is required to fulfill GDPR requirements as service isn't directly exposed to users, but through clients and identify the total number of people using the service, helping the service track the volume of users using the product. [This field has been removed from current builds of Office, but might still appear in older builds.]

  • Data_EntryPoint - integer value to identify entry point for Lens flow.

  • Data_I2DServiceProcessID - String that identifies the service-request in I2D service when user is uploading images for conversion.

  • Data_LensSessionID - String field to identify Lens session ID.

Office.OfficeMobile.PdfViewer.PdfFileOperations (on Android)

The event is collected for the Office app for Android. It records when a .pdf open, close, or save operation takes place and is used to understand and prioritize the user experience based on .pdf file operation information. The event enables us to keep the .pdf open, close, and save operations performing as expected, and to improve .pdf file operation performance.

The following fields are collected:

  • Data_Doc_FileOpSessionID - Unique ID for a Document Session

  • Data_ErrorCode - error in case of file open failures/download failures / download canceled

  • Data_ErrorMessage - relevant message-to-error code

  • Data_FailureReason - In case of open failure, these enums define the reason for failure.

  • Data_FetchReason - Denotes how the file was fetched (manual, cached, not cached)

  • Data_FileGUID – Global identifier for the file, which is randomly generated

  • Data_FileLocation - Location where the file sits, ex: Local, ODSP, iCloud, etc.

  • Data_FileOpenEntryPoint - entry point for file open

  • Data_FileSize - Size of the file on which the operation is happening

  • Data_NetworkRequestErrorResponse – Network Error response corresponding to error code.

  • Data_NetworkRequestStage – Error stage in case of cloud pdf file download.

  • Data_OpenMode - In which mode the PDF was opened, ex: 0: View mode, 2: Sign mode

  • Data_PageCount - Count of page in the PDF File.

  • Data_PasswordProtected - Marker that tells whether the file is password protected or not.

  • Data_ProviderApp - currently providing provider app in case of file activation only

  • Data_ReadOnly - Marker that tells whether the file is read only or not.

  • Data_Result - The status of the operation being performed, ex: true:success, false:failure

  • Data_Type - Type of file operation (open, close, or save)

  • IsMIPProtected - Boolean indicating whether file is MIP (Microsoft Information Protection) encrypted or not.

Office.OfficeMobile.PdfViewer.PdfFileOperations (on iOS)

The event is collected for the Office app for iOS. It records when a .pdf open, close, or save operation takes place and is used to understand and prioritize the user experience based on .pdf file operation information. The event enables us to keep the .pdf open, close, and save operations performing as expected, and to improve .pdf file operation performance.

  • Data_Doc_FileOpSessionID - Unique ID for a Document Session

  • Data_ErrorCode – error in case of file open failures/download failures / download canceled

  • Data_ErrorMessage – relevant message to error code

  • Data_FailureReason - In case of open failure, these enums define the reason for failure.

  • Data_FetchReason - Denotes how the file was fetched (manual, cached, not cached)

  • Data_FileGUID – Global identifier for the file, which is randomly generated

  • Data_FileLocation - Location where the file sits (Local, ODSP, iCloud, etc.)

  • Data_FileOpenEntryPoint – entry point for file open

  • Data_FileSize - Size of the file on which the operation is happening

  • Data_OpenMode - In which mode the PDF was opened (0: View mode 2: Sign mode)

  • Data_PageCount - Count of page in the PDF File.

  • Data_PasswordProtected - Marker that tells whether the file is password protected or not.

  • Data_ProviderApp – currently providing provider app in case of file activation only

  • Data_ReadOnly - Marker that tells whether the file is read only or not.

  • Data_Result - The status of the operation being performed (true:success, false:failure)

  • Data_SessionLength - Stores the duration (in milliseconds) for which pdf file is opened.

  • Data_Type - Type of file operation (open, close, or save)

Office.OfficeMobile.Search.VoiceSearchUsage

This event is triggered when the user taps on the microphone in the search box inside the Microsoft 365 mobile app. The event will track the usage of voice search and also time taken to establish service request post tap on microphone. This data is used to track the usage and health of the feature.

The following fields are collected:

  • VoiceButtonClicked - Integer value mapped to taps on the voice search mic.

  • VoiceConsentAccepted - Integer value mapped to Cortana consent/permissions given (only applicable to Microsoft internal audience)

  • VoicePermissionGranted - Integer value mapped to the permissions access action

  • VoiceRecognitionCompleted - Integer value mapped to successful voice recognition completion

  • VoiceSearchError - Integer value mapped to occurrence of errors during speech to text.

  • VoiceSearchStartupLatency - Real number mapped to start-up latency for speech.

  • VoiceSearchTokenFetchingLatency - Real number mapped to successful token fetch latency

Office.OneNote.Android.App.Navigation.NavigationUIStateChanged

[This event was previously named OneNote.App.Navigation.NavigationUIStateChanged.]

This event collects the critical signal used to ensure OneNote users can successfully navigate through the app. The telemetry is used to ensure critical regression detection for OneNote app and service health.

The following fields are collected:

  • IS_SPANNED - Indicates whether the app is in a spanned mode. This is specifically logged for foldable devices.

  • NEW_STATE - Indicates the applications' state right after the navigation

  • OLD_STATE - Indicates the applications' state right before the navigation

Office.OneNote.Android.Canvas.PageCreated

This event is triggered when a new OneNote page is created. The data is used to monitor, detect, and fix any issues caused when a page is created in OneNote.

The following fields are collected:

  • EVENT_UUID - Unique ID for an event

  • NOTE_TYPE - This will capture the type of created page

  • PAGE_CREATE_LOCATION - This will capture the location of a created page, where it's triggered from

  • TIME_TAKEN_IN_MS - time taken to create page

Office.OneNote.Android.Canvas.PageOpened

[This event was previously named OneNote.Canvas.PageOpened.]

This event is triggered when a Page is opened. The telemetry is used to monitor, detect, and fix any issues caused when a Page is opened in OneNote.

The following fields are collected:

  • EVENT_UUID - Unique ID for an event

  • JOT_ID - object of the page opened

  • TIME_TAKEN_IN_MS - time taken to open page

Office.OneNote.Android.Capture.NewNote.NewNoteTaken

[This event was previously named OneNote.Capture.NewNote.NewNoteTaken.]

This signal is used to ensure that after a user signs-into a OneNote Android App, notebooks are properly provisioned, and user has successfully created a new note. This is used to ensure critical regression detection for OneNote app and service health.

The following fields are collected:

  • None

Office.OneNote.Android.LensSDK.OfficeLensLaunched

[This event was previously named OneNote.LensSDK.OfficeLensLaunched.]

This event collects the critical signal used to ensure that OfficeLens is launched correctly. The telemetry is used to ensure critical regression detection for OneNote app and service health.

The following fields are collected:

  • CAPTURE_MODE - Indicates which mode has OfficeLens has been launched in. It could be default, edit, fast insert or video import.

  • ERROR_CODE - Indicates the launch error code in case there was an error while launching.

  • IMAGE_COUNT - Indicates the number of images taken

  • LAUNCH_REASON - Indicates the flow under which OfficeLens was launched. It could be over the lock screen or via Camera or Gallery options in StickyNotes or via OneNote Canvas etc.

Office.OneNote.Android.MessageBar.MessageBarClicked

[This event was previously named OneNote.MessageBar.MessageBarClicked.]

The signal used to indicate any issues encountered while using Message Bar. The telemetry is used to monitor, detect, and fix any issues caused during interaction with Message Bar.

The following fields are collected:

  • Message_Bar_Type - Returns if the user is using old or new message bar

  • Message_Type - Returns the error message ID

Office.OneNote.Android.StickyNotes.NoteCreated

Critical signal that is used to monitor the ability of Sticky Notes users to create notes in the app. Telemetry is used to ensure critical regression detection for OneNote app and service health. If users can’t create a note, this would trigger a high severity incident.

The following fields are collected:

  • IsExportable - A flag indicating whether this event was a result of a user action or not. Should be set to True as NoteCreated is a user-triggered action.

  • NoteLocalId - Distinguishable unique identifier assigned to a note at the time of a user creates the note within the app.

  • StickyNotes-SDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

Office.OneNote.Android.StickyNotes.NoteViewed

Critical signal that is used to monitor the ability of Sticky Notes users to view notes in the app. Telemetry is used to ensure critical regression detection for OneNote app and service health. If users can’t view their notes, this would trigger a high severity incident.

The following fields are collected:

  • HasImages - A flag indicating whether the note viewed has images stored in it.

  • IsExportable - A flag indicating whether this event was a result of a user action or not. Should be set to True as NoteViewed is a user-triggered action.

  • NoteLocalId - Distinguishable unique identifier assigned to a note at the time a user creates the note within the app.

  • StickyNotes-SDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

Office.OneNote.Canvas.Ink.InkStrokeLogger

This event is used to detect and diagnose a high frequency bug that a user encounters while using Ink feature. This is used to determine the most appropriate mode of fixing this issue.

The following fields are collected:

  • CurrentCanvasZoomFactor - Current Zoom factor of the canvas.

  • CurrentNotebook - Identifier of the current active notebook.

  • CurrentPage - Identifier of the current active page

  • CurrentSection - Identifier of the current active section.

  • DefaultCanvasZoomFactor - Default Zoom factor of the canvas.

  • InkStrokeCount - Total count of ink strokes since the last log.

  • InkStrokeWithLayerInkEffect - Count of ink strokes with layer ink effect since the last log.

  • InkStrokeWithoutPressureCount - Count of Ink Strokes without Pressure since the last log.

  • InkStrokeWithPencilInkEffect - Count of ink strokes with pencil ink effect since the last log.

  • InkStrokeWithTilt - Count of ink strokes with tilt since the last log.

Office.OneNote.FirstRun.FirstRunDurationsBreakdown

The event is triggered upon completion of provisioning of the user in the app. This happens right after user signs into the app for the first time. The event collects durations of different stages of provisioning. The data helps Microsoft determine which stages of provisioning consume the most time and help us develop a solution to reduce the time taken.

The following fields are collected:

  • Duration_FirstRunAttemptToCreateGuide_MS - Time taken by the app to create a 'Getting Started' guide

  • Duration_FirstRunBootStatusUpdateEnded_MS - Time taken for the app to update the value of BootStatus to Succeeded/Failed. BootStatus helps the app track its status during First run.

  • Duration_FirstRunBootStatusUpdateStarted_MS - Time taken for the app to update the value of BootStatus to Started. BootStatus helps the app track its status during First run.

  • Duration_FirstRunCheckIfPathBeAccessible_MS - Time taken by the app to figure out if the notebook's path is accessible to it

  • Duration_FirstRunCreateEmptyNotebook_MS - Time taken by the app to create an empty organizational notebook

  • Duration_FirstRunCreateNotebook_MS - Time taken for the app to create a new personal notebook

  • Duration_FirstRunCreateQuickNotes_MS - Time taken by the app to create a 'Quick Notes' section in the notebook, in case one didn't already exist

  • Duration_FirstRunEnsureOneDriveIdentityForOpenDefaultNotebook_MS - Time taken by the app to ensure that an identity exists for a notebook

  • Duration_FirstRunExecutionForMsaAccount_MS - Time taken for provisioning to complete for a Live account

  • Duration_FirstRunExecutionForOrgAccount_MS - Time taken for provisioning to complete for an organizational account

  • Duration_FirstRunFGetNotebooks_WaitForResult_MS - Time taken by the app to obtain personal notebooks for an identity

  • Duration_FirstRunFGetNotebooks_WaitForResultForPersonalNotebook_MS - Time taken by the app to obtain notebooks for an identity

  • Duration_FirstRunFindLogicalDuplicateOfNotebookInNotebookList_MS - Time taken for the app to check if a duplicate notebook could exist

  • Duration_FirstRunFOpenOrCreateDefaultOrgIdNotebook_MS - Total time taken for the app to find or create and finally open the default notebook for an organizational account

  • Duration_FirstRunFTryGetCreateDefaultNotebook_MS - Time taken by the app to find or create a new default notebook

  • Duration_FirstRunGetAvailableAccount_MS - Time taken to obtain the signed in accounts

  • Duration_FirstRunGetEnterpriseIdentity_MS - Time taken by the app to find the Enterprise Identity

  • Duration_FirstRunGetFolderProxyFromPath_MS - Time taken by the app to obtain web location for a notebook

  • Duration_FirstRunGetNotebook_MS - Time taken for the app to obtain a notebook

  • Duration_FirstRunGetPersonalNotebooks_MS - Time taken by the app to obtain personal notebooks for an identity

  • Duration_FirstRunOldCreateAndOpenNotebook_MS - Total time taken for the app to find or create and finally open the default notebook

  • Duration_FirstRunOpenDefaultNotebook_MS - Time taken for the app to make few validations and finally open the default notebook

  • Duration_FirstRunOpenNotebook_MS - Time taken by the app to open an existing organizational notebook

  • Duration_FirstRunSearchForExistingPersonalNotebook_MS - Time taken for the app to find the existing personal notebook

  • Duration_FirstRunStampNotebookAsDefault_MS - Time taken by the app to stamp a notebook as default, in case it wasn't already

  • Duration_FirstRunTryOpenDefaultNotebook_MS - Time taken for the app to just open the default notebook

Office.OneNote.Navigation.CreatePage

Critical signal used to monitor the ability of OneNote users to create pages in OneNote. Telemetry used to ensure critical regression detection for OneNote app and service health. If users can't create a page this would trigger a high severity incident.

The following fields are collected:

  • IsAtSectionEnd - Indicates whether a new page is created at the end of section or not.

  • IsBlank - Indicates whether a new page is blanked page or created with a template.

  • IsRecentsView - Indicates whether a page is created from a recent or not.

  • NavView - Indicates whether a page is created from a navigation view or not.

  • NoteType - Indicates the type (quick note, list, or photo) of a page.

  • QuickNoteType - Indicates the type (quick note, list, or photo) of a page.

  • RailState - Indicates the state of OneNote's navigation rail when creating a page.

  • Trigger - Indicates an entry point where the create page action is started.

  • TriggerInfo - Indicates additional information related to the trigger.

Office.OneNote.Navigation.CreateSection

Critical signal used to monitor the ability of OneNote users to create sections in OneNote. Telemetry used to ensure critical regression detection for OneNote app and service health. If users can't create a page this would trigger a high severity incident.

The following fields are collected:

  • NotebookID - A unique identifier of a notebook.

  • SectionID - A unique identifier of a section created.

  • Trigger - Indicates an entry point where the create section action is started.

  • TriggerInfo - Indicates additional information related to the trigger.

Office.OneNote.Navigation.Navigate

Critical signal used to monitor the ability of OneNote users to navigate between pages in OneNote. Telemetry used to ensure critical regression detection for OneNote app and service health. If users can't navigate this would trigger a high severity incident.

The following fields are collected:

  • FromNotebook - A unique identifier of a notebook.

  • FromPage - A unique identifier of a page.

  • FromSection - A unique identifier of a section.

  • FromSectionGroup - A unique identifier of a section group.

  • IsCurrentUserEduStudent - Indicates whether the current user has a student role in an education notebook or not.

  • IsEduNotebook - Indicates whether the current page is in an education notebook or not.

  • IsEduNotebookReadOnlyPage - Indicates whether the current page is a read only page in an education notebook or not.

  • ToNotebook - A unique identifier of a notebook.

  • ToPage - A unique identifier of a page.

  • ToSection - A unique identifier of a section.

  • ToSectionGroup - A unique identifier of a section group.

Office.OneNote.NotebookManagement.CreateNotebook

Critical signal used to monitor the ability of OneNote users to create notebooks in OneNote. Telemetry used to ensure critical regression detection for OneNote app and service health. If users can't create notebooks this would trigger a high severity incident.

The following fields are collected:

  • NotebookID - A unique identifier of a notebook.

Office.OneNote.NotebookManagement.OpenNotebook

Critical signal used to monitor the ability of OneNote users to open notebooks in OneNote. Telemetry used to ensure critical regression detection for OneNote app and service health. If users can't open notebooks this would trigger a high severity incident.

The following fields are collected:

  • NotebookID - A unique identifier of a notebook.

Office.OneNote.Search.Search

Critical signal ID used to monitor the ability of OneNote users to find information across thousands of pages and notebooks. Telemetry used to ensure critical regression detection for OneNote app and service health. If users can't find information across notebooks this would trigger a high severity incident.

The following fields are collected:

  • PageSearchResultCount - Indicates the number of search's results found in a page search mode.

  • PageTimeToFirstResultInMs - Indicates the amount of time OneNote takes to find the first match in a page search mode.

  • PageTimeToLastResultInMs - Indicates the amount of time OneNote takes to find the last match in a page search mode.

  • PageTimeToMedianResultInMs - Indicates the median of time OneNote takes to find all matches in a page search mode.

  • SearchResultCount - Indicates the number of search's results found.

  • TagSearchResultCount - Indicates the number of search's results found in a tag search mode.

  • TagTimeToFirstResultInMs - Indicates the amount of time OneNote takes to find the first match in a tag search mode.

  • TagTimeToLastResultInMs - Indicates the amount of time OneNote takes to find the last match in a tag search mode.

  • TagTimeToMedianResultInMs - Indicates the median of time OneNote takes to find all matches in a tag search mode.

  • TimeToFirstResultInMs - Indicates the amount of time OneNote takes to find the first match.

  • TimeToLastResultInMs - Indicates the amount of time OneNote takes to find the last match.

  • TimeToMedianResultInMs - Indicates the median of time OneNote takes to find all matches.

Office.OneNote.SIGS.CriticalErrorEncountered

This event captures a critical signal that is used to monitor the health of Signal Ingestion Service (SIGS), by logging whenever a critical error is encountered. Critical errors can block the whole of SIGS, and this will help us catch any such issues as soon as they're encountered by users.

Without this, we'll be dependent on users to report the problems they're facing. Absence of such telemetry would make the turnaround time for such issues much higher.

The following fields are collected:

  • ErrorCode - The code of the issue that was hit by the user.

Office.OneNote.StickyNotes.NoteCreated (on iOS), OneNote.StickyNotes.NoteCreated (on Android)

This is a critical signal that is used to monitor the ability of Sticky Notes users to create notes in the app. Telemetry is used to ensure critical regression detection for OneNote app and service health. If users can't create a note, this would trigger a high severity incident.

The following fields are collected:

  • NoteLocalId - Distinguishable unique identifier assigned to a note at the time of a user creates the note within the app.

  • IsExportable - A flag indicating whether this event was a result of a user action or not. Should be set to True as NoteCreated is a user-triggered action.

  • StickyNotes-SDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

Office.OneNote.StickyNotes.NoteViewed (on iOS), OneNote.StickyNotes.NoteViewed (on Android)

This is a critical signal that is used to monitor the ability of Sticky Notes users to create notes in the app. Telemetry is used to ensure critical regression detection for OneNote app and service health. If users can't create a note, this would trigger a high severity incident.

The following fields are collected:

  • HasImages - A flag indicating whether the note viewed has images stored in it.

  • IsExportable - A flag indicating whether this event was a result of a user action or not. Should be set to True as NoteViewed is a user-triggered action.

  • NoteLocalId - Distinguishable unique identifier assigned to a note at the time a user creates the note within the app.

  • StickyNotes-SDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

Office.OneNote.Storage.NotebookSyncResult

This event logs notebook sync result. It's used for figuring out how many unique sync targets when calculating OneNote sync score.

The following fields are collected

  • CachedError_Code - a numbered or alphanumeric code used to determine the nature of the cached error, and/or why it occurred

  • CachedError_Description -a description of the cached error

  • CachedError_Tag -indicate where in the code throws the cached error

  • CachedError_Type -the type of the cached error, for example, Win32Error, etc.

  • ExecutionTime -time in milliseconds taken to replicate the notebook

  • Gosid -global object space ID

  • IdentityType -identity type, for example, Windows Live, Org ID, etc.

  • InitialReplicationInSession -is this replication the first notebook replication after open or not

  • IsBackgroundSync -is this a background sync or not

  • IsCachedErrorSuppressed -is the cached error suppressed or not

  • IsCachedErrorUnexpected -is the cached error unexpected or not

  • IsNotebookErrorSuppressed -is the notebook level sync error suppressed or not

  • IsNotebookErrorUnexpected -is the notebook level sync error unexpected or not

  • IsSectionErrorSuppressed -is the section sync error suppressed or not

  • IsSectionErrorUnexpected -is the section sync error unexpected or not

  • IsUsingRealtimeSync -is the notebook sync using modern page content sync or not

  • LastAttemptedSync -timestamp when the notebook was attempted to be synced last time

  • LastBackgroundSync -timestamp when the latest background sync was attempted

  • LastNotebookViewedDate -the date when the notebook was last viewed

  • LastSuccessfulSync -timestamp when the notebook successfully synced before

  • NeedToRestartBecauseOfInconsistencies -does the sync need to restart because of inconsistencies or not

  • NotebookErrorCode -notebook level sync error code saved on notebook graph space

  • NotebookId -notebook ID

  • NotebookType -notebook type

  • ReplicatingAgainBecauseOfInconsistencies -does the sync restart because of inconsistencies or not

  • SectionError_Code -a numbered or alphanumeric code used to determine the nature of the section sync error, and/or why it occurred

  • SectionError_Description -a description of the section sync error

  • SectionError_Tag -indicate where in the code throws the section sync error

  • SectionError_Type -the type of the section sync error, for example, Win32Error, etc.

  • Success -is the notebook sync successful or not

  • SyncDestinationType -sync destination type, that is, OneDrive or SharePoint

  • SyncId -a number unique to each notebook sync

  • SyncWasFirstInSession -is this sync the first sync in current session

  • SyncWasUserInitiated -is this sync user initiated or not

  • TenantId -SharePoint tenant ID

  • TimeSinceLastAttemptedSync -time since last notebook sync attempt

  • TimeSinceLastSuccessfulSync -time since last successful notebook sync

Office.OneNote.System.AppLifeCycle.AppLaunch

The critical signal used to ensure OneNote users can successfully launch the app. The telemetry is used to ensure critical regression detection for OneNote app and service health. If users can't launch the app in our performance window, this would trigger a high severity incident.

The following fields are collected: None

Office.Outlook.Desktop.AccountConfiguration.CreateAccountResult

Result of adding an account to Outlook in a new profile, from the Office Backstage, or from the account settings dialog. The data is actively monitored to ensure we don't see any spikes in failures. We also analyze the data to find areas of improvement. We aim to improve this success rate with each release.

The following fields are collected:

  • AccountCreationResult – The result (success, failure, cancellation, etc.) of adding the account to Outlook.

  • AccountCreationTime – time taken to attempt account creation

  • AccountInfoSource - account settings source (for example, AutoDiscover, GuessSmart, AutoDetect, etc.)

  • AccountType – The type of account being configured.

  • HashedEmailAddress – hashed email address

  • ShowPasswordPageFlightEnabled - indicator if ShowPopImapPasswordPage flight is enabled

Office.Outlook.Desktop.AccountConfiguration.RepairAccountResult

Result of repairing an account or changing advanced account settings. The data is actively monitored to ensure we don't see any spikes in failures. We also analyze the data to find areas of improvement. Since this a new (refactored) experience we want to make sure we got this right.

The following fields are collected:

  • AccountInfoSource - account info source for the account used to attempt repair

  • AccountType - type of account for which account repair was attempted

  • HashedEmailAddress - hashed email address

  • ManualRepairRequested - indicator if manual repair was requested

  • Result - result of attempt to repair account. For example: "Success" or "Fail_SaveChangesToAccount"

Office.Outlook.Desktop.AccountConfiguration.UpdatePasswordResult

Result of updating an account's password from the Account Settings dropdown. The data is actively monitored to ensure we don't see any spikes in failures. We also analyze the data to find areas of improvement. Since this a new (refactored) experience we want to make sure we got this right.

The following fields are collected:

  • AccountType - type of account for which updating password was attempted

  • HashedEmailAddress - hashed email address

  • Result - result of attempt to update password. For example: "Success" or "Fail_AllowLessSecureAppsDisabled"

Office.Outlook.Desktop.Stores.CreateNewStore

Collects the result of creating a new store (with type and version), and the result code. We actively monitor this event to track the health a user's ability to sync and store mail locally, archive mails (in a PST), or use Groups.

The following fields are collected:

  • Standard HVA Activity with custom payload

  • StoreType – The type of store created OST/PST/NST

  • StoreVersion – The store version created Small/Large/Tardis

Office.Outlook.Mac.AccountAddWorkflow

Result of adding an account in Outlook. The data is monitored to ensure we don't see any spikes in failures. We also analyze the data to find areas of improvement. We aim to improve this success rate with each release.

The following fields are collected:

  • AccountConfigMethod - the account configuration method

  • AccountType - the type of account being configured

  • AccountWorkflowSession - session where account workflow is attempted

  • SessionDuration - duration of session

  • ThreadId - identifier for the thread

Office.Outlook.Mac.AccountOnboardingFlow

Result of adding an account in Outlook using new account configuration experience. The data is monitored to ensure we don't see any spikes in failures. We also analyze the data to find areas of improvement. We aim to improve this success rate with each release.

The following fields are collected:

  • AccountConfigAutoSignIn - automatic account configuration set by admin

  • AccountConfigDomain - domain specified during account configuration

  • AccountConfigEntryPoint - entry point where user entered account configuration

  • AccountConfigErrorCode - error code encountered during account configuration

  • AccountConfigErrorString - error encountered during account configuration

  • AccountConfigMethod - account configuration method

  • AccountConfigPhase - current step of account configuration workflow

  • AccountConfigPhaseFrom - beginning step of account configuration workflow

  • AccountConfigPhaseTo - last step of account configuration workflow

  • AccountType - type of account being configured

  • AccountWorkflowSession - session where account workflow is attempted

  • SessionDuration - duration of session

Office.Outlook.Mac.DeleteAccountUsage

Result of deleting an account in Outlook. The data is monitored to ensure we don't see any spikes in failures. We also analyze the data to find areas of improvement. We aim to improve this success rate with each release.

The following fields are collected:

  • AccountType - type of account being configured

  • AccountID - account identifier

  • DeprovisionAccount - indicates whether account is removed from server

  • IsFastDelete - indicates whether account is deleted on background thread

Office.PowerPoint.Copilot.TriggerHandoff

This event is triggered when the user launches "powerpoint.exe /HOFF <some id>". The data is used to denote whether the ID was empty or not and whether the app launched successfully or not. We aren't able to evaluate the success of the Copilot handoff feature if we don't know whether there was an empty handoff ID and whether the app launched successfully.

The following fields are collected:

  • App - The application process sending the event.

  • AppInfo_Language – The language the application is running under.

  • AppVersionLong – The application version.

  • Channel – The preference for audience.

  • DeviceID – The device identifier.

  • DeviceInfo_NetworkType – The type of network (Wi-Fi, Wired, Unknown).

  • DeviceInfo_OsBuild – The version of the operating system.

  • IsHandoffIDEmpty – Whether the handoff ID is empty or not.

  • PipelineInfo_ClientCountry – The device country (based on IP address).

  • PipelineInfo_ClientIp – The first three octets of the IP address.

  • SessionId – The identifier for the session.

  • Success – Whether the app successfully loaded.

Office.PowerPoint.DocOperation.Close

Collected when PowerPoint presentations are closed. It contains the information needed to be able to properly investigate and diagnose issues that happen through the close process, which entail persisting and syncing the user's data. Microsoft uses this data to ensure that close is working as expected and user content is successfully being persisted.

The following fields are collected:

  • Data_AddDocTelemetryResult:long - Does this log entry have all necessary document telemetry (Data_Doc_* fields)? If not, why?

  • Data_AutoSaveDisabledReasons:string - Predefined set of values of why was autosave disabled on this document? (Merge error, Save error, Group policy etc.)

  • Data_CloseReason:long - How was close performed? Closing document? Closing app?

  • Data_CppUncaughtExceptionCount:long - Number of unhandled exceptions

  • Data_DetachedDuration:long - Time for which Activity was detached/not running

  • Data_Doc_AccessMode:long - How was this document opened (Read only | read write)

  • Data_Doc_AssistedReadingReasons:long - Predefined set of values of why document was opened in assisted reading mode

  • Data_Doc_AsyncOpenKind:long – Indicates whether a cached version of the cloud document was opened and which asynchronous refresh logic was used.

  • Data_Doc_ChunkingType:long - How is document stored in SharePoint

  • Data_Doc_EdpState:long - Enterprise Data Protection state of document

  • Data_Doc_Ext:string - Document extension

  • Data_Doc_Extension:string - Document extension

  • Data_Doc_FileFormat:long - Predefined set of values of format of file (more granular than extension)

  • Data_Doc_Fqdn:string - Where is document stored (SharePoint.com, live.net), only available for Office 365 domains

  • Data_Doc_FqdnHash:string - Hash of where document is stored

  • Data_Doc_IdentityTelemetryId:string - Unique GUID of user

  • Data_Doc_IdentityUniqueId:string - Unique identifier of identity that was used for Shared Documents action

  • Data_Doc_IOFlags:long - Bitmask for various IO-related flags for a given document

  • Data_Doc_IrmRights:long - Predefined set of values of what type of Information Rights Management is applied on this document (Forward, Reply, SecureReader, Edit etc.)

  • Data_Doc_IsCloudCollabEnabled:bool - True if the "IsCloudCollabEnabled" HTTP header has already been received from an OPTIONS request.

  • Data_Doc_IsIncrementalOpen:bool - Was document opened incrementally (new feature that opens document without needing to download entire document)

  • Data_Doc_IsOcsSupported:bool - Is Document supports co-authoring using new OCS service

  • Data_Doc_IsOpeningOfflineCopy:bool - verifies if document is being opened from local cache

  • Data_Doc_IsSyncBacked:bool - verifies if document is being opened from folder that is using OneDrive sync back app

  • Data_Doc_Location:long - Predefined set of values of where document is stored (Local, SharePoint, WOPI, Network etc.)

  • Data_Doc_LocationDetails:long - Predefined set of values of more detailed location (Temp folder, downloads folder, One Drive Documents, One Drive Pictures etc.)

  • Data_Doc_NumberCoAuthors:long - Number of co-authors at the time of opening of a document

  • Data_Doc_PasswordFlags:long - Predefined set of values of how document is encrypted with password (None, password to read, password to edit)-

  • Data_Doc_ReadOnlyReasons:long - Predefined set of values of why this document was marked read only (Locked on server, final document, password protected to edit etc.)

  • Data_Doc_ResourceIdHash:string - Hash of resource identifier for documents stored in cloud

  • Data_Doc_RtcType - Indicates how the real-time channel (RTC) was set up for current file (Disabled, unsupported, on demand, always on, etc.).

  • Data_Doc_ServerDocId:string - immutable identifier for documents stored in cloud

  • Data_Doc_ServerProtocol:long - Predefined set of values of which protocol is used to talk to server (Http, Cobalt, WOPI etc.)

  • Data_Doc_ServerType:long - Predefined set of values of type of server (SharePoint, DropBox, WOPI)

  • Data_Doc_ServerVersion:long - verifies if server is based off Office14, Office15, or Office 16

  • Data_Doc_SessionId:long - generated GUID that Identifies the instance of the document within the same process session

  • Data_Doc_SharePointServiceContext:string - An opaque string, typically GridManagerID.FarmID. Useful for correlating client-side and server-side log

  • Data_Doc_SizeInBytes:long - Document size in bytes

  • Data_Doc_SpecialChars:long - Bitmask indicating special chars in the document's URL or Path

  • Data_Doc_StorageProviderId:string - A string that identifies the document's storage provider, like "DropBox"

  • Data_Doc_StreamAvailability:long - Predefined set of values of status of document Stream(available, permanently disabled, not available)

  • Data_Doc_UrlHash:string - hash of full URL of documents stored in cloud

  • Data_Doc_UsedWrsDataOnOpen:bool - true if the file was opened incrementally using pre cached WRS data on the host

  • Data_Doc_WopiServiceId:string - WOPI Service identifier, for example "Dropbox"

  • Data_DocHasStorage:bool - Does this document have local storage?

  • Data_fLifeguarded:bool - Was document ever lifeguarded (feature to fix document errors by themselves without prompting user)?

  • Data_IsDocAutoSaveable:bool - Is presentation auto saveable?

  • Data_IsDocDirty:bool - Does presentation have changes that aren't yet saved?

  • Data_IsNewDoc:bool - Is new document or existing

  • Data_IsRecoveredDoc:bool - Is document recovered one? (If prior session crashed, we show document recovery pane on next session)

  • Data_NewDocDiscarded:bool - Was new presentation discarded without being saved

  • Data_OCSClosingDlgCanceled:bool - If upload is pending on OCS while user closes document, dialog is popped up to user to wait. Which option user chose?

  • Data_OCSClosingDlgExpired:bool - Did dialog expire (after 1 minute) on its own?

  • Data_OCSClosingStatus:long - What's final status of OCS (In CSI, Closable, In OCS Transition, In CSI transition, etc.)

  • Data_OCSClosingWaitDurationMS:long - How much time user had to wait for OCS to upload

  • Data_OCSHandleTransitionResult:long - Predefined set of values of result of transition performed during close (Already tried, continue to close, etc.)

  • Data_ServerDocId:string - GUID to uniquely identify a document

  • Data_StopwatchDuration:long - Total time for Activity

  • Data_UserContinuedZRTClose:bool - Upon showing dialog on close, did user selected 'Continue' to close?

Office.PowerPoint.DocOperation.NewDocument

Collected when PowerPoint creates a new presentation. Includes success failure and performance metrics.

This information is used to ensure we can create files successfully and with no degradation in performance.

The following fields are collected:

  • NewDocumentType – Whether new document is created from template or just created blank?

  • FLifeguarded – Is document life guarded (feature that restores corrupt document state without prompting user)

Office.PowerPoint.DocOperation.OpenCompleteProtocol

Collected when PowerPoint opens presentations. It contains the information needed to be able to properly investigate and diagnose issues that happen through the end stages of the open process.

Microsoft uses this data to ensure the feature is working as expected and there's no degradation to opening presentations.

The following fields are collected:

  • Data_AntiVirusScanMethod:long - Predefined set of values of type of AntiVirus scanned (IOAV, AMSI, None etc.)

  • Data_AntiVirusScanStatus:long - Predefined set of values of anti-virus scan that happens for every document opened (NoThreatsDetected, Failed, MalwareDetected etc.)

  • Data_CloseAndReopen:bool - Was this document closed and reopened?

  • Data_ClpDocHasDrmDoc:bool - Whether the document has a DRM document

  • Data_ClpDocHasIdentity:bool - Whether the document has identity info (used to get and set sensitivity labels)

  • Data_ClpDocHasSessionMetadata:bool – Whether the document has working sensitivity label metadata from the session

  • Data_ClpDocHasSpoMetadata:bool - Whether the document has sensitivity label metadata from SPO via IMetadataCache

  • Data_ClpDocHasSpoPackage:bool – Whether the document has sensitivity label metadata from SPO via IPackage

  • Data_ClpDocIsProtected:bool - Whether or not the document is protected by IRM

  • Data_ClpDocMetadataSource:int - Enum specifying where sensitivity label metadata is from (IRM, OPC part, Sharepoint etc.)

  • Data_ClpDocNeedsUpconversion:bool - Whether the document needs to upconvert sensitivity label data from the custom.xml part

  • Data_ClpDocNumFailedSetLabels:int - Count of sensitivity labels that failed to set on the document

  • Data_ClpDocSessionMetadataDirty:bool - Whether the document has working sensitivity label metadata that has been dirtied

  • Data_ClpDocWasInTrustBoundary:bool – Whether the document was in the trust boundary (allowing for coauthoring on documents protected by sensitivity labels)

  • Data_DetachedDuration:long - Time for which Activity was detached/not running

  • Data_Doc_AccessMode:long - How was this document opened (Read only | read write)

  • Data_Doc_AssistedReadingReasons:long - Predefined set of values of why document was opened in assisted reading mode

  • Data_Doc_AsyncOpenKind:long – Indicates whether a cached version of the cloud document was opened and which asynchronous refresh logic was used.

  • Data_Doc_ChunkingType:long - How is document stored in SharePoint

  • Data_Doc_EdpState:long - Enterprise Data Protection state of document

  • Data_Doc_Ext:string - Document extension

  • Data_Doc_Extension:string - Document extension

  • Data_Doc_FileFormat:long - Predefined set of values of format of file (more granular than extension)

  • Data_Doc_Fqdn:string - Where is document stored (SharePoint.com, live.net), only available for Office 365 domains

  • Data_Doc_FqdnHash:string - Hash of where document is stored

  • Data_Doc_IdentityTelemetryId:string - Unique GUID of user

  • Data_Doc_IdentityUniqueId:string - Unique identifier of identity that was used for Shared Documents action

  • Data_Doc_IOFlags:long - Bitmask for various IO-related flags for a given document

  • Data_Doc_IrmRights:long - Predefined set of values of what type of Information Rights Management is applied on this document (Forward, Reply, SecureReader, Edit etc.)

  • Data_Doc_IsCloudCollabEnabled:bool - True if the "IsCloudCollabEnabled" HTTP header has already been received from an OPTIONS request.

  • Data_Doc_IsIncrementalOpen:bool - Was document opened incrementally (new feature that opens document without needing to download entire document)

  • Data_Doc_IsOcsSupported:bool - Is Document supports co-authoring using new OCS service

  • Data_Doc_IsOpeningOfflineCopy:bool - Is document being opened from local cache?

  • Data_Doc_IsSyncBacked:bool - Is document opened from folder that is using OneDrive sync back app

  • Data_Doc_Location:long - Predefined set of values of where document is stored (Local, SharePoint, WOPI, Network etc.)

  • Data_Doc_LocationDetails:long - Predefined set of values of more detailed location (Temp folder, downloads folder, One Drive Documents, One Drive Pictures etc.)

  • Data_Doc_NumberCoAuthors:long - Number of co-authors at the time of opening of a document

  • Data_Doc_PasswordFlags:long - Predefined set of values of how document is encrypted with password (None, password to read, password to edit)-

  • Data_Doc_ReadOnlyReasons:long - Predefined set of values of why this document was marked read only (Locked on server, final document, password protected to edit etc.)

  • Data_Doc_ResourceIdHash:string - Hash of resource identifier for documents stored in cloud

  • Data_Doc_RtcType - Indicates how the real-time channel (RTC) was set up for current file (Disabled, unsupported, on demand, always on, etc.).

  • Data_Doc_ServerDocId:string - immutable identifier for documents stored in cloud

  • Data_Doc_ServerProtocol:long - Predefined set of values of which protocol is used to talk to server (Http, Cobalt, WOPI etc.)

  • Data_Doc_ServerType:long - Predefined set of values of type of server (SharePoint, DropBox, WOPI)

  • Data_Doc_ServerVersion:long - verifies if server is based off Office14, Office15, or Office 16

  • Data_Doc_SessionId:long - generated GUID that Identifies the instance of the document within the same process session

  • Data_Doc_SharePointServiceContext:string - An opaque string, typically GridManagerID.FarmID. Useful for correlating client side and server-side logs

  • Data_Doc_SizeInBytes:long - Document size in bytes

  • Data_Doc_SpecialChars:long - Bitmask indicating special chars in the document's URL or Path

  • Data_Doc_StorageProviderId:string - A string that identifies the document's storage provider, like "DropBox"

  • Data_Doc_StreamAvailability:long - Predefined set of values of status of document Stream(available, permanently disabled, not available)

  • Data_Doc_UrlHash:string - hash of full URL of documents stored in cloud

  • Data_Doc_UsedWrsDataOnOpen:bool - true if the file was opened incrementally using pre cached WRS data on the host

  • Data_Doc_WopiServiceId:string - WOPI Service identifier, for example "Dropbox"

  • Data_ExecutionCount:long - How many times we executed IncOpen protocol before executing this (OpenComplete) protocol

  • Data_FailureComponent:long - Predefined set of values of which component caused this protocol to fail? (Conflict, CSI, Internal etc.)

  • Data_FailureReason:long - Predefined set of values of what's the failure reason (FileIsCorrupt, BlockedByAntivirus etc.)

  • Data_FullDownloadRoundTripCount:long - The number of roundtrips to the server taken to download the entire document.

  • Data_IsProtocolRunInIncOpenMode:bool - Was the protocol run for an incremental download, which is a download where parts of the document were downloaded after initially showing it to the user.

  • Data_MethodId:long - Internally which line of code was last one to be executed

  • Data_StopwatchDuration:long - Total time for Activity

  • Data_TimeToEdit:long - Time it took for document to become editable

  • Data_TimeToView:long - Time it took for first slide of document to be rendered

  • Data_UnhandledException:bool - Any unhandled native exception?

Office.PowerPoint.DocOperation.Save

Collected whenever PowerPoint performs a save using the modern code path. Includes success or failure result type of save performance metrics and relevant document metadata. Failures in save can result in data loss. Microsoft uses this data to ensure the feature is working as expected and user content is successfully being persisted.

The following fields are collected:

  • Data_AddDocTelemetryResult:long - Does this log entry have all necessary document telemetry (Data_Doc_* fields)? If not, why?

  • Data_BeforeSaveEvent:long - Time taken to raise Document Before Save Event

  • Data_CheckDownRevSaveTimeMS:long - Time taken to check revision

  • Data_CheckMacroSaveTimeMS:long - Time taken to save macros

  • Data_ClearAutoSaveTimeMS:long - Time taken to clear AutoSave flag

  • Data_ClearDirtyFlagTimeMS:long - Time taken to clear document dirty flag

  • Data_CloneDocumentTimeMS:long - Time taken to clone document before starting the save

  • Data_ClpDocHasDrmDoc:bool - Whether the document has a DRM document

  • Data_ClpDocHasIdentity:bool - Whether the document has identity info (used to get and set sensitivity labels)

  • Data_ClpDocHasSessionMetadata:bool – Whether the document has working sensitivity label metadata from the session

  • Data_ClpDocHasSpoMetadata:bool - Whether the document has sensitivity label metadata from SPO via IMetadataCache

  • Data_ClpDocHasSpoPackage:bool – Whether the document has sensitivity label metadata from SPO via IPackage

  • Data_ClpDocIsProtected:bool - Whether or not the document is protected by IRM

  • Data_ClpDocMetadataSource:int - Enum specifying where sensitivity label metadata is from (IRM, OPC part, Sharepoint etc.)

  • Data_ClpDocNeedsUpconversion:bool - Whether the document needs to upconvert sensitivity label data from the custom.xml part

  • Data_ClpDocNumFailedSetLabels:int - Count of sensitivity labels that failed to set on the document

  • Data_ClpDocSessionMetadataDirty:bool - Whether the document has working sensitivity label metadata that has been dirtied

  • Data_ClpDocWasInTrustBoundary:bool – Whether the document was in the trust boundary (allowing for coauthoring on documents protected by sensitivity labels)

  • Data_CommitTransactionTimeMS:long - Time taken to commit the save transaction

  • Data_CppUncaughtExceptionCount:long - Uncaught native exceptions while activity was running

  • Data_DetachedDuration:long - Time for which Activity was detached/not running

  • Data_Doc_AccessMode:long - How was this document opened (Read only | read write)

  • Data_Doc_AssistedReadingReasons:long - Predefined set of values of why document was opened in assisted reading mode

  • Data_Doc_AsyncOpenKind:long – Indicates whether a cached version of the cloud document was opened and which asynchronous refresh logic was used.

  • Data_Doc_ChunkingType:long - How is document stored in SharePoint

  • Data_Doc_EdpState:long - Enterprise Data Protection state of document

  • Data_Doc_Ext:string - Document extension

  • Data_Doc_Extension:string - Document extension

  • Data_Doc_FileFormat:long - Predefined set of values of format of file (more granular than extension)

  • Data_Doc_Fqdn:string - Where is document stored (SharePoint.com, live.net), only available for Office 365 domains

  • Data_Doc_FqdnHash:string - Hash of where document is stored

  • Data_Doc_IdentityTelemetryId:string - Unique GUID of user

  • Data_Doc_IdentityUniqueId:string - Unique identifier of identity that was used for Shared Documents action

  • Data_Doc_IOFlags:long - Bitmask for various IO-related flags for a given document

  • Data_Doc_IrmRights:long - Predefined set of values of what type of Information Rights Management is applied on this document (Forward, Reply, SecureReader, Edit etc.)

  • Data_Doc_IsCloudCollabEnabled:bool - True if the "IsCloudCollabEnabled" HTTP header has already been received from an OPTIONS request.

  • Data_Doc_IsIncrementalOpen:bool - Was document opened incrementally (new feature that opens document without needing to download entire document)

  • Data_Doc_IsOcsSupported:bool - Is Document supports co-authoring using new OCS service

  • Data_Doc_IsOpeningOfflineCopy:bool - verifies if document being is opened from local cache

  • Data_Doc_IsSyncBacked:bool - Is document opened from folder that is using OneDrive sync back app

  • Data_Doc_Location:long - Predefined set of values of where document is stored (Local, SharePoint, WOPI, Network etc.)

  • Data_Doc_LocationDetails:long - Predefined set of values of more detailed location (Temp folder, downloads folder, One Drive Documents, One Drive Pictures etc.)

  • Data_Doc_NumberCoAuthors:long - Number of co-authors at the time of opening of a document

  • Data_Doc_PasswordFlags:long -Predefined set of values of how document is encrypted with password (None, password to read, password to edit)

  • Data_Doc_ReadOnlyReasons:long - Predefined set of values of why this document was marked read only (Locked on server, final document, password protected to edit etc.)

  • Data_Doc_ResourceIdHash:string - Hash of resource identifier for documents stored in cloud

  • Data_Doc_RtcType - Indicates how the real-time channel (RTC) was set up for current file (Disabled, unsupported, on demand, always on, etc.).

  • Data_Doc_ServerDocId:string - immutable identifier for documents stored in cloud

  • Data_Doc_ServerProtocol:long - Predefined set of values of which protocol is used to talk to server (Http, Cobalt, WOPI etc.)

  • Data_Doc_ServerType:long - Predefined set of values of type of server (SharePoint, DropBox, WOPI)

  • Data_Doc_ServerVersion:long - verifies if server is based off Office14, Office15, or Office 16

  • Data_Doc_SessionId:long - generated GUID that Identifies the instance of the document within the same process session

  • Data_Doc_SharePointServiceContext:string - An opaque string, typically GridManagerID.FarmID. Useful for correlating client-side and server-side logs

  • Data_Doc_SizeInBytes:long - Document size in bytes

  • Data_Doc_SpecialChars:long - Bitmask indicating special chars in the document's URL or Path

  • Data_Doc_StorageProviderId:string - A string that identifies the document's storage provider, like "DropBox"

  • Data_Doc_StreamAvailability:long - Predefined set of values of status of document Stream(available, permanently disabled, not available)

  • Data_Doc_UrlHash:string - hash of full URL of documents stored in cloud

  • Data_Doc_UsedWrsDataOnOpen:bool - true if the file was opened incrementally using pre cached WRS data on the host

  • Data_Doc_WopiServiceId:string - WOPI Service identifier, for example "Dropbox"

  • Data_DurationUAEOnSaveStartedMs:long - Time taken for Unknown App Exit during save

  • Data_EnsureSaveTransactionTimeMS:long - Time taken to ensure save transaction is created if doesn't exist already

  • Data_FailureComponent:long- Predefined set of values of which component caused this protocol to fail? (Conflict, CSI, Internal etc.)

  • Data_FailureReason:long - Predefined set of values of what's the failure reason (FileIsCorrupt, BlockedByAntivirus etc.)

  • Data_fLifeguarded:bool - Was document ever lifeguarded (feature to fix document errors by themselves without prompting user)?

  • Data_HandleEnsureContentType:long - Time taken to ensure all the content types are correct

  • Data_HandleEnsureContentTypeTimeMS:long - Time taken to ensure all the content types are correct

  • Data_HasEmbeddedFont:bool - Does this document have embedded fonts?

  • Data_InitializeSaveTimeMS:long - Time taken to initialize document content to begin save

  • Data_InOCSTransition:bool - Is this save performed for transitioning to OCS

  • Data_IsSavingWithEmbeddedFont:bool - Does this document have embedded fonts?

  • Data_MethodId:long - Internally which line of code was last one to be executed

  • Data_PerformEmbedFontsTimeMS:long - Time taken to serialize embedded fonts

  • Data_PerformModernSaveTimeMS:long - Time taken to perform modern save (new code)

  • Data_PerformPostSaveTimeMS:long - Time taken to perform post save functions (notifications, undo entries)

  • Data_PrepareForSaveTimeMS:long - Time taken to start save

  • Data_RaiseDocumentBeforeSaveEventTimeMS:long - Time taken to raise the BeforeSave event

  • Data_ReflectDocumentChangeTimeMS:long - Time taken to reflect saved changes to UI (repopulate thumbnails etc.)

  • Data_ReportStartTimeMS:long - Time taken to finish initializing telemetry for save

  • Data_ReportSuccessTimeMS:long - Time taken to finish reporting successful save

  • Data_ResetDirtyFlagOnErrorTimeMS:long - Time taken to reset document dirty flag on error

  • Data_SaveReason:long - Predefined set of values of why this save was performed? (AutoSave, ToOCSTransitionSave, ToCSITransitionSave etc.)

  • Data_SaveType:long - Predefined set of values of save type (SaveAs, Publish, Manual, OMSave etc.)

  • Data_SavingWithFont:bool- Are we saving document with new embedded fonts?

  • Data_ScrubClonedDocumentTimeMS:long - Time taken to remove personal information on cloned copy of document

  • Data_StopwatchDuration:long - Total time for Activity

  • Data_TransactionType:long - Is it Save or MergeAndSave transaction?

Office.PowerPoint.DocOperation.SaveAs

Collected whenever PowerPoint performs a Save As. Includes success or failure result type of save performance metrics and relevant document metadata. Failures in save can result in data loss. Microsoft uses this data to ensure the feature is working as expected and user content is successfully being persisted.

The following fields are collected:

  • Data_AddDocTelemetryResult:long - Does this log entry have all necessary document telemetry (Data_Doc_* fields)? If not, why?

  • Data_ClpDocHasDrmDoc:bool - Whether the document has a DRM document

  • Data_ClpDocHasIdentity:bool - Whether the document has identity info (used to get and set sensitivity labels)

  • Data_ClpDocHasSessionMetadata:bool – Whether the document has working sensitivity label metadata from the session

  • Data_ClpDocHasSpoMetadata:bool - Whether the document has sensitivity label metadata from SPO via IMetadataCache

  • Data_ClpDocHasSpoPackage:bool – Whether the document has sensitivity label metadata from SPO via IPackage

  • Data_ClpDocIsProtected:bool - Whether or not the document is protected by IRM

  • Data_ClpDocMetadataSource:int - Enum specifying where sensitivity label metadata is from (IRM, OPC part, Sharepoint etc.)

  • Data_ClpDocNeedsUpconversion:bool - Whether the document needs to upconvert sensitivity label data from the custom.xml part

  • Data_ClpDocNumFailedSetLabels:int - Count of sensitivity labels that failed to set on the document

  • Data_ClpDocSessionMetadataDirty:bool - Whether the document has working sensitivity label metadata that has been dirtied

  • Data_ClpDocWasInTrustBoundary:bool – Whether the document was in the trust boundary (allowing for coauthoring on documents protected by sensitivity labels)

  • Data_CppUncaughtExceptionCount:long - Uncaught native exceptions while activity was running

  • Data_DetachedDuration:long - Time for which Activity was detached/not running

  • Data_DstDoc_AccessMode:long - How was this document opened (Read only | read write)

  • Data_DstDoc_AssistedReadingReasons:long - Predefined set of values of why document was opened in assisted reading mode

  • Data_DstDoc_AsyncOpenKind:long – Indicates whether a cached version of the new cloud document was opened and which asynchronous refresh logic was used.

  • Data_DstDoc_ChunkingType:long - How is document stored in SharePoint

  • Data_DstDoc_EdpState:long - Enterprise Data Protection state of document

  • Data_DstDoc_Ext:string - Document extension

  • Data_DstDoc_Extension:string - Document extension

  • Data_DstDoc_FileFormat:long - Predefined set of values of format of file (more granular than extension)

  • Data_DstDoc_Fqdn:string - Where is document stored (SharePoint.com, live.net), only available for Office 365 domains

  • Data_DstDoc_FqdnHash:string - Hash of where document is stored

  • Data_DstDoc_IdentityTelemetryId:string - Unique GUID of user

  • Data_DstDoc_IdentityUniqueId:string - Unique identifier of identity that was used for Shared Documents action

  • Data_DstDoc_IOFlags:long - Bitmask for various IO-related flags for a given document

  • Data_DstDoc_IrmRights:long - Predefined set of values of what type of Information Rights Management is applied on this document (Forward, Reply, SecureReader, Edit etc.)

  • Data_DstDoc_IsCloudCollabEnabled:bool - True if the "IsCloudCollabEnabled" HTTP header has already been received from an OPTIONS request.

  • Data_DstDoc_IsIncrementalOpen:bool - Was document opened incrementally (new feature that opens document without needing to download entire document)

  • Data_DstDoc_IsOcsSupported:bool - Is Document supports co-authoring using new OCS service

  • Data_DstDoc_IsOpeningOfflineCopy:bool - verifies if document is being opened from local cache

  • Data_DstDoc_IsSyncBacked:bool - Is document opened from folder that is using OneDrive sync back app

  • Data_DstDoc_Location:long - Predefined set of values of where document is stored (Local, SharePoint, WOPI, Network etc.)

  • Data_DstDoc_LocationDetails:long - Predefined set of values of more detailed location (Temp folder, downloads folder, One Drive Documents, One Drive Pictures etc.)

  • Data_DstDoc_NumberCoAuthors:long - Number of co-authors at the time of opening of a document

  • Data_DstDoc_PasswordFlags:long - Predefined set of values of how document is encrypted with password (None, password to read, password to edit)

  • Data_DstDoc_ReadOnlyReasons:long - Predefined set of values of why this document was marked read only (Locked on server, final document, password protected to edit, etc.)

  • Data_DstDoc_ResourceIdHash:string - Hash of resource identifier for documents stored in cloud

  • Data_DstDoc_ServerDocId:string - immutable identifier for documents stored in cloud

  • Data_DstDoc_ServerProtocol:long - Predefined set of values of which protocol is used to talk to server (Http, Cobalt, WOPI etc.)

  • Data_DstDoc_ServerType:long - Predefined set of values of type of server (SharePoint, DropBox, WOPI)

  • Data_DstDoc_ServerVersion:long - verifies if server is based off Office14, Office15, or Office 16

  • Data_DstDoc_SessionId:long - generated GUID that Identifies the instance of the document within the same process session

  • Data_DstDoc_SharePointServiceContext:string - An opaque string, typically GridManagerID.FarmID. Useful for correlating client side and server-side logs

  • Data_DstDoc_SizeInBytes:long - Document size in bytes

  • Data_DstDoc_SpecialChars:long - Bitmask indicating special chars in the document's URL or Path

  • Data_DstDoc_StorageProviderId:string - A string that identifies the document's storage provider, like "DropBox"

  • Data_DstDoc_StreamAvailability:long - Predefined set of values of status of document Stream(available, permanently disabled, not available)

  • Data_DstDoc_UrlHash:string - hash of full URL of documents stored in cloud

  • Data_DstDoc_UsedWrsDataOnOpen:bool - true if the file was opened incrementally using pre cached WRS data on the host

  • Data_DstDoc_WopiServiceId:string - WOPI Service identifier, for example "Dropbox"

  • Data_FileType:long - Predefined set of values of internal type of file

  • Data_fLifeguarded:bool - Was document ever lifeguarded (feature to fix document errors by themselves without prompting user)?

  • Data_FWebCreated:bool - Does this document have WebCreator flag?

  • Data_SaveReason:long - Predefined set of values of why this save was performed? (AutoSave, ToOCSTransitionSave, ToCSITransitionSave, etc.)

  • Data_SaveType:long - Predefined set of values of save type (SaveAs, Publish, Manual, OMSave, etc.)

  • Data_SrcDoc_AccessMode:long - How was this document opened (Read only | read write)

  • Data_SrcDoc_AssistedReadingReasons:long - Predefined set of values of why document was opened in assisted reading mode

  • Data_SrcDoc_AsyncOpenKind:long – Indicates whether a cached version of the original cloud document was opened and which asynchronous refresh logic was used.

  • Data_SrcDoc_ChunkingType:long - How is document stored in SharePoint

  • Data_SrcDoc_EdpState:long - Enterprise Data Protection state of document

  • Data_SrcDoc_Ext:string - Document extension

  • Data_SrcDoc_Extension:string - Document extension

  • Data_SrcDoc_FileFormat:long - Predefined set of values of format of file (more granular than extension)

  • Data_SrcDoc_Fqdn:string - Where is document stored (SharePoint.com, live.net), only available for Office 365 domains

  • Data_SrcDoc_FqdnHash:string - Hash of where document is stored

  • Data_SrcDoc_IdentityTelemetryId:string - Unique GUID of user

  • Data_SrcDoc_IdentityUniqueId:string - Unique identifier of identity that was used for Shared Documents action

  • Data_SrcDoc_IOFlags:long - Bitmask for various IO-related flags for a given document

  • Data_SrcDoc_IrmRights:long - Predefined set of values of what type of Information Rights Management is applied on this document (Forward, Reply, SecureReader, Edit etc.)

  • Data_SrcDoc_IsCloudCollabEnabled:bool - True if the "IsCloudCollabEnabled" HTTP header has already been received from an OPTIONS request.

  • Data_SrcDoc_IsIncrementalOpen:bool - Was document opened incrementally (new feature that opens document without needing to download entire document)

  • Data_SrcDoc_IsOcsSupported:bool - Is Document supports co-authoring using new OCS service

  • Data_SrcDoc_IsOpeningOfflineCopy:bool - verifies if document is being opened from local cache

  • Data_SrcDoc_IsSyncBacked:bool - Is document opened from folder that is using OneDrive sync back app

  • Data_SrcDoc_Location:long - Predefined set of values of where document is stored (Local, SharePoint, WOPI, Network etc.)

  • Data_SrcDoc_LocationDetails:long - Predefined set of values of more detailed location (Temp folder, downloads folder, One Drive Documents, One Drive Pictures etc.)

  • Data_SrcDoc_NumberCoAuthors:long - Number of co-authors at the time of opening of a document

  • Data_SrcDoc_PasswordFlags:long - Predefined set of values of how document is encrypted with password (None, password to read, password to edit)

  • Data_SrcDoc_ReadOnlyReasons:long - Predefined set of values of why this document was marked read only (Locked on server, final document, password protected to edit, etc.)

  • Data_SrcDoc_ResourceIdHash:string - Hash of resource identifier for documents stored in cloud

  • Data_SrcDoc_ServerDocId:string - immutable identifier for documents stored in cloud

  • Data_SrcDoc_ServerProtocol:long - Predefined set of values of which protocol is used to talk to server (Http, Cobalt, WOPI etc.)

  • Data_SrcDoc_ServerType:long - Predefined set of values of type of server (SharePoint, DropBox, WOPI)

  • Data_SrcDoc_ServerVersion:long - verifies if server is based off Office14, Office15, or Office 16

  • Data_SrcDoc_SessionId:long - generated GUID that identifies the instance of the document within the same process session

  • Data_SrcDoc_SharePointServiceContext:string - An opaque string, typically GridManagerID.FarmID. Useful for correlating client side and server-side logs

  • Data_SrcDoc_SizeInBytes:long - Document size in bytes

  • Data_SrcDoc_SpecialChars:long - Bitmask indicating special chars in the document's URL or Path

  • Data_SrcDoc_StorageProviderId:string - A string that identifies the document's storage provider, like "DropBox"

  • Data_SrcDoc_StreamAvailability:long - Predefined set of values of status of document Stream(available, permanently disabled, not available)

  • Data_SrcDoc_UrlHash:string - hash of full URL of documents stored in cloud

  • Data_SrcDoc_UsedWrsDataOnOpen:bool - true if the file was opened incrementally using pre cached WRS data on the host

  • Data_SrcDoc_WopiServiceId:string - WOPI Service identifier, for example "Dropbox"

  • Data_StopwatchDuration:long - Total time for Activity

  • Data_TypeOfSaveDialog:long - Predefined set of values of Dialog (RUN_SAVEAS_DLG,RUN_SAVEMEDIA_DLG, RUN_SAVEAS_VIDEO_DLG etc.)

  • Data_WaitForSaveOrMergeSuccess:bool - SaveAs succeeded waiting for a background save or merge.

  • Data_WaitForSaveOrMergeTimeout:long - SaveAs timed out when waiting for a background save or merge.

  • DstDoc - New location of document

  • SrcDoc - Original location of document

Office.PowerPoint.DocOperation.SaveLegacy

Collected whenever PowerPoint performs a save using the legacy code path. Includes success or failure result type of save performance metrics and relevant document metadata. Failures in save can result in data loss. Microsoft uses this data to ensure the feature is working as expected and user content is successfully being persisted.

The following fields are collected:

  • Data_AddDocTelemetryResult:long - Does this log entry have all necessary document telemetry (Data_Doc_* fields)? If not, why?

  • Data_ClpDocHasDrmDoc:bool - Whether the document has a DRM document

  • Data_ClpDocHasIdentity:bool - Whether the document has identity info (used to get and set sensitivity labels)

  • Data_ClpDocHasSessionMetadata:bool – Whether the document has working sensitivity label metadata from the session

  • Data_ClpDocHasSpoMetadata:bool - Whether the document has sensitivity label metadata from SPO via IMetadataCache

  • Data_ClpDocHasSpoPackage:bool – Whether the document has sensitivity label metadata from SPO via IPackage

  • Data_ClpDocIsProtected:bool - Whether or not the document is protected by IRM

  • Data_ClpDocMetadataSource:int - Enum specifying where sensitivity label metadata is from (IRM, OPC part, Sharepoint etc.)

  • Data_ClpDocNeedsUpconversion:bool - Whether the document needs to upconvert sensitivity label data from the custom.xml part

  • Data_ClpDocNumFailedSetLabels:int - Count of sensitivity labels that failed to set on the document

  • Data_ClpDocSessionMetadataDirty:bool - Whether the document has working sensitivity label metadata that has been dirtied

  • Data_ClpDocWasInTrustBoundary:bool – Whether the document was in the trust boundary (allowing for coauthoring on documents protected by sensitivity labels)

  • Data_CppUncaughtExceptionCount:long - Uncaught native exceptions while activity was running

  • Data_DetachedDuration:long - Time for which Activity was detached/not running

  • Data_Doc_AccessMode:long - How was this document opened (Read only | read write)

  • Data_Doc_AssistedReadingReasons:long - Predefined set of values of why document was opened in assisted reading mode

  • Data_Doc_AsyncOpenKind:long – Indicates whether a cached version of the cloud document was opened and which asynchronous refresh logic was used.

  • Data_Doc_ChunkingType:long - How is document stored in SharePoint

  • Data_Doc_EdpState:long - Enterprise Data Protection state of document

  • Data_Doc_Ext:string - Document extension

  • Data_Doc_Extension:string - Document extension

  • Data_Doc_FileFormat:long - Predefined set of values of format of file (more granular than extension)

  • Data_Doc_Fqdn:string - Where is document stored (SharePoint.com, live.net), only available for Office 365 domains

  • Data_Doc_FqdnHash:string - Hash of where document is stored

  • Data_Doc_IdentityTelemetryId:string - Unique GUID of user

  • Data_Doc_IdentityUniqueId:string - Unique identifier of identity that was used for Shared Documents action

  • Data_Doc_IOFlags:long - Bitmask for various IO-related flags for a given document

  • Data_Doc_IrmRights:long - Predefined set of values of what type of Information Rights Management is applied on this document (Forward, Reply, SecureReader, Edit etc.)

  • Data_Doc_IsCloudCollabEnabled:bool - True if the "IsCloudCollabEnabled" HTTP header has already been received from an OPTIONS request.

  • Data_Doc_IsIncrementalOpen:bool - Was document opened incrementally (new feature that opens document without needing to download entire document)

  • Data_Doc_IsOcsSupported:bool - Is Document supports co-authoring using new OCS service

  • Data_Doc_IsOpeningOfflineCopy:bool - verifies if document is being opened from local cache

  • Data_Doc_IsSyncBacked:bool - Is document opened from folder that is using OneDrive sync back app

  • Data_Doc_Location:long - Predefined set of values of where document is stored (Local, SharePoint, WOPI, Network etc.)

  • Data_Doc_LocationDetails:long - Predefined set of values of more detailed location (Temp folder, downloads folder, One Drive Documents, One Drive Pictures etc.)

  • Data_Doc_NumberCoAuthors:long - Number of co-authors at the time of opening of a document

  • Data_Doc_PasswordFlags:long - Predefined set of values of how document is encrypted with password (None, password to read, password to edit)

  • Data_Doc_ReadOnlyReasons:long - Predefined set of values of why this document was marked read only (Locked on server, final document, password protected to edit, etc.)

  • Data_Doc_ResourceIdHash:string - Hash of resource identifier for documents stored in cloud

  • Data_Doc_RtcType - Indicates how the real-time channel (RTC) was set up for current file (Disabled, unsupported, on demand, always on, etc.).

  • Data_Doc_ServerDocId:string - immutable identifier for documents stored in cloud

  • Data_Doc_ServerProtocol:long - Predefined set of values of which protocol is used to talk to server (Http, Cobalt, WOPI etc.)

  • Data_Doc_ServerType:long - Predefined set of values of type of server (SharePoint, DropBox, WOPI)

  • Data_Doc_ServerVersion:long - verifies if server is based off Office14, Office15, or Office 16

  • Data_Doc_SessionId:long - generated GUID that Identifies the instance of the document within the same process session

  • Data_Doc_SharePointServiceContext:string - An opaque string, typically GridManagerID.FarmID. Useful for correlating client side and server-side logs

  • Data_Doc_SizeInBytes:long - Document size in bytes

  • Data_Doc_SpecialChars:long - Bitmask indicating special chars in the document's URL or Path

  • Data_Doc_StorageProviderId:string - A string that identifies the document's storage provider, like "DropBox"

  • Data_Doc_StreamAvailability:long - Predefined set of values of status of document Stream(available, permanently disabled, not available)

  • Data_Doc_UrlHash:string - hash of full URL of documents stored in cloud

  • Data_Doc_UsedWrsDataOnOpen:bool - true if the file was opened incrementally using pre cached WRS data on the host

  • Data_Doc_WopiServiceId:string - WOPI Service identifier, for example "Dropbox"

  • Data_DstDoc_AccessMode:long - How was this document opened (Read only | read write)

  • Data_DstDoc_AssistedReadingReasons:long - Predefined set of values of why document was opened in assisted reading mode

  • Data_DstDoc_AsyncOpenKind:long – Indicates whether a cached version of the new cloud document was opened and which asynchronous refresh logic was used.

  • Data_DstDoc_ChunkingType:long - How is document stored in SharePoint

  • Data_DstDoc_EdpState:long - Enterprise Data Protection state of document

  • Data_DstDoc_Ext:string - Document extension

  • Data_DstDoc_Extension:string - Document extension

  • Data_DstDoc_FileFormat:long - Predefined set of values of format of file (more granular than extension)

  • Data_DstDoc_Fqdn:string - Where is document stored (SharePoint.com, live.net), only available for Office 365 domains

  • Data_DstDoc_FqdnHash:string - Hash of where document is stored

  • Data_DstDoc_IdentityTelemetryId:string - Unique GUID of user

  • Data_DstDoc_IdentityUniqueId:string - Unique identifier of identity that was used for Shared Documents action

  • Data_DstDoc_IOFlags:long - Bitmask for various IO-related flags for a given document

  • Data_DstDoc_IrmRights:long - Predefined set of values of what type of Information Rights Management is applied on this document (Forward, Reply, SecureReader, Edit etc.)

  • Data_DstDoc_IsCloudCollabEnabled:bool - True if the "IsCloudCollabEnabled" HTTP header has already been received from an OPTIONS request.

  • Data_DstDoc_IsIncrementalOpen:bool - Was document opened incrementally (new feature that opens document without needing to download entire document)

  • Data_DstDoc_IsOcsSupported:bool - Is Document supports co-authoring using new OCS service

  • Data_DstDoc_IsOpeningOfflineCopy:bool - verifies if document is being opened from local cache

  • Data_DstDoc_IsSyncBacked:bool - Is document opened from folder that is using OneDrive sync back app

  • Data_DstDoc_Location:long - Predefined set of values of where document is stored (Local, SharePoint, WOPI, Network etc.)

  • Data_DstDoc_LocationDetails:long - Predefined set of values of more detailed location (Temp folder, downloads folder, One Drive Documents, One Drive Pictures etc.)

  • Data_DstDoc_NumberCoAuthors:long - Number of co-authors at the time of opening of a document

  • Data_DstDoc_PasswordFlags:long - Predefined set of values of how document is encrypted with password (None, password to read, password to edit)

  • Data_DstDoc_ReadOnlyReasons:long - Predefined set of values of why this document was marked read only (Locked on server, final document, password protected to edit etc.)

  • Data_DstDoc_ResourceIdHash:string - Hash of resource identifier for documents stored in cloud

  • Data_DstDoc_ServerDocId:string - immutable identifier for documents stored in cloud

  • Data_DstDoc_ServerProtocol:long - Predefined set of values of which protocol is used to talk to server (Http, Cobalt, WOPI etc.)

  • Data_DstDoc_ServerType:long - Predefined set of values of type of server (SharePoint, DropBox, WOPI)

  • Data_DstDoc_ServerVersion:long - verifies if server is based off Office14, Office15, or Office 16

  • Data_DstDoc_SessionId:long - generated GUID that Identifies the instance of the document within the same process session

  • Data_DstDoc_SharePointServiceContext:string - An opaque string, typically GridManagerID.FarmID. Useful for correlating client side and server-side logs

  • Data_DstDoc_SizeInBytes:long - Document size in bytes

  • Data_DstDoc_SpecialChars:long - Bitmask indicating special chars in the document's URL or Path

  • Data_DstDoc_StorageProviderId:string - A string that identifies the document's storage provider, like "DropBox"

  • Data_DstDoc_StreamAvailability:long - Predefined set of values of status of document Stream(available, permanently disabled, not available)

  • Data_DstDoc_UrlHash:string - hash of full URL of documents stored in cloud

  • Data_DstDoc_UsedWrsDataOnOpen:bool - true if the file was opened incrementally using pre cached WRS data on the host

  • Data_DstDoc_WopiServiceId:string - WOPI Service identifier, for example "Dropbox"

  • Data_FileType:long - Predefined set of values of internal type of file

  • Data_fLifeguarded:bool - Was document ever lifeguarded (feature to fix document errors by themselves without prompting user)?

  • Data_SaveReason:long - Predefined set of values of why this save was performed? (AutoSave, ToOCSTransitionSave, ToCSITransitionSave etc.)

  • Data_SaveType:long - Predefined set of values of save type (SaveAs, Publish, Manual, OMSave etc.)

  • Data_SrcDoc_AccessMode:long - How was this document opened (Read only | read write)

  • Data_SrcDoc_AssistedReadingReasons:long - Predefined set of values of why document was opened in assisted reading mode

  • Data_SrcDoc_AsyncOpenKind:long – Indicates whether a cached version of the original cloud document was opened and which asynchronous refresh logic was used.

  • Data_SrcDoc_ChunkingType:long - How is document stored in SharePoint

  • Data_SrcDoc_EdpState:long - Enterprise Data Protection state of document

  • Data_SrcDoc_Ext:string - Document extension

  • Data_SrcDoc_Extension:string - Document extension

  • Data_SrcDoc_FileFormat:long - Predefined set of values of format of file (more granular than extension)

  • Data_SrcDoc_Fqdn:string - Where is document stored (SharePoint.com, live.net), only available for Office 365 domains

  • Data_SrcDoc_FqdnHash:string - Hash of where document is stored

  • Data_SrcDoc_IdentityTelemetryId:string - Unique GUID of user

  • Data_SrcDoc_IdentityUniqueId:string - Unique identifier of identity that was used for Shared Documents action

  • Data_SrcDoc_IOFlags:long - Bitmask for various IO-related flags for a given document

  • Data_SrcDoc_IrmRights:long - Predefined set of values of what type of Information Rights Management is applied on this document (Forward, Reply, SecureReader, Edit etc.)

  • Data_SrcDoc_IsCloudCollabEnabled:bool - True if the "IsCloudCollabEnabled" HTTP header has already been received from an OPTIONS request.

  • Data_SrcDoc_IsIncrementalOpen:bool - Was document opened incrementally (new feature that opens document without needing to download entire document)

  • Data_SrcDoc_IsOcsSupported:bool - Is Document supports co-authoring using new OCS service

  • Data_SrcDoc_IsOpeningOfflineCopy:bool - verifies if document is being opened from local cache

  • Data_SrcDoc_IsSyncBacked:bool - Is document opened from folder that is using OneDrive sync back app

  • Data_SrcDoc_Location:long - Predefined set of values of where document is stored (Local, SharePoint, WOPI, Network etc.)

  • Data_SrcDoc_LocationDetails:long - Predefined set of values of more detailed location (Temp folder, downloads folder, One Drive Documents, One Drive Pictures, etc.)

  • Data_SrcDoc_NumberCoAuthors:long - Number of co-authors at the time of opening of a document

  • Data_SrcDoc_PasswordFlags:long - Predefined set of values of how document is encrypted with password (None, password to read, password to edit)

  • Data_SrcDoc_ReadOnlyReasons:long - Predefined set of values of why this document was marked read only (Locked on server, final document, password protected to edit, etc.)

  • Data_SrcDoc_ResourceIdHash:string - Hash of resource identifier for documents stored in cloud

  • Data_SrcDoc_ServerDocId:string - immutable identifier for documents stored in cloud

  • Data_SrcDoc_ServerProtocol:long - Predefined set of values of which protocol is used to talk to server (Http, Cobalt, WOPI etc.)

  • Data_SrcDoc_ServerType:long - Predefined set of values of type of server (SharePoint, DropBox, WOPI)

  • Data_SrcDoc_ServerVersion:long - verifies if server is based off Office14, Office15, or Office 16

  • Data_SrcDoc_SessionId:long - generated GUID that Identifies the instance of the document within the same process session

  • Data_SrcDoc_SharePointServiceContext:string - An opaque string, typically GridManagerID.FarmID. Useful for correlating client side and server-side logs

  • Data_SrcDoc_SizeInBytes:long - Document size in bytes

  • Data_SrcDoc_SpecialChars:long - Bitmask indicating special chars in the document's URL or Path

  • Data_SrcDoc_StorageProviderId:string - A string that identifies the document's storage provider, like "DropBox"

  • Data_SrcDoc_StreamAvailability:long - Predefined set of values of status of document Stream(available, permanently disabled, not available)

  • Data_SrcDoc_UrlHash:string - hash of full URL of documents stored in cloud

  • Data_SrcDoc_UsedWrsDataOnOpen:bool - true if the file was opened incrementally using pre cached WRS data on the host

  • Data_SrcDoc_WopiServiceId:string - WOPI Service identifier, for example "Dropbox"

  • Data_StopwatchDuration:long - Total time for Activity

  • Data_TypeOfSaveDialog:long - Predefined set of values of Dialog (RUN_SAVEAS_DLG, RUN_SAVEMEDIA_DLG, RUN_SAVEAS_VIDEO_DLG etc.)

  • Doc - current document for Save

  • DstDoc - New location of document (in case of SaveAs)

  • SrcDoc - Original location of document (in case of SaveAs)

Office.PowerPoint.PPT.Android.RehearseView.FeedbackReceived

This event is used to analyze the seen/tried/kept funnel of the feature. This event along with Seen and Tried event helps us determine if users are dropping out of the funnel. The data is used to determine into if users are dropping because of errors faced during the experience. This helps us maintain the health of the feature.

The following fields are collected:

  • None

Office.PowerPoint.PPT.Android.RehearseView.SessionStarted

This event is used to analyze the seen/tried/kept funnel of the feature. This event along with Seen and Kept event helps us figure out if users are dropping out of the funnel. This data is used to understand if users are dropping because of errors faced during experience. This helps us maintain the health of the feature.

The following fields are collected:

  • None

Office.PowerPoint.PPT.IOS.RehearseView

This event is denoting that user has stopped the rehearsal session. The data is used in combination with Office.PowerPoint.IOS.Android.RehearseView.StartSession as the first indicator of any crashes or errors that user faces.

The following fields are collected:

  • ConnectionCreationTime - time taken to create service side connections.

  • CountDownAlertTime - Time for which countdown alert was displayed.

  • CountdownInitTime – Time between slideshow load completed and countdown started.

  • CritiqueSummary - Summary of what all critiques user saw with their counts.

  • ExitEventCode - Code to identify under which scenario user exit out of rehearse session, whether it was error scenario or successful exit

  • FRETime - Time between FRE screen started to display until user dismissed it.

  • MicrophonePermissionTime - Time for which microphone permission alert was displayed until user selected one of the options.

  • PauseRehearsingCount - Count of how many times user clicked on pause rehearsal

  • RehearsalInitTime - Time taken by rehearsal to initialize

  • ResumeRehearsingCount - Count of how many times user clicked on resume rehearsal

  • Sessionid - This is speech front door session ID. This is used to debug service logs.

  • SlideshowViewLoadTime - Time taken by slideshow to load.

Office.PowerPoint.PPT.IOS.RehearseView.RehearsalSummaryPage

Event is triggered when summary page has finished loading. This event helps us capture the performance of the summary page. It tells how much time it takes for the rehearsal summary service page to load on the client. It's required to keep the feature performant.

The following fields are collected:

  • PayloadCreationTime - This is the time taken in milliseconds to create payload.

  • PostUrlCallTime - This is the time taken in milliseconds to send the post URL call.

  • RehearseSessionId - This is speech front door session ID. We can use this to debug service logs.

  • SummaryPageErrorReceived - This is a Boolean value that indicates if summary page was received or error occurred.

  • SummaryPageHtmlLoadTime - This is the time taken in milliseconds to load summarypageHtml.

  • SummaryPageLoadStartTime - This is the time taken in milliseconds receive first response from the server.

  • SummaryPageLoadTime - Time taken to load summary page. This includes payload creation time.

  • ThumbnailsCount - This is the total number of thumbnails that will be part of summary page.

Office.PowerPoint.PPT.IOS.RehearseView.StartSession

This event is triggered when the user clicks on start session. This event helps us capture how many users are using the Presenter coach feature on iOS. When combined with Office.PowerPoint.PPT.iOS.RehearseView it will tell us how many users successfully completed the rehearsal session and how many couldn’t. This is our first indicator of crashes or errors in the feature.

The following fields are collected:

  • None

Office.PowerPoint.PPT.Mac.Shell.PrintInfo

Collected whenever an export PDF operation has completed and contains information about the success of the operation. This information is critical to identify the success of export PDF operations for our application.

The following fields are collected:

  • Data_ExportAsPDFSucceed - Boolean indicating if exporting as PDF was a success.

Office.PowerPoint.PPT.Shared.RehearseView.RehearseClicked

This event captures when RehearseWithCoach is clicked. This event is used to analyze the seen- tried-kept funnel of the feature. This event along with tried and kept event helps us figure out if users are dropping out of the funnel. This helps us maintain the health of the feature.

The following fields are collected:

  • None

Office.PowerPoint.PPT.Shared.SlideShow.Failure

Collecting failures during slide show as a key feature for PowerPoint. Microsoft is collecting when error happens during slide show to help improve user experience on slide show. Microsoft uses this data to get diagnostic information about where the error happens while user is using slide show.

The following fields are collected:

  • CountOArtErrors - total number of OArt errors

  • CountOtherErrors - total number of other errors

  • CountPPTErrors - total number of PPT errors

  • CountSlideShowErrors - total number of slide show errors

  • FirstOArtError - first error happened in OArt

  • FirstOtherError - first error happened in other area

  • FirstPPTError - first error happened in PPT

  • FirstSlideShowError - first error happened in slide show

Office.PowerPoint.Rehearsal.RehearseAgain

This event captures when Rehearse Again is clicked in the summary report. This event is used to analyze the success of the PowerPoint Coach entry points, and is an indicator of the health of the feature.

The following fields are collected:

  • None

Office.PowerPoint.RunPrintOperation

Collected whenever a print PDF operation has completed and contains information about the layout type, use of slide numbers, and the success of the operation. This information is critical to identify the success of print PDF operations for our application.

The following fields are collected:

  • Data_PrintWithSlideNumbers - Boolean indicating if the user is printing with slide numbers.

  • Data_SavePrintLayoutType - The print layout type at the time of starting the print or export operation.

  • Data_Success - Boolean indicating if printing was a success.

Office.Project.ProjectFileSave

Project saves a file. This event indicates a Project save. It allows Microsoft to measure success of Project saving a file, which is important to avoid document data loss.

The following fields are collected:

  • Data_TriggerTime - time of save

  • Data_FileType - type of file the project is being saved as

Office.Session.Activity.Start

Allows us to know when a data streamer session has started. Used for feature health and monitoring. This event is generated by Microsoft Data Streamer for Excel Add-in.

The following fields are collected:

  • Activity_Name - Name of the activity "Session"

  • Activity_CV - ID to correlate the events across the connection session

  • Activity_StartStopType - Start

  • Activity_DateTimeTicks - Data Time for the activity

Office.Session.Activity.Stop

Allows us to know when a data streamer session has stopped Used for feature health and monitoring. This event is generated by Microsoft Data Streamer for Excel Add-in.

The following fields are collected:

  • Activity_Name - Name of the activity "Session"

  • Activity_CV - ID to correlate the events across the connection session

  • Activity_StartStopType - Stop

  • Activity_DateTimeTicks - Data Time for the activity

Office.StickyNotes.Web.SDK.ContextUrlAction

Triggered when user hovers or clicks on a context url to go back to source (user action) and is required to compute how frequently users click on the context url to go back to the source (which is one of the core actions of OneNote Sticky Notes).

The following fields are collected:

  • Consent_AddInContentSourceLocation - Add In content source location 

  • Consent_AddInContentState - Add In content state 

  • Consent_ControllerConnectedServicesConsentTime - Indicates when the user chose the status of optional connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DiagnosticDataConsentTime - Indicates when the user provided the consent for diagnostic data. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DownloadContentConsentTime - Indicates when the user made the choice to enable or disable connected experiences that download online content. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_UserContentDependentConsentTime - Indicates when the user chose to enable or disable connected experiences that analyze content was made. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Data_ActionName - Action during which event was recorded

  • Data_App_Name - The name of the application that is providing the data. Allows us to identify which application is showing an issue so we know how to address it.

  • Data_App_Platform - The broad classification of the platform on which the app is running. Allows us to identify on which platforms an issue may be occurring so that we can correctly prioritize the issue.

  • Data_App_Version - The version of the application. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

  • Data_Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • Data_Device_Id - A unique identifier for the device. Allows us to identify the distribution of issues across a set of devices.

  • Data_EditMode - Indicates whether a sticky note is being accessed in list mode or in a pop-up window

  • Data_EventName - A unique name of a OneNote's event. OneNote events use this custom field to specify a unique name due to an engineering limitation in the past.

  • Data_ExpirationDate - A date in numerical format indicates when this event will be stop sending from clients

  • Data_FeedEnabled - Identifies if feed is enabled. 

  • Data_HostApp - Identifies the host app name that launches a sub-app. 

  • Data_HostSessionId - Uniquely identifies the host app session for a sub-app 

  • Data_isActionableContext - Is the context url available and clickable

  • Data_Namespace - A namespace of the event. Allows us to group the event into groups.

  • Data_NoteLocalId - Note ID

  • Data_OTelJS_Version - Version of OTel logger 

  • Data_SamplePolicy - Identifies if the sample policy is Measure or Critical 

  • Data_Session_Id - Uniquely identifies a given session of data. Allows us to identify the impact of issues by evaluating the number of sessions that are impacted and if there are common features of those sessions.

  • Data_SessionCorrelationId - The globally unique identifier for the host's session.

  • Data_ShortEventName - A short name of an event. Allows us to identify the event that was being sent from the client. 

  • Data_StickyNotesSDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it. 

  • Event_ReceivedTime - The time the event was logged in the service 

  • M365aInfo_EnrolledTenantId - Enrolled tenant ID 

  • User_ActiveUserTenantId - Active user tenant ID 

  • User_TelemetryRegion - Identifies the data boundary of the user 

Office.StickyNotes.Web.SDK.NoteCreated

Triggered when a user creates a sticky note (user action).

We'll be migrating the users from the old sticky notes app to the new sticky notes app and need this telemetry to make sure that the note creation experience of new sticky notes app is working as expected by the users.

This is also required to track Smart Capture / New Note (which are some of the core actions of OneNote Sticky Notes) for detailed analysis of how user interacts with the app, thus helping product team improve workflows in the app.

The following fields are collected:

  • Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • baseData_properties_version - Version of properties such as PostChannel and PrivacyGuardPlugin 

  • Browser_Name - Always logged blank 

  • Browser_Version - Always logged blank 

  • Consent_AddInContentSourceLocation - Add In content source location 

  • Consent_AddInContentState - Add In content state 

  • Consent_ControllerConnectedServicesConsentTime - Indicates when the user chose the status of optional connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DiagnosticDataConsentTime - Indicates when the user provided the consent for diagnostic data. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DownloadContentConsentTime - Indicates when the user made the choice to enable or disable connected experiences that download online content. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_UserContentDependentConsentTime - Indicates when the user chose to enable or disable connected experiences that analyze content was made. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Culture_UiLanguage - Always logged blank 

  • Data_App_Name - The name of the application that is providing the data. Allows us to identify which application is showing an issue so we know how to address it.

  • Data_App_Platform - The broad classification of the platform on which the app is running. Allows us to identify on which platforms an issue may be occurring so that we can correctly prioritize the issue.

  • Data_App_Version - The version of the application. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

  • Data_AppInfo_Id - Name of the host application 

  • Data_AppInfo_Version - Version of the host application 

  • Data_Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • Data_ContextHostApp – Host app that note was taken in context of

  • Data_ContextHostCategory - Category (Meeting / Learning / Office) of the host app that note was taken in context of

  • Data_Device_Id - A unique identifier for the device. Allows us to identify the distribution of issues across a set of devices.

  • Data_EventName - A unique name of a OneNote's event. OneNote events use this custom field to specify a unique name due to an engineering limitation in the past.

  • Data_ExpirationDate - A date in numerical format indicates when this event will be stop sending from clients

  • Data_FeedEnabled - Identifies if feed is enabled. 

  • Data_hasImage - Is the note created using Smart Capture

  • Data_HostApp - Identifies the host app name that launches a sub-app. 

  • Data_HostSessionId - Uniquely identifies the host app session for a sub-app 

  • Data_isActionableContext - Is the context url available and clickable, in order to compute % of notes with actionable context

  • Data_Namespace - A namespace of the event. Allows us to group the event into groups.

  • Data_NoteLocalId - Note ID

  • Data_OTelJS_Sink - Sink used by OTel logger. It's always logged blank. 

  • Data_OTelJS_Version - Version of OTel logger 

  • Data_SamplePolicy - Identifies if the sample policy is Measure or Critical 

  • Data_ScreenshotCapturedOnce - Is this the first screenshot capture of a user

  • Data_SDX_AssetId - ONLY exists for store Add-ins. OMEX gives the Add in an AssetId when it goes into Store. It's always logged blank. 

  • Data_SDX_BrowserToken - Identifier that sits in the browser's cache 

  • Data_SDX_HostJsVersion - This is the platform-specific version of Office.js (for example, outlook web16.01.js) This contains the API surface for ad ins 

  • Data_SDX_Id - The GUID of an Add-in, which uniquely identifies it 

  • Data_SDX_InstanceId - Represents Add in document pair 

  • Data_SDX_MarketplaceType - Indicates where the Add-in installed from 

  • Data_SDX_OfficeJsVersion - This is the version of Office.js that will redirect to the platform-specific version. 

  • Data_SDX_SessionId - Session ID of the Add-in 

  • Data_SDX_Version - Version of the Add-in 

  • Data_Session_Id - Uniquely identifies a given session of data. Allows us to identify the impact of issues by evaluating the number of sessions that are impacted and if there are common features of those sessions.

  • Data_SessionCorrelationId - The globally unique identifier for the host's session.

  • Data_ShortEventName - A short name of an event. Allows us to identify the event that was being sent from the client. 

  • Data_StickyNotesSDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it. 

  • Data_TimeTakenInMS - time taken to capture a new note in millisecond.

  • Data_User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • Data_User_PrimaryIdentityHash - A pseudonymous identifier that represents the current user.

  • Data_User_PrimaryIdentitySpace - The type of identity contained in the PrimaryIdentityHash. One of MSACID, OrgIdCID, or UserObjectId.

  • Data_User_TenantId - The tenant that a user's subscription is tied to. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant.

  • DeviceInfo_BrowserName - Browser Name 

  • DeviceInfo_BrowserVersion - Browser Version 

  • DeviceInfo_Id - The globally unique device identifier for a device 

  • DeviceInfo_OsName - The name of the device OS 

  • DeviceInfo_OsVersion - The version of the operating system 

  • Event_ReceivedTime - The time the event was logged in the service 

  • M365aInfo_EnrolledTenantId - Enrolled tenant ID 

  • OriginalRoutingGeo - Identifies if the original routing geo is eu or not. 

  • PartA_PrivTags - Always logged blank 

  • Release_IsOutOfServiceFork - It's always logged as true or blank 

  • Session_SamplingValue - A value in (0, 1) 

  • User_ActiveUserTenantId - Active user tenant ID 

  • User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • User_TelemetryRegion - Identifies the data boundary of the user 

  • UserInfo_Language - Current language setting of the device to help us detect issues affecting certain languages 

  • UserInfo_TimeZone - The user's time zone relative to UTC.

  • WAC_ApplicationMode - Always logged blank 

  • WAC_ApplicationModeExtended - Always logged blank 

  • WAC_BrowserLanguage - Always logged blank 

  • WAC_ContentLanguage - Always logged blank 

  • WAC_Datacenter - Always logged blank 

  • WAC_Host - Always logged blank 

  • WAC_IsBusinessUser - Always logged blank 

  • WAC_IsEdu - Always logged blank 

  • WAC_IsSynthetic - Always logged blank 

  • WAC_OsVersion - Always logged blank 

  • WAC_Ring - Always logged blank 

  • WAC_ServerDocId - Server Document ID for the document that was scanned. It's always logged as blank. 

  • WAC_SessionOrigin - Always logged blank 

  • WAC_UiHost - Always logged blank 

  • WAC_UiHostIntegrationType - Always logged blank 

Office.StickyNotes.Web.SDK.NoteDeleted

Triggered when a user deletes a sticky note (user action).

We'll be migrating the users from the old sticky notes app to the new sticky notes app and need this telemetry to make sure that the note deletion experience of new sticky notes app is working as expected by the users.

This is required for detailed analysis of how user interacts with the app, thus helping product team improve workflows in the app.

The following fields are collected:

  • Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • baseData_properties_version - Version of properties such as PostChannel and PrivacyGuardPlugin 

  • Browser_Name - Always logged blank 

  • Browser_Version - Always logged blank 

  • Consent_AddInContentSourceLocation - Add In content source location 

  • Consent_AddInContentState - Add In content state 

  • Consent_ControllerConnectedServicesConsentTime - Indicates when the user chose the status of optional connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DiagnosticDataConsentTime - Indicates when the user provided the consent for diagnostic data. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DownloadContentConsentTime - Indicates when the user made the choice to enable or disable connected experiences that download online content. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_UserContentDependentConsentTime - Indicates when the user chose to enable or disable connected experiences that analyze content was made. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Culture_UiLanguage - Always logged blank 

  • Data_App_Name - The name of the application that is providing the data. Allows us to identify which application is showing an issue so we know how to address it.

  • Data_App_Platform - The broad classification of the platform on which the app is running. Allows us to identify on which platforms an issue may be occurring so that we can correctly prioritize the issue.

  • Data_App_Version - The version of the application. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

  • Data_AppInfo_Id - Name of the host application 

  • Data_AppInfo_Version - Version of the host application 

  • Data_Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • Data_Device_Id - A unique identifier for the device. Allows us to identify the distribution of issues across a set of devices.

  • Data_EditMode - Indicates whether a sticky note is being edited in list mode or in a popout window

  • Data_EventName - A unique name of a OneNote's event. OneNote events use this custom field to specify a unique name due to an engineering limitation in the past.

  • Data_ExpirationDate - A date in numerical format indicates when this event will be stop sending from clients

  • Data_FeedEnabled - Identifies if feed is enabled. 

  • Data_feedNoteType - 'StickyNote' | 'OneNotePage' | 'SamsungNote' 

  • Data_HostApp - Identifies the host app name that launches a sub-app. 

  • Data_HostSessionId - Uniquely identifies the host app session for a sub-app 

  • Data_Namespace - A namespace of the event. Allows us to group the event into groups.

  • Data_NoteLocalId - Note ID

  • Data_OTelJS_Sink - Sink used by OTel logger. It's always logged blank. 

  • Data_OTelJS_Version - Version of OTel logger 

  • Data_SamplePolicy - Identifies if the sample policy is Measure or Critical 

  • Data_SDX_AssetId - ONLY exists for store Add-ins. OMEX gives the Add in an AssetId when it goes into Store. It's always logged blank. 

  • Data_SDX_BrowserToken - Identifier that sits in the browser's cache 

  • Data_SDX_HostJsVersion - This is the platform-specific version of Office.js (for example, outlook web16.01.js) This contains the API surface for ad ins 

  • Data_SDX_Id - The GUID of an Add-in, which uniquely identifies it 

  • Data_SDX_InstanceId - Represents Add in document pair 

  • Data_SDX_MarketplaceType - Indicates where the Add-in installed from 

  • Data_SDX_OfficeJsVersion - This is the version of Office.js that will redirect to the platform-specific version. 

  • Data_SDX_SessionId - Session ID of the Add-in 

  • Data_SDX_Version - Version of the Add-in 

  • Data_Session_Id - Uniquely identifies a given session of data. Allows us to identify the impact of issues by evaluating the number of sessions that are impacted and if there are common features of those sessions.

  • Data_SessionCorrelationId - The globally unique identifier for the host's session.

  • Data_ShortEventName - A short name of an event. Allows us to identify the event that was being sent from the client. 

  • Data_source - Is the selected note a related note, recent note, or result of a search operation

  • Data_StickyNotesSDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it. 

  • Data_User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • Data_User_PrimaryIdentityHash - A pseudonymous identifier that represents the current user.

  • Data_User_PrimaryIdentitySpace - The type of identity contained in the PrimaryIdentityHash. One of MSACID, OrgIdCID, or UserObjectId.

  • Data_User_TenantId - The tenant that a user's subscription is tied to. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant.

  • DeviceInfo_BrowserName - Browser Name 

  • DeviceInfo_BrowserVersion - Browser Version 

  • DeviceInfo_Id - The globally unique device identifier for a device 

  • DeviceInfo_OsName - The name of the device OS 

  • DeviceInfo_OsVersion - The version of the operating system 

  • Event_ReceivedTime - The time the event was logged in the service 

  • M365aInfo_EnrolledTenantId - Enrolled tenant ID 

  • OriginalRoutingGeo - Identifies if the original routing geo is eu or not. 

  • Release_IsOutOfServiceFork - It's always logged as true or blank 

  • Session_SamplingValue - A value in (0, 1) 

  • User_ActiveUserTenantId - Active user tenant ID 

  • User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • User_TelemetryRegion - Identifies the data boundary of the user 

  • UserInfo_Language - Current language setting of the device to help us detect issues affecting certain languages 

  • UserInfo_TimeZone - The user's time zone relative to UTC.

  • WAC_ApplicationMode - Always logged blank 

  • WAC_ApplicationModeExtended - Always logged blank 

  • WAC_BrowserLanguage - Always logged blank 

  • WAC_ContentLanguage - Always logged blank 

  • WAC_Datacenter - Always logged blank 

  • WAC_Host - Always logged blank 

  • WAC_IsBusinessUser - Always logged blank 

  • WAC_IsEdu - Always logged blank 

  • WAC_IsSynthetic - Always logged blank 

  • WAC_OsVersion - Always logged blank 

  • WAC_Ring - Always logged blank 

  • WAC_ServerDocId - Server Document ID for the document that was scanned. It's always logged as blank. 

  • WAC_SessionOrigin - Always logged blank 

  • WAC_UiHost - Always logged blank 

  • WAC_UiHostIntegrationType - Always logged blank 

Office.StickyNotes.Web.SDK.NotePopupEditor

Triggered when user pops out note from bar or opens note list from pop out (user action).

We'll be migrating the users from the old sticky notes app to the new sticky notes app and need this telemetry to make sure that the note pop out experience of new sticky notes app is working as expected by the users.

This is also required to track how frequently users use the pop out feature, for detailed analysis of how user interacts with the app, thus helping product team improve workflows in the app.

The following fields are collected:

  • Consent_AddInContentSourceLocation - Add In content source location 

  • Consent_AddInContentState - Add In content state 

  • Consent_ControllerConnectedServicesConsentTime - Indicates when the user chose the status of optional connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DiagnosticDataConsentTime - Indicates when the user provided the consent for diagnostic data. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DownloadContentConsentTime - Indicates when the user made the choice to enable or disable connected experiences that download online content. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_UserContentDependentConsentTime - Indicates when the user chose to enable or disable connected experiences that analyze content was made. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Data_ActionName - Action during which event was recorded

  • Data_App_Name - The name of the application that is providing the data. Allows us to identify which application is showing an issue so we know how to address it.

  • Data_App_Platform - The broad classification of the platform on which the app is running. Allows us to identify on which platforms an issue may be occurring so that we can correctly prioritize the issue.

  • Data_App_Version - The version of the application. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

  • Data_Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • Data_Device_Id - A unique identifier for the device. Allows us to identify the distribution of issues across a set of devices.

  • Data_EditMode - Indicates whether a sticky note is being accessed in list mode or in a popup window.

  • Data_EventName - A unique name of a OneNote's event. OneNote events use this custom field to specify a unique name due to an engineering limitation in the past.

  • Data_ExpirationDate - A date in numerical format indicates when this event will be stop sending from clients

  • Data_FeedEnabled - Identifies if feed is enabled. 

  • Data_HostApp - Identifies the host app name that launches a sub-app. 

  • Data_HostSessionId - Uniquely identifies the host app session for a sub-app 

  • Data_Namespace - A namespace of the event. Allows us to group the event into groups.

  • Data_NoteLocalId - Note ID

  • Data_NoteWasEmpty - Whether note was blank before popping out note from bar or opening note list from pop out

  • Data_OTelJS_Version - Version of OTel logger 

  • Data_SamplePolicy - Identifies if the sample policy is Measure or Critical 

  • Data_Session_Id - Uniquely identifies a given session of data. Allows us to identify the impact of issues by evaluating the number of sessions that are impacted and if there are common features of those sessions.

  • Data_SessionCorrelationId - The globally unique identifier for the host's session.

  • Data_ShortEventName - A short name of an event. Allows us to identify the event that was being sent from the client. 

  • Data_source - Is the selected note a related note, recent note or result of a search operation

  • Data_StickyNotesSDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it. 

  • Event_ReceivedTime - The time the event was logged in the service 

  • M365aInfo_EnrolledTenantId - Enrolled tenant ID 

  • User_ActiveUserTenantId - Active user tenant ID 

  • User_TelemetryRegion - Identifies the data boundary of the user 

Office.StickyNotes.Web.SDK.NoteViewed

Triggered when a user views a sticky note (user action).

We'll be migrating the users from the old sticky notes app to the new sticky notes app and need this telemetry to make sure that the note viewing experience of new sticky notes app is working as expected by the users.

This is also required to track Recall of a note (which is one of the core actions of OneNote Sticky Notes) for detailed analysis of how user interacts with the app, thus helping product team improve workflows in the app.

The following fields are collected:

  • Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • baseData_properties_version - Version of properties such as PostChannel and PrivacyGuardPlugin 

  • Browser_Name - Always logged blank 

  • Browser_Version - Always logged blank 

  • Consent_AddInContentSourceLocation - Add In content source location 

  • Consent_AddInContentState - Add In content state 

  • Consent_ControllerConnectedServicesConsentTime - Indicates when the user chose the status of optional connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DiagnosticDataConsentTime - Indicates when the user provided the consent for diagnostic data. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DownloadContentConsentTime - Indicates when the user made the choice to enable or disable connected experiences that download online content. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_UserContentDependentConsentTime - Indicates when the user chose to enable or disable connected experiences that analyze content was made. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Culture_UiLanguage - Always logged blank 

  • Data_App_Name - The name of the application that is providing the data. Allows us to identify which application is showing an issue so we know how to address it.

  • Data_App_Platform - The broad classification of the platform on which the app is running. Allows us to identify on which platforms an issue may be occurring so that we can correctly prioritize the issue.

  • Data_App_Version - The version of the application. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

  • Data_AppInfo_Id - Name of the host application 

  • Data_AppInfo_Version - Version of the host application 

  • Data_Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • Data_ContextHostApp - Host app that note was taken in context of

  • Data_ContextHostCategory - Category (Meeting / Learning / Office) of the host app that note was taken in context of

  • Data_createdAt - Timestamp when the sticky note was created

  • Data_Device_Id - A unique identifier for the device. Allows us to identify the distribution of issues across a set of devices.

  • Data_EventName - A unique name of a OneNote's event. OneNote events use this custom field to specify a unique name due to an engineering limitation in the past.

  • Data_ExpirationDate - A date in numerical format indicates when this event will be stop sending from clients

  • Data_FeedEnabled - Identifies if feed is enabled. 

  • Data_FeedNoteType - 'StickyNote' | 'OneNotePage' | 'SamsungNote' 

  • Data_HostApp - Identifies the host app name that launches a sub-app. 

  • Data_HostSessionId - Uniquely identifies the host app session for a sub-app 

  • Data_isNewNoteScenario - Is the current scenario that of a user taking a new note

  • Data_lastModified - Timestamp when the sticky note was last modified

  • Data_Namespace - A namespace of the event. Allows us to group the event into groups.

  • Data_NoteId - Note ID

  • Data_OTelJS_Sink - Sink used by OTel logger. It's always logged blank. 

  • Data_OTelJS_Version - Version of OTel logger 

  • Data_SamplePolicy - Identifies if the sample policy is Measure or Critical 

  • Data_SDX_AssetId - ONLY exists for store Add-ins. OMEX gives the Add in an AssetId when it goes into Store. It's always logged blank. 

  • Data_SDX_BrowserToken - Identifier that sits in the browser's cache 

  • Data_SDX_HostJsVersion - This is the platform-specific version of Office.js (for example, outlook web16.01.js) This contains the API surface for ad ins 

  • Data_SDX_Id - The GUID of an Add-in, which uniquely identifies it 

  • Data_SDX_InstanceId - Represents Add in document pair 

  • Data_SDX_MarketplaceType - Indicates where the Add-in installed from 

  • Data_SDX_OfficeJsVersion - This is the version of Office.js that will redirect to the platform-specific version. 

  • Data_SDX_SessionId - Session ID of the Add-in 

  • Data_SDX_Version - Version of the Add-in 

  • Data_Session_Id - Uniquely identifies a given session of data. Allows us to identify the impact of issues by evaluating the number of sessions that are impacted and if there are common features of those sessions.

  • Data_SessionCorrelationId - The globally unique identifier for the host's session.

  • Data_ShortEventName - A short name of an event. Allows us to identify the event that was being sent from the client. 

  • Data_source - Is the selected note a related note, recent note, or result of a search operation

  • Data_StickyNotesSDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it. 

  • Data_User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • Data_User_PrimaryIdentityHash - A pseudonymous identifier that represents the current user.

  • Data_User_PrimaryIdentitySpace - The type of identity contained in the PrimaryIdentityHash. One of MSACID, OrgIdCID, or UserObjectId.

  • Data_User_TenantId - The tenant that a user's subscription is tied to. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant.

  • DeviceInfo_BrowserName - Browser Name 

  • DeviceInfo_BrowserVersion - Browser Version 

  • DeviceInfo_Id - The globally unique device identifier for a device 

  • DeviceInfo_OsName - The name of the device OS 

  • DeviceInfo_OsVersion - The version of the operating system 

  • Event_ReceivedTime - The time the event was logged in the service 

  • M365aInfo_EnrolledTenantId - Enrolled tenant ID 

  • OriginalRoutingGeo - Identifies if the original routing geo is eu or not. 

  • PartA_PrivTags - Always logged blank 

  • Release_IsOutOfServiceFork - It's always logged as true or blank 

  • Session_SamplingValue - A value in (0, 1) 

  • User_ActiveUserTenantId - Active user tenant ID 

  • User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • User_TelemetryRegion - Identifies the data boundary of the user 

  • UserInfo_Language - Current language setting of the device to help us detect issues affecting certain languages 

  • UserInfo_TimeZone - The user's time zone relative to UTC.

  • WAC_ApplicationMode - Always logged blank 

  • WAC_ApplicationModeExtended - Always logged blank 

  • WAC_BrowserLanguage - Always logged blank 

  • WAC_ContentLanguage - Always logged blank 

  • WAC_Datacenter - Always logged blank 

  • WAC_Host - Always logged blank 

  • WAC_IsBusinessUser - Always logged blank 

  • WAC_IsEdu - Always logged blank 

  • WAC_IsSynthetic - Always logged blank 

  • WAC_OsVersion - Always logged blank 

  • WAC_Ring - Always logged blank 

  • WAC_ServerDocId - Server Document ID for the document that was scanned. It's always logged as blank. 

  • WAC_SessionOrigin - Always logged blank 

  • WAC_UiHost - Always logged blank 

  • WAC_UiHostIntegrationType - Always logged blank 

Office.StickyNotes.Web.SDK.RelatedNotesListUpdated

Triggered when the user switches to a different context (user action) and is required to compute the total number of related notes users have for the current context.

More the number of related notes for a given context, more efficient is OneNote Sticky Notes.

This is also required to track Recall (which is one of the core actions of OneNote Sticky Notes) and make sure that the recall experience of new sticky notes app is working as expected and for detailed analysis of how user interacts with the app, thus helping product team improve workflows in the app.

The following fields are collected:

  • Consent_AddInContentSourceLocation - Add In content source location 

  • Consent_AddInContentState - Add In content state 

  • Consent_ControllerConnectedServicesConsentTime - Indicates when the user chose the status of optional connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DiagnosticDataConsentTime - Indicates when the user provided the consent for diagnostic data. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DownloadContentConsentTime - Indicates when the user made the choice to enable or disable connected experiences that download online content. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_UserContentDependentConsentTime - Indicates when the user chose to enable or disable connected experiences that analyze content was made. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Data_App_Name - The name of the application that is providing the data. Allows us to identify which application is showing an issue so we know how to address it.

  • Data_App_Platform - The broad classification of the platform on which the app is running. Allows us to identify on which platforms an issue may be occurring so that we can correctly prioritize the issue.

  • Data_App_Version - The version of the application. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

  • Data_Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • Data_Device_Id - A unique identifier for the device. Allows us to identify the distribution of issues across a set of devices.

  • Data_EventName - A unique name of a OneNote's event. OneNote events use this custom field to specify a unique name due to an engineering limitation in the past.

  • Data_ExpirationDate - A date in numerical format indicates when this event will be stop sending from clients

  • Data_FeedEnabled - Identifies if feed is enabled. 

  • Data_HostApp - Identifies the host app name that launches a sub-app. 

  • Data_HostSessionId - Uniquely identifies the host app session for a sub-app 

  • Data_Namespace - A namespace of the event. Allows us to group the event into groups.

  • Data_OTelJS_Version - Version of OTel logger 

  • Data_RelatedNotesCount - Count of related notes

  • Data_SamplePolicy - Identifies if the sample policy is Measure or Critical 

  • Data_Session_Id - Uniquely identifies a given session of data. Allows us to identify the impact of issues by evaluating the number of sessions that are impacted and if there are common features of those sessions.

  • Data_SessionCorrelationId - The globally unique identifier for the host's session.

  • Data_ShortEventName - A short name of an event. Allows us to identify the event that was being sent from the client. 

  • Data_StickyNotesSDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it. 

  • Data_TimeTakenInMS - Time taken to show related notes after a change in context in millisecond.

  • Event_ReceivedTime - The time the event was logged in the service 

  • M365aInfo_EnrolledTenantId - Enrolled tenant ID 

  • User_ActiveUserTenantId - Active user tenant ID 

  • User_TelemetryRegion - Identifies the data boundary of the user 

Office.StickyNotes.Web.SDK.SearchInitiated

Triggered when the search term is updated (user action).

We'll be migrating the users from the old sticky notes app to the new sticky notes app and need this telemetry to make sure that the search experience of new sticky notes app is working as expected by the users.

This is also required to track how frequently users search in OneNote Sticky Notes, for detailed analysis of how user interacts with the app, thus helping product team improve workflows in the app.

Please note that this event won’t be logged multiple times while a search term is getting actively updated. Once logged, this event will be logged again only when the search term is completely erased, and the user starts typing a new search term.

The following fields are collected:

  • Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • baseData_properties_version - Version of properties such as PostChannel and PrivacyGuardPlugin 

  • Browser_Name - Always logged blank 

  • Browser_Version - Always logged blank 

  • Consent_AddInContentSourceLocation - Add In content source location 

  • Consent_AddInContentState - Add In content state 

  • Consent_ControllerConnectedServicesConsentTime - Indicates when the user chose the status of optional connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DiagnosticDataConsentTime - Indicates when the user provided the consent for diagnostic data. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DownloadContentConsentTime - Indicates when the user made the choice to enable or disable connected experiences that download online content. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_UserContentDependentConsentTime - Indicates when the user chose to enable or disable connected experiences that analyze content was made. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Culture_UiLanguage - Always logged blank 

  • Data_App_Name - The name of the application that is providing the data. Allows us to identify which application is showing an issue so we know how to address it.

  • Data_App_Platform - The broad classification of the platform on which the app is running. Allows us to identify on which platforms an issue may be occurring so that we can correctly prioritize the issue.

  • Data_App_Version - The version of the application. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

  • Data_AppInfo_Id - Name of the host application 

  • Data_AppInfo_Version - Version of the host application 

  • Data_Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • Data_Device_Id - A unique identifier for the device. Allows us to identify the distribution of issues across a set of devices.

  • Data_EventName - A unique name of a OneNote's event. OneNote events use this custom field to specify a unique name due to an engineering limitation in the past.

  • Data_ExpirationDate - A date in numerical format indicates when this event will be stop sending from clients

  • Data_FeedEnabled - Identifies if feed is enabled. 

  • Data_HostApp - Identifies the host app name that launches a sub-app. 

  • Data_HostSessionId - Uniquely identifies the host app session for a sub-app 

  • Data_Namespace - A namespace of the event. Allows us to group the event into groups.

  • Data_OTelJS_Sink - Sink used by OTel logger. It's always logged blank. 

  • Data_OTelJS_Version - Version of OTel logger 

  • Data_SamplePolicy - Identifies if the sample policy is Measure or Critical 

  • Data_SDX_AssetId - ONLY exists for store Add-ins. OMEX gives the Add in an AssetId when it goes into Store. It's always logged blank. 

  • Data_SDX_BrowserToken - Identifier that sits in the browser's cache 

  • Data_SDX_HostJsVersion - This is the platform-specific version of Office.js (for example, outlook web16.01.js) This contains the API surface for ad ins 

  • Data_SDX_Id - The GUID of an Add-in, which uniquely identifies it 

  • Data_SDX_InstanceId - Represents Add in document pair 

  • Data_SDX_MarketplaceType - Indicates where the Add-in installed from 

  • Data_SDX_OfficeJsVersion - This is the version of Office.js that will redirect to the platform-specific version. 

  • Data_SDX_SessionId - Session ID of the Add-in 

  • Data_SDX_Version - Version of the Add-in 

  • Data_SearchEntryPoint - Entry point from which search action in OneNote Sticky Notes is invoked. Currently, we're tracking the 'TellMeSearch' entry point, which is the OneNote Win32 search at the top.

  • Data_Session_Id - Uniquely identifies a given session of data. Allows us to identify the impact of issues by evaluating the number of sessions that are impacted and if there are common features of those sessions.

  • Data_SessionCorrelationId - The globally unique identifier for the host's session.

  • Data_ShortEventName - A short name of an event. Allows us to identify the event that was being sent from the client. 

  • Data_StickyNotesSDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it. 

  • Data_User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • Data_User_PrimaryIdentityHash - A pseudonymous identifier that represents the current user.

  • Data_User_PrimaryIdentitySpace - The type of identity contained in the PrimaryIdentityHash. One of MSACID, OrgIdCID, or UserObjectId.

  • Data_User_TenantId - The tenant that a user's subscription is tied to. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant.

  • DeviceInfo_BrowserName - Browser Name 

  • DeviceInfo_BrowserVersion - Browser Version 

  • DeviceInfo_Id - The globally unique device identifier for a device 

  • DeviceInfo_OsName - The name of the device OS 

  • DeviceInfo_OsVersion - The version of the operating system 

  • Event_ReceivedTime - The time the event was logged in the service 

  • M365aInfo_EnrolledTenantId - Enrolled tenant ID 

  • OriginalRoutingGeo - Identifies if the original routing geo is eu or not. 

  • Release_IsOutOfServiceFork - It's always logged as true or blank 

  • Session_SamplingValue - A value in (0, 1) 

  • User_ActiveUserTenantId - Active user tenant ID 

  • User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • User_TelemetryRegion - Identifies the data boundary of the user 

  • UserInfo_Language - Current language setting of the device to help us detect issues affecting certain languages 

  • UserInfo_TimeZone - The user's time zone relative to UTC.

  • WAC_ApplicationMode - Always logged blank 

  • WAC_ApplicationModeExtended - Always logged blank 

  • WAC_BrowserLanguage - Always logged blank 

  • WAC_ContentLanguage - Always logged blank 

  • WAC_Datacenter - Always logged blank 

  • WAC_Host - Always logged blank 

  • WAC_IsBusinessUser - Always logged blank 

  • WAC_IsEdu - Always logged blank 

  • WAC_IsSynthetic - Always logged blank 

  • WAC_OsVersion - Always logged blank 

  • WAC_Ring - Always logged blank 

  • WAC_ServerDocId - Server Document ID for the document that was scanned. It's always logged as blank. 

  • WAC_SessionOrigin - Always logged blank 

  • WAC_UiHost - Always logged blank 

  • WAC_UiHostIntegrationType - Always logged blank 

Office.StreamDevice.Activity.Start

Allows us to know if start streaming data source is successful. Used for feature health and monitoring. This event is generated by Microsoft Data Streamer for Excel Add-in.

The following fields are collected:

  • Datasource_Type - Serial device, or App Service information

  • DataSource_Name - Name of connected data source

  • Activity_Name - Name of the activity "StreamDeviceData" or "StreamFileData"

  • Activity_CV - ID to correlate the events across the connection session

  • Activity_StartStopType - Start

  • Activity_DateTimeTicks - Data Time for the activity

Office.StreamDevice.Activity.Stop

Allows us to know if stop streaming data source is successful. Used for feature health and monitoring. This event is generated by Microsoft Data Streamer for Excel Add-in.

The following fields are collected:

  • Datasource_Type - Serial device, or App Service information

  • DataSource_Name - Name of connected data source

  • Activity_Name - Name of the activity "StreamDeviceData" or "StreamFileData"

  • Activity_CV - ID to correlate the events across the connection session

  • Activity_StartStopType - Stop

  • Activity_DateTimeTicks - Data Time for the activity

Office.TargetedMessaging.ABExperimentMessageTrigger

Tracks the number of users receiving BizBar and Dynamic Canvas messages from TargetedMessagingService (TMS). This data is critical to understand what messages users are getting and on what surface so that we can ensure they aren't missing any messages that may be critical to their continued use of the product. Also needed to accurately measure the success of our experiments and campaigns run through TMS.

The following fields are collected:

  • Data_Surface – Name of the surface that this service delivered message is meant for

  • Data_Flight – ECS/CT Flight identifier that was used to deliver this message

  • Data_CampaignId – identifier of the campaign that this message is part of

  • Data_MessageId – identifier of this service delivered message

  • Data_TransactionId – identifier of this transaction with the service

  • Data_TriggerPoint – The step in which this event was logged (message received vs message displayed)

Office.Text.FontPickerFontSelected.Win32

This event indicates whether the downloaded font was rendered correctly. Used to indicate success or failure of Font Download.

The following fields are collected:

  • Font name (Data_Font) - name of font picked in font picker

  • User click (Data_FClick) - if user used mouse to select item

Office.Text.ResourceClient.RequestResourceInternal

This event indicates whether the font was downloaded correctly. Used to indicate success or failure of rendering the downloaded font.

The following fields are collected:

  • Data_FontToken - resource file name will be saved as

  • Data_HTTPResult - result of the HTTP request

  • Data_HTTPStatusCode - HTTP code returned from the HTTP request

  • Data_isInternetOn - If we had connection when trying to retrieve the resource

  • Data_RequestUrl - URL of the CDN resource we're trying to retrieve

Office.Translator.DocumentTranslated

Collects success or failure of a full document translation a user trigger in the Translator SDX. This is critical to evaluate the health of the translation feature and react to any outages that might occur. Monitor the health of the "Translate Document" scenario in Word.

The following fields are collected:

  • Data.actionSource - How was the translate selection triggered

  • Data.bodyBackgroundColor - Office theme container background color

  • Data.bodyForegroundColor - Office theme container foreground color

  • Data.browserLang - Browser current display language

  • Data.browserOnline - Obsolete

  • Data.browserPlatform - Browser platform

  • Data.browserUserAgent - Browser user agent

  • Data.colorDepth - System color depth

  • Data.contentLanguage - Detected language of the content to translate

  • Data.controlBackgroundColor - Office theme control background color

  • Data.controlForegroundColor - Office theme control foreground color

  • Data.correlationId - Unique identifier of the request sent to the service

  • Data.crossSessionId - Unique identifier of the user

  • Data.crossSessionStartTime - UTC timestamp of when the translation session started

  • Data.currentTime - UTC timestamp of when this telemetry message was sent

  • Data.displayLanguage - Office display language

  • Data.documentSourceLang - Document content language

  • Data.documentTargetLang - Language document will be translated to

  • Data.environment - Service environment the request is sent to

  • Data.errorMessage - Error message reported by the service

  • Data.eventActionType - Type of telemetry event

  • Data.eventTagId - Unique identifier of the line of code that produced this telemetry message.

  • Data.flights - Enabled flights

  • Data.fileSize - Size of Word file to translate

  • Data.fileSource - Where is the Word file hosted (offline, online)

  • Data.fileType - Word file extension

  • Data.innerHeight" - Side pane container height

  • Data.innerWidth" - Side pane container width

  • Data.lookupSourceLang - Not used for document translation

  • Data.lookupTargetLang - Not used for document translation

  • Data.officeHost - Office application hosting the side pane

  • Data.officeLocale - Office user language

  • Data.officeMachineId - Device Unique identifier

  • Data.officePlatform - Device platform

  • Data.officeSessionId - Office session identifier

  • Data.officeUserId - Office user unique identifier

  • Data.officeVersion - Office version

  • Data.pageXOffset - Side pane horizontal scroll position from the left side of the pane

  • Data.pageYOffset - Side pane vertical scroll position from the top side of the pane

  • Data.pixelDepth - Screen color resolution

  • Data.responseCode - Request response code from the service

  • Data.responseTime - Request elapsed time

  • Data.resultType - Request result

  • Data.screenHeight - Screen height in pixels

  • Data.screenLeft - Horizontal coordinate of the window relative to the screen

  • Data.screenTop - Vertical coordinate of the window relative to the screen

  • Data.screenWidth - Screen width in pixels

  • Data.selectedTab - Which tab is selected Selection or Document

  • Data.serverUrl - Translation service URL

  • Data.sessionId - Side pane session identifier

  • Data.sessionStartTime - UTC Timestamp of when the translation session started

  • Data.sourceTextHash - Hash of text to translate

  • Data.sourceTextLength - Text to translate length

  • Data.sourceTextWords - Number of words in the text to translate

  • Data.warningMessage - Warning message reported by the service

Office.Translator.TextTranslated

Collects success or failure of a selection translation that a user action triggers in the Translator SDX. This is critical to evaluate the health of the translation feature and react to any outages that might occur. Used to monitor the health of the "Translate Selection" scenario in Excel, PowerPoint, Word.

The following fields are collected:

  • Data.actionSource - How was the translate selection triggered

  • Data.bodyBackgroundColor - Office theme container background color

  • Data.bodyForegroundColor - Office theme container foreground color

  • Data.browserLang - Browser current display language

  • Data.browserOnline - Obsolete

  • Data.browserPlatform - Browser platform

  • Data.browserUserAgent - Browser user agent

  • Data.colorDepth - System color depth

  • Data.contentLanguage - Detected language of the content to translate

  • Data.controlBackgroundColor - Office theme control background color

  • Data.controlForegroundColor - Office theme control foreground color

  • Data.correlationId - Unique identifier of the request sent to the service

  • Data.crossSessionId - Unique identifier of the user

  • Data.crossSessionStartTime - UTC timestamp of when the translation session started

  • Data.currentTime - UTC timestamp of when this telemetry message was sent

  • Data.displayLanguage - Office display language

  • Data.documentSourceLang - Not used for selection

  • Data.documentTargetLang - Nor used for translation selection

  • Data.environment - Service environment the request is sent to

  • Data.errorMessage - Error message reported by the service

  • Data.eventActionType - Type of telemetry event

  • Data.eventTagId" - Unique identifier of the line of code that produced this telemetry message

  • Data.flights - Enabled flights

  • Data.innerHeight - Side pane container height

  • Data.innerWidth - Side pane container width

  • Data.lookupSourceLang - Language of the currently selected text

  • Data.lookupTargetLang - Language currently selected text will be translated to

  • Data.officeHost - Office application hosting the side pane

  • Data.officeLocale - Office user language

  • Data.officeMachineId - Device Unique identifier

  • Data.officePlatform - Device platform

  • Data.officeSessionId - Office session identifier

  • Data.officeUserId - Office user unique identifier

  • Data.officeVersion - Office version

  • Data.pageXOffset - Side pane horizontal scroll position from the left side of the pane

  • Data.pageYOffset - Side pane vertical scroll position from the top side of the pane

  • Data.pixelDepth - Screen color resolution

  • Data.responseCode - Request response code from the service

  • Data.responseTime - Request elapsed time

  • Data.resultType - Request result

  • Data.screenHeight - Screen height in pixels

  • Data.screenLeft - Horizontal coordinate of the window relative to the screen

  • Data.screenTop - Vertical coordinate of the window relative to the screen

  • Data.screenWidth - Screen width in pixels

  • Data.selectedTab - Which tab is selected Selection or Document

  • Data.serverUrl - Translation service URL

  • Data.sessionId - Side pane session identifier

  • Data.sessionStartTime - UTC Timestamp of when the translation session started

  • Data.sourceTextHash - Hash of text to translate

  • Data.sourceTextLength - Text to translate length

  • Data.sourceTextWords - Number of words in the text to translate

  • Data.warningMessage - Warning message reported by the service

Office.UX.AccChecker.AccCheckerFinalViolationCountPerRule

This event is triggered when Accessibility issues are reported for the currently opened document. This event represents the Accessibility violations (Errors, Warnings, and Tips) that exist per Rule, for the opened document at the beginning and end of the session. This event is used to record the counts of Accessibility violations (Errors, Warnings, and Tips) per Rule, for the opened document at the beginning and end of the session.

Details of violation counts per rule help Microsoft to identify which Accessibility issues are most common in Office documents. This helps with work on remediating them and drives the creation of an inclusive environment in the workplace and classroom for people with disabilities.

The following fields are collected:

  • Data_FinalCount_RuleID_0 - Number of violations of Rule ID = n that remain the last time the acc checker ran in a session.

  • Data_FinalCount_RuleID_1 - Number of violations of Rule ID = n that remain the last time the acc checker ran in a session.

  • Data_FinalCount_RuleID_2 - Number of violations of Rule ID = n that remain the last time the acc checker ran in a session.

  • Data_FinalCount_RuleID_3 - Number of violations of Rule ID = n that remain the last time the acc checker ran in a session.

  • Data_FinalCount_RuleID_4 - Number of violations of Rule ID = n that remain the last time the acc checker ran in a session.

  • Data_FinalCount_RuleID_5 - Number of violations of Rule ID = n that remain the last time the acc checker ran in a session.

  • Data_FinalCount_RuleID_6 - Number of violations of Rule ID = n that remain the last time the acc checker ran in a session.

  • Data_FinalCount_RuleID_7 - Number of violations of Rule ID = n that remain the last time the acc checker ran in a session.

  • Data_FinalCount_RuleID_8 - Number of violations of Rule ID = n that remain the last time the acc checker ran in a session.

  • Data_FinalCount_RuleID_9 - Number of violations of Rule ID = n that remain the last time the acc checker ran in a session.

  • Data_FinalCount_RuleID_10 - Number of violations of Rule ID = n that remain the last time the acc checker ran in a session.

  • Data_FinalCount_RuleID_11 - Number of violations of Rule ID = n that remain the last time the acc checker ran in a session.

  • Data_FinalCount_RuleID_12 - Number of violations of Rule ID = n that remain the last time the acc checker ran in a session.

  • Data_FinalCount_RuleID_13 - Number of violations of Rule ID = n that remain the last time the acc checker ran in a session.

  • Data_FinalCount_RuleID_14 - Number of violations of Rule ID = n that remain the last time the acc checker ran in a session.

  • Data_FinalCount_RuleID_15 - Number of violations of Rule ID = n that remain the last time the acc checker ran in a session.

  • Data_FinalCount_RuleID_16 - Number of violations of Rule ID = n that remain the last time the acc checker ran in a session.

  • Data_FinalCount_RuleID_17 - Number of violations of Rule ID = n that remain the last time the acc checker ran in a session.

  • Data_InitialCount_RuleID_0 - Number of violations of Rule ID = n that were found the first time the acc checker ran in a session.

  • Data_InitialCount_RuleID_1 - Number of violations of Rule ID = n that were found the first time the acc checker ran in a session.

  • Data_InitialCount_RuleID_2 - Number of violations of Rule ID = n that were found the first time the acc checker ran in a session.

  • Data_InitialCount_RuleID_3 - Number of violations of Rule ID = n that were found the first time the acc checker ran in a session.

  • Data_InitialCount_RuleID_4 - Number of violations of Rule ID = n that were found the first time the acc checker ran in a session.

  • Data_InitialCount_RuleID_5 - Number of violations of Rule ID = n that were found the first time the acc checker ran in a session.

  • Data_InitialCount_RuleID_6 - Number of violations of Rule ID = n that were found the first time the acc checker ran in a session.

  • Data_InitialCount_RuleID_7 - Number of violations of Rule ID = n that were found the first time the acc checker ran in a session.

  • Data_InitialCount_RuleID_8 - Number of violations of Rule ID = n that were found the first time the acc checker ran in a session.

  • Data_InitialCount_RuleID_9 - Number of violations of Rule ID = n that were found the first time the acc checker ran in a session.

  • Data_InitialCount_RuleID_10 - Number of violations of Rule ID = n that were found the first time the acc checker ran in a session.

  • Data_InitialCount_RuleID_11 - Number of violations of Rule ID = n that were found the first time the acc checker ran in a session.

  • Data_InitialCount_RuleID_12 - Number of violations of Rule ID = n that were found the first time the acc checker ran in a session.

  • Data_InitialCount_RuleID_13 - Number of violations of Rule ID = n that were found the first time the acc checker ran in a session.

  • Data_InitialCount_RuleID_14 - Number of violations of Rule ID = n that were found the first time the acc checker ran in a session.

  • Data_InitialCount_RuleID_15 - Number of violations of Rule ID = n that were found the first time the acc checker ran in a session.

  • Data_InitialCount_RuleID_16 - Number of violations of Rule ID = n that were found the first time the acc checker ran in a session.

  • Data_InitialCount_RuleID_17 - Number of violations of Rule ID = n that were found the first time the acc checker ran in a session.

  • FinalDocID - Final DocumentID of the scanned document

  • FinalDocUrlHash - Final DocumentURLHash of the scanned document

  • InitialDocID - Initial DocumentID of the scanned document

  • InitialDocUrlHash - Initial DocumentURLHash of the scanned document

  • PaneOpened - A boolean that tracks whether the AccChecker pane was opened

  • ServerDocID - Server DocumentID for the document scanned by the Accessibility checker

Office.UX.AccChecker.AccCheckerViolationInformation

This event is triggered when Accessibility issues are reported for the currently opened document. It represents the aggregate counts of violations (Errors, Warnings, and Tips) for the opened document at the beginning and end of the session. This event is used to record the aggregate counts of Accessibility violations (Errors, Warnings, and Tips) for the opened document at the beginning and end of the session. The knowledge of Accessibility checker usage allows Microsoft to improve its application experiences to be more inclusive for people with disabilities in Office usage scenarios for the workplace and classroom.

The following fields are collected:

  • FinalDocID - Final DocumentID of the scanned document

  • FinalDocUrlHash - Final DocumentURLHash of the scanned document

  • FinalErrorCount - Final count of Errors reported by Accessibility Checker for the document

  • FinalIntelligentServiceCount - Final count of Intelligent services issues reported by Accessibility Checker for the document

  • FinalTipCount - Final count of tips reported by Accessibility Checker for the document

  • FinalViolationCount - Final count of violations reported by Accessibility Checker for the document

  • FinalWarningCount - Final count of warnings reported by Accessibility Checker in the document

  • InitialDocID - Initial DocumentID of the scanned document

  • InitialDocUrlHash - Initial DocumentURLHash of the scanned document

  • InitialErrorCount - Number of all violations of type Error that were found the first time the acc checker ran in a session.

  • InitialIntelligentServicesCount - Number of all violations of type Intelligent Service that were found the first time the acc checker ran in a session.

  • InitialTipCount - Number of all violations of type Tip that were found the first time the acc checker ran in a session.

  • InitialUrlHash - Number of all violations of type error that were found the first time the acc checker ran in a session.

  • InitialViolationCount - Number of all violations that were found the first time the acc checker ran in a session.

  • InitialWarningCount - Number of all violations of type Warning that were found the first time the acc checker ran in a session.

  • PaneOpened - A Boolean that tracks whether the Accessibility Checker pane was opened

  • ServerDocID - Server DocumentID for the document scanned by the Accessibility checker

Office.UX.AccChecker.BackgroundAccCheckerEnabledState

This event is triggered when the user or IT Admin has enabled the Background Accessibility checker for the Office user. This event is used to understand the instances when the Background Accessibility checker is enabled for Office users. The enabled status of the Background Accessibility checker allows Microsoft to understand if documents can be scanned automatically in the background. This helps to create a more inclusive workplace and classroom environment for people with disabilities.

The following fields are collected:

  • BackgroundAccCheckerEnabled - Boolean to track the Enabled/Disabled state of the Background Accessibility checker

Office.UX.AccChecker.BackgroundScanningCheckboxClicked

This event is triggered when the user enables the Background Accessibility checker from the Accessibility checker task pane. This event is used to understand the instances when the Background Accessibility checker is enabled for Office documents. The enabled status of the Background Accessibility checker allows Microsoft to understand if documents can be scanned automatically in the background. This helps to create a more inclusive workplace and classroom environment for people with disabilities.

The following fields are collected:

  • FinalBackgroundScanningState - Initial state of the checkbox that enables background scanning

  • InitialBackgroundScanningState - Initial state of the checkbox that enables background scanning

Office.UX.AccChecker.DisabledResults

This event is triggered when the Accessibility Checker gets disabled for the opened document. This event is used to understand the instances when the Office Accessibility checker gets disabled, due to a legacy or unsupported Office document. The disabled status of the Accessibility checker allows Microsoft to understand how often a document can't be scanned, and to assist users in allowing the scanning of such documents – by upconverting the document to a modern file format. This helps to create a more inclusive workplace and classroom environment for people with disabilities.

The following fields are collected:

  • Data_Disabled_ID - ID of the disabled error

  • Data_Disabled_Reason - Reason for disabling the Accessibility Checker

  • Data_IsUpConvertEnabled - Tracks whether Upconvert to a modern file format is available for the document

Office.UX.AccChecker.ShowTaskPane

This event is triggered when the Accessibility Checker task pane is launched for the currently opened document. This event is used to understand the usage of the Office Accessibility Checker. The Accessibility Checker is used to identify and remediate Accessibility issues in Office documents. The knowledge of Accessibility Checker usage allows Microsoft to improve its application experiences to be more inclusive for people with disabilities in Office usage scenarios for the workplace and classroom.

The following fields are collected:

  • BackgroundScanCheckboxEnabled - Tracks whether the Background Accessibility Checker is enabled

  • Column - Purpose

  • DocUrlHash - Unique doc ID hash of the document that was scanned

  • HasAccessibilityViolations - Tracks if the document contains any accessibility violations at the point the pane is opened

  • IsPaneDisabled - Tracks if the Accessibility Checker pane is opened in a disabled state (legacy or unsupported document)

  • PaneOpenedBefore - Tracks if the Accessibility Checker pane was opened before

  • WAC_ServerDocId - Server Document ID for the document that was scanned

Office.Visio.Shared.FeatureExperimentation

Tracks feature flighting for users. This event helps us determines success or failure of feature flights.

The following fields are collected:

  • Data_Enable:bool- true indicate the feature is enabled for current user

  • Data_Feature:string - name of the feature

  • Data_Flighted:bool - true indicates the feature is enabled

  • Data_Licensed:bool - true indicates the feature is under licensing check

  • Data_Subscriber:bool - true indicates the user has subscription license

Office.Visio.Shared.RefreshSmartDiagram

Captures diagram refresh failures when file is created through DV. This helps us debug the failures and issues in data refresh in a DV diagram.

The following fields are collected:

  • Data_ConnectorsBasedOnSequence:bool - true if the refreshed diagram was originally created using connector based on sequence" option

  • Data_DialogError:string - error during refreshing smart diagram

  • Data_FileError:string - error string when connected Excel file is invalid

  • Data_OverwriteSelected:bool - true if user selected overwrite diagram option during refresh

  • Data_WarningShown:bool - true if there was any warning shown to user during data refresh

Office.Visio.Shared.WritebackToExcel

Captures Excel write back failures when file is created through DV. This helps us debug the failures and issues in writing back data to Excel in a DV diagram.

The following fields are collected:

  • Data_ConnectorsBasedOnSequence:bool - true means connectors are created based on sequence settings

  • Data_DataSourceType:string - This filed indicates whether diagram is created from  "Table" or "CustomRange"

  • Data_DialogError:string - Custom Error type while creating smart diagram through Excel

  • Data_NoOfShapesAdded:int - Number of shapes added during writeback to Excel functionality

  • Data_NoOfShapesDeleted:int - Number of shapes deleted during writeback to Excel functionality

  • Data_OverwriteSelected:bool - true indicate user selected overwrite data option

  • Data_SourceDataModified:bool - true indicates source data is modified

  • Data_WarningShown:bool - true means data update warning shown to the user

  • Data_WarningShownBecauseOfPresenceOfFormula:bool - true indicates warning shown to the user because of presence of formula in Excel

  • Data_WarningShownToAddNextStepID:bool - true indicates warning show to the user because next step Identifier missing in Excel

  • Data_WarningShownToConvertToTable:bool - true indicates warning shown to the user to convert Excel data to table format

Office.Word.Accessibility.LearningTools.ReadAloud.ReadAloudGetDataFromCache

[This event was previously named Office.Word.Accessibility.LearningTools.ReadAloud.EventName.ReadAloudGetDataFromCache.]

The event is triggered when user listens to a paragraph that has already been prefetched and Read Aloud will be playing the cached paragraph now instead of making a request to EDU service to get the neural voice. The data helps track how many of users are using previously-fetched paragraphs thereby giving usage ideas along with the solidifying our calculation for Read Aloud play minutes since the paragraphs that are read from cache are currently not getting tracked. Data is used to track the usage of Read Aloud neural implementation via cached files, how many minutes are being generated.

The following fields are collected:

  • Data_input_length - Log the text length that is being read from cache

  • Data_locale - Log the locale that was passed with initial request

Office.Word.Document.DirtyFlagChanged

This event indicates Office Word edits a document that changes the document internal state into "dirty". It allows Microsoft to evaluate the feature health of edit-document. The event is a heartbeat of user edits. It's also used to calculated monthly active users/devices.

The following fields are collected:

  • Data_CollectionTime- Timestamp of the event.

  • Data_DirtyTag - The code identifier the makes the document edit.

  • Data_Doc_AccessMode - Document is read only/editable.

  • Data_Doc_AsyncOpenKind – Indicates whether a cached version of the cloud document was opened and which asynchronous refresh logic was used.

  • Data_Doc_CreationTime - Document creation timestamp.

  • Data_Doc_EdpState - Electronic Data Protection setting for the document.

  • Data_Doc_Ext - Document extension (docx/xlsb/pptx, etc.)

  • Data_Doc_FileFormat - File format protocol version.

  • Data_Doc_FolderUrlHash - One-way hash of folder URL.

  • Data_Doc_Fqdn - OneDrive or SharePoint Domain Name.

  • Data_Doc_FqdnHash - One-way hash of customer identifiable domain name.

  • Data_Doc_IdentityTelemetryId - A one-way hash of the user identity used to perform the open.

  • Data_Doc_InitializationScenario - Records how the document was opened.

  • Data_Doc_IOFlags - Reports on the cached flags used to set open request options.

  • Data_Doc_IrmRights - Actions permitted by the Electronic Data Protection policy that has been applied to the document/user.

  • Data_Doc_IsCloudCollabEnabled - Flag indicating whether the cloud collaboration is enabled for the file.

  • Data_Doc_IsOcsSupported - Flag indicating that the document is supported in the collaboration service.

  • Data_Doc_IsOpeningOfflineCopy - Flag indicating that the offline copy of a document was opened.

  • Data_Doc_IsPrefetched - Flag indicating whether the file was prefetched before open operation happened.

  • Data_Doc_IsSyncBacked - Flag indicating that an auto synced copy of the document exists on the computer.

  • Data_Doc_KnownFolderMoveStatus - Represents the signed-in user's known folder migration status in a given session.

  • Data_Doc_LastModifiedTime - Timestamp when document was last modified.

  • Data_Doc_LicenseCategory - Indicates the license category of the user (EnhancedRFM, SubscriptionConsumer, Freemium, etc.).

  • Data_Doc_Location - Indicates which service provided the document (OneDrive, File Server, SharePoint).

  • Data_Doc_NumberCoAuthors - Count of the number of fellow users in a collaborative editing session.

  • Data_Doc_ReadOnlyReasons - Reasons why the document was opened read only.

  • Data_Doc_ResourceIdHash - An anonymized document identifier used to diagnose problems.

  • Data_Doc_RtcType - Indicates how the real-time channel (RTC) was set up for current file (Disabled, unsupported, on demand, always on, etc.).

  • Data_Doc_ServerDocId - An immutable anonymized document identifier used to diagnose problems.

  • Data_Doc_ServerProtocol - The protocol version used to communicate with the service.

  • Data_Doc_ServerStore - Predefined set of values for which schema is used to store the file on the service.

  • Data_Doc_ServerType - The type of the server offering the service (SharePoint, OneDrive, WOPI etc.).

  • Data_Doc_ServerVersion - The server version offering the service.

  • Data_Doc_SessionId - The server version offering the service.

  • Data_Doc_SizeInBytes - Indicator of document size.

  • Data_Doc_StorageProviderId - Identifier of the document storage provider, like "Computer".

  • Data_Doc_StorageSchema - Predefined set of values for which schema is used to store the file cached on disk.

  • Data_Doc_StreamAvailability - Indicator if document stream is available/disabled.

  • Data_Doc_TenantId - GUID that identifies the SharePoint tenant where the document is located.

  • Data_Doc_UrlHash - One-way hash to create a naïve document identifier.

  • Data_DocumentLocation - type of the document location.

  • Data_DocumentLocationDetails - Sub-type of the document location.

  • Data_FAlwaysSaveEnabled - Indicates whether always-save was enabled.

  • Data_FirstEditTime - Timestamp of first edit.

  • Data_IntervalMin - Interval to send this telemetry event.

  • Data_IntervalThresholdMin - Interval threshold to allow sending this telemetry event.

  • Data_NumberCoAuthors - Number of coauthors editing the document during the session.

  • Data_NumberOfTimesDocumentDirtied - Number of edits made to the document.

  • Data_pdod - The document identifier during this process session.

  • Data_UrlHash - Hash of the document path.

  • Data_ViewKind - Type of Word view.

Office.Word.FileNew.CreateNewFile

This event indicates that a new document is created in Office Word and tracks success or failure of the operation. The event is used to monitor that new document creation is working as expected. It's also used to calculated monthly active users/devices and cloud reliability metrics.

The following fields are collected:

  • Data_DirtyState - whether the document was created in a dirty state (with changes that need to be saved)

  • Data_ErrorID - error identifier in case of operation failure

  • Data_MainPdod - The document identifier during this process session

  • Data_StyleVersion – version number of default Word styles.

  • Data_UsesCustomTemplate - indicates whether the document was created from a custom template

Office.Word.FileOpen.UserInitiatedOpen

This event is triggered when a user opens a Word document. The event monitors whether "file open" is working as expected. The data is used to calculate monthly active users/devices, and cloud reliability metrics.

The following fields are collected:

  • Data_AddDocTelemRes - Reports whether we were able to properly populate other document telemetry-related values in the event. Used for data quality diagnostics.

  • Data_BytesAsynchronous - Number of bytes (compressed) that we believe we can open the file without if we get them before the user wants to start editing or maybe saving.

  • Data_BytesAsynchronousWithWork - Number of bytes (compressed) that we might be able to open the file without but would require significant code investments to make it happen

  • Data_BytesSynchronous - Number of bytes (compressed) that we must have before we can start opening the file

  • Data_BytesUnknown - Number of bytes in document parts that we don't expect to find.

  • Data_Doc_AccessMode - Document is read only/editable

  • Data_Doc_AssistedReadingReasons - Predefined set of values of why document was opened in assisted reading mode

  • Data_Doc_ChunkingType - Units used for incremental document open

  • Data_Doc_EdpState - Electronic Data Protection setting for the document

  • Data_Doc_Ext - Document extension (docx/xlsb/pptx, etc.)

  • Data_Doc_FileFormat - File format protocol version

  • Data_Doc_Fqdn - OneDrive or SharePoint Domain Name

  • Data_Doc_FqdnHash - One-way hash of customer identifiable domain name

  • Data_Doc_IdentityTelemetryId - A one-way hash of the user identity used to perform the open

  • Data_Doc_InitializationScenario - Records how the document was opened

  • Data_Doc_IOFlags - Reports on the cached flags used to set open request options

  • Data_Doc_IrmRights - Actions permitted by the Electronic Data Protection policy that has been applied to the document/user

  • Data_Doc_IsConvergedOD - Flag indicating that the document belongs to a OneDrive consumer account that has been migrated to the SharePoint service

  • Data_Doc_IsIncrementalOpen - Flag indicating that the document has been incrementally opened

  • Data_Doc_IsOcsSupported - Flag indicating that the document is supported in the collaboration service

  • Data_Doc_IsOpeningOfflineCopy - Flag indicating that the offline copy of a document was opened

  • Data_Doc_IsSyncBacked - Flag indicating that an auto synced copy of the document exists on the computer

  • Data_Doc_KnownFolderMoveStatus - represents the signed-in user's known folder migration status in a given session.

  • Data_Doc_LicenseCategory - Indicates the license category of the user (EnhancedRFM, SubscriptionConsumer, Freemium, etc.)

  • Data_Doc_Location - Indicates which service provided the document (OneDrive, File Server, SharePoint)

  • Data_Doc_LocationDetails - Indicates which Known Folder provided a locally stored document

  • Data_Doc_NumberCoAuthors - Count of the number of fellow users in a collaborative editing session

  • Data_Doc_PasswordFlags - Indicates read or read/write password flags set

  • Data_Doc_ReadOnlyReasons - Reasons why the document was opened read only

  • Data_Doc_ResourceIdHash - An anonymized document Identifier used to diagnose problems

  • Data_Doc_ServerDocId - An immutable anonymized document Identifier used to diagnose problems

  • Data_Doc_ServerProtocol - the protocol version used to communicate with the service

  • Data_Doc_ServerStore - Predefined set of values for which schema is used to store the file on the service

  • Data_Doc_ServerType - the type of the server offering the service (SharePoint, OneDrive, WOPI etc.)

  • Data_Doc_ServerVersion - the server version offering the service

  • Data_Doc_SessionId - the server version offering the service

  • Data_Doc_SharePointServiceContext - Diagnostic information from SharePoint requests

  • Data_Doc_SizeInBytes - Indicator of document size

  • Data_Doc_SpecialChars - Indicator of special chars in the document's URL or Path

  • Data_Doc_StorageSchema - Predefined set of values for which schema is used to store the file cached on disk

  • Data_Doc_StreamAvailability - Indicator if document stream is available/disabled

  • Data_Doc_SyncBackedType - Indicator as to the type of document (local or service based)

  • Data_Doc_TenantId - GUID that identifies the SharePoint tenant where the document is located

  • Data_Doc_UrlHash - One-way hash to create a naïve document identifier

  • Data_Doc_WopiServiceId - Contains unique identifier of WOPI service provider

  • Data_EditorDisablingRename - Identifier of the first editor that caused for rename to be disabled

  • Data_EditorsCount - Number of editors in the document

  • Data_FFileInUseDialog - Indicates that "File in Use" dialog box appeared while opening this document.

  • Data_FHasWPMUnsafeEdit - Indicates that the document has WPM unsupported contents upon open.

  • Data_FOpenWpmRecoveryRevision - Indicates that the document has been opened from the OCSB2 recovery revision.

  • Data_ForceReadWriteReason - Integer value representing the reason why the file was forced into read/write mode

  • Data_FSucceededAfterRecoverableFailure - Indicates that open succeeded after repairing a failure while opening the document

  • Data_InsecureProtocolStatus - Reports that tool tried to detect if file is accessed using an insecure protocol and captures user-choice (either abort the open, continue with insecure protocol, or upgrade to secure protocol) in the dialog box shown.

  • Data_LastLoggedTag - Unique tag for code call site used to identify when we try to fail the open twice (used for data quality diagnostics)

  • Data_LinkStyles - Indicates whether we're linking to the template styles

  • Data_MainPdod - The document identifier in Office Word process

  • Data_Measurements - Encoded string containing the time breakdown of the different parts of open. Used to diagnose open performance.

  • Data_MoveDisabledReason - Error that is disabling move for the document

  • Data_MoveFlightEnabled - Whether the flight for the move feature is enabled

  • Data_OpenInitiateKind – Type of the scenario where users started this file-open operation.

  • Data_PartsUnknown - The number of document parts that we couldn't get data for

  • Data_RecoverableFailureInitiationLocationTag - Unique tag for code call site used to identify the place in code where we attempt to fix the file before opening it

  • Data_RenameDisabledReason - Error that is causing for rename to be disabled for this document

  • Data_RenameFlightEnabled - Whether the flight for the rename feature is enabled

  • Data_SecondaryTag - Unique tag for code call site used to add additional failure data for open.

  • Data_TemplateFormat - File format of the template that the document is based on.

  • Data_UsesNormal - Indicates whether the open document is based on the normal template.

  • Data_VerboseMeasurements - Encoded string containing the detailed time breakdown of the different parts of open. Used to measure performance, only enabled for internal rings.

  • Data_WpmFallOutReason - If the document has WPM unsupported contents upon open, list the first content type Word detected.

  • KfmStatus - determines whether user is known folder move (KFM) enrolled, eligible or not eligible. It also determines if user is signed in or not, and whether user's device is KFM enrolled eligible or not eligible.

Office.Word.FileSave.ActCmdGosubSaveAs

This event indicates that a user is saving their changes to a new document. The event monitors whether saving to a new document is working as expected. It's also used to calculated monthly active users/devices and cloud reliability metrics.

The following fields are collected:

  • Data_AddDocTelemRes - Reports whether we were able to properly populate other document telemetry-related values in the event. Used for data quality diagnostics.

  • Data_DetachedDuration - How long was the activity detached from the thread

  • Data_Doc_AccessMode - Document is read only/editable

  • Data_Doc_AssistedReadingReasons - Predefined set of values of why document was opened in assisted reading mode

  • Data_Doc_AsyncOpenKind – Indicates whether a cached version of the cloud document was opened and which asynchronous refresh logic was used.

  • Data_Doc_ChunkingType - Units used for incremental document open

  • Data_Doc_EdpState - Electronic Data Protection setting for the document

  • Data_Doc_Ext - Document extension (docx/xlsb/pptx etc.)

  • Data_Doc_FileFormat - File format protocol version

  • Data_Doc_Fqdn - OneDrive or SharePoint Domain Name

  • Data_Doc_FqdnHash - One-way hash of customer identifiable domain name

  • Data_Doc_IdentityTelemetryId - A one-way hash of the user identity used to perform the open

  • Data_Doc_InitializationScenario - Records how the document was opened

  • Data_Doc_IOFlags - Reports on the cached flags used to set open request options

  • Data_Doc_IrmRights - Actions permitted by the Electronic Data Protection policy that has been applied to the document/user

  • Data_Doc_IsIncrementalOpen - Flag indicating that the document has been incrementally opened

  • Data_Doc_IsOcsSupported - Flag indicating that the document is supported in the collaboration service

  • Data_Doc_IsOpeningOfflineCopy - Flag indicating that the offline copy of a document was opened

  • Data_Doc_IsSyncBacked - Flag indicating that an auto synced copy of the document exists on the computer

  • Data_Doc_Location - Indicates which service provided the document (OneDrive, File Server, SharePoint etc.)

  • Data_Doc_LocationDetails - Indicates which Known Folder provided a locally stored document

  • Data_Doc_NumberCoAuthors - Count of the number of fellow users in a collaborative editing session

  • Data_Doc_PasswordFlags - Indicates read or read/write password flags set

  • Data_Doc_ReadOnlyReasons - Reasons why the document was opened read only

  • Data_Doc_ResourceIdHash - An anonymized document identifier used to diagnose problems

  • Data_Doc_RtcType - Indicates how the real-time channel (RTC) was set up for current file (Disabled, unsupported, on demand, always on, etc.).

  • Data_Doc_ServerDocId - An immutable anonymized document identifier used to diagnose problems

  • Data_Doc_ServerProtocol - The protocol version used to communicate with the service

  • Data_Doc_ServerType - The type of the server offering the service (SharePoint, OneDrive, WOPI etc.)

  • Data_Doc_ServerVersion - The server version offering the service

  • Data_Doc_SessionId - Identifies a specific document edit session within the full session

  • Data_Doc_SharePointServiceContext - Diagnostic information from SharePoint requests

  • Data_Doc_SizeInBytes - Indicator of document size

  • Data_Doc_SpecialChars - Indicator of special chars in the document's URL or Path

  • Data_Doc_StreamAvailability - Indicator if document stream is available/disabled

  • Data_Doc_SyncBackedType - Indicator as to the type of document (local or service based)

  • Data_Doc_UrlHash - One-way hash to create a naïve document identifier

  • Data_EditorDisablingRename - identifier of the first editor that caused rename to be disabled

  • Data_EditorsCount - Number of editors in the document

  • Data_LastLoggedTag - Unique tag for code call site used to identify when we fail to try the save twice (used for data quality diagnostics)

  • Data_MoveDisabledReason - Error that is disabling move for the document

  • Data_MoveFlightEnabled - Whether the flight for the move feature is enabled

  • Data_RenameDisabledReason - Error that is causing rename to be disabled for the document

  • Data_RenameFlightEnabled - Whether the flight for the rename feature is enabled

Office.Word.FileSave.ActFConfirmSaveDocCoreQuerySave

This event indicates Office Word prompts the user to save changes when it tries to close the document. It allows Microsoft to monitor whether save-at-quit works as expected to avoid document data loss. The event monitors whether save-at-quit is working as expected. It's also used to calculated monthly active users/devices and cloud reliability metrics.

The following fields are collected:

  • Data_AddDocTelemRes - Reports whether we were able to properly populate other document telemetry-related values in the event. Used for data quality diagnostics.

  • Data_DetachedDuration - How long was the activity detached from the thread

  • Data_Doc_AccessMode - Document is read only/editable

  • Data_Doc_AssistedReadingReasons - Predefined set of values of why document was opened in assisted reading mode

  • Data_Doc_AsyncOpenKind – Indicates whether a cached version of the cloud document was opened and which asynchronous refresh logic was used.

  • Data_Doc_ChunkingType - Units used for incremental document open

  • Data_Doc_EdpState - Electronic Data Protection setting for the document

  • Data_Doc_Ext - Document extension (docx/xlsb/pptx etc.)

  • Data_Doc_FileFormat - File format protocol version

  • Data_Doc_Fqdn - OneDrive or SharePoint Domain Name

  • Data_Doc_FqdnHash - One-way hash of customer identifiable domain name

  • Data_Doc_IdentityTelemetryId - A one-way hash of the user identity used to perform the open

  • Data_Doc_InitializationScenario - Records how the document was opened

  • Data_Doc_IOFlags - Reports on the cached flags used to set open request options

  • Data_Doc_IrmRights - Actions permitted by the Electronic Data Protection policy that has been applied to the document/user

  • Data_Doc_IsIncrementalOpen - Flag indicating that the document has been incrementally opened

  • Data_Doc_IsOcsSupported - Flag indicating that the document is supported in the collaboration service

  • Data_Doc_IsOpeningOfflineCopy - Flag indicating that the offline copy of a document was opened

  • Data_Doc_IsSyncBacked - Flag indicating that an auto synced copy of the document exists on the computer

  • Data_Doc_Location - Indicates which service provided the document (OneDrive, File Server, SharePoint etc.)

  • Data_Doc_LocationDetails - Indicates which Known Folder provided a locally stored document

  • Data_Doc_NumberCoAuthors - Count of the number of fellow users in a collaborative editing session

  • Data_Doc_PasswordFlags - Indicates read or read/write password flags set

  • Data_Doc_ReadOnlyReasons - Reasons why the document was opened read only

  • Data_Doc_ResourceIdHash - An anonymized document identifier used to diagnose problems

  • Data_Doc_RtcType - Indicates how the real-time channel (RTC) was set up for current file (Disabled, unsupported, on demand, always on, etc.).

  • Data_Doc_ServerDocId - An immutable anonymized document identifier used to diagnose problems

  • Data_Doc_ServerProtocol - the protocol version used to communicate with the service

  • Data_Doc_ServerType - the type of the server offering the service (SharePoint, OneDrive, WOPI etc.)

  • Data_Doc_ServerVersion - the server version offering the service

  • Data_Doc_SessionId - Identifies a specific document edit session within the full session

  • Data_Doc_SharePointServiceContext - Diagnostic information from SharePoint requests

  • Data_Doc_SizeInBytes - Indicator of document size

  • Data_Doc_SpecialChars - Indicator of special chars in the document's URL or Path

  • Data_Doc_StreamAvailability - Indicator if document stream is available/disabled

  • Data_Doc_SyncBackedType - Indicator as to the type of document (local or service based)

  • Data_Doc_UrlHash - One-way hash to create a naïve document identifier

  • Data_Doc_WopiServiceId - Contains unique identifier of WOPI service provider

  • Data_DstDoc_AccessMode - Destination Document is read only/editable

  • Data_DstDoc_EdpState -Electronic Data Protection setting for the destination document-

  • Data_DstDoc_Ext - Document extension (docx/xlsb/pptx, etc.) for the destination document

  • Data_DstDoc_FileFormat - File format protocol version for the destination document

  • Data_DstDoc_Location - Indicates which service will provide storage for destination document (OneDrive, File Server, SharePoint etc.)

  • Data_DstDoc_LocationDetails - Indicates which local Known Folder stored the destination document

  • Data_DstDoc_SessionId - Identifies a specific document edit session within the full session

  • Data_DstDoc_UrlHash - One-way hash to create a naïve document identifier for the destination document

  • Data_FailureClass - Integer representing the failure class for OCS transition failures

  • Data_LocationPickerSaveStatus - Integer value that indicates the action that triggered the save from the save on exit dialog

  • Data_MainPdod - The document identifier in Office Word process.

  • Data_MoveFlightEnabled - Whether the flight for the move feature is enabled

  • Data_OCSSyncbackSaveStarted - Flag that indicates that this save is related to sync back save

  • Data_RenameDisabledReason - Error that is causing for rename to be disabled for this document

  • Data_RenameFlightEnabled - Whether the flight for the rename feature is enabled

  • Data_SaveInitiateKind - Integer that indicates how the save was initiated

  • Data_SrcDocIsUnnamedOrNew - Indicates whether the document we're saving is new

Office.Word.FileSave.SaveAsSaveFile

This event indicates Office Word saves a document into a new document. It allows Microsoft to detect errors in save-as, which is important to avoid document data loss. The event monitors whether save-as is working as expected. It's also used to calculated monthly active users/devices and cloud reliability metrics.

The following fields are collected:

  • Data_AddDocTelemRes - Reports whether we were able to properly populate other document telemetry-related values in the event. Used for data quality diagnostics.

  • Data_AddDocTelemResDst - Reports whether we were able to properly populate other document telemetry-related values in the event for the destination document. Used for data quality diagnostics.

  • Data_AddDocTelemResSrc - Reports whether we were able to properly populate other document telemetry-related values in the event for the source document. Used for data quality diagnostics.

  • Data_CantSkipSaveReason - Reason for not skipping save. There are cases when save can be skipped on purpose (for example, if there are no changes on the document since the last save).

  • Data_DetachedDuration - How long was the activity detached from the thread

  • Data_dmsecBackgroundSaveMaxUnresponsivenessInterval - Max continuous time interval (in milliseconds) when Word was unresponsive during a background save.

  • Data_dmsecForegroundSaveUnresponsivenessTime - Time interval (in milliseconds) when Word was unresponsive during a foreground save.

  • Data_Doc_AccessMode - Document is read only/editable

  • Data_Doc_AssistedReadingReasons - Predefined set of values of why document was opened in assisted reading mode

  • Data_Doc_AsyncOpenKind – Indicates whether a cached version of the cloud document was opened and which asynchronous refresh logic was used.

  • Data_Doc_ChunkingType - Units used for incremental document open

  • Data_Doc_EdpState - Electronic Data Protection setting for the document

  • Data_Doc_Ext - Document extension (docx/xlsb/pptx etc.)

  • Data_Doc_FileFormat - File format protocol version

  • Data_Doc_Fqdn - OneDrive or SharePoint Domain Name

  • Data_Doc_FqdnHash - One-way hash of customer identifiable domain name

  • Data_Doc_IdentityTelemetryId - A one-way hash of the user identity used to perform the open

  • Data_Doc_IOFlags - Reports on the cached flags used to set open request options

  • Data_Doc_IrmRights - Actions permitted by the Electronic Data Protection policy that has been applied to the document/user

  • Data_Doc_IsIncrementalOpen - Flag indicating that the document has been incrementally opened

  • Data_Doc_IsOcsSupported - Flag indicating that the document is supported in the collaboration service

  • Data_Doc_IsOpeningOfflineCopy - Flag indicating that the offline copy of a document was opened

  • Data_Doc_IsSyncBacked - Flag indicating that an auto synced copy of the document exists on the computer

  • Data_Doc_Location - Indicates which service provided the document (OneDrive, File Server, SharePoint etc.)

  • Data_Doc_LocationDetails - Indicates which Known Folder provided a locally stored document

  • Data_Doc_NumberCoAuthors - Count of the number of fellow users in a collaborative editing session

  • Data_Doc_ReadOnlyReasons - Reasons why the document was opened read only

  • Data_Doc_ResourceIdHash - An anonymized document identifier used to diagnose problems

  • Data_Doc_RtcType - Indicates how the real-time channel (RTC) was set up for current file (Disabled, unsupported, on demand, always on, etc.).

  • Data_Doc_ServerDocId - An immutable anonymized document identifier used to diagnose problems

  • Data_Doc_ServerProtocol - the protocol version used to communicate with the service

  • Data_Doc_ServerType - the type of the server offering the service (SharePoint, OneDrive, WOPI etc.)

  • Data_Doc_ServerVersion - the server version offering the service

  • Data_Doc_SessionId - Identifies a specific document edit session within the full session

  • Data_Doc_SharePointServiceContext - Diagnostic information from SharePoint requests

  • Data_Doc_SizeInBytes - Indicator of document size

  • Data_Doc_SpecialChars - Indicator of special chars in the document's URL or Path

  • Data_Doc_StreamAvailability - Indicator if document stream is available/disabled

  • Data_Doc_UrlHash - One-way hash to create a naïve document identifier

  • Data_DstDoc_AccessMode - Destination Document is read only/editable

  • Data_DstDoc_AssistedReadingReasons - Predefined set of values of why the destination document was opened in assisted reading mode

  • Data_DstDoc_AsyncOpenKind – Indicates whether a cached version of the new cloud document was opened and which asynchronous refresh logic was used.

  • Data_DstDoc_ChunkingType - Units used for incremental document open

  • Data_DstDoc_EdpState - Electronic Data Protection setting for the destination document

  • Data_DstDoc_Ext - Document extension (docx/xlsb/pptx etc.)

  • Data_DstDoc_FileFormat - File format protocol version

  • Data_DstDoc_Fqdn - OneDrive or SharePoint Domain Name for the destination document

  • Data_DstDoc_FqdnHash - One-way hash of customer identifiable domain name for the destination document

  • Data_DstDoc_IdentityTelemetryId - A one-way hash of the user identity used to perform the open

  • Data_DstDoc_InitializationScenario - Records how the destination document was opened

  • Data_DstDoc_IOFlags - Reports on the cached flags used to set open request options for the destination document

  • Data_DstDoc_IrmRights - Actions permitted by the Electronic Data Protection policy that has been applied to the destination document/user

  • Data_DstDoc_IsIncrementalOpen - Flag indicating that the document has been incrementally opened

  • Data_DstDoc_IsOcsSupported - Flag indicating that the document is supported in the collaboration service

  • Data_DstDoc_IsOpeningOfflineCopy - Flag indicating that the offline copy of a document was opened

  • Data_DstDoc_IsSyncBacked - Flag indicating that an auto synced copy of the document exists on the computer

  • Data_DstDoc_Location - Indicates which service provided the storage for the destination document (OneDrive, File Server, SharePoint etc.)

  • Data_DstDoc_LocationDetails - Indicates which Known Folder provided a locally stored document

  • Data_DstDoc_NumberCoAuthors - Count of the number of fellow users in a collaborative editing session

  • Data_DstDoc_PasswordFlags - Indicates read or read/write password flags set for the destination document

  • Data_DstDoc_ReadOnlyReasons - Reasons why the destination document was opened read only

  • Data_DstDoc_ResourceIdHash - An anonymized document identifier used to diagnose problems

  • Data_DstDoc_ServerDocId - An immutable anonymized document identifier used to diagnose problems

  • Data_DstDoc_ServerProtocol - the protocol version used to communicate with the service

  • Data_DstDoc_ServerType - the type of the server offering the service (SharePoint, OneDrive, WOPI etc.)

  • Data_DstDoc_ServerVersion - the server version offering the service

  • Data_DstDoc_SessionId - Identifies a specific document edit session within the full session

  • Data_DstDoc_SharePointServiceContext - Diagnostic information from SharePoint requests

  • Data_DstDoc_SizeInBytes - Indicator of document size

  • Data_DstDoc_SpecialChars - Indicator of special chars in the document's URL or Path

  • Data_DstDoc_StreamAvailability - Indicator if document stream is available/disabled

  • Data_DstDoc_SyncBackedType - Indicator as to the type of document (local or service based)

  • Data_DstDoc_UrlHash - One-way hash to create a naïve document identifier for the destination document

  • Data_DstDoc_WopiServiceId - Contains unique identifier of WOPI service provider

  • Data_editToSaveTimeMicroseconds - The duration, measured in microseconds, between the moment a user edits a document and until the completion of the save operation.

  • Data_FailureClass - Integer representing the failure class for OCS transition failures

  • Data_fCoherencyFailureRetry - Flag indicating that the save operation retried for coherency failures

  • Data_FirstTryCV - The first save retry action identifier

  • Data_fOcsPersister - Flag indicating that the app is using collaboration service to save the document.

  • Data_fOperationCancelled - Flag indicating that the save operation is canceled

  • Data_fSaveAs - Flag indicating that the save operation is a SaveAs

  • Data_fSaveShouldBrickFile - Flag indicating that the save operation should brick the document

  • Data_fStoppedRetryingAtCap - Flag indicating that the save operation stopped retrying

  • Data_IntermediateResults - Intermediate save actions' trackbag tags and error codes

  • Data_IntermediateResultsTotalCount - Integer that indicates intermediate save action count

  • Data_LocationPickerPropagateToSaveTime,spLapsedMsec - Measure the time, in milliseconds, that it takes for the save to trigger after getting a result from the location picker

  • Data_LocationPickerSaveStatus - Status returned by the location picker

  • Data_MainPdod - The document identifier in Office Word process

  • Data_Measurements - Performance measurement data for the save operation

  • Data_MoveDisabledReason - Error that is disabling move for the document

  • Data_MoveFlightEnabled - Whether the flight for the move feature is enabled

  • Data_nSaveUIReshow - Integer that indicates how many times the Save UI shows

  • Data_OCSSyncbackSaveStarted - Flag indicating that the save operation has an error associated with saving to a cloud server

  • Data_RenameDisabledReason - Error that is causing for rename to be disabled for this document

  • Data_RenameFlightEnabled - Whether the flight for the rename feature is enabled

  • Data_RetryNumber - Integer that indicates how many times the save operation retries

  • Data_SaveInitiateKind - Integer that indicates how the save was initiated

  • Data_SaveOnClose - Flag indicating that the save operation happens in closing the document

  • Data_SecondaryTag - Secondary trackback tag for the save operation

  • Data_SrcDoc_AccessMode - Source Document is read only/editable

  • Data_SrcDoc_AssistedReadingReasons - Predefined set of values of why document was opened in assisted reading mode

  • Data_SrcDoc_AsyncOpenKind – Indicates whether a cached version of the original cloud document was opened and which asynchronous refresh logic was used.

  • Data_SrcDoc_ChunkingType - Units used for incremental document open

  • Data_SrcDoc_EdpState - Electronic Data Protection setting for the source document

  • Data_SrcDoc_Ext - Document extension for the source document (docx/xlsb/pptx, etc.)

  • Data_SrcDoc_FileFormat - File format protocol version for the source document

  • Data_SrcDoc_Fqdn - OneDrive or SharePoint Domain Name for the source document

  • Data_SrcDoc_FqdnHash - One-way hash of customer identifiable domain name for the source document

  • Data_SrcDoc_IdentityTelemetryId - A one-way hash of the user identity used to perform the open

  • Data_SrcDoc_InitializationScenario - Records how the document was opened

  • Data_SrcDoc_IOFlags - Reports on the cached flags used to set open request options

  • Data_SrcDoc_IrmRights - Actions permitted by the Electronic Data Protection policy that has been applied to the document/user

  • Data_SrcDoc_IsIncrementalOpen - Flag indicating that the document has been incrementally opened

  • Data_SrcDoc_IsOcsSupported - Flag indicating that the document is supported in the collaboration service

  • Data_SrcDoc_IsOpeningOfflineCopy - Flag indicating that the offline copy of a document was opened

  • Data_SrcDoc_IsSyncBacked - Flag indicating that an auto synced copy of the document exists on the computer

  • Data_SrcDoc_Location - Indicates which service provided the source document (OneDrive, File Server, SharePoint, etc.)

  • Data_SrcDoc_LocationDetails - Indicates which Known Folder provided a locally stored document

  • Data_SrcDoc_NumberCoAuthors - Count of the number of fellow users in a collaborative editing session

  • Data_SrcDoc_OlDocUniqueId - An immutable anonymized document identifier used to diagnose problems

  • Data_SrcDoc_PasswordFlags - Indicates read or read/write password flags set

  • Data_SrcDoc_ReadOnlyReasons - Reasons why the document was opened read only

  • Data_SrcDoc_ResourceIdHash - An anonymized document identifier used to diagnose problems

  • Data_SrcDoc_ServerDocId - An immutable anonymized document identifier used to diagnose problems

  • Data_SrcDoc_ServerProtocol - the protocol version used to communicate with the service

  • Data_SrcDoc_ServerType - the type of the server offering the service (SharePoint, OneDrive, WOPI etc.)

  • Data_SrcDoc_ServerVersion - the server version offering the service

  • Data_SrcDoc_SessionId - Identifies a specific document edit session within the full session

  • Data_SrcDoc_SharePointServiceContext - Diagnostic information from SharePoint requests

  • Data_SrcDoc_SizeInBytes - Indicator of document size

  • Data_SrcDoc_SpecialChars - Indicator of special chars in the document's URL or Path

  • Data_SrcDoc_StreamAvailability - Indicator if document stream is available/disabled

  • Data_SrcDoc_SyncBackedType - Indicator as to the type of document (local or service based)

  • Data_SrcDoc_UrlHash - One-way hash to create a naïve document identifier

  • Data_SrcDoc_WopiServiceId - Contains unique identifier of WOPI service provider

  • Data_SrcDocIsUnnamedOrNew - Indicates whether the document we're saving is new

  • Data_TrackbackTag - Trackback tag for the save operation

  • Data_VerboseMeasurements - Detailed performance measurement data for the save operation

  • FinalDocSize - The size of the document which is going to be saved finally.

  • fMergeSucceeded - Indicates if changes made by other users are merged to the document as part of the saving process.

  • HasPendingAutoCreate - Indicates whether the file is in the middle of AutoCreate process

  • IOTransactionId - unique identifier for various phases of save operation like loading and merging of document.

Office.Word.Word.DocumentDirtyFlagChanged

This event indicates Office Word edits a document that changes the document internal state into "dirty". It allows Microsoft to evaluate the feature health of edit-document. The event is a heartbeat of user edits. It's also used to calculated monthly active users/devices.

The following fields are collected:

  • Data_CollectionTime- Timestamp of the event

  • Data_DocumentLocation- type of the document location

  • Data_DocumentLocationDetails- Sub-type of the document location

  • Data_FAlwaysSaveEnabled- Indicates whether always-save was enabled

  • Data_FirstEditTime- Timestamp of first edit

  • Data_NumberCoAuthors- Number of co-authors editing the document during the session

  • Data_NumberOfTimesDocumentDirtied- Number of edits made to the document

  • Data_Pdod- Document identifier in Office Word process

  • Data_UrlHash- Hash of the document path

  • Data_ViewKind- Type of Word view

OneNote.App.Navigation.RatingReminderDialogShown

The critical signal used to measure effectiveness of trigger logic for Rating reminder. This dialog is shown when the user has met all the conditions to see the rating reminder (no. of active days, has rated previously or not, etc.). This is used to ensure that the trigger logic for Rating reminder. If the users are seeing this dialog, it will provide us with ways to receive feedback from the customers on the right time and improve app health.

The following fields are collected:

  • None

ParseLicenseOp

Collected when a user attempts to open an IRM protected doc or apply IRM protections. It contains the information needed to be able to properly investigate and diagnose issues that happen when parsing licenses operation is performed.

The following fields are collected:

  • AppInfo.ClientHierarchy - Client hierarchy, which indicates the application runs in production environment or developer environment

  • AppInfo.Name - Application name

  • AppInfo.Version - Application version

  • iKey - Logger server ID

  • RMS.ApplicationScenarioId - Scenario ID provided by the application

  • RMS.Duration - Total time for the operation to complete

  • RMS.DurationWithoutExternalOps - Total time minus external operations consumed, such as network latency.

  • RMS.ErrorCode - The error code returned if any from the operation

  • RMS.HttpCall - indicate if there's HTTP operation

  • RMS.LicenseFormat - The license Format: Xrml or Json

  • RMS.Result - Success or fail of the operation

  • RMS.ScenarioId - Scenario ID defined by Rights Management Service Client

  • RMS.SDKVersion - The version of Rights Management Service Client

  • RMS.ServerType - The type of Rights Management Service Server

  • RMS.StatusCode - Status code of the operation result

  • RMS.VerifyCertChainDuration - Duration time to verify certificate chain

  • RMS.VerifySignatureDuration - Duration time to verify signature

qr.code.scan

This event lets us know when a user signs into Outlook Mobile by scanning an auth QR code on a desktop Outlook client, which securely contains the user's sign-in information, thereby eliminating the need for manual sign-in. The event is used to detect the successful initiation and completion of the user authentication process using QR functionality. The event diagnoses sign-in errors that could prevent the user from successfully authenticating in the mobile app.

The following fields are collected:

  • action - what action has the user taken for the qrcode flow

read.conversation

This event is triggered when an email isn't visible on the device screen anymore. Used for monitoring possible negative impact on the health and performance of rendering an email message.

The following fields are collected:

  • above_40fps - count of frames rendered above 40 fps

  • above_50fps - count of frames rendered above 50 fps

  • above_55fps - count of frames rendered above 55 fps

  • adal_id - the account's active directory authentication ID, a unique identifier in the Microsoft authentication system

  • component_name - the name of the component/view that is active during the filtering

  • event_mode - the place in the app that the user entered the conversation (groups or other)

  • internet_message_id - a tracking ID for the most recent message in the conversation

  • orientation - the screen orientation at the time of the even (portrait or landscape)

  • recent_message_id - the ID of the most recent message in the conversation

  • start_time - timestamp of when the email message was visible to user.

  • suggested_reply_state - the state of suggested replies for this conversation (unavailable, available, shown, used, or discarded)

  • suggested_reply_types - indicates type and count of suggested reply shown/used for this conversation. It’s a dictionary. For example, {text: 2, send_avail: 1}.

  • total_count - total frames displayed by the component

  • view_duration - how long the component was viewed by the user

save.attempt

Allows us to identify the impact of issues caused by users attempting to save a file by evaluating the number of sessions impacted and if there are common features of those sessions.

The following fields are collected:

  • file_type - The type of file the user tried to save (such as .doc)

  • origin - Where the file save attempt originated from (such as from an email) so we can detect issues associated with saving a file from a specific place in the app

  • token_type - the type of token used to authenticate the account in order to save the file to help us detect authentication issues associated with saving a file

search.subtab.selected

The event collects origin points for the reason a search sub_tab was selected. The sub tabs sit under the primary app search bar to filter data. This event lets us track the entity type pills (all, mail, contacts, and calendar) that users are using when they do their searches so we can ensure the search filter mechanisms are working properly.

The following fields are collected:

  • properties_general -The general properties that all Aria event is collecting

  • selected_reason - The cause of the type pill getting selected, which could be one of the following values (glyph being an icon): tap_on_header, tap_on_see_all, enter_search_mode, mail_glyph, calendar_glyph.

  • subtab_type - The type pill that got selected, which could be one of these four values: all, mail, contact, event.

send.message

This event is triggered when the user has finished composing and taps the send button. Data collected indicates possible negative impact on the performance and health of sending email messages. The data is used to understand if the feature is functioning successfully.

The following fields are collected:

  • account - tracks the account that performed the action [This field has been removed from current builds of Office, but might still appear in older builds.]

  • choose_from_email_menu_clicked_count - the number of times user chooses attach email from attach menu.

  • compose_addressing_duration - indicates the total time user spends on To/Cc/Bcc fields

  • compose_duration - tracks the total time user took to compose the message including multiple drafts session

  • deferred_send - This tells us if the user has scheduled the email to be sent later.

  • draft_message_id - tracks the compose message ID of the message being sent

  • elaborate_used - indicates whether the message was generated by using the feature Elaborate. Its value can be one of "used", "not_used", "used_and_edited"

  • eml_attachment_count - the number of eml files being sent as attachments to the message.

  • event_mode - tracks the event mode if applicable to the message ("groups" or "other")

  • from_message_reminder - Indicates if the message was sent in response to a message reminder

  • from_voice_assistant - lets us know if a sent mail originated from the voice assistant.

  • has_attachment - indicates whether message has any attachments

  • has_eml_attachment - indicates whether message has any attachments of type eml.

  • has_mip_label - indicates whether a MIP label was stamped on the message or not

  • image_attachment_count - indicates how many images are being sent as attachments to the message

  • image_body_count - indicates how many images are being sent inline as part of the body of the message

  • image_movement_count - indicates how many images of the message that have been moved to inline or move back.

  • is_group_escalation - is this a group escalated message, "escalated message" is a message that was sent to the user's mailbox because of an escalation (subscribed to group)

  • is_groups - track whether message sent is a groups message or not

  • is_request_delivery_receipt - if the message was selected to request delivery receipt.

  • is_request_read_receipt - if the message was selected to request read receipt.

  • key_stroke_count - tracks the keystrokes count for the message that is being sent

  • mail_importance_type - the message’s importance type that user selected to mark the sending mail’s priority (for example, high/low/normal)

  • message_id - tracks the message ID being replied/forwarded

  • message_ordering_mode - tracks how the user orders their messages in the reading pane (for example, newest on bottom or newest on top) so we can analyze the impact this has on the send rate and the type of send (for example, reply, reply all, or forward).

  • origin - indicates where compose was initiated, that is, new, reply, quick reply etc.

  • proofing_card_shown - the number of proofing card displayed to show suggestions

  • proofing_suggestion_applied - the number of proofing suggestions applied by the user

  • proofing_suggestion_displayed - whether there's at least one proofing suggestion displayed while sending

  • proofing_unused_suggestions - the number of unresolved proofing suggestions while sending the message

  • send_draft_origin - indicates where send was initiated, that is, compose or quick reply

  • smart_compose_model_version - tracks which version of smart compose model is being used

  • source_inbox - indicates source inbox type for reference message,

  • suggested_reply_state - capturing suggested reply state that is, unavailable, available, shown, used, discarded for this sent mail

  • suggested_reply_types - indicates type and count of suggested reply shown/used for this sent email. It’s a dictionary. For example, {text: 2, send_avail: 1}.

  • suggestions_requested - indicates how many smart compose suggestions requested

  • suggestions_results - smart compose suggestions’ result. For example, accepted, rejected

  • suggestions_returned - indicates how many smart compose suggestions returned from server

  • suggestions_shown - indicates how many smart compose suggestions shown to the user

  • thread_id - indicates thread ID of the conversation being replied/forwarded

  • video_message_default_thumbnail_count - the number of video thumbnails that have been unfurled with default thumbnail while sending a message

  • video_message_deleted_thumbnail_count - the number of video thumbnails being deleted that have been unfurled through sharing link while sending a message

  • video_message_link_count - the number of video links that could be unfurled while sending a message

session

Allows us to detect and fix situations where we're using up too much of your device's battery and helps us identify what could be the cause.

The following fields are collected:

  • battery_level - tells us the battery level on the device to help us detect when our app is causing a negative impact on your device's battery level

  • has_hx - Tells us the account is using our new sync service to help us detect issues caused by our sync service

  • Session.Duration - the length of the session in seconds

  • Session.DurationBucket - duration length time bucket [This field has been removed from current builds of Office, but might still appear in older builds.]

  • Session.FirstLaunchTime - first recorded launch time of the app [This field has been removed from current builds of Office, but might still appear in older builds.]

  • Session.State - the indicator of whether this is the start or end of the session

settings.action

This event collects the configuration information in settings. The data allows us to detect situations where there's possible negative impact on the users’ ability configure app settings, such as notification settings, primary mail account, and configuring the email signature.

The following fields are collected:

  • account_order_changed - To check if you changed the order of your accounts to make sure this configuration works properly

  • action - possible actions taken in settings, such as deleting an account to help us diagnose issues and ensure no negative impact

  • app_lock_disabled_reason - Indicated the reason we disabled the applock feature on a device

  • app_lock_state - Indicates whether user turned the applock feature on or off

  • auth_type - The authentication type being used by the account, so we understand which backend sync layer we're using to help us diagnose issues

  • changed_folder - Capturing whether a folder was changed to help us diagnose issues.

  • delete_scope - During an account deletion, whether you deleted the account from this device or from all devices with Outlook.

  • emo_default_provider_addin_id - Field that captures the compliant add-in ID of the default meeting provider.

  • emo_default_provider_selected_type - Field that determines the type of the default meeting provider set by the user.

  • emo_default_provider_switch_type - The type of switch done by the user between the online meeting providers in the Every Meeting Online screen. Helps us to understand the user’s engagement with the feature.

  • enabled_state - Whether your auto reply, save contacts, and block external images settings are configured correctly

  • notification_action - To check if you have configured any notification actions for triaging emails to help us make sure this setting is working successfully

  • notification_action_number - To check if your notification actions (action one or action two) are configured correctly

  • server_type - Similar to auth_type, it tells us which type of account you have to help us diagnose issues better. Examples: Office365, Gmail, Outlook

  • setting_properties - Tracks properties relation to setting action detailed below:

    • alternate_app_icon_setting - the selected alternate app icon (light, dark)
    • app_lock_state – indicates whether user turned on/off/disabled the App Lock feature in settings
    • auth_type - indicates the back-end authentication type allowing us to know if there's an issue with a particular account type
    • badge_count_state - indicates what type of badge count the user has asked for that is, no badges, focused inbox only, etc.
    • changed_folder - determines whether this action was archived, scheduled, or another action.
    • contacts_sort_by – tracks whether the contacts are sorted by first name or last name
    • delete_scope - tracks whether this action was related to deleting someone just on this device or on all devices, if applicable.
    • density_setting - the message list density mode selected by the user
    • enabled_state - whether state related to the action is enabled
    • fab_tap_behavior – the selected tap behavior (single press or tap & hold) for the floating action button we have on our main screens to compose an email, create an event, etc.
    • in_app_language - the selected in-app language, string type (default, en-US, fa, ru etc.)
    • notification_action_setting - indicates the details of, if applicable, notification action settings related to this action
      • notification_action - indicates what the user was trying to do, that is, flag, delete, archive, it allows us to determine what message action the user wanted to perform on the notification and if the action failed or not.
      • notification_action_number - indicates which action number (two of three actions are customizable) was assigned a notification action, that is, action one, action two. This allows us to determine if there's a problem with a particular action.
    • notification_state - indicates what type of badge count the user has asked for that is, no badges, focused inbox only, etc.
    • server_type - indicates the back-end server type allowing us to know if there's an issue with a particular server type
    • signature_setting - indicates if the setting was applied to all account or an individual account
    • source - indicates what is the source of notifications, if applicable, from settings or don't disturb setting
    • swipe_setting - indicates the details of, if applicable, swipe settings related to this action
      • swipe_action - indicates what the user was trying to do, that is, flag, delete, archive, it allows us to determine what action the user wanted and if the action failed or not.
      • swipe_direction - indicates which way the user set up the swipe to be, that is, left to right or right to left. This allows us to determine if there's a problem with a particular swipe direction.
    • temperature_unit_setting - the selected temperature unit to be used for weather
    • theme_color_setting - the custom app theme color selected by the user
    • ui_mode_setting - the selected UI mode (dark, light, system default, low battery etc.)
    • week_start – indicates the day of week set as the week start (Saturday, Sunday, Monday)
  • state_changed_to - To check if your focused inbox On/Off setting is configured correctly

  • swipe_action - To check if you have configured any swipe actions for triaging emails to help us make sure this setting is working successfully

  • swipe_direction - To check if your swipe directions (left or right) are configured correctly

sidebar.action

Allows us to detect situations where there's possible negative impact on your ability configure your app settings, such as your notification settings, your primary mail account, and configuring your mail signature.

Data fields that are common for Outlook Mobile for this event on iOS and Android:

  • Account - tracks the account and its data associated with the event, values tracked in this data are in the common om field documentation [This field has been removed from current builds of Office, but might still appear in older builds.]

  • action - tracks the type of side bar action occurred, that is, dismissed, help button selected, mail side bar, etc.,

  • from_favorites - tracks if the action is coming from an item in favorites

  • mail_folder_type - what type of folder was selected during the side bar action, if any.

  • sidebar_type - tracks the type of side bar associated with this event, that is, mail or calendar to help us ensure the navigation from the favorites setting works properly

The following fields are collected:

  • account_type - indicates what authentication type the account is. For example, Gmail, outlook, etc.

  • account_has_groups - Helps us make sure if the account has groups, they're configured correctly

  • calendar_accounts_count - Number of calendar accounts you have to help us make sure your calendar accounts are configured correctly

  • calendar_apps_count - Number of calendar apps you have to help us make sure your interesting calendar apps are configured correctly

  • calendar_type - The type of calendar you have (Primary calendar, Group calendar, etc.)

  • has_favorite_folders - Helps us make sure favorite folders are configured correctly

  • has_favorite_people - Helps us make sure favorite people/contacts are configured correctly

  • has_group_calendar - Helps us make sure if you have group calendars, they're configured correctly

  • has_group_calendar_account - Helps us make sure if you have group calendars, they're configured correctly

  • has_group_toggled - Helps us make sure if you have toggled group calendars, this setting is configured correctly

  • interesting_calendars_accounts_count - Number of interesting calendar accounts you have to help us make sure your interesting calendar accounts are configured correctly

  • mail_accounts_count - The total number of mail accounts in the sidebar to make sure this is configured correctly

  • mail_folder_type - The type of folder the user tapped on to make sure it's configured correctly. This could include Deleted folder, Spam, or your Sent folder.

  • mail_inbox_unread_count - Helps us ensure the unread count is displayed and configured accurately

  • mail_subfolder_depth - Helps us ensure we can successfully display a user's mail subfolder configurations

StoreOp

Collected when a user attempts to open an IRM protected doc or apply IRM protections. It contains the information needed to be able to properly investigate and diagnose issues that happen when Rights Management Service license store operation is performed.

The following fields are collected:

  • AppInfo.ClientHierarchy - Client hierarchy, which indicates the application runs in production environment or developer environment

  • AppInfo.Name - Application name.

  • AppInfo.Version - Application version

  • iKey - Logging service server ID

  • RMS.ApplicationScenarioId - Scenario ID provided by the application

  • RMS.ContentId - Content ID in End User License

  • RMS.Duration - Total time for API call to complete

  • RMS.DurationWithoutExternalOps - Total time minus external operations consumed, such as network latency.

  • RMS.ErrorCode - The error code returned if any from the operation

  • RMS.HttpCall - indicate if there's HTTP operation

  • RMS.LicenseFormat - The license Format: Xrml or Json

  • RMS.OperationName - Operation name

  • RMS.Result - Success or fail of the operation

  • RMS.ScenarioId - Scenario ID defined by Rights Management Service Client

  • RMS.SDKVersion - The version of Rights Management Service Client

  • RMS.ServerType - The type of Rights Management Service Server

  • RMS.StatusCode - Status code of the operation result

  • RMS.Url - The URL of Rights Management Service Server

Survey.Floodgate.TriggerMet

Tracks when a device has met the criteria to show a survey. Used to assess the health of the survey triggering process as well as to ensure the signal used to analyze customer issues and health is working properly.

The following fields are collected:

  • CampaignId – Identifier of a service delivered campaign

  • SurveyId – Unique instance of a campaign

  • SurveyType – Identifies the type of survey

Survey.UI.Form.Submit

Tracks when a survey is submitted. Used to assess the health of the survey submission process as well as to ensure the signal used to analyze customer issues and health is working properly.

The following fields are collected:

  • CampaignId – Identifier of a service delivered campaign

  • SurveyId – Unique instance of a campaign

  • SurveyType – Identifies the type of survey

Traditional.Login.User.Retention

This event is triggered when IMAP (Internet Messaging Access Protocol) or POP3 (Post Office Protocol) user fails to sign in using Outlook app. By comparing the number and error type of sign-in failures, we ensure the sign-in process update is performing as expected.

The following fields are collected:

  • Errors - Error string that indicates what caused the sign in to fail.

  • Ever_Succeeded - Indicates whether user succeeded to sign in in between immediate and scheduled events.

  • Has_Existing_Account - Used to check whether user has an existing account after a failed sign-in attempt.

  • Type - Type of event, which currently has two values: immediate (event is sent immediately after sign in fails) and scheduled (event is sent after a scheduled time period).

watchAppV2

This event is triggered from the Outlook watch app, when notifications are communicated from Outlook mobile to the Outlook watch app, and when the user is performing actions in the Outlook watch app. This event allows us to detect and fix possible issues with capabilities on the watch, such as receiving notifications and responding to emails.

The following fields are collected:

  • app_action - Tells us the types of action the user took on the watch, such as "archive_message" to help us detect issues related to a specific action such as being unable to successfully archive messages on the watch

  • category - Specifies a category (Usage, app_action, notification, etc.) for the event

  • is_complication_enabled - Tells us if the user has added Outlook to their watch screen to help us detect issues related to watch screens

  • is_watch_app_installed - Tells us if the user has installed our watch app on their device

  • notification - Tells us the if a notification, if any was sent to the watch from the device.

  • view - Tells us the view (Home, Inbox, Calendar, etc.) the watch was on, to help us detect issues related to a specific view

  • watch_app_version - Tell us the version of the connected watch app

  • watch_manufacturer - Tells us the manufacturer of the connected watch

  • watch_model - Tells us the model of the connected watch

  • watch_os - Tells us the OS version of the watch they have installed to help us detect issues related to specific OS versions of the watch

  • watch_os_brand - Tells us the type of OS (Apple, Wear, Tizen, etc.) the connected watch is running

Application status and boot subtype

Determination if specific feature events have occurred, such as start or stop, and if feature is running​.

app.startup

This event lets us detect and fix issues where Outlook is starting slowly or incompletely, making it difficult for users to use our app. This includes information on the specific features that were enabled and how long parts of the startup took.

The following fields are collected:

  • attach_base_context_millis - time between the base Context starting and onCreate() starting

  • device_ram_in_mb - the RAM available on the device

  • has_company_portal - whether the company portal app is installed

  • hx_okhttp_mode - whether the new email syncing service component is using OKHttp for sending and receiving HTTP-based network requests

  • initial_activity_name - the Android Activity that launched the app

  • is_pen_connected - detects if a user is using pen or stylus to operate the app

  • manufacturer - the device manufacturer

  • model - the device model

  • on_create_millis - time taken in the onCreate() method

  • on_resume_millis - time taken in the onResume() method

  • time_until_attach - time between the class loading and the base Context starting

  • total_millis - total time from class loading start to Android Activity resume completion

boot.time

This event lets us detect when critical app errors occurred that would cause your app to crash or experience serious issues like causing you to see empty rows in your inbox. This event collects information that allows us to categorize and classify issues to help prioritize the impact of issues on customers.

The following fields are collected:

  • black_list_reason - Only supported for backward compatibility, this field collects the same information as the now preferred deny_list_reason field.

  • deny_list_reason - Tells us if there's a reason why we should disregard this data. Some examples include launching due to a remote notification and launching due to a background fetch.

  • step_premain – Tells us the amount of time it has taken for Outlook to go from the user tapping the icon to step0_main the "main" step defined in this document.

  • step0_main - Tells us the amount of time it has taken for Outlook to get to the "main" step, which is a step defined by Apple.

  • step1_appWillFinishLaunching - Tells us the amount of time it has taken for Outlook to go from the "main" step to the "appWillFinishLaunching" step, which is a step defined by Apple.

  • step2_appDidFinishLaunching - Tells us the amount of time it has taken for Outlook to go from the "appWillFinishLaunching" step to the "appDidFinishLaunching" step, which is a step defined by Apple.

  • step3_engineStarted - Tells us the amount of time it has taken for Outlook to go from the "appDidFinishLaunching" step to starting the engine of the app, which handles storing and syncing data.

  • step4_runLoopFirstIdle - Tells us the amount of time it has taken for Outlook to go from the "engineStarted" step to having no additional work to complete.

  • total_time - Tells us the total amount of time it has taken for Outlook to complete the boot process.

DnsLookupOp

Collected when a user attempts to open an IRM protected doc or apply IRM protections. It contains the information needed to be able to properly investigate and diagnose issues that happen when DNS information lookup operation is performed.

The following fields are collected:

  • AppInfo.ClientHierarchy - Client hierarchy, which indicates the application runs in production environment or developer environment

  • AppInfo.Name - Application name.

  • AppInfo.Version - Application version

  • iKey - Logging service server ID

  • RMS.ApplicationScenarioId - Scenario ID provided by the application

  • RMS.Duration - Total time for the operation to complete

  • RMS.DurationWithoutExternalOps - Total time minus external operations consumed, such as network latency.

  • RMS.ErrorCode - The error code returned if any from the operation

  • RMS.HttpCall - indicate if there's http operation

  • RMS.LicenseFormat - The license Format: Xrml or Json

  • RMS.NoOfDomainsSearched - The number of domains searched

  • RMS.NoOfDomainsSkipped - The number of domains skipped

  • RMS.Result - Success or fail of the operation

  • RMS.ScenarioId - Scenario ID defined by Rights Management Service Client

  • RMS.SDKVersion - The version of Rights Management Service Client

  • RMS.ServerType - The type of Rights Management Service Server

  • RMS.StatusCode - Status code of the operation result

first.visible

This event lets us detect the first time the app is launched intentionally by the user. This event is required to ensure that the app is successfully working in Original Equipment Manufacturer (OEM) builds.

The following fields are collected:

  • is_oem - a field tracking that indicates whether the application is running on an OEM variant

  • is_system_install - a field tracking the presence of a pre-installed property file that should indicate that this install is OEM

  • manufacturer - device manufacturer

  • model - device model

  • systemFlagSet - value of the Android system flag (ApplicationInfo.FLAG_SYSTEM) that indicates if the application was installed as part of the device's system image

GetUserOp

Collected when a user attempts to open an IRM protected doc or apply IRM protections. It contains the information needed to be able to properly investigate and diagnose issues that happen when getting user certificates operation is performed.

The following fields are collected:

  • AppInfo.ClientHierarchy - Client hierarchy, which indicates the application runs in production environment or developer environment

  • AppInfo.Name - Application name

  • AppInfo.Version - Application version

  • iKey - Logging service server ID

  • RMS.ApplicationScenarioId - Scenario ID provided by the application

  • RMS.ContentId - Content ID

  • RMS.Duration - Total time for the operation to complete

  • RMS.DurationWithoutExternalOps - Total time minus external operations consumed, such as network latency.

  • RMS.ErrorCode - The error code returned from the operation

  • RMS.HttpCall - indicate if there's HTTP operation

  • RMS.LicenseFormat - The license Format: Xrml or Json

  • RMS.Result - Success or fail of the operation

  • RMS.ScenarioId - Scenario ID defined by Rights Management Service Client

  • RMS.SDKVersion - The version of Rights Management Service Client

  • RMS.ServerType - The type of Rights Management Service Server

  • RMS.StatusCode - Status code of the operation result

  • RMS.Type - type of user info

HttpOp

Collected when a user attempts to open an IRM protected doc or apply IRM protections. It contains the information needed to be able to properly investigate and diagnose issues that happen when http request operation is performed.

The following fields are collected:

  • AppInfo.ClientHierarchy - Client hierarchy, which indicates the application runs in production environment or developer environment

  • AppInfo.Name - Application name

  • AppInfo.Version - Application version

  • iKey - Logging service server ID

  • RMS.ApplicationScenarioId - Scenario ID provided by the application

  • RMS.CallBackStatus - The status of authentication call back returned result

  • RMS.CallbackTime - The time consumed by authentication call back

  • RMS.CorrelationId - correlation ID of the http request

  • RMS.DataSize - data size of the HTTP request

  • RMS.Duration - Total time for the operation to complete

  • RMS.DurationWithoutExternalOps - Total time minus external operations consumed, such as network latency.

  • RMS.ErrorCode - The error code returned if any from the operation

  • RMS.HttpCall - indicate if there's nested http operation

  • RMS.LicenseFormat - The license Format: Xrml or Json

  • RMS.OperationName - operation name

  • RMS.Result - Success or fail of the operation

  • RMS.ScenarioId - Scenario ID defined by Rights Management Service Client

  • RMS.SDKVersion - The version of Rights Management Service Client

  • RMS.ServerType - The type of Rights Management Service Server

  • RMS.StatusCode - Status code of the operation result

  • RMS.Url - The URL of Rights Management Service Server

  • RMS.WinhttpCallbackStatus - The status of winhttp call back result

Initialized

Allows us to analyze the health of the interface that allows mobile apps to fetch user and privacy settings from Office services and diagnose connectivity and privacy setting service issues.

The following fields are collected:

  • roamingSettingType - identifies the location from which we attempt to read settings

IpcCreateOauth2Token

Collected when a user attempts to open an IRM protected doc or apply IRM protections. It contains the information needed to be able to properly investigate and diagnose issues that happen when the IpcCreateOauth2Token API call is made.

The following fields are collected:

  • AppInfo.ClientHierarchy - Client hierarchy, which indicates the application runs in production environment or developer environment

  • AppInfo.Name - Application name.

  • AppInfo.Version - Application version

  • iKey - Logging service server ID

  • RMS.Duration - Total time for API call to complete

  • RMS.DurationWithoutExternalOps - Total time minus external operations consumed, such as network latency.

  • RMS.ErrorCode - The error code returned if any from the API call

  • RMS.HttpCall - indicate if there's HTTP operation

  • RMS.Result - Success or fail of the API call

  • RMS.ScenarioId - Scenario ID defined by the API

  • RMS.SDKVersion - The version of Rights Management Service Client

  • RMS.StatusCode - Status code of the returned result

Office.Android.AccountStorageInfo

This event determines the number of MSA and ADAL accounts in the registry and shared preferences. It enables the analysis of inconsistencies between data stores and helps us to stabilize app performance.

The following fields are collected:

  • RegistryADALCount- Indicates number of ADAL accounts in registry.

  • RegistryLiveIdCount- Indicates number of MSA accounts in registry.

  • SharedPrefADALCount- Indicates number of ADAL accounts in shared preferences.

  • SharedPrefLiveIdCount- Indicates number of MSA accounts in shared preferences.

Office.Android.AndroidOffice16BootLatency

Critical to capture for app performance metric with respect to the response time of the app from the boot. Microsoft uses this to collect the time taken for the app to be responsive and also detect scenarios that may impact boot time in Word, Excel, or PowerPoint.

The following fields are collected:

  • AppLaunchResponsiveTimeInMilliSec - App launch responsive time

  • AppSuspendedDuringBoot - Boolean to indicate if app was suspended during boot

  • CollectionTime - Time of event

  • FileActivationAttempted - Boolean to indicate if file activation as attempted

  • FirstIdleOnAppThreadTimeInMilliSec - App thread idle time

  • IsThisFirstLaunch - Boolean to indicate if this is first time app launch

  • UserDialogInterruptionDuringBoot - Boolean to indicate if there was a blocking UI during boot

Office.Android.WxpinfraAndroid.AppDiskSize.AppDiskSize

This event is collected for Office applications running under Android platform and records when an app boot takes place. This event helps in keeping the app disk size used by the Office applications under check. The goal of this data is to continuously improve on reducing the disk size used by the application on the end users’ device.

The following fields are collected:

  • ApkSize - Size (in Bytes) of the Office application apk downloaded and extracted on the device.

  • CacheSize - Size (in Bytes) of the cache folder used by the Office application.

  • UserDataSize - Size (in Bytes) of the user data directory used by the Office application.

Office.ClickToRun.Ads.Container.AdsContainer

This event is collected from free versions of Office applications running on the Windows platform. This event triggered when a free version of an application is launched. This event includes metadata about the version of the application and dependencies, the performance of Office advertisements, and error information if there's an issue.

The following fields are collected:

  • Activity_Result_Code - The code associated with the error

  • Activity_Result_Type - Whether the event was successful

  • Data_AdFailure - Duration until advertisement add-in reported ad bid failure

  • Data_AdReady - Duration until advertisement add-in reported ad bid success

  • Data_AdShowingFailure - Time when failing to show the ad pane.

  • Data_AppActivated - Last time when application is activated.

  • Data_AppActivateTime - Total time when user is active in the app during the lifecycle of video advertisement.

  • Data_AppDeactivated - Last time when application is deactivated.

  • Data_BusbarClick - Time when user clicks the description on video advertisement notification.

  • Data_BusbarDismiss - Time when user clicks the Close/Dismiss button on video advertisement notification.

  • Data_BusbarShown - Duration until video advertisement notification is shown.

  • Data_BusbarToShow - Duration until video advertisement notification is about to be shown.

  • Data_ContainerInstanceId - A unique identifier for each advertisement container

  • Data_Destroy - Duration when advertisement container is destroyed due to an error

  • Data_DocumentLoaded - Duration until advertisement add-in page is loaded

  • Data_ErrorDescription - A human-readable description of the error

  • Data_ErrorSource - The component responsible for the error

  • Data_Init - Duration to initialize advertisement container

  • Data_LaunchExtComponent - Identify the utilization of specific internal APIs.

  • Data_PaneClosed - Time when ad pane is closed.

  • Data_ReadyToBeShown - Duration until an ad is ready to be shown to user

  • Data_Refresh - Duration until advertisement add-in page is refreshed

  • Data_SDXInstanceId - A unique identifier for each advertisement add-in initialization

  • Data_SDXPackageVersion - The version of the advertisement add-in

  • Data_SDXReady - Duration to finish advertisement add-in initialization

  • Data_ShownTime - Duration until an ad has been shown to user

  • Data_StartSDX - Duration to start advertisement add-in initialization

  • Data_SDXStoreType - The source of the advertisement add-in package in usage

  • Data_TimeToShowVideo - Duration until next video advertisement is about to be shown.

  • Data_TimeToStartVideo - Duration until next video advertisement starts to load.

  • Data_Type - The type of advertisement

  • Data_VideoToShow - Duration until video advertisement is about to be shown.

  • Data_WatchNow - Time when user clicks the Watch Now button on video advertisement notification.

  • Data_WindowActivated - Last time when window containing advertisement add-in page is activated.

  • Data_WindowClosed - Duration until application window is closed

  • Data_WindowDeactivated - Last time when window containing advertisement add-in page is deactivated.

Office.DesignerApp.App.TileClicked

The event log captures time to interact for user, this helps in understanding the time user has to wait for before any mini apps screen comes for them. This information is crucial for ensuring a better Designer experience for users and tracking boot time. It helps in capturing essential data around starting designer and mini apps.

The following fields are collected:

  • CorrelationId - GUID used to correlate activities.

  • EndPoint - Used to identify the appropriate Designer screen in which design/image creation was performed.

  • flowId - GUID used to identify current app flow started on home screen.

  • Host - Identifies the host app name that launches Designer.

  • HostAppSessionId - Uniquely identifies the host app session for a sub-app.

  • Locale - Locale of user.

  • MiniAppsConfigVersion - Configuration version of mini apps supported on home screen.

  • MiniAppsEnabled - Identifies if sub apps are enabled on Designer home screen.

  • SDKLaunchCorrelationId - GUID used to correlate Designer SDK activities.

  • SdkVersion - Version of Designer SDK.

  • Source - Logs source of Designer SDK launch.

  • SystemLocale - System locale of the device.

  • TimeZone - The user's time zone relative to UTC.

  • UserAgeGroup - Logs age group of user like minor or adult.

  • UserIntent - Indicates whether some operation is to be considered as active operation or not.

Office.Extensibility.OfficeJS.Appactivated

Records information about unexpected shutdowns of Office. This allows us to identify crashes or hangs in the product so that they can be addressed.

The following fields are collected:

  • Data_AirspaceInitTime:integer- time taken to initialize Airspace Office component

  • Data_AllShapes:integer - number of shapes in the document

  • Data_APIInitTime:integer - time taken to initialize Visio API module

  • Data_AppSizeHeight – Add-in window size's height

  • Data_AppSizeWidth – Add-in window size's width

  • Data_AppURL - URL of the Add-in; Logs full URL for Store Add-ins and URL domain for non-store Add-ins

  • Data_Doc_AsyncOpenKind:long – Indicates whether a cached version of the cloud document was opened and which asynchronous refresh logic was used.

  • Data_AuthorsCount:integer - number of authors who edited the document in this session

  • Data_BackgroundPages:integer - number of background pages in diagram

  • Data_BootTime:integer - The amount of time it took to boot Visio

  • Data_Browser - Browser string with information about the browser such as type, version

  • Data_ChildWindowMixedModeTime:integer - time taken to enable mixed mode in Visio (Child window can have different DpiAwareness from parent window)

  • Data_CommentsCount:integer - number of comments in document

  • Data_ConnectionCount:integer - number of data connections in diagram

  • Data_ContentMgrInitTim:integer - time taken to initialize content manager

  • Data_CreateMainFrameTime:integer - Create mainframe time

  • Data_CreatePaletteTime:integer - Time taken to create the global color palette

  • Data_DispFormatCount:integer - number of data graphics in diagram

  • Data_Doc_Ext:string - Document extension

  • Data_Doc_Fqdn:string - Where is document stored (SharePoint.com, live.net), only available for Office 365 domains

  • Data_Doc_FqdnHash:string - Hash of where document is stored

  • Data_Doc_IsIncrementalOpen:bool- : Was document opened incrementally (new feature that opens document without needing to download entire document)

  • Data_Doc_IsOpeningOfflineCopy:bool - Is document being opened from local cache?

  • Data_Doc_IsSyncBacked:bool- true when this is a server document that exists locally, and is synchronized with the server (for example, through OneDrive or ODB client apps)

  • Data_Doc_Location:long- : Predefined set of values of where document is stored (Local, SharePoint, WOPI, Network etc.)

  • Data_Doc_LocationDetails:long - Predefined set of values of more detailed location (Temp folder, downloads folder, One Drive Documents, One Drive Pictures

  • Data_Doc_ResourceIdHash:string - Hash of resource Identifier for documents stored in cloud

  • Data_Doc_RtcType - Indicates how the real-time channel (RTC) was setup for current file (Disabled, unsupported, on demand, always on, etc.).

  • Data_Doc_ServerDocId:string - immutable identifier for documents stored in cloud

  • Data_Doc_SessionId:long - generated GUID that Identifies the instance of the document within the same process session

  • Data_Doc_SizeInBytes:long - Document size in bytes

  • Data_Doc_SpecialChars:long - long Bitmask indicating special chars in the document's URL or Path

  • Data_Doc_SyncBackedType - Indicator as to the type of document (local or service based) 

  • Data_Doc_UrlHash:string - hash of full URL of documents stored in cloud

  • Data_DpiAwarenessTime:integer - Time taken to enable Per Monitor DPI Awareness

  • Data_DurationToCompleteInMilliseconds:double- Duration to complete save as in millisecond

  • Data_ErrorCode:int - 0 for success, integer for failure in save

  • Data_FailureReason:integer - failure reason for asynchronous save

  • Data_FileExtension - File extension of diagram opened

  • Data_FileHasDGMaster:bool - true when file has Data Graphics

  • Data_FileHasImportedData:bool - true when file has imported data

  • Data_FileHasShapesLinked:bool - true when file has linked shapes to data

  • Data_FileIOBytesRead:int - total bytes read while saving

  • Data_FileIOBytesReadSquared:int - squared value of Data_FileIOBytesRead

  • Data_FileIOBytesWritten:int - total bytes written while saving

  • Data_FileIOBytesWrittenSquared:int- squared value of Data_FileIOBytesWritten

  • Data_FilePathHash:binary -Binary Hash of file path

  • Data_FilePathHash: binary - GUID for file path

  • Data_FileSize - Document size in bytes

  • Data_ForegroundPages:integer - number of foreground pages in diagram

  • Data_ForegroundShapes:integer - integer number of shapes in Foreground pages

  • Data_GdiInitTime:integer - time taken to initialize GDI module

  • Data_HasCoauthUserEdit:bool - true if document was edited in a co-authoring session

  • Data_HasCustomPages:bool - true if document contains custom pages

  • Data_HasCustPatterns:bool - true if file has custom patterns

  • Data_HasDynConn:bool - true if document contains dynamic connection

  • Data_HasScaledPages:bool - true if document contains scaled pages

  • Data_HasUserWaitTime:bool - true when file dialog is shown while saving

  • Data_InitAddinsTime:integer - time taken to initialize and load the COM Add

  • Data_InitBrandTime:integer - amount of time it takes to initialize splash screen and branding Office components

  • Data_InitGimmeTime:integer - time taken to initialize Office component

  • Data_InitLicensingTime:integer - time taken to initialize licensing Office component

  • Data_InitMsoUtilsTime:integer - Initialization time to MSOUTILS Office component

  • Data_InitPerfTime:integer - Performance Office component initialization time

  • Data_InitTCOTime:integer - amount of time it takes to initialize Office component manager

  • Data_InitTrustCenterTime:integer - Time taken to initialize Office component trust center

  • Data_InitVSSubSystemsTime:integer - amount of time it takes to initialize Visio components

  • Data_InternalFile:bool - true if file is an internal file. for example, Stencil

  • Data_IsAsyncSave:bool - true if save was asynchronous

  • Data_IsAutoRecoveredFile:bool - true if file was auto recovered

  • Data_IsEmbedded:bool - true if Visio file was embedded in another app

  • Data_IsInfinitePageDisabledForAllPages:bool - if Infinite Page disabled for all pages for the document true

  • Data_IsIRMProtected:bool - true if file is Information Right Protected

  • Data_IsLocal:bool - true if file is local

  • Data_IsRecoverySave:bool - true if safe was triggered because of recovery

  • Data_IsShapeSearchPaneHiddenState:bool - true if shape search pane was hidden for document

  • Data_IsSmartDiagramPresentInActivePageOfFile:bool - bool, true if smart data visual diagram is present in active page of file

  • Data_IsSmartDiagramPresentInFile:bool - bool, true if the smart data visual diagram present in file.

  • Data_IsUNC:bool - true if document path is adhering to Universal Naming Convention

  • Data_LandscapePgCount:integer - number of pages having landscape orientation in the diagram

  • Data_Layers:integer - number of layers in the diagram

  • Data_LoadProfileTime:integer - amount of time it takes to load Office profiler

  • Data_LoadRichEditTim:integer- rich edit component load time

  • Data_LoadVisIntlTime:integer - time taken to load Visio international DLL

  • Data_Location:integer - Location of the file from which it was opened 0 Local, 1, Network, 2, SharePoint, 3 – Web

  • Data_MasterCount:integer - number of masters in the diagram

  • Data_MaxCoauthUsers:integer - maximum number of users co-authoring at any point of time in the session Filesystem, Registry, First Party, SDX

  • Data_MaxTilesAutoSizeOn:integer - Maximum number of tiles of a page for which auto size was enabled

  • Data_MsoBeginBootTime:integer - MSO boot time

  • Data_MsoDllLoadTime:integer - time taken to load MSO DLL

  • Data_MsoEndBootTime:integer - time taken to end MSO boot

  • Data_MsoInitCoreTime:integer - Take taken to initialize MSO Office component

  • Data_MsoInitUITime:integer - time taken to initialize MSO Office component UI

  • Data_MsoMigrateTime:integer - Time taken to migrate user settings on first bootup if user upgraded from previous version

  • Data_NetworkIOBytesRead:int - total network bytes read while saving

  • Data_NetworkIOBytesReadSquared:int - squared value of Data_NetworkIOBytesRead

  • Data_NetworkIOBytesWritten:int - total network bytes written while saving

  • Data_NetworkIOBytesWrittenSquared :int- squared value of NetworkIOBytesWritten

  • Data_OartStartupTime:integer - time taken to initialize OART Office component

  • Data_OleInitTime:integer - OLE Office component initialization time

  • Data_OpenDurationTimeInMs:integer - duration to open file in milliseconds

  • Data_OriginatedFromTemplateID:integer - identifier for template from which diagram was created. NULL for third-party templates

  • Data_Pages:integer - number of pages in document

  • Data_PositionToolbarsTime:integer - time taken to get the toolbars into place

  • Data_ReadOnly:bool - True if the file is read only

  • Data_RecordSetCount:integer - number of record set in the diagram

  • Data_RecoveryTime:integer - time taken to open recovery files

  • Data_ReviewerPages:integer - number of reviewer pages in diagram

  • Data_RibbonTime:integer - time taken to display the status bar

  • Data_RoamingSettingsStartupTime:integer - time taken create and load all currently roamed Visio settings

  • Data_SchemeMgrStartupTime:integer - time taken to initialize scheme manager

  • Data_SDX_AssetId - ONLY exists for store Add-ins. OMEX gives the Add in an AssetId when it goes into Store

  • Data_SDX_BrowserToken - Identifier that sits in the browser's cache

  • Data_SDX_HostJsVersion - This is the platform-specific version of Office.js (for example, outlook web16.01.js) This contains the API surface for ad ins

  • Data_SDX_Id - The GUID of an Add-in, which uniquely identifies it

  • Data_SDX_InstanceId - Represents Add in document pair

  • Data_SDX_MarketplaceType - Indicates where the Add-in installed from

  • Data_SDX_OfficeJsVersion - This is the version of Office.js that will redirect to the platform-specific version.

  • Data_SDX_Version - Version of the Add-in

  • Data_ShellCmdLineTime:integer - time taken to Parse and execute any shell commands on the command line

  • Data_Size:long - File size in bytes

  • Data_StartEndTransactionTime:integer - time taken to initialize Visio components

  • Data_STNInitTime:integer - time taken to initialize stencil window configuration

  • Data_Tag:string - unique identifier to identify Save As event

  • Data_ThemeCount:integer - number of themes in diagram

  • Data_TimeStamp - Time stamp when document was closed

  • Data_UIInitTime:integer - UI initialization time

  • Data_WasSuccessful:bool - true if save as was successful

  • Data_WinLaunchTime:integer - time taken to launch the Visio startup pane, etc.)

Office.Extensibility.Sandbox.ODPActivationHanging

Collects when an Office add-in takes unexpectedly long to launch (>5 sec). Used to detect and fix problems with Office add-ins launching.

The following fields are collected:

  • AppId - ID of the App

  • AppInfo - data regarding the type of add-in (task pane or UILess or in content etc.) and the provider type (omen, SharePoint, filesystem etc.)

  • AppInstanceId - ID of the app instance

  • AssetId - asset ID of the app

  • IsPreload – indicates if the add-in is being preloaded in background for improving activation performance

  • NumberOfAddinsActivated - counter of add-ins activated

  • RemoterType - specifies the type of remoter (Trusted, untrusted, Win32webView, Trusted UDF etc.) used to activate the add-in

  • StoreType - origin of the app

  • TimeForAuth - time spent on auth

  • TimeForSandbox - time spent on the sandbox

  • TimeForServerCall - time spent on the server call

  • TotalTime - total time spent

  • UsesSharedRuntime - indicates if the app uses sharedRuntime or not.

Office.Lens.LensSdk.LaunchLens

Launches help us determine the number of users or devices launching the app and further understand feature usage. It helps us track the volume of users using the product, as well as identifying changes in trends, help look for and rectify issues in the product.

The following fields are collected on Android:

  • Data_CameraXBindUsecasesApi - Time taken by camera library to initialize before it launches camera.

  • Data_CameraXBindUsecasesToPreview - Time taken by camera library in showing camera preview to user.

  • Data_CurrentWorkFlowType - Explains whether the user was capturing, editing, saving images, etc.

  • Data_IsDexModeEnabled - Boolean indicating if device supports Samsung Dex features.

  • Data_IsEmbeddedLaunch - Boolean field indicating if user launched the control in picture-in-picture mode.

  • Data_IsInterimCropEnabled - Boolean field indicating if user has chosen to manually crop each image.

  • Data_IsMultiWindowEnabled - Boolean field indicating if it's possible to run app in split screen.

  • Data_IsTalkBackEnabled - Boolean indicating if device is in accessibility mode.

  • Data_LaunchPerf - Integer indicating time taken to launch the app.

  • Data_LensSdkVersion - Version of the SDK running in the app.

  • Data_RecoveryMode - Boolean field indicating if this session was recovered after app was killed.

  • Data_SDKMode - The mode in which image(s) were captured.

  • Data_SessionId - Identifier tracking each session of the app.

  • Data_TelemetryEventTimestamp - Time at which this event or action was completed.

The following fields are collected on iOS:

  • Data_currentWorkflowId - Explains whether the user was capturing a photo, scanning document, whiteboard, etc; or extracting text, table, etc; from images.

  • Data_defaultWorkflow - Explains the default mode in which camera was launched, like document, whiteboard, photo, businesscard.

  • Data_imageDPI - Specifies the quality in DPI (low, high medium) in which media was captured.

  • Data_isExistingUser - Specifies if the user is a new user or existing user.

  • Data_isFirstLaunch - Boolean indicating if the app is being launched after a new installation.

  • Data_isResumeSession - Specifies whether the app was launched in resume or user did a fresh start. (Boolean field)

  • Data_launchReason - Determine if the launch is done via Camera or Gallery.

  • Data_launchWorkflowItem - Field specifies if the app is launched from camera screen or edit screen.

  • Data_Lens_SessionId - Identifier tracking each session of the app.

  • Data_LensEventName - Name of the event. For example, Office_Lens_LensSdk_LaunchLens

  • Data_mediaCompressionFactor - The factor by which images are compressed by app.

  • Data_version - Version of the SDK running in the app.

Office.OfficeMobile.AppActivation.Launch

This event identifies first time and subsequent activations through external triggers that activate the app. App activation loads certain dependencies that are responsible for making the app run smoothly and this event will record if it loaded successfully. It will also record the source of activation and app intent that was responsible for activating the app.

The following fields are collected:

  • ActionName - Integer value mapping to the name of the action/feature which is invoked from the activation point.

  • ActivationType - Integer value mapping to the source of activation

  • IsActionTriggered - Boolean value determining whether the action got triggered after the successful activation of the app.

  • IsFirstRun - Boolean value determining whether it was the first run of the app or a subsequent run.

Office.OfficeMobile.FRE.FirstRunSetup

The first run of the app after installation will trigger this heartbeat event. It helps identify installs and auto upgrades from older versions of the app and enable us to identify errors in auto-upgrades, including library loads and expansion/language package download failures.

The following fields are collected:

  • IsFlightAssigned - Boolean value determining if the user was part of any preassigned flight group that can trigger exposure to certain experiences.

  • IsFRELoadSuccessful - integer mentioning the result state

Office.OneNote.Android.App.AppBootComplete, Office.Android.EarlyTelemetry.AppBootComplete

[This event was previously named OneNote.App.AppBootComplete.]

The event is recorded once every session when the app boot is completed. The data is used to ensure new consumer users can successfully launch and use OneNote for the first time and, to ensure critical regression detection for the OneNote app and service health.

The following fields are collected:

  • ACTIVITY_BOOT_TIME_IN_MS - Time taken to complete Activity creation

  • ACTIVITY_NAME - Name of the Activity opened when booted

  • ANY_DIALOG_SHOWN - Indicates if any dialog is shown during boot time

  • APP_SUSPEND_DURING_EVENT - Indicates if the boot was preempted

  • APP_THREAD_CREATION_WAIT_TIME_TIME_FOR_APP_THREAD_CREATION - Time taken to create Application threads

  • AVAILABLE_MEMORY_IN_MB - Total memory available in device

  • AVG_SNAPSHOT_POPULATION_TIME - Avg. time taken to fetch notebook structures while using the App

  • BOOT_END_AT_VIEW - Sub-category of Activity name (Name of the View)

  • BOOT_SNAPSHOTS - Detail of notebook structure fetches for the account(s) used in App

  • COREAPP_STARTUP_ACCOUNT_SETUP_STARTUP_ACCOUNT_SETUP - Time taken to check and initiate SSO experience

  • CRASH_INTERACTION_DURING_BOOT> 0 - To indicate if the App crashed during last session

  • DALVIK_HEAP_LIMIT_IN_MB - Obsolete

  • DELAY_LOAD_STICKY_NOTES - Indicates if the Sticky Notes with delay or not

  • FISHBOWL_SHOWN_DURING_EVENT - Indicates instances where content in not synced

  • HAS_LOGCAT_LOGGING_IMPACT_ON_BOOT - Indicates if boot time is impacted due to logs

  • INIT_SNAPSHOT_DURATION - Time taken to get the notebook structure for the user account(s)

  • IsNewHomepageExperienceEnabled - [Yes/No] Indicates if user has got the new homepage experience

  • IS_COLD_BOOT - Indicates if the App launch when the App wasn't running in the background

  • IS_FIRST_LAUNCH - Indicates if this is the First time App was launched in the device

  • IS_FOLDABLE_TYPE - Indicates if the device is a foldable device

  • IS_PHONE - Indicates if the device is a phone or tablet

  • IS_RECENT_PAGES_AVAILABLE_ON_FRAGMENT_CREATION - Indicates if UI is ready and waiting for content to be made available

  • IS_REHYDRATE_LAUNCH - Indicates if App was killed by the system

  • IS_UPGRADE - Indicates if the App is being launched after upgrade

  • JOT_MAIN_APP_CREATE_TIME_MAIN_APP_CREATE_TIME - Time taken to create JOT component (shared code component)

  • JOT_MAIN_APP_INIT_TIME_MAIN_APP_INIT_TIME - Time taken to initialize JOT component

  • LAUNCH_POINT - Indicates if the App is opened from Widget or App Icon or Hyperlink or Share to ON etc.

  • MSO_ACTIVATION_TIME_ACTIVATION_TIME - Time taken to initialize MSO

  • NATIVE_LIBRARIES_LOAD_TIME - Time taken to load libraries

  • NAVIGATION_CREATE_TO_NAVIGATION_RESUME_CREATE_TO_NAVIGATION_RESUME - Time taken to complete navigation

  • NAVIGATION_RESUME_TO_BOOT_END_RESUME_TO_BOOT_END - Time taken to measure delay in page load after boot

  • NAVIGATION_SET_CONTENT_VIEW_TIME_SET_CONTENT_VIEW_TIME - Time taken to bring in content

  • NUMBER_Of_RUNNING_PROCESSES - Indicates number of active processes running

  • NUMBER_OF_SNAPSHOTS - Count of fetches of notebook structure during boot

  • OFFICEASSETMANAGER_INITIALIZATION_TIME - Time taken to unzip and initialize Asset Manager

  • PROCESS_BOOT_TIME_IN_MS - Time taken to complete Process creation

  • ROOT_ACTIVITY_CREATE_ACTIVITY_CREATE - Time taken to transition from Root layer

  • ROOT_ACTIVITY_DISK_CHECK_ACTIVITY_DISK_CHECK - Obsolete

  • ROOT_ACTIVITY_LAUNCH_NEXTACTIVITY_ACTIVITY_LAUNCH_NEXTACTIVITY - Obsolete

  • ROOT_ACTIVITY_PROCESS_INTENT_ACTIVITY_PROCESS_INTENT - Obsolete

  • ROOT_ACTIVITY_SESSION_ACTIVITY_SESSION - Time taken to transition from Root layer

  • ROOT_TO_NAVIGATION_TRANSITION_TO_NAVIGATION_TRANSITION - Time taken to handle navigation from Root

  • SNAPSHOT_PUBLISH_TO_RENDERING_END_PUBLISH_TO_RENDERING_END - Time to complete rendering content

  • SPLASH_ACTIVITY_SESSION_ACTIVITY_SESSION - Time taken to show splash screen

  • SPLASH_TO_ROOT_TRANSITION_TO_ROOT_TRANSITION - Time taken to transition from Root layer

  • TIME_BETWEEN_PROCESS_BOOT_AND_ACTIVITY_BEGIN_IN_MS - Time between process & activity creation

  • TIME_TAKEN_IN_MS - Time taken to complete boot

  • TOTAL_MEMORY_IN_MB - Total memory of the Device

  • USER_INTERACTED_DURING_EVENT - Indicates if the user has interacted during booting

Office.OneNote.Android.App.OneNoteAppForeground, Office.Android.EarlyTelemetry.OneNoteAppForeground

[This event was previously named OneNote.App.OneNoteAppForeground.]

The signal used to indicate OneNote App is in foreground. The telemetry is used to ensure critical regression detection for OneNote app and service health.

The following fields are collected:

  • None

Office.OneNote.Android.AppLaunch, Office.Android.EarlyTelemetry.AppLaunch

[This event was previously named OneNote.AppLaunch.]

The critical signal used to ensure OneNote users can successfully launch the app. The telemetry is used to ensure critical regression detection for OneNote app and service health.

The following fields are collected:

  • ANDROID_SDK_VERSION - Captures the Android SDK Version

  • FirstLaunchTime - Records time when the App was first launched

  • InstallLocation - Indicates if the app is pre-installed or downloaded form Store

  • is_boot_completed_ever - Indicates if the App has even been booted successfully before in the device

  • IS_DARK_MODE_ENABLED - A Boolean that indicates if app is in dark mode or not

  • NewOneNoteUser - Identify if the user is a new user

Office.Outlook.Desktop.ExchangePuidAndTenantCorrelation

Collects the user PUID and Tenant Identifier once per session. The correlation of PUID and Tenant are necessary to understand and diagnose Outlook issues on a per-tenant basis.

The following fields are collected:

  • CollectionTime - Timestamp of the event

  • ConnId - Connection Identifier: Identifier of the connection parsing out PUID and OMS tenant Identifier

  • OMSTenantId – Microsoft-generated Unique identifier of Tenant

  • PUID - Exchange's PUID to uniquely identify users

Office.Outlook.Mac.MacOLKActivationState

Collects how Outlook is activated, such as with a subscription or volume license. The data is monitored to ensure we don't see any spikes in failures. We also analyze the data to find areas of improvement.

The following fields are collected:

  • SetupUIActivationMethod - Outlook activation method, such as subscription or volume license

Office.PowerPoint.DocOperation.Open

Collected whenever PowerPoint opens a file. Contains success information, failure details, performance metrics, and basic details about the file including file format type and document metadata. This information is necessary to ensure PowerPoint can open files successfully with no degradation in performance. It allows us to diagnose any problems we discover.

The following fields are collected:

  • Data_AddDocTelemetryResult - Does this log entry have all necessary document telemetry (Data_Doc_* fields)

  • Data_AddDocumentToMruList - Method AddDocumentToMruList execution duration

  • Data_AlreadyOpened - Was this document previously opened (within the context of the same process session)

  • Data_AntiVirusScanMethod - Predefined set of values of type of anti-virus scanned (IOAV, AMSI, None etc.)

  • Data_AntiVirusScanStatus - Predefined set of values of anti-virus scan that happens for every document opened (NoThreatsDetected, Failed, MalwareDetected, etc.)

  • Data_AsyncOpenKind - Predefined set of values of async options (Collab, ServerOnly, SyncBacked, NotAsync)

  • Data_CancelBackgroundDownloadHr - Was downloading of document interrupted? If yes, what was the result of interruption?

  • Data_CheckForAssistedReadingReasons - Method CheckForAssistedReadingReasons execution duration in milliseconds

  • Data_CheckForDisabledDocument - Method CheckForDisabledDocument execution duration in milliseconds

  • Data_CheckForExistingDocument - Method CheckForExistingDocument execution duration in milliseconds

  • Data_CheckIncOpenResult - Method CheckIncOpenResult execution duration in milliseconds

  • Data_CheckLambdaResult - Method CheckLambdaResult execution duration in milliseconds

  • Data_CheckPackageForRequiredParts - Method CheckPackageForRequiredParts execution duration in milliseconds

  • Data_CheckPackageForSpecialCases - Method CheckPackageForSpecialCases execution duration in milliseconds

  • Data_CheckRequiredPartsLoaded - Method CheckRequiredPartsLoaded execution duration in milliseconds

  • Data_CheckWebSharingViolationForIncOpen - Method CheckWebSharingViolationForIncOpen execution duration in milliseconds

  • Data_CleanClickCorrelationId - The correlation GUID from client origin. As it could be from web or other sources we use this correlation ID to stitch the end to end events from client to the target app (in this case PowerPoint)

  • Data_CleanClickOrigin - Where the ppt fileUrl link is originally opened from (Office Apps/windows start recommended/WAC)

  • Data_ClickTime - The timestamp when the file URL link is clicked, used to track performance from click event until file loaded in app.

  • Data_CloseAndReopenWithoutDiscard – Whether a document was closed and reopened during the open process without discarding.

  • Data_ClpDocHasDrmDoc:bool - Whether the document has a DRM document

  • Data_ClpDocHasIdentity:bool - Whether the document has identity info (used to get and set sensitivity labels)

  • Data_ClpDocHasSessionMetadata:bool – Whether the document has working sensitivity label metadata from the session

  • Data_ClpDocHasSpoMetadata:bool - Whether the document has sensitivity label metadata from SPO via IMetadataCache

  • Data_ClpDocHasSpoPackage:bool – Whether the document has sensitivity label metadata from SPO via IPackage

  • Data_ClpDocIsProtected:bool - Whether or not the document is protected by IRM

  • Data_ClpDocMetadataSource:int - Enum specifying where sensitivity label metadata is from (IRM, OPC part, Sharepoint etc.)

  • Data_ClpDocNeedsUpconversion:bool - Whether the document needs to upconvert sensitivity label data from the custom.xml part

  • Data_ClpDocNumFailedSetLabels:int - Count of sensitivity labels that failed to set on the document

  • Data_ClpDocSessionMetadataDirty:bool - Whether the document has working sensitivity label metadata that has been dirtied

  • Data_ClpDocWasInTrustBoundary:bool – Whether the document was in the trust boundary (allowing for coauthoring on documents protected by sensitivity labels)

  • Data_ContentTransaction - Predefined set of values of when transaction can be created (AllowedOnLoadDocument, AllowedOnOpenComplete, etc.)

  • Data_CorrelationId - A GUID passed to PowerPoint by ProtocolHandler for correlating telemetry. ProtocolHandler is a separate process that handles Office links for the OS.

  • Data_CppUncaughtExceptionCount:long - Uncaught native exceptions while activity was running

  • Data_CreateDocumentTimeMS - Method CreateDocumentTimeMS execution duration in milliseconds

  • Data_CreateDocumentToken - Method CreateDocumentToken execution duration in milliseconds

  • Data_CreateDocumentToW - Method CreateDocumentToW execution duration in milliseconds

  • Data_CreateDocWindow - Method CreateDocWindow execution duration in milliseconds

  • Data_CreateLocalTempFile - Method CreateLocalTempFile execution duration in milliseconds

  • Data_CsiDownloadErrDlgSuppressed:bool – Whether the dialog that would have been shown by CSI during a download error has been suppressed, usually in favor of a dialog shown by PowerPoint instead.

  • Data_DeferredBlobDisabledReasons - Value that maps to an enum set indicating the reasons deferred blobs were disabled during the document open

  • Data_DetachedDuration:long - Time for which Activity was detached/not running

  • Data_DetermineFileType - Method DetermineFileType execution duration in milliseconds

  • Data_Doc_AccessMode:long - How was this document opened (Read only / read write)

  • Data_Doc_AssistedReadingReasons:long - Predefined set of values of why document was opened in assisted reading mode

  • Data_Doc_AsyncOpenKind:long – Indicates whether a cached version of the cloud document was opened and which asynchronous refresh logic was used.

  • Data_Doc_ChunkingType:long - How is document stored in SharePoint

  • Data_Doc_EdpState:long - Enterprise Data Protection state of document

  • Data_Doc_Ext:string - Document extension

  • Data_Doc_Extension:string - Document extension

  • Data_Doc_FileFormat:long - Predefined set of values of format of file (more granular than extension)

  • Data_Doc_Fqdn:string – - Where is document stored (SharePoint.com, live.net), only available for Office 365 domains

  • Data_Doc_FqdnHash:string – - Hash of where document is stored

  • Data_Doc_IdentityTelemetryId:string – - Unique GUID of user

  • Data_Doc_IdentityUniqueId:string - Unique identifier of identity that was used for Shared Documents action

  • Data_Doc_IOFlags:long - Bitmask for various IO-related flags for a given document

  • Data_Doc_IrmRights:long - Predefined set of values of what type of Information Rights Management is applied on this document (Forward, Reply, SecureReader, Edit etc.)

  • Data_Doc_IsCloudCollabEnabled:bool - True if the "IsCloudCollabEnabled" HTTP header has already been received from an OPTIONS request.

  • Data_Doc_IsIncrementalOpen:bool – - Was document opened incrementally (new feature that opens document without needing to download entire document)

  • Data_Doc_IsOcsSupported:bool - Is Document supports co-authoring using new OCS service

  • Data_Doc_IsOpeningOfflineCopy:bool - Is document being opened from local cache?

  • Data_Doc_IsSyncBacked:bool - Is document opened from folder that is using OneDrive sync back app

  • Data_Doc_Location:long - Predefined set of values of where document is stored (Local, SharePoint, WOPI, Network etc.)

  • Data_Doc_LocationDetails:long - Predefined set of values of more detailed location (Temp folder, downloads folder, One Drive Documents, One Drive Pictures, etc.)

  • Data_Doc_NumberCoAuthors:long - Number of co-authors at the time of opening of a document

  • Data_Doc_PasswordFlags:long - Predefined set of values of how document is encrypted with password (None, password to read, password to edit)

  • Data_Doc_ReadOnlyReasons:long –- Predefined set of values of why this document was marked read only (Locked on server, final document, password protected to edit, etc.)

  • Data_Doc_ResourceIdHash:string - Hash of resource identifier for documents stored in cloud

  • Data_Doc_RtcType - Indicates how the real-time channel (RTC) was set up for current file (Disabled, unsupported, on demand, always on, etc.).

  • Data_Doc_ServerDocId:string - immutable identifier for documents stored in cloud

  • Data_Doc_ServerProtocol:long - Predefined set of values of which protocol is used to talk to server (Http, Cobalt, WOPI etc.)

  • Data_Doc_ServerType:long - Predefined set of values of type of server (SharePoint, DropBox, WOPI)

  • Data_Doc_ServerVersion:long - Is server is based off Office14, Office15, Office 16?

  • Data_Doc_SessionId:long - generated GUID that Identifies the instance of the document within the same process session

  • Data_Doc_SharePointServiceContext:string - An opaque string, typically GridManagerID.FarmID. Useful for correlating client-side and server-side logs

  • Data_Doc_SizeInBytes:long - Document size in bytes

  • Data_Doc_SpecialChars:long - Bitmask indicating special chars in the document's URL or Path

  • Data_Doc_StorageProviderId:string - A string that identifies the document's storage provider, like "DropBox"

  • Data_Doc_StreamAvailability:long- Predefined set of values of status of document Stream (available, permanently disabled, not available)

  • Data_Doc_UrlHash:string - hash of full URL of documents stored in cloud

  • Data_Doc_UsedWrsDataOnOpen:bool - true if the file was opened incrementally using pre-cached WRS data on the host

  • Data_Doc_WopiServiceId:string - WOPI Service identifier, for example "Dropbox"

  • Data_DownloadErrorCsi:int – Type of a download error, as provided by CSI

  • Data_DownloadErrorHResult:int – HResult of a download error, as provided by CSI

  • Data_DownloadExcludedData - Method DownloadExcludedData execution duration in milliseconds

  • Data_DownloadExcludedDataTelemetry - Predefined set of values of state of synchronously waiting for download(SynchronousLogicHit, UserCancelled RunModalTaskUnexpectedHResult etc.)

  • Data_DownloadFileInBGThread - Method DownloadFileInBGThread execution duration in milliseconds

  • Data_DownloadFragmentSize - Size of fragment(downloadable chunk of file), usually 3.5 MB

  • Data_DRGDisabledReason - Value that maps to an enum indicating the reason the DRG stack was disabled during download for document open

  • Data_DRGSyncOpResult - Value that maps to an enum indicating the DRG sync op result during document open

  • Data_ExcludedEmbeddedItems - Number of zip parts that are excluded for first render

  • Data_ExcludedEmbeddedItemsSize - Total size of zip parts that are excluded for first render

  • Data_ExcludedRequiredItems - Number of zip parts that are excluded but required for first render

  • Data_ExcludedRequiredItemsSize - Total size of zip parts that are excluded but required for first render

  • Data_ExecutionCount - How many times IncOpen protocol was executed

  • Data_FailureComponent:long - Predefined set of values of which component caused this protocol to fail? (Conflict, CSI, Internal etc.)

  • Data_FailureReason:long - Predefined set of values of what's the failure reason (FileIsCorrupt, BlockedByAntivirus etc.)

  • Data_FCreateNew - Is this new blank document

  • Data_FCreateNewFromTemplate - Is this new document from templates

  • Data_FErrorAfterDocWinCreation:boolean- Did any error or exception happen after the document window is created.

  • Data_FileIOClpState:int – Bitset containing values regarding sensitivity label status. For example, this includes information about whether coauthoring with protected labels is enabled, whether the document has a label applied from the current tenant, and whether the document is protected by IRM.

  • Data_FileUrlLocation - Predefined set of values of where document is stored (NetworkShare, LocalDrive, ServerOther etc.)

  • Data_FirstSlideCompressedSize - compressed size of first slide zip part (usually Slide1.xml)

  • Data_FIsAutoBackupFile- Is this file an auto backup file?

  • Data_FIsDownloadFileInBgThreadEnabled - Is downloading in background thread enabled?

  • Data_fLifeguarded:bool - Was document ever lifeguarded (feature to fix document errors by themselves without prompting user)?

  • Data_ForceReopenOnIncOpenMergeFailure - Flag representing if we were forced to reopen due to merge failure in Inc Open

  • Data_ForegroundThreadPass0TimeMS - (Mac only) Total time spent in foreground thread in first pass

  • Data_ForegroundThreadPass1TimeMS - (Mac only) Total time spent in foreground thread in second pass

  • Data_FWebCreatorDoc - Is doc created from template or QuickStarter

  • Data_HasDocToken - Does this document have CSI doc token (internal code)

  • Data_HasDocument - Does this document have CSI document (internal code)

  • Data_InclusiveMeasurements - Does method measurement durations are inclusive of child method call duration

  • Data_IncompleteDocReasons - Predefined set of values of why open was incomplete (Unknown, DiscardFailure etc.)

  • Data_IncOpenDisabledReasons - Predefined set of values of Reasons why incremental open was disabled

  • Data_IncOpenFailureHr - result of why Incremental open failed

  • Data_IncOpenFailureTag - Tag (pointer to code location) of where Incremental open failed

  • Data_IncOpenFallbackReason - Why was IncOpen not run

  • Data_IncOpenRequiredTypes - Predefined set of values of content types needed for first render (RequiredXmlZipItem, RequiredNotesMaster etc.)

  • Data_IncOpenStatus - Predefined set of values of Incremental open status (Attempted, FoundExcludedItems, DocIncOpenInfoCreated etc.)

  • Data_InitFileContents - Method InitFileContents execution duration in milliseconds

  • Data_InitialExcludedItems - Number of zip parts that are excluded initially

  • Data_InitialExcludedItemsSize - Total size of zip parts that are excluded initially

  • Data_InitializationTimeMS - (Mac Only) Time to initialize

  • Data_InitialRoundtripCount - Number of server responses needed to form initial zip archive

  • Data_InitLoadProcess - Method InitLoadProcess execution duration in milliseconds

  • Data_InitPackage - Method InitPackage execution duration in milliseconds

  • Data_InitSecureReaderReasons - Method InitSecureReaderReasons execution duration in milliseconds

  • Data_InsecureWarningStage - Value that maps to the status of the Insecure Warning API call and the selected group policy during insecure URL upgrade attempt

  • Data_InstanceId - A GUID generated in code in the place where the open is triggered, uniquely identifies the open attempt, it could help troubleshooting issues like open flow gets to run more than once per instance etc.

  • Data_IsIncOpenInProgressWhileOpen - In case of multiple open of the same document, is Inc open protocol running alongside open protocol?

  • Data_IsMultiOpen - Do we support multiple open?

  • Data_IsOCS - Was document in OCS mode in its' last known state

  • Data_IsODPFile - Is document in 'Open Document Format' used by OpenOffice.org

  • Data_IsPPTMetroFile - Is document metro (pptx) file format

  • Data_LegacyFallbackReason - Value that maps to an enum indicating the reason a fallback to the legacy open protocol was triggered during a document open

  • Data_LinkOpenInOption - an int from 0 to 3 as follow to indicate the open in option used to open the file. 0 means link isn't part of the LOR v2 test, 1 means default option is selected, 2 means in browser option is selected, and 3 means in native app option is selected.

  • Data_LoadDocument - Method LoadDocument execution duration in milliseconds

  • Data_MeasurementBreakdown - Encoded measurement breakdown (shortened detailed method perf)

  • Data_Measurements - Encoded measurements

  • Data_MethodId - Last method that was executed

  • Data_NotRequiredExcludedItems - Total number of PowerPoint package items that aren't required for first render and excluded

  • Data_NotRequiredExcludedItemsSize - Total size of PowerPoint package items that aren't required for first render and excluded

  • Data_NotRequiredExcludedParts - Total number of zip parts that aren't required for first render and excluded

  • Data_NotRequiredExcludedPartsSize - Total number of zip parts that aren't required for first render and excluded

  • Data_OngoingBlockingOpenCount – This is a count of how many blocking open protocols are currently running.

  • Data_OngoingOpenCount – This is a count of how many open protocols are currently running.

  • Data_OpenCompleteFailureHR - result of why OpenComplete protocol failed

  • Data_OpenCompleteFailureTag - Tag (pointer to code location) of where OpenComplete protocol failed

  • Data_OpenLifeguardOption - Predefined set of values of choices for lifeguard operation (None, TryAgain, OpenInWebApp etc.)

  • Data_OpenReason - Predefined set of values of how this document was opened (FilePicker, OpenFromMru, FileDrop etc.)

  • Data_OSRPolicy - SecureReader Policy

  • Data_OSRReason - Reasons why this document was opened in Secure Reader

  • Data_OtherContentTypesWithRequiredParts - Nonstandard content types that were excluded but required for first render

  • Data_PersistStack - Combined string of predefined strings indicating the type of persist stack being used to open this document

  • Data_PrepCacheAsync - Flag for OcsiOpenPerfPrepCacheAsync

  • Data_PreviousDiscardFailed - Indicates previous open/close attempt on the document didn't properly release all memory

  • Data_PreviousFailureHr - In case of reopening of the same document, what was last failure result

  • Data_PreviousFailureTag - In case of reopening of the same document, what was last failure tag (pointer to code location)

  • Data_PreviousOpenFallbackHR - The error code for the failure that resulted in opening the document using a fallback method.

  • Data_PreviousOpenFallbackProtocol - The previous protocol that was used before a failure was detected that resulted in opening the document using a fallback method.

  • Data_PreviousOpenFallbackTag - The failure tag (pointer to code location) that resulted in opening the document using a fallback method.

  • Data_PreviousOpenFallbackTimeMS - The amount of time spent in milliseconds before a failure occurred that resulted in opening the document using a fallback method.

  • Data_RemoteDocToken - Is Remote Open enabled (prototype feature that enables opening file from service rather than from host)?

  • Data_Repair - Are we in document repair mode (for corrupt documents that are fixable)

  • Data_RequestPauseStats - How many times code requested to pause perf recording

  • Data_RequiredPartsComressedSize - Total size of required PowerPoint parts needed for first render

  • Data_RequiredPartsDownload - Total size of required PowerPoint parts that are downloaded

  • Data_RequiredPartsRoundtripCount - Total number of roundtrips (calls to host) needed to get all the required PowerPoint parts for first render

  • Data_RequiredZipItemsDownload - Total size of required zip items needed for first render

  • Data_RequiredZipItemsRoundtripCount - Total number of roundtrips (calls to host) needed to get all the required zip items for first render

  • Data_RoundtripsAfterMissingRequiredParts - Total number of roundtrips (calls to host) needed after we found missing required PowerPoint parts

  • Data_RoundtripsAfterMissingRequiredZipItems - Total number of roundtrips (calls to host) needed after we found missing required zip items

  • Data_RoundtripsAfterRequiredPackage - Total number of roundtrips (calls to host) needed after we created the package

  • Data_RoundtripsAfterRequiredParts - Total number of roundtrips (calls to host) needed after we downloaded all required parts

  • Data_SetDocCoAuthAutoSaveable - Method SetDocCoAuthAutoSaveable execution duration in milliseconds

  • Data_SniffedFileType - An educated guess of proposed file type of corrupt document

  • Data_StartTime - Perf counter when Open started

  • Data_StopwatchDuration:long - Total time for Activity

  • Data_SyncSlides - Method SyncSlides execution duration in milliseconds

  • Data_TimerStartReason - Predefined set of values of how timer was started (CatchMissedSyncStateNotification, WaitingForFirstDownload etc.)

  • Data_TimeSplitMeasurements - Encoded measurement breakdown (shortened detailed method perf)

  • Data_TimeToInitialPackage - Time took to create initial package

  • Data_TimeToRequiredPackage - Time took to create required package

  • Data_TimeToRequiredParts - Time took to create package with all required parts in it

  • Data_TimeToViewMS - Time taken in milliseconds before the document is visible

  • Data_TotalRequiredParts - Total number of PowerPoint parts required for first render

  • Data_UnknownRequiredParts - Total number of non-standard parts required for first render

  • Data_UnpackLinkWatsonId - Watson identifier of error when document is opened via Share OneDrive URL

  • Data_UnpackResultHint - Predefined set of values of unpacking share URL results (NavigateToWebWithoutError, UrlUnsupported, AttemptOpen etc.)

  • Data_UnpackUrl - Method UnpackUrl execution duration in milliseconds

  • Data_UpdateAppstateTimeMS - Method UpdateAppstate execution duration in milliseconds

  • Data_UpdateCoauthoringState - Method UpdateCoauthoringState execution duration in milliseconds

  • Data_UpdateReadOnlyState - Method UpdateReadOnlyState execution duration in milliseconds

  • Data_WACCorrelationId - In case of opening file in browser, get the correlation of WebApp logs

  • Data_WasCachedOnInitialize - Was this document cached during initialization

  • Data_WBDirtyBeforeDiscard - Is working branch became dirty before reopening document

  • Data_ZRTOpenDisabledReasons - Why we couldn't open document from cache (Zero Round Trip)

Office.PowerPoint.PPT.Desktop.Bootime

Collecting how PowerPoint is booted. It includes boot PowerPoint in protected view, in assisted reading mode, from Macro, print, new and blank document, document recovery, from automation and if it's click- to-run. It also collects how long it takes PowerPoint to boot. This data is critical to guarantee PowerPoint performs well when booted from different modes. Microsoft uses this data to catch long booting time when opening PowerPoint from different modes.

The following fields are collected:

  • AssistedReading - in assisted reading mode

  • Automation - from automation

  • Benchmark - run performance benchmark

  • Blank - blank document

  • BootTime - session boot time

  • Embedding - embedding document

  • IsC2R - is click-to-run

  • IsNew - new document

  • IsOpen - is open

  • Macro1 - run Macro

  • Macro2 - run Macro

  • NonStandardSpaceInCmdLine – there's non-standard space in command line

  • Print - print document

  • PrintDialog - print document with dialog

  • PrintPrinter - print document with printer

  • ProtectedView - in protected view

  • Regserver - Register PowerPoint as a COM server

  • Restore - restore document

  • Show - show document

  • Time - session time

  • UnprotectedView - in unprotected view

Office.PowerPoint.PPT.HasUserEditedDocument

Collected when a user starts editing a document. Microsoft uses this data to calculate active users who edited a PowerPoint document.

The following fields are collected:

  • CorrelationId – document Correlation Identifier

Office.Project.BootAndOpenProject

Project is booted by opening a file. This event indicates that a user has opened Office Project with an associated file. It contains critical success data of making sure Project can start and load a file.

The following fields are collected:

  • Data_AlertTime - The amount of time the boot dialog was active.

  • Data_BootTime - The amount of time it took to boot Project

  • Data_CacheFileSize - If the file was cached, the size of the file

  • Data_EntDocType - The type of file that was opened

  • Data_IsInCache - Whether the file opened was cached

  • Data_LoadSRAs - If the user wants to load SRAs or not

  • Data_Outcome - Total boot and file open time.

  • Data_OpenFromDocLib - If the Project file opened was from the document library

  • Data_ProjectServerVersion - The version and build that Project is currently on

Office.Project.BootProject

Project is booted without opening a file. This event indicates that a user has opened Office Project without an associated file. It contains critical success data of making sure Project can start.

The following fields are collected:

  • Data_BootTime - The amount of time it took to boot Project

  • Data_FileLoaded - False if opening from out-space or new blank project

  • Data_IsEntOfflineWithProfile - If the users are in the professional SKU and not connected to the server

  • Data_IsEntOnline - If the session of Project is connected to a Project server with enterprise features

  • Data_IsLocalProfile - If the Project session is connected to a Project server with enterprise features

  • Data_ProjectServerVersion - The version and build that Project is currently on

Office.Project.OpenProject

Project opens a file. This event indicates a user directly opening a Project file by a user. It contains critical success data of opening files in Project.

The following fields are collected:

  • Data_AgileMode - defines if the project opened is a waterfall or agile project

  • Data_AlertTime - The amount of time the boot dialog was active

  • Data_CacheFileSize - If the file was cached, the size of the file

  • Data_EntDocType - the type of file that was opened

  • Data_IsInCache - whether the file opened was cached

  • Data_LoadSRAs - If the user wants to load SRAs or not

  • Data_OpenFromDocLib - If the Project file opened was from the document library

  • Data_Outcome - Total boot and file open time

  • Data_Outcome - Total boot and file open time.

  • Data_ProjectServerVersion - The version and build that Project is currently on

Office.SessionIdProvider.OfficeProcessSessionStart

Applicable to all the Office windows-based applications: Win32 and UWP

The following fields are collected:

  • OfficeProcessSessionStart sends basic information upon the start of a new Office session. This is used to count the number of unique sessions seen on a given device. This is used as a heartbeat event to ensure that the application is running on a device or not. In addition, it serves as a critical signal for overall application reliability

  • AppSessionGuid - An identifier of a particular application session starting at process creation time and persisting until process end. It's formatted as a standard 128-bit GUID but constructed of four parts. Those four parts in order are (1) 32-bit Process ID (2) 16-bit Session ID (3) 16 bit Boot ID (4) 64-bit Process creation time in UTC 100 ns

  • processSessionId - Randomly generated guid to identify the app session

  • UTCReplace_AppSessionGuid - Constant boolean value. Always true.

Office.StickyNotes.Web.SDK.AppBoot

Triggered when app is booted (user action) and is required to compute usage.

The following fields are collected:

  • Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • baseData_properties_version - Version of properties such as PostChannel and PrivacyGuardPlugin 

  • Browser_Name - Always logged blank 

  • Browser_Version - Always logged blank 

  • Consent_AddInContentSourceLocation - Add In content source location 

  • Consent_AddInContentState - Add In content state 

  • Consent_ControllerConnectedServicesConsentTime - Indicates when the user chose the status of optional connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DiagnosticDataConsentTime - Indicates when the user provided the consent for diagnostic data. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DownloadContentConsentTime - Indicates when the user made the choice to enable or disable connected experiences that download online content. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_UserContentDependentConsentTime - Indicates when the user chose to enable or disable connected experiences that analyze content was made. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Culture_UiLanguage - Always logged blank 

  • Data_App_Name - The name of the application that is providing the data. Allows us to identify which application is showing an issue so we know how to address it.

  • Data_App_Platform - The broad classification of the platform on which the app is running. Allows us to identify on which platforms an issue may be occurring so that we can correctly prioritize the issue.

  • Data_App_Version - The version of the application. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

  • Data_AppInfo_Id - Name of the host application 

  • Data_AppInfo_Version - Version of the host application 

  • Data_Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • Data_clientSessionId - Client Session ID

  • Data_Device_Id - A unique identifier for the device. Allows us to identify the distribution of issues across a set of devices.

  • Data_EventName - A unique name of a OneNote's event. OneNote events use this custom field to specify a unique name due to an engineering limitation in the past.

  • Data_ExpirationDate - A date in numerical format indicates when this event will be stop sending from clients

  • Data_FeedEnabled - Identifies if feed is enabled. 

  • Data_HostApp - Identifies the host app name that launches a sub-app. 

  • Data_HostSessionId - Uniquely identifies the host app session for a sub-app 

  • Data_Namespace - A namespace of the event. Allows us to group the event into groups.

  • Data_OTelJS_Sink - Sink used by OTel logger. It's always logged blank. 

  • Data_OTelJS_Version - Version of OTel logger 

  • Data_SamplePolicy - Identifies if the sample policy is Measure or Critical 

  • Data_SDX_AssetId - ONLY exists for store Add-ins. OMEX gives the Add in an AssetId when it goes into Store. It's always logged blank. 

  • Data_SDX_BrowserToken - Identifier that sits in the browser's cache 

  • Data_SDX_HostJsVersion - This is the platform-specific version of Office.js (for example, outlook web16.01.js) This contains the API surface for ad ins 

  • Data_SDX_Id - The GUID of an Add-in, which uniquely identifies it 

  • Data_SDX_InstanceId - Represents Add in document pair 

  • Data_SDX_MarketplaceType - Indicates where the Add-in installed from 

  • Data_SDX_OfficeJsVersion - This is the version of Office.js that will redirect to the platform-specific version. 

  • Data_SDX_SessionId - Session ID of the Add-in 

  • Data_SDXSessionId - SDX Session ID

  • Data_SDX_Version - Version of the Add-in 

  • Data_Session_Id - Uniquely identifies a given session of data. Allows us to identify the impact of issues by evaluating the number of sessions that are impacted and if there are common features of those sessions.

  • Data_SessionCorrelationId - The globally unique identifier for the host's session.

  • Data_ShortEventName - A short name of an event. Allows us to identify the event that was being sent from the client. 

  • Data_StickyNotesSDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it. 

  • Data_User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • Data_User_PrimaryIdentityHash - A pseudonymous identifier that represents the current user.

  • Data_User_PrimaryIdentitySpace - The type of identity contained in the PrimaryIdentityHash. One of MSACID, OrgIdCID, or UserObjectId.

  • Data_User_TenantId - The tenant that a user's subscription is tied to. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant.

  • DeviceInfo_BrowserName - Browser Name 

  • DeviceInfo_BrowserVersion - Browser Version 

  • DeviceInfo_Id - The globally unique device identifier for a device 

  • DeviceInfo_OsName - The name of the device OS 

  • DeviceInfo_OsVersion - The version of the operating system 

  • Event_ReceivedTime - The time the event was logged in the service 

  • M365aInfo_EnrolledTenantId - Enrolled tenant ID 

  • OriginalRoutingGeo - Identifies if the original routing geo is eu or not. 

  • PartA_PrivTags - Always logged blank 

  • Release_IsOutOfServiceFork - It's always logged as true or blank 

  • Session_SamplingValue - A value in (0, 1) 

  • User_ActiveUserTenantId - Active user tenant ID 

  • User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • User_TelemetryRegion - Identifies the data boundary of the user 

  • UserInfo_Language - Current language setting of the device to help us detect issues affecting certain languages 

  • UserInfo_TimeZone - The user's time zone relative to UTC.

  • WAC_ApplicationMode - Always logged blank 

  • WAC_ApplicationModeExtended - Always logged blank 

  • WAC_BrowserLanguage - Always logged blank 

  • WAC_ContentLanguage - Always logged blank 

  • WAC_Datacenter - Always logged blank 

  • WAC_Host - Always logged blank 

  • WAC_IsBusinessUser - Always logged blank 

  • WAC_IsEdu - Always logged blank 

  • WAC_IsSynthetic - Always logged blank 

  • WAC_OsVersion - Always logged blank 

  • WAC_Ring - Always logged blank 

  • WAC_ServerDocId - Server Document ID for the document that was scanned. It's always logged as blank. 

  • WAC_SessionOrigin - Always logged blank 

  • WAC_UiHost - Always logged blank 

  • WAC_UiHostIntegrationType - Always logged blank 

Office.System.SessionHandoff

Indicates that the current Office session is a handoff session. This means that handling of a user's request to open a document is being handed off to an already running instance of the same application.

The following fields are collected.

  • ParentSessionId - The ID of the session that will be taking over handling of the users' request.

Office.Taos.Hub.Windows.Launched

This event gets triggered whenever the app gets launched. This event is used to record the lifecycle of the app.

The following fields are collected:

  • AdditionalInfo - Additional information of the Failure.

  • AppInfo_Id - The App ID.

  • AppInfo_Version - Office desktop app version.

  • AppType - The type of the container, from which logs are emitted.

  • BridgeInstanceId - A unique ID given to the Office Windows app instance, used to corelate all the events from a single app session. We can't derive any PII from this ID.

  • DeviceInfo_Id - A unique device ID calculated by 1DS SDK.

  • DeviceInfo_Make - The device make.

  • DeviceInfo_Model - The device model.

  • DeviceInfo_NetworkCost - Network cost type of the user (Unmetered, metered, etc.)

  • DeviceInfo_NetworkType - The type of network (Wi-Fi, Wired, Unknown).

  • DeviceInfo_OsName - OS name installed in the user's device.

  • DeviceInfo_OsVersion - The OS version installed in the user's device.

  • DeviceInfo_SDKUid - Unique identifier for the SDK.

  • EventInfo_BaseEventType - The event type.

  • EventInfo_BaseType - The type of the event.

  • EventInfo_Level - The event level.

  • EventInfo_Name - The name of the event.

  • EventInfo_PrivTags - The event tags.

  • EventInfo_Source - The source of the event. For exmaple, OneCollector

  • EventInfo_SdkVersion - 1DS SDK Version.

  • EventInfo_Time - The time of the event.

  • FailReason - Error message of the failure.

  • Feature - The name of the feature.

  • LastError - Error code of the failure.

  • M365aInfo_EnrolledTenantId - The Enrollment TenantID.

  • Method - The name of the calling method.

  • PerformanceMarkerTimestamp - The Performance Timestamp.

  • PipelineInfo_AccountId - Aria Pipeline account ID

  • PipelineInfo_ClientCountry - The device country or region (based on IP address).

  • PipelineInfo_ClientIp - The first three octets of the IP address.

  • PipelineInfo_IngestionTime - Ingestion time of the event.

  • Result - A boolean value indicating success/failure.

  • Uri - The URI of the current loaded Office Web.

  • UserInfo_TimeZone - Time zone of the user.

Office.TelemetryEngine.IsPreLaunch

Applicable for Office UWP applications. This event is fired when an Office application is initiated for the first-time post upgrade/install from the store. This is part of basic diagnostic data, used to track whether a session is launch session or not.

The following fields are collected:

  • appVersionBuild - The app build version number.

  • appVersionMajor - The app major version number.

  • appVersionMinor - The app minor version number.

  • appVersionRev - The app revision version number.

  • SessionID - Randomly generated GUID to identify the app session

Office.TelemetryEngine.SessionHandOff

Applicable to Win32 Office applications. This event helps us understand whether there was a new session created to handle a user-initiated file open event. It's a critical diagnostic information that is used to derive reliability signal and ensure that the application is working as expected.

The following fields are collected:

  • appVersionBuild - The app build version number.

  • appVersionMajor - The app major version number.

  • appVersionMinor - The app minor version number.

  • appVersionRev - The app revision version number.

  • childSessionID - Randomly generated guid to identify the app session

  • parentSessionId - Randomly generated guid to identify the app session

Office.Visio.VisioIosAppBootTime

This is triggered every time the Visio iOS application boots. It's essential to understand boot performance of the Visio iOS app. Used to troubleshoot poor performance.

The following fields are collected:

  • Data_AppBootTime - Duration taken for app to boot, in milliseconds.

Office.Visio.VisioIosAppResumeTime

This event is triggered every time the Visio iOS app resumes focus. It's essential to measure app resume performance and troubleshoot performance issues of Visio iOS app.

The following fields are collected:

  • Data_AppResumeTime - Duration for app to resume in milliseconds.

Office.Word.FileOpen.OpenCmdFileMruPriv

This event indicates Office Word opens a document from the Most Recent Used (MRU) list. It also contains critical file open performance data and is an app start event from user perspective. The event monitors whether fileopen-from-MRU is working as expected. It's also used to calculated monthly active users/devices, and cloud reliability metrics.

The following fields are collected:

  • Data_AddDocTelemRes - Reports whether we were able to properly populate other document telemetry-related values in the event. Used for data quality diagnostics.

  • Data_BytesAsynchronous - Number of bytes (compressed) that we believe we can open the file without if we get them before the user wants to start editing or maybe saving

  • Data_BytesAsynchronousWithWork - Number of bytes (compressed) that we might be able to open the file without but would require significant code investments to make it happen

  • Data_BytesSynchronous - Number of bytes (compressed) that we must have before we can start opening the file

  • Data_BytesUnknown - Number of bytes in document parts that we don't expect to find

  • Data_DetachedDuration - How long was the activity detached from the thread

  • Data_Doc_AccessMode - Document is read only/editable

  • Data_Doc_AssistedReadingReasons - Predefined set of values of why document was opened in assisted reading mode

  • Data_Doc_AsyncOpenKind – Indicates whether a cached version of the cloud document was opened and which asynchronous refresh logic was used.

  • Data_Doc_ChunkingType - Units used for incremental document open

  • Data_Doc_EdpState - Electronic Data Protection setting for the document

  • Data_Doc_Ext - Document extension (docx/xlsb/pptx etc.)

  • Data_Doc_FileFormat - File format protocol version

  • Data_Doc_Fqdn - OneDrive or SharePoint Domain Name

  • Data_Doc_FqdnHash - One-way hash of customer identifiable domain name

  • Data_Doc_IdentityTelemetryId - A one-way hash of the user identity used to perform the open

  • Data_Doc_InitializationScenario - Records how the document was opened

  • Data_Doc_IOFlags - Reports on the cached flags used to set open request options

  • Data_Doc_IrmRights - Actions permitted by the Electronic Data Protection policy that has been applied to the document/user

  • Data_Doc_IsIncrementalOpen - Flag indicating that the document has been incrementally opened

  • Data_Doc_IsOcsSupported - Flag indicating that the document is supported in the collaboration service

  • Data_Doc_IsOpeningOfflineCopy - Flag indicating that the offline copy of a document was opened

  • Data_Doc_IsSyncBacked - Flag indicating that an auto-synced copy of the document exists on the computer

  • Data_Doc_Location - Indicates which service provided the document (OneDrive, File Server, SharePoint etc.)

  • Data_Doc_LocationDetails - Indicates which Known Folder provided a locally stored document

  • Data_Doc_NumberCoAuthors - Count of the number of fellow users in a collaborative editing session

  • Data_Doc_PasswordFlags - Indicates read or read/write password flags set

  • Data_Doc_ReadOnlyReasons - Reasons why the document was opened read only

  • Data_Doc_ResourceIdHash - An anonymized document Identifier used to diagnose problems

  • Data_Doc_RtcType - Indicates how the real-time channel (RTC) was set up for current file (Disabled, unsupported, on demand, always on, etc.).

  • Data_Doc_ServerDocId - An immutable anonymized document Identifier used to diagnose problems

  • Data_Doc_ServerProtocol - the protocol version used to communicate with the service

  • Data_Doc_ServerType - the type of the server offering the service (SharePoint, OneDrive, WOPI, etc.)

  • Data_Doc_ServerVersion - the server version offering the service

  • Data_Doc_SessionId - Identifies a specific document edit session within the full session

  • Data_Doc_SharePointServiceContext - Diagnostic information from SharePoint requests

  • Data_Doc_SizeInBytes - Indicator of document size

  • Data_Doc_SpecialChars - Indicator of special chars in the document's URL

  • Data_Doc_SyncBackedType - Indicator as to the type of document (local or service based)

  • Data_Doc_UrlHash - One-way hash to create a naïve document identifier

  • Data_Doc_WopiServiceId - Contains unique identifier of WOPI service provider

  • Data_EditorDisablingRename - Identifier of the first editor that caused for rename to be disabled

  • Data_EditorsCount - Number of editors in the document

  • Data_ForceReadWriteReason - Integer value representing the reason why the file was forced into read/write mode

  • Data_FSucceededAfterRecoverableFailure - Indicates that open succeeded after repairing a failure while opening the document

  • Data_LastLoggedTag - Unique tag for code call site used to identify when we try to fail the open twice (used for data quality diagnostics)

  • Data_LinkStyles - Indicates whether we're linking to the template styles

  • Data_MainPdod - The document identifier in Office Word process

  • Data_Measurements - Encoded string containing the time breakdown of the different parts of open. Used to measure performance.

  • Data_MoveDisabledReason - Error that is disabling move for the document

  • Data_MoveFlightEnabled - Whether the flight for the move feature is enabled

  • Data_PartsUnknown - the number of document parts that we couldn't get data for

  • Data_RecoverableFailureInitiationLocationTag - Unique tag for code call site used to identify the place in code where we attempt to fix the file before opening it

  • Data_RenameDisabledReason - Error that is causing for rename to be disabled for this document

  • Data_RenameFlightEnabled - Whether the flight for the rename feature is enabled

  • Data_SecondaryTag - Unique tag for code call site used to add additional failure data for open

  • Data_TemplateFormat - File format of the template that the document is based on.

  • Data_UsesNormal - Indicates whether the open document is based on the normal template

  • PathData_Doc_StreamAvailability - Indicator if document stream is available/disabled

Office.Word.FileOpen.OpenFFileOpenXstzCore

This event indicates Office Word opens a document who is double-clicked by a user. It also contains critical file open performance data and is an app start event from user perspective. The event monitors whether file-openfrom-file-double-click is working as expected. It's also used to calculated monthly active users/devices, and cloud reliability metrics.

The following fields are collected:

  • Data_AddDocTelemRes - Reports whether we were able to properly populate other document telemetry-related values in the event. Used for data quality diagnostics

  • Data_BytesAsynchronous - Number of bytes (compressed) that we believe we can open the file without if we get them before the user wants to start editing or maybe saving

  • Data_BytesAsynchronousWithWork - Number of bytes (compressed) that we might be able to open the file without but would require significant code investments to make it happen

  • Data_BytesSynchronous - Number of bytes (compressed) that we must have before we can start opening the file

  • Data_BytesUnknown - Number of bytes in document parts that we don't expect to find

  • Data_DetachedDuration - How long was the activity detached from the thread

  • Data_Doc_AccessMode - Document is read only/editable

  • Data_Doc_AssistedReadingReasons - Predefined set of values of why document was opened in assisted reading mode

  • Data_Doc_AsyncOpenKind – Indicates whether a cached version of the cloud document was opened and which asynchronous refresh logic was used.

  • Data_Doc_ChunkingType - Units used for incremental document open

  • Data_Doc_EdpState - Electronic Data Protection setting for the document

  • Data_Doc_Ext - Document extension (docx/xlsb/pptx etc.)

  • Data_Doc_FileFormat - File format protocol version

  • Data_Doc_Fqdn - OneDrive or SharePoint Domain Name

  • Data_Doc_FqdnHash - One-way hash of customer identifiable domain name

  • Data_Doc_IOFlags - Reports on the cached flags used to set open request options

  • Data_Doc_IdentityTelemetryId - A one-way hash of the user identity used to perform the open

  • Data_Doc_InitializationScenario - Records how the document was opened

  • Data_Doc_IrmRights - Actions permitted by the Electronic Data Protection policy that has been applied to the document/user

  • Data_Doc_IsIncrementalOpen - Flag indicating that the document has been incrementally opened

  • Data_Doc_IsOcsSupported - Flag indicating that the document is supported in the collaboration service

  • Data_Doc_IsOpeningOfflineCopy - Flag indicating that the offline copy of a document was opened

  • Data_Doc_IsSyncBacked - Flag indicating that an auto synced copy of the document exists on the computer

  • Data_Doc_Location - Indicates which service provided the document (OneDrive, File Server, SharePoint etc.)

  • Data_Doc_LocationDetails - Indicates which Known Folder provided a locally stored document

  • Data_Doc_NumberCoAuthors - Count of the number of fellow users in a collaborative editing session

  • Data_Doc_PasswordFlags - Indicates read or read/write password flags set

  • Data_Doc_ReadOnlyReasons - Reasons why the document was opened read only

  • Data_Doc_ResourceIdHash - An anonymized document Identifier used to diagnose problems

  • Data_Doc_RtcType - Indicates how the real-time channel (RTC) was set up for current file (Disabled, unsupported, on demand, always on, etc.).

  • Data_Doc_ServerDocId - An immutable anonymized document Identifier used to diagnose problems

  • Data_Doc_ServerProtocol - the protocol version used to communicate with the service

  • Data_Doc_ServerType - the type of the server offering the service (SharePoint, OneDrive, WOPI etc.)

  • Data_Doc_ServerVersion - the server version offering the service

  • Data_Doc_SessionId - Identifies a specific document edit session within the full session

  • Data_Doc_SharePointServiceContext - Diagnostic information from SharePoint requests

  • Data_Doc_SizeInBytes - Indicator of document size

  • Data_Doc_SpecialChars - Indicator of special chars in the document's URL or Path

  • Data_Doc_StreamAvailability - Indicator if document stream is available/disabled

  • Data_Doc_SyncBackedType - Indicator as to the type of document (local or service based)

  • Data_Doc_UrlHash - One-way hash to create a naïve document identifier

  • Data_Doc_WopiServiceId - Contains unique identifier of WOPI service provider

  • Data_EditorDisablingRename - Identifier of the first editor that caused for rename to be disabled

  • Data_EditorsCount - Number of editors in the document

  • Data_FSucceededAfterRecoverableFailure - Indicates that open succeeded after repairing a failure while opening the document

  • Data_ForceReadWriteReason - Integer value representing the reason why the file was forced into read/write mode

  • Data_LastLoggedTag - Unique tag for code call site used to identify when we try to fail the open twice (used for data quality diagnostics)

  • Data_LinkStyles - Indicates whether we're linking to the template styles

  • Data_MainPdod - The document identifier in Office Word process

  • Data_Measurements - Encoded string containing the time breakdown of the different parts of open. Used to measure performance.

  • Data_MoveDisabledReason - Error that is disabling move for the document

  • Data_MoveFlightEnabled - Whether the flight for the move feature is enabled

  • Data_PartsUnknown - the number of document parts that we couldn't get data for

  • Data_RecoverableFailureInitiationLocationTag - Unique tag for code call site used to identify the place in code where we attempt to fix the file before opening it.

  • Data_RenameDisabledReason - Error that is causing for rename to be disabled for this document

  • Data_RenameFlightEnabled - Whether the flight for the rename feature is enabled

  • Data_SecondaryTag - Unique tag for code call site used to add additional failure data for open.

  • Data_TemplateFormat - File format of the template that the document is based on.

  • Data_UsesNormal - Indicates whether the open document is based on the normal template.

Office.Word.FileOpen.OpenIfrInitArgs

This event indicates Office Word opens a document via COM activation or command line. It also contains critical file open performance data, and is an app start event from user perspective. The event monitors whether file-open-from-command-line is working as expected. It's also used to calculated monthly active users/devices, and cloud reliability metrics.

The following fields are collected:

  • Data_AddDocTelemRes - Reports whether we were able to properly populate other document telemetry-related values in the event. Used for data quality diagnostics.

  • Data_BytesAsynchronous - Number of bytes (compressed) that we believe we can open the file without if we get them before the user wants to start editing or maybe saving.

  • Data_BytesAsynchronousWithWork - Number of bytes (compressed) that we might be able to open the file without but would require significant code investments to make it happen

  • Data_BytesSynchronous - Number of bytes (compressed) that we must have before we can start opening the file

  • Data_BytesUnknown - Number of bytes in document parts that we don't expect to find.

  • Data_Doc_AccessMode - Document is read only/editable

  • Data_Doc_AssistedReadingReasons - Predefined set of values of why document was opened in assisted reading mode

  • Data_Doc_AsyncOpenKind – Indicates whether a cached version of the cloud document was opened and which asynchronous refresh logic was used.

  • Data_Doc_ChunkingType - Units used for incremental document open

  • Data_Doc_EdpState - Electronic Data Protection setting for the document

  • Data_Doc_Ext - Document extension (docx/xlsb/pptx, etc.)

  • Data_Doc_FileFormat - File format protocol version

  • Data_Doc_Fqdn - OneDrive or SharePoint Domain Name

  • Data_Doc_FqdnHash - One-way hash of customer identifiable domain name

  • Data_Doc_IOFlags - Reports on the cached flags used to set open request options

  • Data_Doc_IdentityTelemetryId - A one-way hash of the user identity used to perform the open

  • Data_Doc_InitializationScenario - Records how the document was opened

  • Data_Doc_IrmRights - Actions permitted by the Electronic Data Protection policy that has been applied to the document/user

  • Data_Doc_IsIncrementalOpen - Flag indicating that the document has been incrementally opened

  • Data_Doc_IsOcsSupported - Flag indicating that the document is supported in the collaboration service

  • Data_Doc_IsOpeningOfflineCopy - Flag indicating that the offline copy of a document was opened

  • Data_Doc_IsSyncBacked - Flag indicating that an auto synced copy of the document exists on the computer

  • Data_Doc_Location - Indicates which service provided the document (OneDrive, File Server, SharePoint)

  • Data_Doc_LocationDetails - Indicates which Known Folder provided a locally stored document

  • Data_Doc_NumberCoAuthors - Count of the number of fellow users in a collaborative editing session

  • Data_Doc_PasswordFlags - Indicates read or read/write password flags set

  • Data_Doc_ReadOnlyReasons - Reasons why the document was opened read only

  • Data_Doc_ResourceIdHash - An anonymized document Identifier used to diagnose problems

  • Data_Doc_RtcType - Indicates how the real-time channel (RTC) was set up for current file (Disabled, unsupported, on demand, always on, etc.).

  • Data_Doc_ServerDocId - An immutable anonymized document Identifier used to diagnose problems

  • Data_Doc_ServerProtocol - the protocol version used to communicate with the service

  • Data_Doc_ServerType - the type of the server offering the service (SharePoint, OneDrive, WOPI etc.)

  • Data_Doc_ServerVersion - the server version offering the service

  • Data_Doc_SessionId - the server version offering the service

  • Data_Doc_SharePointServiceContext - Diagnostic information from SharePoint requests

  • Data_Doc_SizeInBytes - Indicator of document size

  • Data_Doc_SpecialChars - Indicator of special chars in the document's URL or Path

  • Data_Doc_StreamAvailability - Indicator if document stream is available/disabled

  • Data_Doc_SyncBackedType - Indicator as to the type of document (local or service based)

  • Data_Doc_UrlHash - One-way hash to create a naïve document identifier

  • Data_Doc_WopiServiceId - Contains unique identifier of WOPI service provider

  • Data_EditorDisablingRename - Identifier of the first editor that caused for rename to be disabled

  • Data_EditorsCount - Number of editors in the document

  • Data_FSucceededAfterRecoverableFailure - Indicates that open succeeded after repairing a failure while opening the document

  • Data_ForceReadWriteReason - Integer value representing the reason why the file was forced into read/write mode

  • Data_LastLoggedTag - Unique tag for code call site used to identify when we try to fail the open twice (used for data quality diagnostics)

  • Data_LinkStyles - Indicates whether we're linking to the template styles

  • Data_MainPdod - The document identifier in Office Word process

  • Data_Measurements - Encoded string containing the time breakdown of the different parts of open. Used to diagnose open performance.

  • Data_MoveDisabledReason - Error that is disabling move for the document

  • Data_MoveFlightEnabled - Whether the flight for the move feature is enabled

  • Data_PartsUnknown - the number of document parts that we couldn't get data for

  • Data_RecoverableFailureInitiationLocationTag - Unique tag for code call site used to identify the place in code where we attempt to fix the file before opening it

  • Data_RenameDisabledReason - Error that is causing for rename to be disabled for this document

  • Data_RenameFlightEnabled - Whether the flight for the rename feature is enabled

  • Data_SecondaryTag - Unique tag for code call site used to add additional failure data for open.

  • Data_TemplateFormat - File format of the template that the document is based on.

  • Data_UsesNormal - Indicates whether the open document is based on the normal template.

Office.Word.FileOpen.OpenLoadFile

This event indicates Office Word opens a document via Open dialog. It also contains critical file open performance data and is an app start event from user perspective. The event monitors whether file-open-from-the-open-filedialog is working as expected. It's also used to calculated monthly active users/devices, and cloud reliability metrics.

The following fields are collected:

  • Data_AddDocTelemRes - Reports whether we were able to properly populate other document telemetry-related values in the event. Used for data quality diagnostics.

  • Data_BytesAsynchronous - Number of bytes (compressed) that we believe we can open the file without if we get them before the user wants to start editing or maybe saving

  • Data_BytesAsynchronousWithWork - Number of bytes (compressed) that we might be able to open the file without but would require significant code investments to make it happen

  • Data_BytesSynchronous - Number of bytes (compressed) that we must have before we can start opening the file

  • Data_BytesUnknown - Number of bytes in document parts that we don't expect to find

  • Data_DetachedDuration - How long was the activity detached from the thread

  • Data_Doc_AccessMode - Document is read only/editable

  • Data_Doc_AssistedReadingReasons - Predefined set of values of why document was opened in assisted reading mode

  • Data_Doc_AsyncOpenKind – Indicates whether a cached version of the cloud document was opened and which asynchronous refresh logic was used.

  • Data_Doc_ChunkingType - Units used for incremental document open

  • Data_Doc_EdpState - Electronic Data Protection setting for the document

  • Data_Doc_Ext - Document extension (docx/xlsb/pptx etc.)

  • Data_Doc_FileFormat - File format protocol version

  • Data_Doc_Fqdn - OneDrive or SharePoint Domain Name

  • Data_Doc_FqdnHash - One-way hash of customer identifiable domain name

  • Data_Doc_IdentityTelemetryId - A one-way hash of the user identity used to perform the open

  • Data_Doc_InitializationScenario - Records how the document was opened

  • Data_Doc_IOFlags - Reports on the cached flags used to set open request options

  • Data_Doc_IrmRights - Actions permitted by the Electronic Data Protection policy that has been applied to the document/user

  • Data_Doc_IsIncrementalOpen - Flag indicating that the document has been incrementally opened

  • Data_Doc_IsOcsSupported - Flag indicating that the document is supported in the collaboration service

  • Data_Doc_IsOpeningOfflineCopy - Flag indicating that the offline copy of a document was opened

  • Data_Doc_IsSyncBacked - Flag indicating that an auto synced copy of the document exists on the computer

  • Data_Doc_Location - Indicates which service provided the document (OneDrive, File Server, SharePoint etc.)

  • Data_Doc_LocationDetails - Indicates which Known Folder provided a locally stored document

  • Data_Doc_NumberCoAuthors - Count of the number of fellow users in a collaborative editing session

  • Data_Doc_PasswordFlags - Indicates read or read/write password flags set

  • Data_Doc_ReadOnlyReasons - Reasons why the document was opened read only

  • Data_Doc_ResourceIdHash - An anonymized document Identifier used to diagnose problems

  • Data_Doc_RtcType - Indicates how the real-time channel (RTC) was set up for current file (Disabled, unsupported, on demand, always on, etc.).

  • Data_Doc_ServerDocId - An immutable anonymized document Identifier used to diagnose problems

  • Data_Doc_ServerProtocol - the protocol version used to communicate with the service

  • Data_Doc_ServerType - the type of the server offering the service (SharePoint, OneDrive, WOPI, etc.)

  • Data_Doc_ServerVersion - the server version offering the service

  • Data_Doc_SessionId - Identifies a specific document edit session within the full session

  • Data_Doc_SharePointServiceContext - Diagnostic information from SharePoint requests

  • Data_Doc_SizeInBytes - Indicator of document size

  • Data_Doc_SpecialChars - Indicator of special chars in the document's URL or Path

  • Data_Doc_StreamAvailability - Indicator if document stream is available/disabled

  • Data_Doc_SyncBackedType - Indicator as to the type of document (local or service based)

  • Data_Doc_UrlHash - One-way hash to create a naïve document identifier

  • Data_EditorDisablingRename - Identifier of the first editor that caused for rename to be disabled

  • Data_EditorsCount - Number of editors in the document

  • Data_ForceReadWriteReason - Integer value representing the reason why the file was forced into read/write mode

  • Data_FSucceededAfterRecoverableFailure - Indicates that open succeeded after repairing a failure while opening the document

  • Data_LastLoggedTag - Unique tag for code call site used to identify when we fail to try the save twice (used for data quality diagnostics)

  • Data_LinkStyles - Indicates whether we're linking to the template styles

  • Data_MainPdod - The document identifier in Office Word process

  • Data_Measurements - Encoded string containing the time breakdown of the different parts of open. Used to measure performance.

  • Data_MoveDisabledReason - Error that is disabling move for the document

  • Data_MoveFlightEnabled - Whether the flight for the move feature is enabled

  • Data_PartsUnknown - the number of document parts that we couldn't get data for

  • Data_RecoverableFailureInitiationLocationTag - Unique tag for code call site used to identify the place in code where we attempt to fix the file before opening it

  • Data_RenameDisabledReason - Error that is causing for rename to be disabled for this document

  • Data_RenameFlightEnabled - Whether the flight for the rename feature is enabled

  • Data_SecondaryTag - Unique tag for code call site used to add additional failure data for open

  • Data_TemplateFormat - File format of the template that the document is based on

  • Data_UsesNormal - Indicates whether the open document is based on the normal template

RenewUserOp

Collected when a user attempts to open an IRM protected doc or apply IRM protections. It contains the information needed to be able to properly investigate and diagnose issues that happen when renew user certificates operation is performed.

The following fields are collected:

  • AppInfo.ClientHierarchy - Client hierarchy, which indicates the application runs in production environment or developer environment

  • AppInfo.Name - Application name.

  • AppInfo.Version - Application version

  • iKey - Logger server ID

  • RMS.ApplicationScenarioId - Scenario ID provided by the application

  • RMS.Duration - Total time for the operation to complete

  • RMS.DurationWithoutExternalOps - Total time minus external operations consumed, such as network latency.

  • RMS.ErrorCode - The error code returned if any from the operation

  • RMS.HttpCall - indicates if there's HTTP operation

  • RMS.LicenseFormat - The license Format: Xrml or Json

  • RMS.Result - Success or fail of the operation

  • RMS.ScenarioId - Scenario ID defined by Rights Management Service Client

  • RMS.SDKVersion - The version of Rights Management Service Client

  • RMS.ServerType - The type of Rights Management Service Server

  • RMS.StatusCode - Status code of the operation result

  • RMS.Type - The type of user info

ServiceDiscoveryOp

Collected when a user attempts to open an IRM protected doc or apply IRM protections. It contains the information needed to be able to properly investigate and diagnose issues that happen when service discovery operation is performed.

The following fields are collected:

  • AppInfo.ClientHierarchy - Client hierarchy, which indicates the application runs in production environment or developer environment

  • AppInfo.Name - Application name.

  • AppInfo.Version - Application version

  • iKey - Logging service server ID

  • RMS.ApplicationScenarioId - Scenario ID provided by the application

  • RMS.Duration - Total time for the operation to complete

  • RMS.DurationWithoutExternalOps - Total time minus external operations consumed, such as network latency.

  • RMS.ErrorCode - The error code returned if any from the operation

  • RMS.HttpCall - Indicate if there's HTTP operation

  • RMS.LicenseFormat - The license Format: Xrml or Json

  • RMS.OperationName - Operation name

  • RMS.Result - Success or fail of the operation

  • RMS.ScenarioId - Scenario ID defined by Rights Management Service Client

  • RMS.SDKVersion - The version of Rights Management Service Client

  • RMS.ServerType - The type of Rights Management Service Server

  • RMS.StatusCode - Status code of the operation result

sharedcore.bootstagestatistics

The event is triggered during start-up and shutdown as various layers of the application complete their phase of process. The event captures performance markers for each layer of application start-up and shutdown. The data is used to determine if the app is healthy and performing as expected.

The following fields are collected:

  • DurationMillis - The time, in milliseconds, that it took for the stage to complete the indicated step

  • Result - The result of the stage, indicating if it was completed successfully or if there was an error

  • Stage - Label of the stage of the boot process that is being reported on

  • Step - Label indicating if this event is reporting information on application startup or shutdown of one of the application’s components

Common Fields (documented once for the set of Required events for the app)

  • AppInfo.Env - Application environment, "debug" or "ship" based on the build of the application

  • AppInfo.Name - "olk" (Outlook)

  • AppInfo.UpdateRing - The update ring of the app (for example, "Dogfood", "Production")

  • AppInfo.Version - String specifying the application version (for example, 1.2022.805.100)

  • DeviceInfo.Id - A unique identifier of the user's device, gathered based on the user's network adapter.

  • Event.SchemaVersion - An integer specifying the version of the telemetry event schema

  • Session.Id - A globally unique identifier (GUID) generated at the start of the current session of the application, used to uniquely identify the session

  • UserInfo.Language - The user's language, in the format “en-us” based on the system locale unless otherwise specified

Office accessibility configuration subtype

Office accessibility features​

Office.Accessibility.AccessibilityToolSessionPresenceWin32

Allows us to detect that the user has an Assistive technology tool and its name. This allows us to understand if an Office user is experiencing issues with a specific Assistive Technology tool.

The following fields are collected:

  • Data_Data_Jaws - indicates if Jaws was running during the sessionData_Data_Magic - indicates if Magic was running during the session

  • Data_Data_Magnify - indicates if Magnify was running during the session

  • Data_Data_Narrator - indicates if Narrator was running during the session

  • Data_Data_NVDA - indicates if NVDA was running during the session

  • Data_Data_SA - indicates if SA was running during the session

  • Data_Data_Supernova - indicates if Supernova was running during the session

  • Data_Data_SuperNovaessSuite - indicates if SuperNovaAccessSuite was running during the session

  • Data_Data_WinEyes - indicates if WinEyes was running during the session

  • Data_Data_ZoomText - indicates if ZoomText was running during the session

Office.Apple.DarkMode

This event is collected for Office applications running under Apple platforms. The event tells us if user is running a System on DarkMode and whether the user overwrote the DarkMode System setting in Office. We use this event to help ensure accessibility and prioritize user-experience optimization.

The following fields are collected:

  • Data_DarkModeIsEnabled - Whether DarkMode is enabled in the system.

  • Data_RequiresAquaSystemAppearanceEnabled - Whether DarkMode is overwritten in Office.

Office.Apple.HardwareKeyboardInUse.Apple

This event is collected for Office applications running under Apple platforms. The event tells us that a user is attaching a keyboard to their mobile device. The event helps us improve accessibility and optimize our user experience.

The following fields are collected:

  • Data_CollectionTime - A timestamp denoting the event collection time.

Office.Apple.MbuInstrument.DeviceAccessibilitySettings

This event is collected for Office applications running under Apple platforms. The event collects the state of the different accessibility options available during a session. We use this event to help ensure accessibility and prioritize user-experience optimization.

The following fields are collected:

  • Data_AccessibilityContentSize - A flag indicating whether this setting is enabled

  • Data_AssistiveTouchRunning - A flag indicating whether this setting is enabled

  • Data_BoldTextEnabled - A flag indicating whether this setting is enabled

  • Data_CollectionTime - A flag indicating whether this setting is enabled

  • Data_DarkerSystemColorsEnabled - A flag indicating whether this setting is enabled

  • Data_DifferentiateWithoutColor - A flag indicating whether this setting is enabled

  • Data_GrayscaleEnabled - A flag indicating whether this setting is enabled

  • Data_GuidedAccessEnabled - A flag indicating whether this setting is enabled

  • Data_IncreaseContrast - A flag indicating whether this setting is enabled

  • Data_InvertColorsEnabled - A flag indicating whether this setting is enabled

  • Data_PreferredContentSizeCategory - A flag indicating whether this setting is enabled

  • Data_ReduceMotionEnabled - A flag indicating whether this setting is enabled

  • Data_ReduceTransparency - A flag indicating whether this setting is enabled

  • Data_ReduceTransparencyEnabled - A flag indicating whether this setting is enabled

  • Data_ShakeToUndeEnabled - A flag indicating whether this setting is enabled. (Deprecated - used only on old builds.)

  • Data_ShakeToUndoEnabled - A flag indicating whether this setting is enabled.

  • Data_SpeakScreenEnabled - A flag indicating whether this setting is enabled

  • Data_SpeakSelectionEnabled - A flag indicating whether this setting is enabled

  • Data_SwitchControlRunning - A flag indicating whether this setting is enabled

  • Data_UAZoomEnabled - A flag indicating whether this setting is enabled

  • Data_VoiceOverRunning - A flag indicating whether this setting is enabled

Office.UX.AccChecker.FixItMenuItemSelection

This event is used to track the selected choice within the Accessibility Checker Fixit menu. The data allows Microsoft to understand how documents are being remediated to fix accessibility issues, which helps to create a more inclusive workplace and classroom environment for people with disabilities.

The following fields are collected:

  • RuleID - Integer value used to track which category of Accessibility violation is being remediated by the user.

  • SelectionItem - Integer value that represents the user selection within the FixIt menu.

Office.UX.AccChecker.FixItMenuItemSelectionA11yAssistant

This event is used to track the user selection for the remediation of an Accessibility issue in the document through the Accessibility Assistant pane. This data helps with work on remediating accessibility issues and drives the creation of an inclusive environment in the workplace and classroom for people with disabilities.

The following fields are collected:

  • RuleID - Integer value used to track the category of accessibility issue which is remediated.

  • SelectionItem - Integer value used to track the command invoked to remediate the accessibility issue in the document.

Office.UX.AccChecker.FixItMenuOpenClose

This event is used to track the frequency with which the Accessibility Checker Fixit menu is invoked or dismissed. The data helps Microsoft understand the frequency with which and how documents are being remediated to fix accessibility issues. This contributes to a more inclusive workplace and classroom environment for people with disabilities.

The following fields are collected:

  • RuleID - Integer value used to track which category of Accessibility violation is being remediated by the user.

Office.UX.AccChecker.StatusBarIssueDetected

This event detects the presence of an accessibility issue in the user's document. It's used to understand the prevalence of accessibility issues in Office documents. The data helps with improving Microsoft's accessible authoring tools used for fixing document issues and contributes towards more accessible documents for users. This drives the creation of an inclusive environment in the workplace and classroom for people with disabilities.

The following fields are collected:

  • None

Office.UX.AccChecker.TurnOffNotificationsFromCanvasContextualCardActivity

This event is triggered when the user turns off the in-canvas Accessibility notifications in Word. The data is used to denote that the user has disabled accessibility notifications. This data helps with work on remediating accessibility issues and drives the creation of an inclusive environment in the workplace and classroom for people with disabilities.

The following fields are collected:

  • None

Office.UX.AccChecker.WordAccCheckerGutterIconRendered

This event is used to track the frequency with which the Accessibility Checker in-Canvas notifications are displayed to the user in Word. This helps to understand the frequency with which users are notified about Accessibility issues in Office documents. This data helps with work on remediating accessibility issues and drives the creation of an inclusive environment in the workplace and classroom for people with disabilities.

The following fields are collected:

  • None

Office.UX.AccChecker.WordInCanvasNotificationSettings

This event is triggered when the user or IT Admin has enabled in-Canvas accessibility notifications in Word. This event is used to understand the instances when the in-canvas Accessibility notifications are enabled for Office users. The enabled status of the feature allows Microsoft to understand if the user can be notified after documents are scanned automatically in the background. This data helps with work on remediating accessibility issues and drives the creation of an inclusive environment in the workplace and classroom for people with disabilities.

The following fields are collected:

  • AccCheckerGutterIconEnabled - Boolean to track the offered state of the Accessible Authoring notifications

  • AccCheckerTextContrastScanEnabled - Boolean to track the offered state of Text color contrast Accessible Authoring Enabled/Disabled state of the Accessible Authoring notifications

  • AccessibleAuthoringEnabled - Boolean to track the Enabled/Disabled state of the Accessible Authoring notifications

  • AccessibleAuthoringEnabledByDefault - Boolean to track the default Enabled/Disabled state of the Accessible Authoring notifications

  • AccessibleAuthoringOptOutEnabledInCanvasCard - Boolean to track the offered state for opting out of Accessible Authoring notifications.

  • BackgroundAccCheckerEnabled - Boolean to track the Enabled/Disabled state of the Background Accessibility checker

Office.UX.AccChecker.WordInvokeCanvasContextualCardFromCanvasActivity

This event is used to track user selection on the Word Accessibility Checker in-Canvas notification within the document canvas. This helps to understand the specific Accessibility issues that users remediate within Office documents. This data helps with work on remediating accessibility issues and drives the creation of an inclusive environment in the workplace and classroom for people with disabilities.

The following fields are collected:

  • TextRangeLength - Integer value used to track the length of the text range being remediated for the accessibility issue.

Office.UX.AccChecker.WordInvokeCanvasContextualCardFromGutterActivity

This event is used to track user selection on the Word Accessibility Checker in-Canvas notification. This helps to understand the specific Accessibility issues that users remediate within Office documents. This data helps with work on remediating accessibility issues and drives the creation of an inclusive environment in the workplace and classroom for people with disabilities.

The following fields are collected:

  • IssueType – Integer value used to track which category of Accessibility violation is being remediated by the user.

  • TextRangeLength - Integer value used to track the length of the text range being remediated for the accessibility issue.

Office.UX.AltTextInCanvasContextualCard

This event is used to track the remediation of an Alt-text Accessibility issue in the Word In-Canvas Accessibility card. This data helps with work on remediating accessibility issues and drives the creation of an inclusive environment in the workplace and classroom for people with disabilities.

The following fields are collected:

  • None

Office.UX.AutoAltTextInCanvasContextualCard

This event is used to track the approval of auto-generated Alt-text to remediate an Accessibility issue in the Word In-Canvas Accessibility card. This data helps with work on remediating accessibility issues and drives the creation of an inclusive environment in the workplace and classroom for people with disabilities.

The following fields are collected:

  • None

Office.UX.ColorPickerBulkFixInCanvasContextualCard

This event is used to track the application of a bulk fix for text color contrast issues within the Accessibility Checker In-Canvas Color Picker. This helps to understand bulk color selection for the Accessibility issues that users remediate within Office documents. This data helps with work on remediating accessibility issues and drives the creation of an inclusive environment in the workplace and classroom for people with disabilities.

The following fields are collected:

  • BulkFixFlightEnabled - Boolean value used to track if Bulk color fixes are enabled within the In-Canvas Color Picker.

  • FixedAllIssues - Boolean value used to track if the user fixed all text color contrast issues within the In-Canvas Color Picker.

  • FixedSimilarIssues - Boolean value used to track if the user fixed similar text color contrast issues within the In-Canvas Color Picker.

  • FixSimilarFlightEnabled - Boolean value used to track if bulk fix for similar issues are enabled within the In-Canvas Color Picker.

Office.UX.ColorPickerInCanvasContextualCard

This event is used to track the selected color within the Accessibility Checker In-Canvas Color Picker. This helps to understand the specific color selection for the Accessibility issues that users remediate within Office documents. This data helps with work on remediating accessibility issues and drives the creation of an inclusive environment in the workplace and classroom for people with disabilities.

The following fields are collected:

  • BulkFixAllIssues - Boolean value used to track if Bulk color fixes for all issues are enabled within the In-Canvas Color Picker.

  • BulkFixFlightEnabled - Boolean value used to track if Bulk color fixes are enabled within the In-Canvas Color Picker.

  • BulkFixSimilarIssues - Boolean value used to track if Bulk color fixes for similar issues are enabled within the In-Canvas Color Picker.

  • Color_Category - Integer value that represents the category of the selected color within the In-Canvas Color Picker.

  • ColorFlightSetting - Integer value that represents the settings applied to the color picker suggestions.

  • Color_Index - Integer value that represents the index of the selected color within the In-Canvas Color Picker.

  • FixSimilarFlightEnabled - Boolean value that indicates if fixing similar colors is enabled within the In-Canvas Color Picker.

  • IsAccessible - Boolean value hat represents if the users selection is accessible within the In-Canvas Color Picker.

  • NumberOfSuggestions - Integer value that represents the number of suggestions presented to the user within the In-Canvas Color Picker.

  • SuggestionIndex - Integer value that represents the index of the selected color within the In-Canvas Color Picker.

Office.Word.Accessibility.LearningTools.ReadAloud.PlayReadAloud

This event indicates Office Word reads aloud the text in the document. The event is a heartbeat of the accessibility feature, which allows Microsoft to evaluate the feature health of read-aloud-text.

The following fields are collected:

  • Data_IsDeviceTypePhone - whether a phone device is using ReadAloud.

  • Data_ParagraphCount - paragraph count of the document

  • Data_Play - Is this the first time for Word to read aloud

  • Data_ViewKind - view type of the document

Office.Word.Accessibility.LearningTools.ReadAloud.StopReadAloud

This event indicates Office Word stops reading aloud the text in the document. The event allows Microsoft to evaluate the feature health of read-aloud-text by measuring the working duration.

The following fields are collected:

  • None

Privacy subtype

Office privacy settings

Office.Android.DocsUI.Views.UpsellBlockedAADC

This event captures that subscription upsell was blocked for non-adult users when they encountered the upsell message in Word, Excel, or PowerPoint mobile app. We'll use the data to summarize how many upsell opportunities were lost due to age compliance.

The following fields are collected:

  • EntryPoint – String specifying the upsell entry point that was blocked for age compliance.

Office.OfficeMobile.FRE.UpsellBlockedAADC

This event captures that subscription upsell was blocked for non-adult users when they encountered the upsell message in the Microsoft 365 mobile app. We'll use the data to summarize how many upsell opportunities were lost due to age compliance.

The following fields are collected:

  • EntryPoint – String specifying the upsell entry point that was blocked for age compliance.

Office.Privacy.OffersOptIn

This event is triggered when values for privacy controls are loaded or reloaded. This happens when the user first boots the process and whenever these settings change, such as the user updating them or the values roaming from another device reports information about user’s opt-in status to Personalized Offers. The event is used to ensure that users' privacy choices related to the Personalized Offers control are being enforced as expected.

The following fields are collected:

  • ConsentGroup - consent group to which the user belongs

  • OffersConsentSourceLocation - indicates how the user made the choice to enable or disable Personalized Offers

  • OffersConsentState - indicates whether the user has chosen to enable or disable Personalized Offers

Office.Privacy.PrivacyConsent.PrivacyEvent

[This event was previously named Office.IntelligentServices.PrivacyConsent.PrivacyEvent.]

This event represents a user or system initiated action that is part of the privacy User experience for Office. It's triggered on the privacy First Run dialogs, Account Privacy dialog, and privacy notifications. The event is used to understand the following: users consenting to Office privacy settings, users changing Office privacy settings, and Office privacy settings getting updated in user sessions.

The following fields are collected:

  • Data_ActionId - User action in a privacy dialog

  • Data_ControllerConnectedServicesState - User policy setting for additional optional connected experiences

  • Data_DownloadedContentServiceGroupState - User setting for downloaded content

  • Data_ForwardLinkId - Link to privacy documentation for the user scenario

  • Data_HRESULT - Record of errors during interaction with a privacy dialog

  • Data_IsEnterpriseUser - User license category

  • Data_OfficeServiceConnectionState - User setting for connected services

  • Data_RecordRegistry - Record of showing the enterprise privacy dialog

  • Data_Scenario - First run scenario based on the user license and category

  • Data_SeenInsidersDialog - Record of showing the Insiders privacy dialog

  • Data_SendTelemetryOption - User setting for telemetry

  • Data_SendTelemetryOptionPolicy - User policy setting for telemetry

  • Data_UserCategory - User account type

  • Data_UserCCSDisabled - User override for additional optional connected experiences

  • Data_UserContentServiceGroupState - User setting for analyzing content

  • Data_WillShowDialogs - Record of user needing to see privacy First Run dialogs

Office.Privacy.UnifiedConsent.UI.ConsentAccepted

This event is triggered when a user accepts/acknowledges an account-level consent notice. Data is used to understand the frequency of successes and failures in client components, allowing detection and mitigation of common issues.

The following fields are collected:

  • ConsentLanguage - The language that the consent is being shown to the user in

  • ConsentSurface - The specific technology being used to retrieve and render the consent experience

  • ConsentType - The type of consent presented to the user. For example, Prominent Notice, Consent, etc.

  • CorrelationId - A unique identifier used to link data from the client and the service for the purpose of debugging failures

  • EventCode - A numeric code used to provide details on why a failure may have occurred while getting data from the Consent Service.

  • EventMessage - A human readable message related to the result of the get call. The values are drawn from a list of expected messages.

  • FormFactor - A value indicating the shape and nature of the device sending the data

  • ModelId - A unique identifier indicating which model was the basis for the consent or notice shown to the user

  • ModelType - The type of message being shown to the user. For example, Consent, Notice, etc.

  • ModelVersion - Data indicating which version of a consent or notice was presented to the user

  • Os - The operating system of the device sending the data

  • ReConsentReason - An indicator of why a user is seeing a given consent an additional time.

  • Region - The country or region being used to determine what version of a consent to show the user

Office.Privacy.UnifiedConsent.UI.ConsentRenderFailed

This event is triggered when the user fails to open the Unified Consent dialog. The data is used to understand the frequency of successes and failures in client components, allowing detection and mitigation of common issues.

The following fields are collected:

  • ConsentLanguage - The language that the consent is being shown to the user in

  • ConsentSurface - The specific technology being used to retrieve and render the consent experience

  • ConsentType - The type of consent presented to the user. For example, Prominent Notice, Consent, etc.

  • CorrelationId - A unique identifier used to link data from the client and the service for the purpose of debugging failures

  • EventCode - A numeric code used to provide details on why a failure may have occurred while getting data from the Consent Service.

  • EventMessage - A human readable message related to the result of the get call. The values are drawn from a list of expected messages.

  • FormFactor - A value indicating the shape and nature of the device sending the data

  • ModelId - A unique identifier indicating which model was the basis for the consent or notice shown to the user

  • ModelType - The type of message being shown to the user. For example, Consent, Notice, etc.

  • ModelVersion - Data indicating which version of a consent or notice was presented to the user

  • Os - The operating system of the device sending the data

  • ReConsentReason - An indicator of why a user is seeing a given consent an additional time.

  • Region - The country or region being used to determine what version of a consent to show the user

  • UXSDKVersion - The version of the UX SDK that is used while rendering the consent model to the user.

Office.Privacy.UnifiedConsent.UI.ConsentRenderSuccess

This event is used to track successful rendering of user interface dialog for an account-level consent notice. Data is used to understand the frequency of successes and failures in client components, allowing detection and mitigation of common issues.

The following fields are collected:

  • ConsentLanguage - The language that the consent is being shown to the user in

  • ConsentSurface - The specific technology being used to retrieve and render the consent experience

  • ConsentType - The type of consent presented to the user. For example, Prominent Notice, Consent, etc.

  • CorrelationId - A unique identifier used to link data from the client and the service for the purpose of debugging failures

  • EventCode - A numeric code used to provide details on why a failure may have occurred while getting data from the Consent Service.

  • EventMessage - A human readable message related to the result of the get call. The values are drawn from a list of expected messages.

  • FormFactor - A value indicating the shape and nature of the device sending the data

  • ModelId - A unique identifier indicating which model was the basis for the consent or notice shown to the user

  • ModelType - The type of message being shown to the user. For example, Consent, Notice, etc.

  • ModelVersion - Data indicating which version of a consent or notice was presented to the user

  • Os - The operating system of the device sending the data

  • ReConsentReason - An indicator of why a user is seeing a given consent an additional time.

  • Region - The country or region being used to determine what version of a consent to show the user

Product and service performance data events

The following are the data subtypes in this category:

Unexpected application exit (crash) subtype

Unexpected application exits and the state of the application when that happens​.

android.exit.info

This event will be triggered when app boots and a previous app exit information is detected. This event is used to detect and investigate abnormal app exits.

The following fields are collected:

  • description - The description why app exited.

  • exit_timestamp - The timestamp when app exited.

  • importance - The importance of the process running at the time of app exit.

  • pid - The process ID of the process running at the time of app exit.

  • reason - The reason why app exited.

  • status - The status when app exited.

app.startup.reason

This event lets us detect and fix issues where Outlook crashed during app startup. This event includes information on why the crash happened so we can fix the issue quickly.

The following fields are collected:

  • app_background_time - duration of how long app was in background last session

  • startup_reason_type - indicates why the app is starting up, this will indicate if it was due to force quit, or other reason.

  • watch_status_info - keeps track of the following information, if applicable.

    • is_watch_app_installed - determines if the user has the Watch app installed

    • is_watch_paired - determines if iOS device is paired to a watch

    • is_watch_supported_and_active - indicates whether a watch is supportive and active during the session

The following fields are collected for only Outlook Mobile for iOS:

  • clean_exit_reason - A string of words indicating why if there was a reason for the app stop

  • is_agenda_user - Indicates if the user has opened the agenda recently, which indicates if we're writing disk on the startup

  • is_watch_supported_and_active - indicates whether a watch is supportive and active during the session

application.crash

Used for monitoring critical app crashes and helps us collect information on why the app has crashed and how to prevent it.

The following fields are collected:

  • android.hardware. - (for example, android.hardware.bluetooth) Hardware configuration values provided by the Android platform

  • android.software. - (for example, android.software.device_admin) Software configuration values provided by the Android platform

  • android_version - Device android version name as indicated by android.os.Build.VERSION#RELEASE

  • application_package_name - Application package name as indicated by android.content.Context#getPackageName()

  • application_stack_trace - the stack trace of the crash

  • application_version_code - Application version code defined by the Outlook app

  • application_version_name - Application version name defined by the Outlook app

  • com. (for example, com.google.android.feature.FASTPASS_BUILD, com.amazon.feature.PRELOAD, com.samsung.android.bio.face) Manufacturer-specific configuration values provided by the Android platform

  • crash_report_sdk - SDK to send crash logs. Either Hockey or AppCenter

  • crash_type - crash_type will have java, native, non-fatal as types.

    • java - if crash recorded on application Layer.

    • native - if crash recorded on native layer within the app.

    • non-fatal - crashes being recorded to debug any feature. Application won’t crash but it will upload non-fatal crash logs to help in debugging a feature.

  • device_brand - Device brand (manufacturer or carrier) as indicated by android.os.Build#BRAND

  • device_ID - Device unique ID (IMEI) [This field has been removed from current builds of Office, but might still appear in older builds.]

  • device_manufacturer - Device manufacturer as indicated by android.os.Build#MANUFACTURER

  • device_model - Device model as indicated by android.os.Build#MODEL

  • device_name - Device name as indicated by android.os.Build#DEVICE

  • device_total_memory - Estimation of the total device memory size based on filesystem stats.

  • glEsVersion - OpenGL Embedded Systems version key

crash.event

The event is triggered automatically when the user opens the App for a second time after the App previously crashed. It only gets triggered in case of App crashes. Allows us to detect and fix situations where critical app crashes have occurred and helps us collect information on why the app has crashed and how to prevent it.

The following fields are collected:

  • crash_app_state - Helps us understand what’s the app state App crashes: active, inactive, background, notApplicable.

  • crashTime - Date and time the crash occurred to help with investigation

  • crash_time_from_start – The elapsed time from app start to the crash occurred, to help with investigation

  • exceptionName - The name of the exception that triggered the crash to help with investigation

  • exception_reason – The reason of the exception that triggered the crash to help with investigation

  • hasHx - Tells us the account is using our new sync service to help us detect issues caused by our sync service

  • incidentIdentifier - A unique ID for the crash report so we can find the corresponding issue

  • isAppKill - Helps us understand if that app was killed or close on the device

  • is_crashloop – Helps us understand if the crash could likely be a crash loop.

  • reportKey - A unique ID for the application installation om the device for issue investigation

  • signal - A signal that caused the crash to give us more details to investigate this crash

Error

Allows us to understand the issues that mobile apps are facing when attempting to fetch privacy settings from the server.

The following fields are collected:

  • correlationId - a unique identifier for a service connection that resulted in an error, allowing us to diagnose what might have gone wrong

  • errorCode - identifies the relevant error code received from the service that could be used to diagnose the problem

  • exceptionType - type of error that the library encountered when fetching the setting

  • message - identifies the error message received from the service

  • roamingSettingType - identifies the location from which we attempt to read settings

  • settingId - the setting that was attempted to be fetched

Office.Android.EarlyTelemetry.UngracefulAppExitInfo

This event is triggered in each session and collects information about the exit reasons of the previous process of the app. The data is used to collect information on the Android process exit to help Office understand where apps are experiencing issues and diagnose them appropriately.

The following fields are collected:

  • Data_ExitAppVersion - appversion of the exit process

  • Data_ExitEndTimeStamp - system timestamp when the process exited.

  • Data_ExitOSSignal - OS signal that resulted in process exit

  • Data_ExitProcessName - name of the process that was killed.

  • Data_ExitPSS - PSS information at time of process exit.

  • Data_ExitReason - Reason of exit, integer format mapping to enums defined by Android

  • Data_ExitRSS - RSS details at time of process exit.

  • Data_ExitSessionId - SessionId of the process that died.

  • Data_ExitStartTimeStamp - system Timestamp when the process started.

Office.AppDomain.UnhandledExceptionHandlerFailed

Collects information for any unhandled exceptions using the Data Streamer App. This data is used to monitor the health of the application. This event is generated by Microsoft Data Streamer for Excel Add-in.

The following fields are collected:

  • Exception - Call stack for the Exception

  • Event Name - Event Name is the Event Category and Event Label.

Office.Apple.IdentityDomainName

This event is collected for Office applications running under Apple platforms. The event is used to monitor the health of our system as well as investigating causes of failures by certain domain users. We collect the domain used by our users when they authenticate. We use this data to help identify and fix those issues that might not seem too impactful at a broader level, but that turn out to be very impactful to a certain domain of users.

The following fields are collected:

  • Data_Domain - the domain used for authentication

  • Data_IdentityProvider - The authentication identity provider name. (that is, LiveId or ADAL)

  • Data_IdentityProviderEnum - The authentication identity provider code. (A number)

Office.Apple.MetricKit.CrashDiagnostic

[This event has been removed from current builds of Office, but might still appear in older builds.]

The event is triggered when Office apps crash. The data is used to get additional crash information that helps with fixing bugs and keep Office apps secure and performing as expected.

The following fields are collected:

  • CrashDiagnostic - A blob of text with crash data.

Office.Apple.SystemHealthAppExitMacAndiOS

This event is collected for Office applications running under Apple platforms. The event is used to monitor the health of our Office applications and for investigating causes of failures. We collect data on each application exit to determine whether an application exited gracefully.

The following fields are collected:

  • Data_AffectedProcessSessionID - The identifier for the session that experience the application exit.

  • Data_AffectedSessionBuildNumber - The minor version of the application in which an application exit was observed.

  • Data_AffectedSessionDuration - The length of the session from start to exit

  • Data_AffectedSessionIDSMatch - An indicator of telemetry health.

  • Data_AffectedSessionMERPSessionID - An indicator of telemetry health.

  • Data_AffectedSessionOSLocale - The Locale of the OS under which the application exit was observed.

  • Data_AffectedSessionOSVersion - The OS version under which the application exit was observed.

  • Data_AffectedSessionResidentMemoryOnCrash - The amount of resident memory that was consumed when the application exit occurred

  • Data_AffectedSessionStackHash - An identifier that will denote the specific error being hit.

  • Data_AffectedSessionStartTime - The time at which the session started.

  • Data_AffectedSessionUAEType - The type of application exit observed (if it was an ungraceful exit, this code will denote the type of error observed)

  • Data_AffectedSessionVersion - The major version of the application in which an application exit was observed.

  • Data_AffectedSessionVirtualMemoryOnCrash - The amount of virtual memory that was consumed when the application exit occurred.

  • Data_ExitWasGraceful - Whether the application Exit was graceful or ungraceful.

Office.Extensibility.COMAddinUnhandledException

Event generated when COM Add-in crashes on a consumer version of Office applications.

This is used to compute a global, non-enterprise-specific Microsoft 365 Apps for enterprise "adoption" for an add-in, which is then used by tools like the Readiness Toolkit. This allows enterprise customers to validate if the add-ins they have deployed in their organizations are compatible with the latest versions of Microsoft 365 Apps for enterprise and plan their upgrades accordingly.

The following fields are collected:

  • ScopeId – the current thread scope

  • Method – Office method where exception occurred

  • Interface – Office interface where exception occurred

  • AddinId – the add-in Class ID

  • AddinProgId – deprecated

  • AddinFriendlyName – deprecated

  • AddinTimeDateStamp – the add-in timestamp from the DLL metadata

  • AddinVersion – deprecated

  • AddinFileName – deprecated

  • VSTOAddIn – whether add-in is VSTO

  • AddinConnectFlag – current load behavior

  • LoadAttempts – number of attempts to load add-in

Office.Extensibility.COMAddinUnhandledExceptionEnterprise

Event generated when COM Add-in crashes on an enterprise version of Office applications.

This is used to compute a global, non-enterprise-specific Microsoft 365 Apps for enterprise "adoption" for an add-in, which is then used by tools like the Readiness Toolkit. This allows enterprise customers to validate if the add-ins they have deployed in their organizations are compatible with the latest versions of Microsoft 365 Apps for enterprise and plan their upgrades accordingly.

  • ScopeId – the current thread scope

  • Method – Office method where exception occurred

  • Interface – Office interface where exception occurred

  • AddinId – the add-in Class ID

  • AddinProgId – deprecated

  • AddinFriendlyName – deprecated

  • AddinTimeDateStamp – the add-in timestamp from the DLL metadata

  • AddinVersion – deprecated

  • AddinFileName – deprecated

  • VSTOAddIn – whether add-in is VSTO

  • AddinConnectFlag – current load behavior

  • LoadAttempts – number of attempts to load add-in

Office.Extensibility.Sandbox.ODPActivationHeartbeat

Office Add-ins run in a sandbox. This event collects heartbeat information on activations. When an add-in crashes, this event collects why it crashed in the case it's related to our sandbox. Used to investigate when customers escalate issues.

The following fields are collected:

  • AppId - ID of the App

  • AppInfo - Data regarding the type of add-in (task pane or UILess or in content etc.) and the provider type (omen, SharePoint, filesystem etc.)

  • AppInstanceId - ID of the app instance

  • AssetId - Asset ID of the app

  • ErrorCode - Total time spent

  • IsArm64 - indicates if the add-in activation is happening on an application emulated on an ARM64 device

  • IsAugmentationScenario – indicates if the augmentation loop is responsible for initializing the Office Solutions Framework control

  • IsDebug - indicates if session is a debug session

  • IsMOS - Indicates if the add-in payload format type is XML or JSON.

  • IsPreload – indicates if the add-in is being preloaded in background for improving activation perf.

  • IsWdagContainer – indicates if the add-in activation is being taken place in a Windows Defender Application Guard container.

  • NumberOfAddinsActivated - Counter of add-ins activated

  • RemoterType - Specifies the type of remoter (Trusted, untrusted, Win32webView, Trusted UDF, etc.) used to activate the add-in

  • StoreType - Origin of the app

  • Tag- Specifies where exactly the code has failed using the unique tag associated with it.

  • UsesSharedRuntime - indicates the app uses sharedRuntime or not.

Office.Extensibility.VbaTelemetryBreak

Event generated when a macro-enabled file runs into a compile or runtime error.

Desktop Analytics: This is used as numerator in the computation of enterprise-specific health status for macro types (for example, Word macros, Excel macros, etc.) which is used to infer during pilot if the add-in is "ready to upgrade" in the production ring.

The following fields are collected:

  • TagId – the ID of the telemetry tag

  • BreakReason – the reason for the break (runtime, compile, other error)

  • SolutionType – type of solution (document, template, app add-in, COM add-in)

  • Data.ErrorCode – error code reported by VBA engine

Office.FindTime.AppFailedToStart

Collected when app fails to start due to an unexpected error during startup. Used to track exceptions & crashes. Helps monitor and debug app health.

The following fields are collected:

  • DateTime - Timestamp of when the event is logged.

  • EventName - The name of the event being logged.

Office.Outlook.Desktop.HangBucketMetrics

Collects hang time for outlook hangs – a unique identifier per hang, elapsed time, and call stack information. The data is used to detect and identify app crashes in order to fix in future updates.

The following fields are collected:

  • BucketId - hash of the call stack

  • ElapsedTotal - total time spent in the call

  • ElapsedHanging - hang time spent in the call

Office.Outlook.Desktop.HangReportingScopePerfMetrics

Collects time taken for outlook core scenarios – switchfolder, switchmodule, sendmailoutbox, openitemclassic, sendmailtransport. The data is actively monitored for anomalous performance issues. It's used to detect and diagnose performance issues and improve performance with each update.

The following fields are collected:

  • ElapsedTotal - Total time spent in this call

  • ScopeId - name of the function containing the declaration or a custom name given through scope definition

Office.Outlook.Desktop.WatsonBuckets

This rule collects the crash information from the event logs when Outlook crashed in the previous session.

The data is actively monitored for anomalous hangs. It's used to detect and identify hangs in order to fix in future updates.

The following fields are collected:

  • BucketId – hash of the call stack

  • ElapsedTotal - total time spent in the call

  • ElapsedHanging - hang time spent in the call

Office.PowerPoint.Session

Collecting feature usages on each PowerPoint session. This data is used to calculate the ratio of PowerPoint ungraceful exit while using a feature. The ratio of PowerPoint ungraceful exit is a key signal to guarantee PowerPoint is running as expected.

The following fields are collected:

  • Flag – session flags

  • Usage – feature usages

Office.PowerPoint.UAE.Dialog

Collected every time when PowerPoint ungracefully exited while a dialog open on top of PowerPoint main window. This information is critical to catch PowerPoint ungracefully exits due to an active dialog blocking PowerPoint main window. Microsoft is using this data to diagnose the issue in order to guarantee PowerPoint running as expected.

The following fields are collected:

  • DlgCnt – total number of open dialogs when session crashed

  • DlgId – open dialog identifier

  • IdType – open dialog identifier type

  • InitTime – crashed session initialized time

  • SessionId – crashed session identifier

  • TopId – top dialog identifier

  • Version – crashed session version

Office.PowerPoint.UAE.Document

Collecting what feature is being used on a document when PowerPoint ungracefully exited. These features include slide show, document open, save, edit, co-authoring, shutdown. This information is critical to catch PowerPoint ungracefully exits while using a feature. Microsoft is using this data to diagnose the issue in order to guarantee PowerPoint running as expected.

The following fields are collected:

  • CoauthFlag – coauth usage flags

  • CommandFlag – document modification flags

  • FileIOFlag – file IO usage flags

  • InitTime - crashed session initialized time

  • Location – document location

  • ServerDocId – server document identifier

  • SessionId - crashed session identifier

  • UrlHash – document URL hash

  • Usage – feature usages

  • Version - crashed session version

Office.PowerPoint.UAE.Open

Collecting every time when PowerPoint ungracefully exit while opening a document. This information is critical to catch PowerPoint ungracefully exits while opening a document. Microsoft is using this data to diagnose the issue in order to guarantee PowerPoint running as expected.

The following fields are collected:

  • FileUrlLocation – document URL location

  • Flag – open flags

  • InitTime - crashed session initialized time

  • Location - document location

  • OpenReason – open reason

  • ServerDocId – server document identifier

  • SessionId - crashed session identifier

  • UrlHash - document URL hash

  • Version - crashed session version

Office.PowerPoint.UAE.Session

Collecting what feature has been used when PowerPoint session ungracefully exited.  This information is critical to catch PowerPoint ungracefully exits. Microsoft is using this data to diagnose the issue in order to guarantee PowerPoint running as expected.

The following fields are collected:

  • Flag – session flags

  • InitTime - crashed session initialized time

  • PreviousSessionId - crashed session identifier

  • Usage – feature usages

  • Version - crashed session version

Office.PowerPoint.UAE.Shutdown

Collecting PowerPoint ungracefully exit while shutting down. This information is critical to catch PowerPoint ungraceful exits while shutting down. Microsoft uses this data to diagnose the issue in order to guarantee PowerPoint runs as expected.

The following fields are collected:

  • InitTime - crashed session initialized time

  • SessionId - crashed session identifier

  • Stage – shutdown stage

  • Version - crashed session version

Office.PowerPoint.UAE.SlideShow

Collecting PowerPoint ungracefully exit while shutting down. This information is critical to catch PowerPoint ungraceful exits while shutting down. Microsoft uses this data to diagnose the issue in order to guarantee PowerPoint runs as expected.

The following fields are collected:

  • InitTime - crashed session initialized time

  • Mode – slide show mode

  • SessionId - crashed session identifier

  • State – slide show state

  • Version - crashed session version

Office.Programmability.Addins.COMAddInCrash

Event generated when a COM Add-in crashes. Used to determine adoption and reliability issues with Office add-ins.

The following fields are collected:

  • AddinConnectFlag - Represents load behavior

  • AddinDescriptionV2 - Description of the add-in

  • AddinFileNameV2 - Name of the actual add-in DLL. Doesn't include file location.

  • AddinFriendlyNameV2 - Add-in friendly name

  • AddinIdV2 - Add-in class ID (CLSID)

  • AddinProgIdV2 - Add-in prog ID

  • AddinProviderV2 - Provider of the add-in

  • AddinTimeDateStampV2 - Compiler timestamp

  • AddinVersionV2 - Add-in version

  • Interface - COM interface of add-in that led to crash

  • LoadAttempts - how many load attempts were made prior to crash

  • Method - COM method of add-in, which led to crash

  • OfficeArchitecture - Architecture of the Office client

Office.Programmability.Telemetry.AddInCrash

Event generated when a COM Add-in is loaded. This information is critical to determine whether an add-in caused an Office application crash. It's used to assess global add-in compatibility with Office applications.

The following fields are collected:

  • CLSID – the add-in Class identifier

  • ConnectFlag – the current add-in load behavior

  • FileName – the add-in file name, excluding the file path

  • FriendlyName – the add-in friendly name

  • Interface – the Office interface where the exception occurred

  • LoadAttempts – the number of attempts to load the add-in

  • Method – the Office method where the exception occurred

  • OfficeApplication – the Office application where the exception occurred

  • OfficeVersion – the versions of Office

  • ProgID – the add-in Prog identifier

Office.Programmability.Telemetry.MacroFileOpened

Triggered upon opening a macro (VBA)-containing file on a device that has been onboarded to Office Apps as a Service (OAAS) by the IT admin and where Microsoft 365 Apps for enterprise has been activated with an enterprise license. The event is used to understand the health of macro(VBA)-containing files in a tenant and is compared to Office.Programmability.Telemetry.VbaTelemetryBreak which tracks errors on VBA-containing files.

No fields are collected.

Office.System.SystemHealthUngracefulAppExitDesktopCOMAddIn

The event is triggered by an abnormal application termination while executing COM Add-in for Office client applications such as Word, Excel, PowerPoint, and Outlook. The data is used to determine reliability of add-ins and issues in Office connected to add-in crashes.

The following fields are collected:

  • AddinConnectFlag - Represents load behavior

  • AddinDescription - Description of the add-in

  • AddinFileName - Name of the actual add-in DLL. Doesn't include file location.

  • AddinFriendlyName - Add-in friendly name

  • AddinId - Add-in class ID (CLSID)

  • AddinProgId - Add-in prog ID

  • AddinProvider - Provider of the add-in

  • AddinTimeDateStamp - Complier timestamp

  • AddinVersion - Add-in version

  • CrashedProcessSessionId - A unique identifier of the crashed process.

  • CrashTag - The unique identifier for the code of the crash.

  • CrashType - Bucketing identifier for the type of crash.

  • Interface - COM interface of add-in that led to crash

  • LoadAttempts - how many load attempts were made prior to crash

  • Method - COM method of add-in that led to crash

  • TelemetryContext - Context of the add-in and client session. (Consumer or enterprise session, public add-in, or private add-in)

Office.System.SystemHealthUngracefulAppExitMacAndiOS

On boot event that captures ungraceful app exits for further investigation.

The following fields are collected:

  • AffectedProcessAppBuild – Build number

  • AffectedProcessAppBuildRevision – Build Revision Number

  • AffectedProcessAppMajorVer – Major version number of App

  • AffectedProcessAppMinorVer – Minor version number of App

  • AffectedProcessAppName – Application name

  • AffectedProcessResidentMemoryOnCrash – Resident memory of crashed app

  • AffectedProcessUnsymbolicatedChecksum – Goes with Stack hash for symbolization

  • AffectedProcessVirtualMemoryOnCrash – Virtual memory of crashed app

  • AffectedSessionDuration – Duration of session in seconds before crash

  • AffectedSessionLongBuildNumber – Long build number

  • CrashedProcessSessionID – SessionID of the process in app crash

  • DetectionTime – DateTime of app crash

  • DeviceModel – Hardware model

  • MERPSessionID – Session ID of MERP

  • ReportingOsLocaleTag – OS locale

  • ReportingOSVerStr – OS version

  • SessionBuildNumber – Crashed App's version

  • SessionIDSMatch – Boolean to verify whether reporting session ID is the same as picked up by Merp

  • SessionVersion – Crashed App's version– StackHash – Hash of the crashed app's stack trace

  • UAEType – Enum giving us information on what type of crash it was

Office.ThisAddIn.StartupFailed

Collects information for exception that occurs during startup of the Data Streamer App. This data is used to monitor the health of the application. This event is generated by Microsoft Data Streamer for Excel Add-in.

The following fields are collected:

  • Exception - Call stack for the Exception

  • Event Name - Event Name is the Event Category and Event Label.

OneNote.SafeBootAction

This is triggered during application start if the app crashed in the previous session. This data is used to track the new crashes and will help us identify if the crash detection logic is working properly and to keep track of number of boot crashes and early crashes.

The following fields are collected:

  • ActionType - Possible values - IncrementCount, ResetBootCounter, ResetEarlyCounter

  • IsLoopCrash - Possible values – Yes/No

  • IsNativeCrash - Possible values - Yes/No

OneNote.SafeBootResetCrashCounterOnAppSuspend, Office.OneNote.Android.SafeBootResetCrashCounterOnAppSuspend, Office.Android.EarlyTelemetry.SafeBootResetCrashCounterOnAppSuspend

The critical signal is sent when we're resetting the crash counter on app suspend before safe boot dialog is shown. This marker is required to track and diagnose the health of the app. A safe boot dialog is shown when the app crashes multiple times continuously. It gives the user an option to reset the app. This marker helps figure out if Safe boot dialog wasn't shown to a user despite hitting trigger criteria.

The following fields are collected:

  • None

telemetry.error

This event lets us diagnose and fix issues that are preventing necessary diagnostic data from being generated or sent. These events let us understand if we're missing critical data needed to identify security issues or major issues with how your app is working.

The following fields are collected:

  • timer_name - Tells where the telemetry issue is happening, for example, in the mailbox component or the calendar. This helps us detect and resolve telemetry issues happening from a specific part of the app

  • type - tells us the type of timer error to help us detect when our app is having any issues with sending diagnostic telemetry data

watchdog.anr

Needed for monitoring app performance errors to prevent cases where the app stops responding, and your screen becomes frozen in the app (referred to as ANR - application not responding).

The following fields are collected:

  • callstack - the code callstack where the ANR occurred

  • caused_restart - whether the app was forced to restart because of the ANR

  • duration - the amount of time the device was frozen

  • id - a unique identifier for the ANR

  • interval - the configured threshold for triggering an ANR

  • is_application_object_initialized - whether the ANR happened after the app was fully initialized or before

  • last_known_is_in_foreground - whether the app was most recently in the foreground or background

Application feature performance subtype

Poor response time or performance for scenarios such as application startup or opening a file.

android.frame.metrics

Allows us to detect and fix situations where our Android app components are causing performance issues, for example, if your inbox isn't scrolling smoothly.

The following fields are collected:

  • animation_duration - duration of animation rendering in milliseconds

  • command_issue_duration - duration to issue commands to the platform in milliseconds

  • draw_duration - duration of drawing the UI in milliseconds

  • input_handling_duration - duration of input handling in milliseconds

  • layout_measure_duration - duration of measuring the layout in milliseconds

  • origin - the app component that is being measured, for example calendar or mail

  • sync_duration - duration to sync the frame in milliseconds

  • swap_buffers_duration - duration to swap buffers in milliseconds

  • total_duration - total duration of the frame rendering in milliseconds

  • unknown_delay - delay caused by unknown sources other than the explicitly tracked durations

background.task.event

This event is triggered when an iOS background task is started, ended, or expires. Background tasks allow the app to finish work when the app is backgrounded. The data is used to determine if the background tasks being used are running successfully and aren't causing the app to crash. Background tasks are an important part of keeping the app in a good state.

The following fields are collected:

  • correlation_Id - A unique identifier given to a task so that we can correlate the start/end/expires in telemetry. [This field has been removed from current builds of Office, but might still appear in older builds.]

  • event_type - The background task event type, either start, end or expire. [This field has been removed from current builds of Office, but might still appear in older builds.]

  • execution_time - The amount of time it took to execute the background task.

  • expiration_execution_time - If the task expires, there's still some time allotted for the task to complete. This field is the amount of time it took to execute the expiration handler.

  • task_id - An ID given to the task by the operating system. This ID is only unique per app session so there will be multiple tasks with the same ID over the course of the app’s lifetime. [This field has been removed from current builds of Office, but might still appear in older builds.]

  • task_name - The name given to the task either by Outlook or by the operating system.

cal.component

This event lets us detect and fix issues where there's perceivable performance impact on our calendar UI components that would cause your calendar to have scrolling issues.

The following fields are collected:

  • above_40fps - count of frames rendered above 40 fps

  • above_40rate - radio of frames rendered above 40 fps

  • above_50fps - count of frames rendered above 50 fps

  • above_50rate - radio of frames rendered above 50 fps

  • above_55fps - count of frames rendered above 55 fps

  • above_55rate - radio of frames rendered above 55 fps

  • account_counter - tracks the number of accounts associated for each type of calendar, for example, 2 for Gmail calendar and whether that account is using our new sync service

  • app_instance – Outlook has two entry points for Duo, one is for Calendar and one is for Mail and both can be launched side by side in multi instance environment. This lets us know which instance is making this reporting call, either Mail or Calendar

  • component_name - Tells us the name of the calendar component such as Agenda view or Day view to help us detect performance issues impacting a specific component in the calendar

  • display_frame_data - Tracks the time spent on displaying every 60 frames to determine if there are performance issues.

  • orientation - Tells us whether the device was in portrait or landscape mode to help us detect performance issues impacting a specific device orientation

  • taskId – TaskId gives us the current instance’s taskId. This will be required in multi instance environment if user wants to launch same instances (Calendar, Calendar or Mail, Mail) side by side

  • view_duration - Tells us how long it took to render the various UI calendar components to help us detect performance issues impacting your calendar experience

contact.action

This event is triggered on different actions on contacts - viewing, updating, and deleting contacts as well as viewing the contacts list. It's used to determine if there are any performance regressions that have to do with contacts.

The following fields are collected:

  • accounts_with_filters - the number of accounts with filters applied to the contact list

  • action - the action that was performed, for example, viewing a contact

  • duration_initial_view_load - duration from opening the view to initially loading the contact list

  • duration_show_contacts - duration from opening the view to showing contacts in the contact list

  • total_contacts - number of contacts with no filters applied

  • total_filtered_contacts - number of contacts with filters applied

conversation.load.time

This event lets us detect and fix issues where there's perceivable performance impact on loading your email conversations to ensure your emails are loading as expected.

The following fields are collected:

  • time - Tells us the amount of time that it has taken for the email conversation to complete loading.

conversation.reloaded

This event lets us detect how often we reload the conversation based on service notifications. We need to track if the update notifications are being too loud and need to be trimmed because they're degrading usability.

The following fields are collected:

  • average - the amount of reloads divided by the size

  • client-request-ID - the client request identifier for the request that caused the error

  • date - the date stamp of the request that caused the error

  • duration - the time the conversation was open

core.data.migration

Allows us to detect and fix situations where there was an error in updating email data on your device to a newer version.

The following fields are collected:

  • db_size_megabytes - tracks the size of the core data database rounded to the nearest 25 megabytes and with a maximum megabyte of 500

  • db_wal_size_megabytes - tracks the size of the core data database when the main store file is untouched rounded to the nearest 1 megabyte and with a maximum megabyte of 10

  • free_space_megabytes - tracks the free space available in buckets 10, 100, 1000, 10,000, and then 100,000.

  • migration_duration_seconds - tracks the migration duration rounded to one of these time slots - 0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100, 110, 120, 130, 140, 150, 160, 170, 180 (180 and beyond should just be 180)

core.data.performance

Allows us to detect and fix situations where the email data we're storing on your device is causing performance issues.

The following fields are collected:

  • Caller - tracks the entity name that calls the save operation

  • db_size_megabytes - tracks the size of the core data database rounded to the nearest 25 megabytes and with a maximum megabyte of 500

  • duration - tracks the amount of time it takes to complete the operation

  • entity - tracks the entity name that called the fetch operation

  • operation - raw value of operation either save, fetch, or "read write queue blocked"

inbox.component

This event collects two types of user data: Microsoft 365 subscription status, and whether the user sees ads. This helps us detect and fix issues where there's perceivable performance impact on the user's inbox UI components, which would cause email messages, avatar, read/unread state to not load or display properly.

The following fields are collected:

  • above_40fps - count of frames rendered above 40 fps

  • above_40rate - radio of frames rendered above 40 fps

  • above_50fps - count of frames rendered above 50 fps

  • above_50rate - radio of frames rendered above 50 fps

  • above_55fps - count of frames rendered above 55 fps

  • above_55rate - radio of frames rendered above 55 fps

  • account_counter - count of each account type present on the device, for example, an Office 365 account = 1 account, Outlook.com account = 1 account.

  • ad_not_shown_reason - reason why ads aren't being shown

  • ad_shown - whether an ad was shown (if ads are enabled)

  • ad_shown_for_premium - unexpectedly showing ad to premium users

  • age - age of the person (used to confirm compliance with age limitations on ads) [This field has been removed from current builds of Office, but might still appear in older builds.]

  • app_instance – Outlook has two entry points for Duo, one is for Calendar and one is for Mail and both can be launched side by side in multi instance environment. This lets us know which instance is making this reporting call, either Mail or Calendar

  • component_name - the name of the component/view that is active during the filtering

  • floating_ad_load_error_code- error code when loading floating ads

  • floating_ad_not_shown_reason- reason why floating ads aren't being shown

  • floating_ad_shown- whether a floating ad was shown (if ads are enabled)

  • has_hx - whether the device has at least one Hx (our new email syncing service) account

  • has_subscription - whether the device has an ads subscription

  • is_all_accounts_inbox - whether the current inbox is the "all accounts" folder

  • is_current_account - whether the current active account is the ads account

  • load_error_code - error code when loading ads

  • network_error_code - network error code when requesting ads

  • orientation - the screen orientation at the time of the even (portrait or landscape)

  • provider – the provider (Xandr or Facebook) of the current showing ad [This field has been removed from current builds of Office, but might still appear in older builds.]

  • sub_error_type - detailed error type

  • taskId – TaskId gives us the current instance’s taskId. This will be required in multi instance environment if user wants to launch same instances (Calendar, Calendar or Mail, Mail) side by side

  • total_count - total frames displayed by the component

  • view_duration - how long the component was viewed by the user

Initial.page.landing

This event helps track the type of experience that users see when they land in our application page. This data is used to determine the traffic of users piped into each experience in our application and also helps us to easily consolidate experimentation results.

The following fields are collected:

  • Page - This is used to track the type of experience that user first sees when they land on our page. Possible values are "Trial", "Skip", "Prebundled", "Subscription" etc.

  • storeExperience - This is used to determine if user was eligible to see the Store SDK Experience.

  • stringVariant - This is used to determine the type of strings that user sees when they land on our page. Note that for any page such as "Trial", user can be eligible to see different strings based on whether they had Legacy Office installed, or if they had previously activated Office. Possible enumerations of this property are "LegacyUpsell", "OfficeOpened", "Default", "YesIntent", "NoIntent" etc.

  • windowsBuildType - This is used to track the type of WindowsBuildType that user is on. that is "RS4", "RS5", "RS19H1", "Vibranium etc. As our experiences are usually targeted to different WindowsBuildTypes, this property is vital in differentiating between rollouts.

IpcpBootstrapUser

Collected when a user attempts to open an IRM protected doc or apply IRM protections. It contains the information needed to be able to properly investigate and diagnose issues that happen when the IpcpBootstrapUser API call is made.

The following fields are collected:

  • AppInfo.ClientHierarchy - Client hierarchy, which indicates the application runs in production environment or developer environment

  • AppInfo.Name - Application name.

  • AppInfo.Version - Application version

  • iKey - Logging service server ID

  • RMS.ApplicationScenarioId - Scenario ID provided by the application

  • RMS.AuthCallbackProvided - Indicate if provides the authentication callback as input of the API call or not

  • RMS.ConnectionInfo.ExtranetUrl - the extranet URL in connection info

  • RMS.ConnectionInfo.IntranetUrl - the intranet URL in connection info

  • RMS.ConnectionMode - The connection mode between Rights Management Service client and server: online or offline

  • RMS.Duration - Total time for API call to complete

  • RMS.DurationWithoutExternalOps - Total time minus external operations consumed, such as network latency.

  • RMS.ErrorCode - The error code returned if any from the API call

  • RMS.GuestTenant - Guest tenant ID for the user

  • RMS.HomeTenant - Home tenant ID for the user

  • RMS.HttpCall - indicate if there's HTTP operation

  • RMS.Identity.ExtranetUrl - The extranet URL of Rights Management service server for the user, collected while getting a new Rights Account Certificate from the server

  • RMS.Identity.IntranetUrl - The intranet URL of Rights Management service server for the user, collected while getting a new Rights Account Certificate from the server

  • RMS.Identity.Status - The first time to get Rights Account Certificate from the server or renew the Rights Account Certificate

  • RMS.Identity.Type - The type of the user account such as windows account or live account

  • RMS.Identity.UserProvided - Indicate if the user email address provided or not while getting new Rights Account Certificate from the server

  • RMS.IssuerId - The ID of the Rights Management Service server that issues Rights Account Certificate

  • RMS.LicenseFormat - The license Format: Xrml or Json

  • RMS.RACType - The type of Rights Accounts Certificate

  • RMS.Result - Success or fail of the API call

  • RMS.ScenarioId - Scenario ID defined by the API

  • RMS.SDKVersion - The version of Rights Management Service Client

  • RMS.ServerType - The type of Rights Management Service Server

  • RMS.StatusCode - Status code of the returned result

  • RMS.TemplatesCount - The number of the templates

  • RMS.TokenProvided - Indicate if provides the token as input of the API call or not

  • RMS.UserProvided - Indicate if provides the consumer as input of the API call or not

  • UserInfo.UserObjectId - The user object ID

IpcpGetKey

Collected when a user attempts to open an Information Rights Managed (IRM) protected document or apply IRM protections. It contains the information needed to be able to properly investigate and diagnose issues that happen when the IpcpGetKey API call is made.

The following fields are collected:

  • AppInfo.ClientHierarchy - Client hierarchy, which indicates the application runs in production environment or developer environment

  • AppInfo.Name - Application name.

  • AppInfo.Version - Application version

  • iKey - Logging service server ID

  • RMS.ApplicationScenarioId - Scenario ID provided by the application

  • RMS.AuthCallbackProvided - Indicate if provides the authentication callback as input of the API call or not

  • RMS.ConnectionMode - The connection mode between Rights Management Service client and server: online or offline

  • RMS.ContentId - Content ID of the document

  • RMS.Duration - Total time for API call to complete

  • RMS.DurationWithoutExternalOps - Total time minus external operations consumed, such as network latency.

  • RMS.ErrorCode - The error code returned if any from the API call

  • RMS.EulId - The ID of End User License

  • RMS.EulProvided - Indicate if provides the End User License as input of the API call or not

  • RMS.GuestTenant - Guest tenant ID for the user

  • RMS.HomeTenant - Home tenant ID for the user

  • RMS.HttpCall - indicate if there's http operation

  • RMS.Identity.ExtranetUrl - The extranet URL of Rights Management service server for the user, collected while getting a new Rights Account Certificate from the server

  • RMS.Identity.IntranetUrl - The intranet URL of Rights Management service server for the user, collected while getting a new Rights Account Certificate from the server

  • RMS.Identity.Status - The first time to get Rights Account Certificate from the server or renew the Rights Account Certificate

  • RMS.Identity.Type - The type of the user account such as windows account or live account

  • RMS.Identity.UserProvided - Indicate if the user email address provided or not while getting new Rights Account Certificate from the server

  • RMS.IssuerId - The ID of the Rights Management Service server that issues Rights Account Certificate

  • RMS.KeyHandle - The memory address of key handle

  • RMS.LicenseFormat - The license Format: Xrml or Json

  • RMS.PL.ExtranetUrl - The extranet URL in Publishing License

  • RMS.PL.IntranetUrl - The intranet URL in Publishing License

  • RMS.PL.KeyType - Values of "Single" or "Double" Indicates whether the PL was protected with Single Key Protection or Double Key Protection

  • RMS.RACType - The type of Rights Accounts Certificate

  • RMS.Result - Success or fail of the API call

  • RMS.ScenarioId - Scenario ID defined by the API

  • RMS.SDKVersion - The version of Rights Management Service Client

  • RMS.ServerType - The type of Rights Management Service Server

  • RMS.StatusCode - Status code of the returned result

  • RMS.TemplatesCount - The number of the templates

  • RMS.TokenProvided - Indicate if provides the token as input of the API call or not

  • RMS.UserProvided - Indicate if provides the consumer as input of the API call or not

  • UserInfo.UserObjectId - The user object ID

json.parse.error

This event denotes that an error is thrown by the json parser. We'll be able to debug the read registry string that was sent to the json parser, to allow a smooth experience for our users.

The following fields are collected:

  • Error - This consists of the error message that the error object returns.

mail.filter.component

This event lets us detect and fix issues where there's perceivable performance impact on your mail filtering experience, which would cause your filters to not load or display properly.

The following fields are collected:

  • above_40fps - count of frames rendered above 40 fps

  • above_40rate - radio of frames rendered above 40 fps

  • above_50fps - count of frames rendered above 50 fps

  • above_50rate - radio of frames rendered above 50 fps

  • above_55fps - count of frames rendered above 55 fps

  • above_55rate - radio of frames rendered above 55 fps

  • account_counter - count of each account type present on the device, for example, an Office 365 account = 1 account, Outlook.com account = 1 account.

  • ad_not_shown_reason - reason why ads aren't being shown

  • ad_shown - whether an ad was shown (if ads enabled)

  • age - age of the person (used to confirm compliance with age limitations on ads)

  • app_instance – Outlook has two entry points for Duo, one is for Calendar and one is for Mail and both can be launched side by side in multi instance environment. This lets us know which instance is making this reporting call, either Mail or Calendar

  • component_name - the name of the component/view that is active during the filtering

  • folder_type - the type of folder that is being filtered (for example, Inbox, Trash, NonSystem)

  • has_hx - whether the device has at least one Hx (the new email syncing service) account

  • has_subscription - whether the device has an ads subscription

  • is_all_accounts_inbox - whether the current inbox is the "all accounts" folder

  • is_current_account - whether the current active account is the ads account

  • load_error_code - error code when loading ads

  • network_error_code - network error code when requesting ads

  • orientation - the screen orientation at the time of the even (portrait or landscape)

  • sub_error_type - detailed error type

  • taskId – TaskId gives us the current instance’s taskId. This will be required in multi instance environment if user wants to launch same instances (Calendar, Calendar or Mail, Mail) side by side

  • total_count - total frames displayed by the component

  • view_duration - how long the component was viewed by the user

message.rendering.intercepted

This event enables us to track how often the users intercept the rendering process before it's completed. We use this data to detect performance issues.

The following fields are collected:

  • is_cache - whether the message body is loaded from cache

  • is_on_screen - whether the rendering process is visible to users (normal rendering)

  • is_rendering_complete - whether the rendering process is completed

  • is_trimmed_body - whether the message body is trimmed body

  • rendering_method - the method of rendering message

  • rendering_time - the duration of rendering the message until user leaves the page

message.rendering.performance

This event lets us monitor the performance of the message rendering process, so that we can analyze the performance of different rendering processes and detect performance issues.

The following fields are collected:

  • bundle_prepare_time - the time to prepare the bundle for rendering

  • full_rendering_time - the time of full rendering process

  • is_cache - whether the message body is loaded from cache

  • is_on_screen - whether the rendering process is visible to users (normal rendering)

  • is_trimmed_body - whether the message body is trimmed body

  • load_message_time - the time to load message from backend (can be 0 if the message has been cached)

  • native_preprocess_time - the time to preprocess message body in native side

  • prepare_body_time - the time to prepare message body (including load and preprocess message)

  • rendering_method - the method of rendering message

  • rendering_time - the time to render message by the bundle

  • wait_time - the time to build message URL

metric.diagnostic

This event is triggered when we receive data on a diagnostic event (for example, a crash or hang) from the iOS system. The data is used to identify and diagnose issues to maintain the quality of service.

The following fields are collected:

  • arguments - This represents arguments passed to the format_string.

  • call_stack_hash - This represents a call stack, which is used to diagnose a crash or hang.

  • class_name - This represents the class name of the exception. For example, NSException.

  • composed_message - A human-readable message string summarizing the reason for the exception.

  • exception_code - This represents an exception code, which is used to determine what led to a crash.

  • exception_name - This represents an exception name, which is used to determine what led to a crash.

  • exception_type - This represents an exception type, which is used to determine what led to a crash.

  • format_string - This represents the exception message before arguments are substituted into the message.

  • hang_duration - The amount of time the app spent as unresponsive.

  • signal - This represents an exception signal, which is used to determine what led to a crash.

  • termination_reason - The reason why the app crashed.

  • virtual_memory_region_info - This represents information stored in the app code when a crash occurred.

metric.diagnostic.call.stack.map

This event is triggered when we receive data on a diagnostic event (for example, a crash or hang) from the iOS system. The data is used to determine what code caused the crash or hang.

The following fields are collected:

  • call_stack – This represents a call stack, which is used to diagnose a crash or hang.

  • call_stack_hash – This represents the hash of a call stack, which can be used to correlate this even with the metric_diagnostic event.

metric.signpost

The event is triggered by receiving data from iOS's MetricKit framework. Once a day, MetricKit sends Outlook a diagnostic report that contains aggregated signpost information. On receiving the report, Outlook will trigger this event.

This event is used to identify regressions by collecting statistics around the time various performance-related Outlook scenarios take to execute.

The following fields are collected:

  • signpost_summary - A histogram representation of the execution times.

  • source - The source of the signpost data.

  • type - The signpost scenario.

Office.Android.AdsMobile.Wxpu.AdUIEvent

[This event was previously named Office.Android.AdsMobile.AdUIEvent.]

This is event is triggered when a user interacts with an advertisement. This event collects information that is used to determine the app and feature performance for the users who are exposed to ads.

The following fields are collected:

  • Data_ActionType - User action performed on the ad view

  • Data_AuctionId - Unique send by the ad network to map to a sell auction on the ad network.

  • Data_PlacementId - Unique identifier used by the ad network service to associate creative to a surface

  • Data_SurfaceId - Uniquely identifies a surface where creative is displayed

Office.Android.AndroidOfficeLaunchToLandingPageLatency

Critical to capture for app performance metric with respect to the response time of the app from the boot. Microsoft uses this to collect the time taken for the app to be responsive and also detect scenarios that may impact boot time in Word, Excel, or PowerPoint.

The following fields are collected:

  • AnyCrashInteractionDuringBoot - Boolean for any crash encountered during boot

  • AppActivationTimeInMs - App phase time

  • AppSuspendedDuringBoot - Boolean for app suspension during boot

  • AvailableMemoryInMB - available memory

  • CollectionTime - time of event

  • DalvikHeapLimitInMB - Heap info

  • Data_FGFlags – A number indicating whether the user is selected for performance related experimentation.

  • DocumentRecoveryInvoked - Boolean to indicate if any document was recovered

  • ExtractionDone - Native library extraction time

  • FastBootGainTimeInMs - Time for fast boot completion

  • FileActivationAttempted - Boolean to indicate if app was launched due to File activation

  • HasLogcatLoggingImpactOnBoot - Boolean to indicate if logcat impacted boot time

  • IsThisFirstLaunch - Boolean to indicate if this is first app launch

  • LatencyTimeInMilliSec - latency in millisecond

  • LibrarySharingTimeInMs - time for sharing libraries

  • LoadMinLibsTimeInMs - Loading time for the minimum set of libraries

  • MruListingTimeInMs - time to load MRU

  • NativeLibrariesLoadTime - CPP library load time

  • NumberOfRunningProcesses - number of running processes

  • NumberOfRunningProcesses - Number of running processes

  • NumberOfRunningServices - Number of running services

  • OfficeActivityTimeInMs - Time for initing OfficeActivity

  • PostAppInitTimeInMs - app phase time

  • PreAppInitializationTime - App phase init time

  • PreAppInitTimeInMs - app phase time

  • TotalMemoryInMB - total memory

  • UIRaaSDownloadLanguagePackageBoot - information related to language pack download

  • UserDialogInterruptionDuringBoot - Boolean for any blocking dialog shown during boot

Office.Android.AuthPerfADALEndToSignInEnd

This event is triggered when an enterprise user clicks on the Next button on the password page to sign in completion. This information helps Microsoft determine the time taken in this flow for performance comparison and make performance improvements as required.

The following fields are collected:

  • Data_ADALEndToSignInEnd - it's the difference in time between two SDT tags that mark the start and end points of the flow

Office.Android.AuthPerfAuthStartToOneAuthAcquireCredStart

This event is triggered when the prompt flow is initiated, and the credential acquisition flow starts. This information helps Microsoft determine the time taken in this flow for performance comparison and make performance improvements as required.

The following fields are collected:

  • Data_ AuthStartToOneAuthAcquireCredStart - it's the difference in time between two SDT tags that mark the start and end points of the flow

Office.Android.AuthPerfAuthStartToOneAuthSignInInteractiveStart

This event is triggered when the authentication flow is initiated in Office Android apps. This information helps Microsoft determine the time taken in this flow and to measure the time spent in integrated flows so that required performance improvements can be made.

The following fields are collected:

  • Data_ AuthStartToOneAuthSignInInteractiveStart - it's the difference in time between two SDT tags that mark the start and end points of the flow

Office.Android.AuthPerfFixMeToOneAuthAcquireCredStart

This event is triggered when the prompt flow initiates the credential acquisition flow for an account that is in invalid state and needs fixing by the user. This helps Microsoft determine the time taken in this flow for performance comparison and make performance improvements as required.

The following fields are collected:

  • Data_ FixMeToOneAuthAcquireCredStart - it's the difference in time between two SDT tags that mark the start and end points of the flow

Office.Android.AuthPerfHRDEndToADALStart

This event is triggered when an enterprise user clicks on the next button in an email page. This information helps Microsoft determine the time taken in this flow for performance comparison and make performance improvements as required.

The following fields are collected:

  • Data_HRDEndToADALStart - it's the difference in time between two SDT tags that mark the start and end points of the flow

Office.Android.AuthPerfHRDEndToIDCRLStart

This event is triggered when a consumer user clicks on the next button in an email page. This information helps Microsoft determine the time taken in this flow for performance comparison and make performance improvements as required.

The following fields are collected:

  • Data_HRDEndToIDCRLStart - it's the difference in time between two SDT tags that mark the start and end points of the flow

Office.Android.AuthPerfIDCRLEndToSignInEnd

This event is triggered when the consumer user clicks on the Next button on password page to sign in completion. This data helps Microsoft determine the time taken in this flow for performance comparison and make performance improvements as required.

The following fields are collected:

  • Data_IDCRLEndToSignInEnd - it's the difference in time between two SDT tags that mark the start and end points of the flow

Office.Android.AuthPerfOneAuthSignInInteractiveEndToSignInEnd

This event is triggered when the sign-in interactive flow ends successfully with the status received by the app. This information helps Microsoft determine the time taken in this flow for performance comparison in Office Android apps and make improvements as needed.

The following fields are collected:

  • Data_ OneAuthSignInInteractiveEndToSignInEnd - it's the difference in time between two SDT tags that mark the start and end points of the flow

Office.Android.AuthPerfSignInStartToHRDStart

This event is triggered when the user clicks on the sign-in button to the email page. This helps Microsoft determine the time taken in this flow for performance comparison and make performance improvements as required.

The following fields are collected:

  • Data_SignInStartToHRDStart - it's the difference in time between two SDT tags that mark the start and end points of the flow

Office.Android.AuthPerfUnifiedSISUEndToADALStart

This event is triggered when an enterprise user clicks on the next button in First Run Experience (FRE) page to open the password page. This information helps Microsoft determine the time taken in this flow for performance comparison and make performance improvements as required.

The following fields are collected:

  • Data_UnifiedSISUEndToADALStart - it's the difference in time between two SDT tags that mark the start and end points of the flow

Office.Android.AuthPerfUnifiedSISUEndToIDCRLStart

This event is triggered when the consumer user clicks on the Next button in the First Run Experience (FRE) page to generate the password page. This information helps Microsoft determine the time taken in this flow for performance comparison and make performance improvements as required.

The following fields are collected:

  • Data_UnifiedSISUEndToIDCRLStart - it's the difference in time between two SDT tags that mark the start and end points of the flow

Office.Android.AuthPerfUnifiedSISUEndToOneAuthSignInInteractiveStart

This event is triggered when the user clicks on the Next button in the First Run Experience (FRE) page to start the Sign-In Interactive flow. This helps Microsoft determine the time taken in this flow, to determine performance in authentication flows in Office Android apps, and make performance improvements as required.

The following fields are collected:

  • Data_ UnifiedSISUEndToOneAuthSignInInteractiveStart - it's the difference in time between two SDT tags that mark the start and end points of the flow

Office.Android.CrashMetadata

This event is triggered when there's a crash, and the crash successfully uploads to crash collection service. This event is used to diagnose Android crashes and also monitor the health of the Android crash upload service.

The following fields are collected:

  • Data_AppErrorTime - the time when the app crashed.

  • Data_CrashAppStore - the App store where the app was installed from

  • Data_CrashedCountry - Country or region where the crash occurred

  • Data_CrashedLocale - Locale of the app when the crash happened

  • Data_CrashedOSVersion - Android OS version for which the crash happened

  • Data_CrashedProcess - the process that has crashed. These are app process like com.microsoft.office.powerpoint

  • Data_CrashesSessionId - ProcessSessionId of the session that crashed

  • Data_IsOEMInstalled - this Boolean value of if app is pre-installed on the device.

  • Data_IsUploadSuccessful - If the report was successfully uploaded or encountered any issues while uploading to crash service.

  • Data_reportId - the ID of the report that is uploaded on the crash service.

  • Data_TotalMemory - System Memory of the device.

  • Data_Type - the type of the crash java/native.

Office.Android.DBTException

This event gets triggered when any exceptions happen during the boot flow when user opens the app. We weren't able to check what those exceptions were earlier. We're capturing these exception details in this event. The data is used to capture exception-related data to determine which exceptions were causing crashes.

The following fields are collected:

  • DBTExceptionDescription - This is text description on exception.

  • DBTExceptionRootTag - This tag identifies exception generated place.

  • DBTExceptionTag - Tag for current event.

  • DBTExceptionType - This is type of error (enum) which is property of exception.

Office.Android.DocsUI.PaywallControl.SaveFlowUiShown

Critical data to log the result of offers UI is shown to user or not. The data is used to understand if the user sees the relevant offer inline with their SKU.

The following fields are collected:

  • EventDate - Timestamp of the event occurrence

  • ProductId - String - ProductId of the SKU being purchased.

  • SessionID - GUID to connect events by session

Office.Android.DocsUI.Views.DimePurchaseFlowState

This health event attempts to capture each state that a user goes through when the user is attempting to make a purchase through the in-app purchase flow hosted by Dime. The data is used to monitor and alert on the health of the purchase flow triggered from Microsoft 365 mobile app when user opts to buy a Microsoft 365 subscription.

The following fields are collected:

  • EntryPoint - Entry point of the purchase attempted by the user

  • OEMPreInstalled - Identifies if the app is pre-installed or organically installed by the user

  • PurchaseState - State of the user when attempting a purchase

    • 0 - Unknown error
    • 1 - Dime is attempted by the user for open
    • 2 - Network error
    • 3 - Dime is shown to the user
    • 4 - Dime is canceled by the user
    • 5 - Refresh needed as purchase is successful
    • 6 - Purchase is successful
    • 7 - Generic dime error
    • 8 - Dime telemetry can't be uploaded due to communication failure
    • 9 - Two instances of Dime running causing interruption error
    • 10 - Base WebURL loaded on Office mobile app is invalid
    • 11 - Communication of Office mobile app with Dime failed
    • 12 - No communication channel could be established
    • 13 - Communication ID couldn't be sent to Dime
    • 14 - The Office mobile app is communicating to the wrong endpoint
    • 15 - AuthToken isn't obtained for this MSA account
    • 16 - AuthToken isn't sent to Dime
  • WebViewShownDuration - Duration for which the dime purchase page is shown to the user

Office.Android.EarlyTelemetry.AdErrorEvent

This event is triggered for ad related error scenario. This event doesn't collect any user related data from the online platform.

The following fields are collected:

  • Data_AuctionId - Unique ID sent by Ad network to map a sell transaction to a specific ad response

  • Data_PlacementId - Unique identifier used by Ad network service to associate an ad to a surface

  • Data_SurfaceId - Uniquely identifies a surface where creative is displayed

  • Data_ErrorType - Category of error

  • Data_ErrorMetadata - Additional details about error

Office.Android.EarlyTelemetry.AsyncLibLoadFailure

This event is triggered when the user launches the app or open any Word, Excel, or PowerPoint file and faces any issues during library load. This data is used to find the failure cases.

The following fields are collected:

  • Data_AdditionalInfo - Info (app state or member variables) regarding the exception will be logged here.

  • Data_ErrorCode - class name of the exception will be logged here.

  • Data_ErrorDescription - detail message string of the error class will be logged here.

  • Data_FailureMethod - Function name where exception is thrown

Office.Android.NullIdOnSignInWithOneAuthAndroid

This event is triggered when any exceptions happen during the boot flow when user opens the app. The data is used to determine what kind of exceptions cause the crashes.

The following fields are collected:

  • AccountType - Integer describing user account type.

  • CompletionState - Integer describing Sign-in Completion state like success/fail.

  • ContributedTag - This is a tag of various types of causes of authentication failure when One Auth is enabled. This provides information about current failure contributions and based on that need to act on fixes/mitigations for respective failures.

  • EntryPoint - Integer describing Sign-in entry

  • FinishSigninTriggerTag - Caller's tag

  • HResult - Integer describing error code

  • IsPhoneOnlyAuthFeatureEnabled - Boolean describing whether feature enabled or not.

  • StartMode - Integer describing Sign-in Mode

  • UserDecision - Integer describing user decision of which type of Sign-in

Office.Android.OneAuthEFailErrors

This event gets triggered when login failed. The data is used to understand what kind of errors are happening.

The following fields are collected:

  • ContributedTag - This is a tag that will indicate the flow where error occurred.

  • Status - Error code integer

  • SubStatus - Error subcategory code integer

Office.Android.SignInTaskInitiated

The event is triggered when the application shows the sign in flow like Account Transfer flow on mobile devices. Data is used to determine the source and mode of the sign in trigger and is also used to analyse the sign in completion errors or identify errors if any.

The following fields are collected:

  • EntryPoint - Indicates the entry point in the app, from where sign in attempt was initiated.

  • StartMode – Indicates the mode in which sign in attempt was started.

Office.Apple.Apple.AppBoot.Mac

This event is collected for Office applications running under Apple platforms. The event is used to collect the time taken to boot the app, as well as some details on the type of boot done. This event helps us monitor our performance and provide performance improvements.

The following fields are collected:

  • Data_ Data_EvtBootTimerDocStageReady - Time elapsed until reaching certain point in code.

  • Data_DocumentRecoveryInvoked - Whether document recovery was invoked during boot.

  • Data_EvtBootTimerBootIdle - Time elapsed until reaching certain point in code.

  • Data_EvtBootTimerFinishLaunchEnd - Time elapsed until reaching certain point in code.

  • Data_EvtBootTimerLaunchDidFinish - Time elapsed until reaching certain point in code.

  • Data_EvtBootTimerLaunchStart - Time elapsed until reaching certain point in code.

  • Data_EvtBootTimerMainStart - Time elapsed until reaching certain point in code.

  • Data_EvtBootTimerStaticInit - Time elapsed until reaching certain point in code.

  • Data_EvtDockStageReady - Time elapsed until reaching certain point in code.

  • Data_IsFileOpenAttempted - Whether a file open was attempted during boot.

  • Data_IsFirstRunAttempted - Whether the app boot went through first run experience.

  • Data_SentToBackground - Whether the app was sent to background during boot.

Office.Apple.DiskRuleResultSerializerErrorOnStreamOp

This event is collected for Office applications running under Apple platforms. The event is used to monitor the health of our telemetry infrastructure. This event denotes an error has occurred.

The following fields are collected:

  • Data_ActualBytesModified - Number of bytes modified.

  • Data_BytesRequested - Number of bytes to process.

  • Data_IsWriteOp - Whether we're about to execute a write operation

Office.Apple.Licensing.AROFFNotificationTapped

This event is triggered when user taps OFF on the Auto Renewal push notification. Event is used to ensure that tapping on the push notification worked correctly to launch the in app experience.

The following fields are collected:

  • None

Office.Apple.MacBootResourceUsage

This event is collected for Office applications running under Apple platforms. This event is collected for Office applications running under Apple platforms. The event is used to collect multiple indicators around the resources being consumed during boot by Office apps. This event helps us monitor our performance and provide performance improvements.

The following fields are collected:

  • Data_BlockInputOperations - A count of block input operations

  • Data_BlockOutputOperations - A count of block output operations

  • Data_InvoluntaryContextSwitches - The number of involuntary context switches

  • Data_MainThreadCPUTime - An elapsed time measurement

  • Data_MaxResidentSize - A memory size measurement

  • Data_MessagesReceived - The number of messages received

  • Data_MessagesSent - The number of messages sent

  • Data_PageFaults - A count of page reclaims

  • Data_PageReclaims - A count of page reclaims

  • Data_ProcessCPUTime - An elapsed time measurement

  • Data_SharedTextMemorySize - A memory size measurement

  • Data_SignalsReceived - The number of signals received

  • Data_Swaps - A count of data swaps

  • Data_SystemCPUTime - An elapsed time measurement

  • Data_SystemUpTime - An elapsed time measurement

  • Data_UnsharedDataSize - A data size measurement

  • Data_UnsharedStackSize - A stack size measurement

  • Data_UserCPUTime - An elapsed time measurement

  • Data_VoluntaryContextSwitchesNvcsw - The number of voluntary context switches

Office.Apple.MAU.Validation

This event is collected for Office applications running under Apple platforms. The event is used to monitor the health of the Microsoft Autoupdate component, which is used to distribute and install application updates. The data collected is used for detecting errors and investigating causes of failures.

The following fields are collected:

  • Data_EventID - We collect a string representing an error code

  • Data_Message - We collect a string containing a description of the error

Office.Apple.MbuInstrument.Hang.Detection.Spin.Control

This event is collected for Office applications running under Apple platforms. The event is logged whenever an application appears to become non-responsive. This event helps us monitor our performance and provide performance improvements.

The following fields are collected:

  • Data_CountSpinControlStart - A marker that indicates that the application appears to have become unresponsive (or slow to respond)

Office.Apple.MbuInstrument.VMOnDocumentClose

This event is collected for Office applications running under Apple platforms. The event is used to collect a snapshot of the state of memory during document close. This event helps us monitor our performance and provide performance improvements.

The following fields are collected:

  • Data_CollectionTime - A timestamp from the moment in which the data was collected

  • Data_ResidentMemory - Observed resident memory value

  • Data_VirtualMemory - Observed virtual memory value

Office.Apple.MbuInstrument.VMOnShutdown

This event is collected for Office applications running under Apple platforms. The event is used to collect a snapshot of the state of memory during application shutdown. This event helps us monitor our performance and provide performance improvements.

The following fields are collected:

  • Data_CollectionTime - A timestamp from the moment in which the data was collected

  • Data_ResidentMemory - Observed resident memory value

  • Data_VirtualMemory - Observed virtual memory value

Office.Apple.MbuInstrument.VMOnStart

This event is collected for Office applications running under Apple platforms. The event is used to collect a snapshot of the state of memory during application start. This event helps us monitor our performance and provide performance improvements.

The following fields are collected:

  • Data_CollectionTime - A timestamp from the moment in which the data was collected

  • Data_ResidentMemory - Observed resident memory value

  • Data_VirtualMemory - Observed virtual memory value

Office.Apple.MsoAppDelegate.BootPerf

This event is collected for Office applications running under Apple platforms. The event is used to collect time and memory consumed during boot by Office apps, as well as some details on the type of boot done. This event helps us monitor our performance and provide performance improvements.

The following fields are collected:

  • Data_AppLaunchDurationMicroSec - The duration of the boot process

  • Data_AppLaunchFinishSystemTime - A timestamp at a particular boot code marker

  • Data_AppLaunchStartSystemTime - A timestamp at a particular boot code marker

  • Data_ResidentMemory - A snapshot of the available resident memory during boot

  • Data_VirtualMemory - A snapshot of the available virtual memory during boot

Office.Apple.UngracefulAppExitHangsInPreviousSession

This event is collected for Office applications running under Apple platforms. The event is used to monitor the health of our Office applications as well as for investigating causes of failures. We collect the number of times an application appeared to be unresponsive prior to hitting an ungraceful application exit.

The following fields are collected:

  • Data_HangsDetected - The number of times the application appeared to become unresponsive prior to observing the ungraceful application exit.

  • Data_LastSessionId - The identifier for the session in which the ungraceful application exit was observed.

  • Data_SessionBuildNumber - The minor version of the application in which an ungraceful application exit was observed.

  • Data_SessionVersion - The major version of the application in which an ungraceful application exit was observed.

Office.Apple.WhatsNewErrorAndWarning

This event is collected for Office applications running under Apple platforms. The event is used to monitor the health of the What's New feature. This event denotes that an error/warning occurred while parsing What's New content, pointing to potential content authoring issues.

The following fields are collected:

  • Data_ContentKey - A pointer to the section of the content that is likely to have caused the error.

  • Data_ErrorCode - The observed error code (if available)

  • Data_ErrorDescription - A description of the error (if available)

  • Data_EventID - We collect a string representing the type of error observed.

  • Data_IncludesHTMLTag - Whether the content contains rich html

  • Data_IncludesItemsTag - Whether the content contains a hierarchy of items

  • Data_LengthOfRawData - The size of the content

  • Data_RequestURL - The URL from which the content was downloaded

  • Data_ServerLanguageTag - The language the content was in.

  • Data_StatusCode - The status of the error (if available)

Office.ClickToRun.Ads.Container.HandleErrorNotification

This event is collected from free versions of Office applications running on the Windows platform. This event is triggered when there's an issue retrieving advertisement content, displaying an advertisement, among other error cases. The data is used to identify issues with the ads container initializing the advertisement add-in and any issues within the add-in.

The following fields are collected:

  • Activity_Result_Code - The error code from event

  • Activity_Result_Type - Whether the event was successful

  • Data_AdFailure - Duration until advertisement add-in reported ad bid failure

  • Data_AdReady - Duration until advertisement add-in reported ad bid success

  • Data_AdShowingFailure - Time when failing to show the ad pane.

  • Data_AppActivated - Last time when application is activated

  • Data_AppActivateTime - Total time when user is active in the app during the lifecycle of video advertisement.

  • Data_AppDeactivated - Last time when application is deactivated.

  • Data_BusbarClick - Time when user clicks the description on video advertisement notification.

  • Data_BusbarDismiss - Time when user clicks the Close/Dismiss button on video advertisement notification.

  • Data_BusbarShown - Duration until video advertisement notification is shown.

  • Data_BusbarToShow - Duration until video advertisement notification is about to be shown.

  • Data_ContainerInstanceId - A unique identifier for each advertisement container

  • Data_Destroy - Duration when advertisement container is destroyed due to an error

  • Data_DocumentLoaded - Duration until advertisement add-in page is loaded

  • Data_ErrorDescription - A human-readable description of the error

  • Data_ErrorSource - The component responsible for the error

  • Data_Init - Duration to initialize advertisement container

  • Data_IsCanceled - A unique identifier for each advertisement container

  • Data_LaunchExtComponent - Identify the utilization of specific internal APIs.

  • Data_MoeErrorCode - The error code from failure

  • Data_PaneClosed - Time when ad pane is closed.

  • Data_ReadyToBeShown - Duration until an ad is ready to be shown to user

  • Data_Refresh - Duration until advertisement add-in page is refreshed

  • Data_SDXPackageVersion - The version of the advertisement add-in

  • Data_SDXReady - Duration to finish advertisement add-in initialization

  • Data_SDXStoreType - The source of the advertisement add-in package in usage

  • Data_ShownTime - Duration until an ad has been shown to user

  • Data_StartSDX - Duration to start advertisement add-in initialization

  • Data_TimeToShowVideo - Duration until next video advertisement is about to be shown.

  • Data_TimeToStartVideo - Duration until next video advertisement starts to load.

  • Data_Type - The type of advertisement

  • Data_VideoToShow - Duration until video advertisement is about to be shown.

  • Data_WatchNow - Time when user clicks the Watch Now button on video advertisement notification.

  • Data_WindowActivated - Last time when window containing advertisement add-in page is activated.

  • Data_WindowClosed - Duration when application document window is closed

  • Data_WindowDeactivated - Last time when window containing advertisement add-in page is deactivated.

Office.ClickToRun.Ads.SDX.Error

This event is collected from free versions of Office applications running on the Windows platform. This event is triggered if there's an error loading, retrieving, or displaying an advertisement. The data is used to identify issues with the advertising add-in on customer machines.

The following fields are collected:

  • Data_EventID - Unique tag to identify code failure location

  • Data_Message - A human-readable description of the error

Office.DesignerApp.App.Boost

The event log captures data regarding the network performance for getting boost information, including metrics on quality, latency, and any encountered errors. This information is crucial for ensuring the boost information is properly received by the client.

The following fields are collected:

  • Action - Action taken on notification which includes, dismiss, display, and click.

  • BoostLimitReached - Indicates whether boost count is exhausted or not.

  • CorrelationId - GUID used to correlate activities.

  • ElapsedTime - Logs time elapsed in completing action.

  • Error - Logs error occurred during any activity.

  • flowId - GUID used to identify current app flow started on home screen.

  • HasBoost - Indicates whether boost count is remaining or not.

  • Host - Identifies the host app name that launches Designer.

  • HostAppSessionId - Uniquely identifies the host app session for a sub-app.

  • IsCopilotPro - Indicates whether copilot pro plan is activated or not.

  • IsSuccessful - Logs success status true or false of action.

  • Locale - Locale of user.

  • MiniAppsConfigVersion - Configuration version of mini apps supported on home screen.

  • MiniAppsEnabled - Identifies if sub apps are enabled on Designer home screen.

  • SDKLaunchCorrelationId - GUID used to correlate Designer SDK activities.

  • SdkVersion - Version of Designer SDK.

  • Source - Logs source of Designer SDK launch.

  • SystemLocale - System locale of the device.

  • TimeZone - The user's time zone relative to UTC.

  • UserAgeGroup - Logs age group of user like minor or adult.

  • UserIntent - Indicates whether some operation is to be considered as active operation or not.

Office.DesignerApp.App.InsertImageCompleted

The event log captures essential data regarding the insert image operation on canvas including metrics like performance, quality of service, reliability, and errors. This information is crucial for ensuring image insertion works properly.

The following fields are collected:

  • CorrelationId - GUID used to correlate activities.

  • ElapsedTime - Logs time elapsed in completing action.

  • flowId - GUID used to identify current app flow started on home screen.

  • Host - Identifies the host app name that launches Designer.

  • HostAppSessionId - Uniquely identifies the host app session for a sub-app.

  • ImageSource - Image was a gallery image, AI image or stock image.

  • IsSuccessful - Logs success status true or false of action.

  • Locale - Locale of user.

  • MiniAppsConfigVersion - Configuration version of mini apps supported on home screen.

  • MiniAppsEnabled - Identifies if sub apps are enabled on Designer home screen.

  • SDKLaunchCorrelationId - GUID used to correlate Designer SDK activities.

  • SdkVersion - Version of Designer SDK.

  • Source - Logs source of Designer SDK launch.

  • SystemLocale - System locale of the device.

  • TimeZone - The user's time zone relative to UTC.

  • UserAgeGroup - Logs age group of user like minor or adult.

Office.DesignerApp.App.MobileFREAnimation

The event log captures essential data regarding the first run experience (FRE) animation, including metrics on performance, quality, exit status, latency, and any encountered errors. This information is crucial for ensuring that users are able to get benefit of the FRE Animation in Designer.

The following fields are collected:

  • CorrelationId - GUID used to correlate activities.

  • Dismiss - Reason for dismissing Designer guided window. It could be because of clicking cross/Ok on dialog or system closed it or outside window was touched.

  • Error - Logs error occurred during any activity.

  • errorMessage - Cause of error occurred.

  • flowId - GUID used to identify current app flow started on home screen.

  • Host - Identifies the host app name that launches Designer.

  • HostAppSessionId - Uniquely identifies the host app session for a sub-app.

  • LaunchTime - Time taken by app in starting.

  • Locale - Locale of user.

  • MiniAppsConfigVersion - Configuration version of mini apps supported on home screen.

  • MiniAppsEnabled - Identifies if sub apps are enabled on Designer home screen.

  • MobileNetworkQuality - Logs quality of current mobile network.

  • SDKLaunchCorrelationId - GUID used to correlate Designer SDK activities.

  • SdkVersion - Version of Designer SDK.

  • Source - Logs source of Designer SDK launch.

  • SystemLocale - System locale of the device.

  • TimeZone - The user's time zone relative to UTC.

  • UserAgeGroup - Logs age group of user like minor or adult.

  • UserIntent - Indicates whether some operation is to be considered as active operation or not.

Office.DesignerApp.App.MobileNetworkErrors

The event log captures data about user network information which includes metrics like performance, quality of service, errors, strength, etc. This information is crucial for ensuring that we optimize user experience based on the network speed of user's devices.

The following fields are collected:

  • ApiTag - Single word identifier of network API.

  • CorrelationId - GUID used to correlate activities.

  • errorCode - Code of error occurred.

  • errorType - Type of error occurred.

  • flowId - GUID used to identify current app flow started on home screen.

  • Host - Identifies the host app name that launches Designer.

  • HostAppSessionId - Uniquely identifies the host app session for a sub-app.

  • Locale - Locale of user.

  • MiniAppsConfigVersion - Configuration version of mini apps supported on home screen.

  • MiniAppsEnabled - Identifies if sub apps are enabled on Designer home screen.

  • RetryCount - Count of retries done for network call.

  • SDKLaunchCorrelationId - GUID used to correlate Designer SDK activities.

  • SdkVersion - Version of Designer SDK.

  • Source - Logs source of Designer SDK launch.

  • SystemLocale - System locale of the device.

  • TimeZone - The user's time zone relative to UTC.

  • UserAgeGroup - Logs age group of user like minor or adult.

  • WillBeRetried - Logs whether network call will be retried if failed.

Office.DesignerApp.App.RefreshSessionId

The event captures the essential health and hygiene data around session refresh while user is still in an ongoing session. It helps in capturing the usage of session ID refresh in situations when user's session is about to expire during ongoing session itself.

The following fields are collected:

  • CorrelationId - GUID used to correlate activities.

  • flowId - GUID used to identify current app flow started on home screen.

  • Host - Identifies the host app name that launches Designer.

  • HostAppSessionId - Uniquely identifies the host app session for a sub-app.

  • Locale - Locale of user.

  • MiniAppsConfigVersion - Configuration version of mini apps supported on home screen.

  • MiniAppsEnabled - Identifies if sub apps are enabled on Designer home screen.

  • SDKLaunchCorrelationId - GUID used to correlate Designer SDK activities.

  • SdkVersion - Version of Designer SDK.

  • Source - Logs source of Designer SDK launch.

  • SystemLocale - System locale of the device.

  • TimeZone - The user's time zone relative to UTC.

  • UserAgeGroup - Logs age group of user like minor or adult.

Office.DesignerApp.App.SharedDesign

This event is triggered when designs or images are shared by clicking on share button. The event log captures essential data regarding the Export feature's performance, including metrics on quality of service, usage, latency, and any encountered errors. This information is crucial for ensuring the Export function operates effectively.

The following fields are collected:

  • Core - Indicates whether some operation has to be considered export operation or not.

  • CorrelationId - GUID used to correlate activities.

  • DesignId - GUID of design created by Designer.

  • ElapsedTime - Logs time elapsed in completing action.

  • EndPoint - Used to identify the appropriate Designer screen in which design/image creation was performed.

  • Error - Logs error occurred during any activity.

  • ExportDuration - Duration of exported item.

  • ExportTime - Time taken in export operation.

  • FileType - Type of file exported.

  • flowId - GUID used to identify current app flow started on home screen.

  • HasAnimation - Exported asset has animation or not.

  • HasVideos - Exported asset has videos in it or not.

  • Host - Identifies the host app name that launches Designer.

  • HostAppSessionId - Uniquely identifies the host app session for a sub-app.

  • IsCached - Logs whether returned results is cached result or not.

  • IsExportPreviewClicked - Export preview screen was dismissed by click or system.

  • IsMotion - Logs whether exported item had motion element or not.

  • IsSuccessful - Logs success status true or false of action.

  • ItemType - Type of item size exported.

  • Locale - Locale of user.

  • MediaType - Type of media being exported.

  • MiniAppsConfigVersion - Configuration version of mini apps supported on home screen.

  • MiniAppsEnabled - Identifies if sub apps are enabled on Designer home screen.

  • NumberOfPages - number of pages in exported design.

  • persistentId - Persistent GUID of design created by Designer.

  • PostedPlatforms - Logs the platform where design/image was exported.

  • PublishTime - Time taken in publish operation.

  • RemoveWaterMark - Watermark while exporting was removed or not.

  • RequestId - GUID to uniquely identify network request.

  • SDKLaunchCorrelationId - GUID used to correlate Designer SDK activities.

  • SdkVersion - Version of Designer SDK.

  • ShareSurface - Logs the place where export took place.

  • Source - Logs source of Designer SDK launch.

  • SystemLocale - System locale of the device.

  • TimeToSaveOrPublish - Time taken in saving the design/image.

  • TimeZone - The user's time zone relative to UTC.

  • TotalPages - Total number of pages of the exported design.

  • TransparentBG - Whether bg was removed or not while exporting the design/image.

  • Trigger - What was the trigger for the design which was exported.

  • UserAgeGroup - Logs age group of user like minor or adult.

  • UserIntent - Indicates whether some operation is to be considered as active operation or not.

Office.DesignerApp.App.UploadAsset

The event log captures essential data regarding the upload operation performance, including metrics on quality, latency, and any encountered errors. This information is crucial for ensuring the upload operation process operates effectively.

The following fields are collected:

  • assetUploadedInStorage - Storage type where asset was uploaded.

  • CorrelationId - GUID used to correlate activities.

  • ElapsedTime - Logs time elapsed in completing action.

  • Error - Logs error occurred during any activity.

  • errorCode - Code of error occurred.

  • ErrorCodeHeader - Logs error code in header returned by network API in case of failure.

  • FailureReasonHeader - Logs error cause in header returned by network API in case of failure.

  • flowId - GUID used to identify current app flow started on home screen.

  • Host - Identifies the host app name that launches Designer.

  • HostAppSessionId - Uniquely identifies the host app session for a sub-app.

  • IsSuccessful - Logs success status true or false of action.

  • Locale - Locale of user.

  • MimeType - Mime type of asset uploaded.

  • MiniAppsConfigVersion - Configuration version of mini apps supported on home screen.

  • MiniAppsEnabled - Identifies if sub apps are enabled on Designer home screen.

  • RetryCount - Count of retries done for network call.

  • SDKLaunchCorrelationId - GUID used to correlate Designer SDK activities.

  • SdkVersion - Version of Designer SDK.

  • Size - Size of uploading asset.

  • Source - Logs source of Designer SDK launch.

  • SystemLocale - System locale of the device.

  • TimeZone - The user's time zone relative to UTC.

  • UploadSource - Source of image upload for creating designs.

  • UserAgeGroup - Logs age group of user like minor or adult.

  • UserIntent - Indicates whether some operation is to be considered as active operation or not.

Office.Extensibility.RichApiMethodInvocation

When customer uses an Office Add-in and calls Rich API for providing service, this event will be triggered. Used to measure the service reliability, performance, and usage for Rich API method invocation.

The following fields are collected:

  • Api - Full name of the API

  • DispFlag - A bit flag describing the type of method call (Ex: 0x1 = METHOD, 0x2 = PROPERTYGET, 0x4 = PROPERTYPUT, 0x8 = PROPERTYPUTREF)

  • DispId - Dispatch ID for the method being called

  • HResult - HResult for the method call

  • Latency - Latency for the call, in microseconds

  • ReqId - GUID for the batch request that this method belongs to

  • TypeId - GUID for the interface on which this method being called

Office.Identity.InteractiveSignInMaciOS

The event is triggered when signing in to Microsoft 365 apps via the Interactive Sign In functionality and is used to monitor sign in attempts and whether they succeeded or not, which allows us to keep the app secure and performing as expected.

The following fields are collected:

  • Activity_Duration - Duration it took to execute the Interactive Sign In.

  • Activity_Success - A flag indicating if the sign in succeeded or not.

  • Associated - A flag indicating whether the account found is signed in previously.

  • Caller - A tag indicating the caller triggering the Sign In flow.

  • CorrelationId - Field used to correlate authentication requests in the backend.

  • Data_ErrorDescription - Description of the error if the sign in failed.

  • Data_FeatureName - Name of this activity: Interactive Sign In.

  • HasUserHint - A flag indicating whether User Principal Name is prefilled.

  • MSASignUp - A flag indicating whether we'll create a new MSA account or not.

  • ProfileAction - A flag indicating whether a new profile was created or not.

  • Result - A fixed value indicating Succeeded/Cancelled/Failed.

  • RunRemediation - A string indicating the providerId for enterprise accounts.

  • SignInContext - A number indicating the reason to show the Sign In flow; for example, First Run Experience, Adding a Connected Service, Open a document from URL, etc.

  • SignInFlowType - A number indicating whether this is an enterprise or consumer account.

  • Status - A number indicating the type of error status when failed.

  • SubStatus - A number indicating error code when failed.

Office.Manageability.Service.ApplyPolicy

Critical telemetry to track failure\Success of applying cloud policy settings to registry. LastError tells why and where the Application of policy in registry failed.

The following fields are collected:

  • Data.ApplyLogMsg - The exception msg if any while policy was being applied

  • Data.Cid - dynamically generated correlation identifier sent to the service when the service call was made to fetch the cloud policy. Used to correlate which call caused an issue while applying the policies on the cloud.

  • Data.Last Error - One of five string values (enumerators) to log which stage of policy application was being executed when the exception occurred

Office.OfficeMobile.PdfViewer.PdfFileOpenMeasurements (on Android)

This event is collected for the Office app for Android. It records when a file open operation takes place. We collect this data to ensure good performance for all file opens on the app.

The following fields are collected:

  • BootRearchFeatureGateFlag - Number (of data type Long) representing the state of Feature Gates that are enabled in a given session.

  • CorrelationId - The unique ID for each file open operation.

  • Data_ActivityTransitionEndTimeSA - Time taken until the end of ActivityTransition boot substage since activation.

  • Data_ActivityTransitionStartTimeSA - Time taken until the start of ActivityTransition boot substage since activation.

  • Data_ActivityTransitionTime - Time taken in the ActivityTransition boot substage.

  • Data_AppActivationEndTimeSA - Time taken until the end of AppActivation boot substage since activation.

  • Data_AppActivationStartTimeSA - Time taken until the start of AppActivation boot substage since activation.

  • Data_AppActivationTimeInMs - The time taken in the AppActivation boot substage.

  • Data_AppBootAction - Describes general action to be performed using the PDF intent, such as ACTION_VIEW. The action describes the general way the rest of the information in the intent should be interpreted.

  • Data_AppBootComponentCheckResult - Result of component name check on the pdf intent.

  • Data_AppBootComponentName - Denotes the class name of the concrete component associated with the intent.

  • Data_AppBootFileExtensionComparisionResult - Denotes the comparison result of the intent's component names. Values included are of type long, which translate to - matching extension, no extension, exception etc.

  • Data_AppBootFileMimeType - Mime type of the file.

  • Data_AppBootFileScheme - Denotes the scheme portion of the intent's data.

  • Data_AppBootFileTentativeExtension - Enum denotes tentative file extension as evaluated from intent.

  • Data_AppBootFileTentativeExtensionComparisionResult - Denotes the comparison result of the intent's component names. Values included are of type long, which translate to - matching extension, no extension, exception etc.

  • Data_AppBootIntentMimeType - The mime type of the external file intent.

  • Data_AppBootOldIntentParserResult - Denotes the parser result of the PDF intent. Values include whether it's matching, not matching etc.

  • Data_AppBootPathType - Type of app boot when user is opening the file. Whether it was organic launch using app launcher, or inorganic launch by directly doing a file activation.

  • Data_ApplicationObjectInitDuration - Time taken (milliseconds) to initialize the application object.

  • Data_CommonLibrariesLoadEndEndTimeSA - Time taken until the end of CommonLibrariesLoadEnd boot substage since activation.

  • Data_CommonLibrariesLoadEndStartTimeSA - Time taken until the start of CommonLibrariesLoadStart boot substage since activation.

  • Data_CommonLibrariesLoadEndTimeSA - Time taken until the end of CommonLibrariesLoad boot substage since activation.

  • Data_CommonLibrariesLoadStartEndTimeSA - Time taken until the end of CommonLibrariesLoadStart boot substage since activation.

  • Data_CommonLibrariesLoadStartStartTimeSA - Time taken until the start of CommonLibrariesLoadEnd boot substage since activation.

  • Data_CommonLibrariesLoadStartTimeSA - Time taken until the start of CommonLibrariesLoadEnd boot substage since activation.

  • Data_CommonLibraryLoadPhaseTime - Time taken to load the common libraries.

  • Data_ControlItemCreationTimeSA - Captures the time at which PDF control item object is created since file open intent was received.

  • Data_Doc_ActivationFQDN - Domain name of the Provider app for a file activation scenario (only first party app info is being logged).

  • Data_Doc_DownloadDurationms - Time to download a PDF cloud file.

  • Data_Doc_Location - Location where the file sits (Local, ODSP, iCloud, third-party files app, wopi

  • Data_Doc_OpenDurationms - Time to open a PDF file in milliseconds.

  • Data_Doc_OpenFromOMDurationMs - Total time taken to open a PDF file in Office mobile.

  • Data_Doc_PasswordProtected - Denotes whether the file is password protected or not.

  • Data_DownloadCacheStateAndStage - Denotes the cache status and fetch stage of files when file result is returned to consumers from cache from file manager layer. Values like cache hit if it's found in local cache, cache miss if not found etc.

  • Data_ExtractionTime - Time taken to extract the packaged assets like fonts on start of the app.

  • Data_FetchReason – Denotes how the file was fetched (manual, cached, not cached)

  • Data_FileActivationTime - Timestamp of the time when the file activation was started.

  • Data_FileFetchEndTimeSA - Time taken for fetching file details from storage location.

  • Data_FileFetchStartTimeSA - Time taken to start fetching the file details since activation was started.

  • Data_FileOpenEntryPoint - Integer denoting Entry point of the file from where it's opened - whether it's an external file open, or opened internally from the app like home screen, search page etc.

  • Data_FileParsingEndTimeSA - Time taken to start rendering the file on screen since activation was started.

  • Data_FRECompletedBeforeActivation - Boolean denoting if all the FRE screens are shown before file activation.

  • Data_FreCompletionDurationSinceActivationMs - Time taken to complete first user experience since activation was started.

  • Data_IntunePolicyAppliedBeforeRenderComplete - Boolean denoting if intune policies are applied.

  • Data_IntunePolicyInvokeTimeSA - Time taken to invoke intune policy since activation was started.

  • Data_IsAppUpgradeInBackground - Boolean denoting if app is upgraded in the Current Boot due to extraction from background process.

  • Data_IsAppUpgradeSession - Boolean denoting if given session is the first session after user has upgraded the app.

  • Data_isDuplicateIntent - Denotes if app has received the same intent twice.

  • Data_IsFastFileActivationEnabled - Boolean denoting if fast file activation flow is enabled or not.

  • Data_IsFastFileActivationTelemetryEnabled - Boolean denoting if fast file activation flow's telemetry is enabled or not.

  • Data_IsHomeScreenUpgradeSession - Denotes whether Office mobile home screen was shown or not, or home screen was upgraded or not in current file open session.

  • Data_IsIntuneManaged - Boolean denoting if file is an intune managed or not (true/false).

  • Data_IsPdfDetectedUsingCompName - Boolean denoting if current intent can be handled by new boot infra based on component name.

  • Data_IsPdfDetectedUsingNewBootInfraLogic - Boolean denoting if incoming intent is identified as a PDF file.

  • Data_IsPdfDetectedUsingNewBootInfraLogicMetaData - Collects metadata about how code detects the file open as pdf file open.

  • Data_IsPriorityCoroutineEnabled - Boolean denoting if priority coroutine fetauregate is enabled or not.

  • Data_isSameFileOpened - Denotes if in external pdf file open the same file is opened again.

  • Data_LibrarySharingEndTimeSA - Time taken for library sharing process to complete since activation.

  • Data_LibrarySharingStartTimeSA - Time taken for library sharing process to start since activation.

  • Data_MinimumLibrariesLoadEndTimeSA - Time taken for minimum library loading process to complete since activation.

  • Data_MinimumLibrariesLoadStartEndTimeSA - Time taken for minimum library start-loading process to complete since activation.

  • Data_MinimumLibrariesLoadStartStartTimeSA - Time taken for minimum library start-loading process to start since activation.

  • Data_MinimumLibrariesLoadStartTimeSA - Time taken for minimum library loading process to start since activation.

  • Data_MinimumLibraryLoadPhaseTime - Time taken to load minimum libraries.

  • Data_NativeLibLoadTime - Time taken to load native libraries.

  • Data_OfficeActivityEndTimeSA - Time taken to complete launch of OfficeActivity after intent processing since app boot.

  • Data_OfficeActivityStartTimeSA - Time taken to start launch of OfficeActivity after intent processing since app boot.

  • Data_OfficeActivityTime - Time taken in OfficeActivity launch after intent processing since app boot.

  • Data_OmActivityCreationTime - Time taken for shell activity creation time since app boot.

  • Data_OmAppActivationTasksEndTimeForFileOpenSA - Time taken for completion of shell activity specific post activation tasks since app boot.

  • Data_OmAppActivationTasksStartTimeForFileOpenSA - Time taken for start of shell activity specific post activation task since app boot.

  • Data_OMAsyncInitOfficeAssetManagerInitiateTimeSA - Time taken for Asset Manager initialization to trigger since activation.

  • Data_OMAsyncInitOfficeAssetManagerPostExecuteEndTimeSA - Time taken for Asset Manager Post-execute phase to complete since activation.

  • Data_OMAsyncInitOfficeAssetManagerPostExecuteStartTimeSA - Time taken for Asset Manager Post-execute phase to start since activation.

  • Data_OMAsyncInitOfficeAssetManagerPreExecuteEndTimeSA - Time taken for Asset Manager Pre-execute phase to complete since activation.

  • Data_OMAsyncInitOfficeAssetManagerPreExecuteStartTimeSA - Time taken for Asset Manager Pre-execute phase to start since activation.

  • Data_OmDeferredLoadingTasksEndTimeSA - Time taken to complete deferred task in shell activity since app boot.

  • Data_OmDeferredLoadingTasksStartTimeSA - Time taken to start deferred task in shell activity since app boot.

  • Data_OMDeferredTasksEndTimeSA - Time taken for deferred tasks to complete since activation.

  • Data_OMDeferredTasksStartTimeSA - Time taken for deferred tasks to start since activation.

  • Data_OMDownloadResourcesEndTimeSA - Time taken for UI Resources download to complete since activation.

  • Data_OMDownloadResourcesStartTimeSA - Time taken for UI Resources download to start since activation.

  • Data_OMInitializeOfficeAssetManagerEndTimeSA - Time taken for AssetManager initialization to end since activation

  • Data_OMInitializeOfficeAssetManagerStartTimeSA - Time taken for AssetManager initialization to start since activation.

  • Data_OMNewIntentTime - Timestamp when last intent was received.

  • Data_OMPostAppActivateEndTimeSA - Time taken to end setup in shell activity post app activation since app boot.

  • Data_OMPostAppActivateStartTimeSA - Time taken to start setup in shell activity post app activation since app boot.

  • Data_OMPostAppInitEndTimeSA - Time taken to complete setup in shell activity post native libraries initialization since app boot.

  • Data_OMPostAppInitStartTimeSA - Time taken to start setup in shell activity post native libraries initialization since app boot.

  • Data_OMStartHandlingIntendedIntentEndTimeSA - Time taken to start handling launched intent since app boot.

  • Data_pdfActivationDetectionFuncExceptionInfo - Java class name of any exception received while evaluating external intent.

  • Data_pdfActivationDetectionFuncTimeTaken - Time taken by the function to detect if the activation was a pdf activation.

  • Data_pdfActivationDetectionFuncTimeTaken - Time taken to compute whether the incoming intent is a PDF file activation intent.

  • Data_PdfActivityCreationTimeSA - Time taken for Pdf activity creation since app boot.

  • Data_PdfActivityOnCreateTimeSA - Time taken for Pdf creation life cycle event invocation since app boot.

  • Data_PdfIntentStartTimeSA - Time taken for Shell activity to launch pdf activity since app boot.

  • Data_PostAppInitEndTimeSA - Time taken to complete setup in base activity post native libraries initialization since app boot.

  • Data_PostAppInitStartTimeSA -Time taken to start setup in base activity post native libraries initialization since app boot.

  • Data_PostAppInitTimeInMs - Time taken by post app initialization since pre-app initialization.

  • Data_PostCommonLibraryLoadPhaseTime - Time taken by bootApp completion since common library load completes.

  • Data_PostOfficeActivityTimeInMs - Time taken between pre app init start and officeactivity ends.

  • Data_PreAppInitEndTimeSA - Time stamp of pre app initialization end in the app boot.

  • Data_PreAppInitStartTimeSA - Time stamp of pre app initialization start in the app boot.

  • Data_PreAppInitTimeInMs - Time duration taken by preappinitialization of the app start.

  • Data_PreCommonLibraryLoadPhaseTime - Time taken between minimum library load completes and common library load completes.

  • Data_PreProcessingEndTimeSA - Time duration between processing end and file activation completion.

  • Data_PreProcessingStartSA - Time taken by processing starts since file activation ends.

  • Data_TotalLockDurationDuringMinLibLoad - Total time taken by lock during minimum library loading.

  • Data_TotalLockDurationDuringNativeLibLoad - Total time taken by lock during library loading

  • Data_VMInitAfterFetchTimeSA - Time taken by ViewModel initialization after file is fetched.

  • Data_VMInitBeforeFetchTimeSA - Time taken by ViewModel initialization before file is fetched.

  • Doc_RenderDurationms - Time to render a pdf file

  • IsMIPProtected - Boolean indicating whether file is MIP (Microsoft Information Protection) encrypted or not.

  • MIPEnryptionHandlerInitTime - The field indicating time to initialize the MIP (Microsoft Information Protection) encryption handler.

  • MIPFirstBlockDecryptionTime - The field indicating time to decrypt the first block of file.

  • MipFirstPageRenderCompletionTS - Timestamp at which first page render is completed.

  • Result - The result of file open. It can be either success, failure and canceled.

Office.OfficeMobile.PdfViewer.PdfFileOpenMeasurements (on iOS)

This event is collected for the Office app for iOS. It records when a file open operation takes place. We collect this data to ensure good performance for all file opens on the app.

The following fields are collected:

  • Data_Doc_ActivationFQDN - Domain name of the Provider app for a file activation scenario (only first party app info is being logged).

  • Data_Doc_CreateTelemetryReason – Telemetry reason for PDF creation.(for example: Create from scan, using "picture to pdf" action, using "document to pdf" action, etc.)

  • Data_Doc_DownloadDurationms - Time to download a PDF cloud file.

  • Data_Doc_DownloadEndTime - Timestamp for end of download of a cloud file.

  • Data_Doc_DownloadStartTime – Timestamp for start of download of a cloud file.

  • Data_Doc_FileOpSessionID - Unique ID for a Document Session.

  • Data_Doc_Location - Location where the file sits (Local, ODSP, iCloud, third-party files app, wopi

  • Data_Doc_OpenCompletionTime - Timestamp for end of open operation of a PDF file.

  • Data_Doc_OpenDurationms - Time to open a PDF file in milliseconds.

  • Data_Doc_OpenStartTime - Timestamp for start of open operation of a PDF file.

  • Data_Doc_TelemetryReason - Telemetry reason for the open event (for example: open from MRU or browse, File Activation, Protocol Activation, etc.).

  • Data_FetchReason – Denotes how the file was fetched (manual, cached, not cached)

  • Doc_RenderDurationms - Time to render a pdf file

Office.OneNote.Android.Sync.ProvisioningCompleted

[This event was previously named OneNote.Sync.ProvisioningCompleted.]

The critical signal used to ensure that after a user signs-into a OneNote Android App, notebooks are properly provisioned so that they can be easily accessed. This is used to ensure critical regression detection for OneNote app and service health.

The following fields are collected:

  • AppSuspendedDuringEvent - Returns Boolean to indicate if app was suspended during provisioning

  • NetworkConnection - The type of network connectivity of the device in use

  • NetworkDataExchange - Records the number of bytes exchanged during provisioning.

  • ServerType - Returns the type of the server offering the service

  • TimeTakenInMilliSeconds - Returns time taken to complete provisioning in millisecond

Office.OneNote.Android.Sync.ProvisioningError

The critical signal used to ensure that after a user signs-into a OneNote Android App, notebooks are properly provisioned so that they can be easily accessed. This is used to ensure critical regression detection for OneNote app and service health.

The following fields are collected:

  • AppSuspendedDuringEvent: Returns boolean to indicate if app was suspended during provisioning

  • ErrorCode – Returns the error code responsible for failure of provisioning

  • NetworkConnection: The type of network connectivity of the device in use

  • NetworkDataExchange - Records the number of bytes exchanged during provisioning.

  • ServerType: Returns the type of the server offering the service

  • TimeTakenInMilliSeconds: Returns time taken to complete provisioning in millisecond

Office.OneNote.Android.Sync.ProvisioningStarted

[This event was previously named OneNote.Sync.ProvisioningStarted.]

The critical signal used to ensure that after a user signs into a OneNote Android App, notebooks are properly provisioned so that they can be easily accessed. This is used to ensure critical regression detection for OneNote app and service health.

The following fields are collected:

  • NetworkConnection - The type of network connectivity of the device in use

  • ServerType - Returns the type of the server offering the service

Office.OneNote.System.BootDialogs.SafeBootDialogPending

The critical signal used to track when we decide to show user a safe boot dialog on next boot because we have been crashing on boot multiple times continuously. This is used to ensure critical regression detection for OneNote app and service health. If users are seeing the safe boot dialog, then we have a critical boot crash bug and this info will help us know how many users are facing this issue and how many users boot the app again to actually see the safe boot dialog vs how many don’t return.

The following fields are collected:

  • None

Office.Outlook.Desktop.BootPerfMetrics

Collects time taken to boot Outlook. The boot time of Outlook is actively monitored to detect and diagnose regressions. It's also used to diagnose customer escalations and improve boot performance over time.

The following fields are collected:

  • AddinElapsedTotal - Total time spent for loading add-ins

  • CredPromptCount – Number of credential prompts shown

  • ElapsedTotal - Total time spent for boot

  • IsLoggingEnabled - Is logging enabled

  • ShowChooseProfileDlg – Whether the Choose Profile Dialog was shown

  • ShowFirstRunDlg - is outlook launched for the first time

  • ShowIMAPSrchfldWarningDlg - Warnings in case we have an IMAP account with an ANSI PST

  • ShowNeedSupportDlg - Boot failure triggered support dialog

  • ShowSafeModeDlg - is the session opened in safe mode

  • ShowScanPstDlg - Store repair check displayed error message

Office.Outlook.Mac.BootPerf

Collects time taken to boot Outlook. The boot time of Outlook is actively monitored to detect and diagnose regressions. It's also used to diagnose customer escalations and improve boot performance over time.

The following fields are collected:

  • MacOLKBootPerfDuration - total time spent booting

  • MacOLKBootPerfID - identifier for the time spent booting

Office.Outlook.Mac.PerformanceUnresponsive

Used to identify user impacting issues in Outlook that may manifest as degraded performance.

The following fields are collected:

  • Duration - time elapsed of degraded performance

  • EventType - type of event experiencing degraded performance

Office.Performance.Boot

Collected when an Office application is booted. Includes whether the boot was initiated by opening a file or launching via the Start menu, whether this was the first boot of the application, how much memory the application is using, and whether there was any blocking UI shown to the user. Used to measure how fast Office applications boot and how much memory they use when they start, to ensure there's an acceptable user experience.

The following fields are collected:

  • ActivationKind - Whether the application was started by launching from the Start menu, by opening a file, or through OLE Automation.

  • BootToStart - Whether the user has chosen to show the start screen when this application starts.

  • ChildProcessCount – The number of child processes that have been launched by the application. (Windows only)

  • ColdBoot - Whether this is the first time the Office application ran after a system restart or application binary had to be loaded from disk. (macOS/iOS only)

  • DeviceModel - The model of the device. (macOS/iOS only)

  • DocAsyncOpenKind - When opening a document, an enumeration indicating the type of asynchronous flow used.

  • DocLocation - When opening a document, indicates which service provided the document (OneDrive, File Server, SharePoint, etc.).

  • DocSizeInBytes - When opening a document, the file size in bytes.

  • DocSyncBackedType - When opening a document, an indicator as to the type of document (local or service based)

  • DurationPreloaded - Duration spent in boot activity as part of preloading.

  • DurationPreloadedAppBootTime - Boot time of a preloaded app.

  • DurationPreloading - The duration in microseconds from when the process was created by the operating system to when preloading completes and the app sits and waits for activation by the user.

  • DurationPreloadingActivation - The duration in microseconds from when the user activates a preloaded app to when the boot activity completes.

  • DurationPreloadingWaitLoop - The duration in microseconds that the app sits waiting for activation by the user after preloading.

  • DurationProcessCreationAfterReboot - Duration elapsed in creating Word process after reboot the machine.

  • DurationResumed - Duration spent in boot activity as part of resume (after activation).

  • DurationSecondaryHandOff - The time taken by the secondary instance of the app to complete the handoff to the preloaded primary instance.

  • DurationUntilMso20Initialization - The duration in microseconds it took between when the Office process was initialized and mso20win32client.dll was loaded.

  • Embedding – Whether the app was opened for OLE embedding.

  • FirstBoot - Whether this was a first boot of the application.

  • FreeMemoryPercentage – What percent of memory on the device is free. (Windows only)

  • HandleCount – The number of operating system handles the process has opened. (Windows only)

  • HardFaultCount – The number of hard page faults for the process. (Windows only)

  • IdentityBackgroundDuration - The amount of time authentication initialization took in the background.

  • IdentityMainThreadDuration - The amount of time authentication initialization took on the main thread.

  • InitializationDuration - The duration in microseconds it took to first initialize the Office process.

  • InterruptionMessageId - If the boot was interrupted by a dialog asking for user input, the ID of the dialog.

  • IsPreloaded - Indicates whether session is preloaded.

  • LegacyDuration - The length of time the activity took to execute, measured using different starting and ending points than Activity.Duration.

  • LoadAccountsDuration - The amount of time it took to load the accounts that are signed into Office.

  • OneAuthConfigCached - Whether the configuration data for the new authentication stack was previously cached.

  • OneAuthStackUsed - Whether the new authentication stack is being used.

  • OpenAsNew – Whether the app was started by opening an existing document as the template for a new one.

  • OtherOperationCount – The number of I/O operations performed, other than read and write operations. (Windows only)

  • OtherTransferCount – The number of bytes transferred during operations other than read and write operations. (Windows only)

  • PageFaultCount – The number of page faults for the process. (Windows only)

  • PreloadingResult - Succeeded if a preloaded app eventually was booted by the user. A failure reason otherwise.

  • PreloadingWorkingSetMB - The amount of memory in the process's working set during the preloading and wait phase.

  • PrimaryDiskType – Whether the primary storage device is a solid-state drive or a rotational drive and its rotation speed if applicable. (macOS/iOS only)

  • PrivateCommitUsageMB – The Commit Charge (for example, the amount of memory that the memory manager has committed for this process) in megabytes for this process. (Windows only)

  • PrivateCommitUsagePeakMB - The largest Commit Charge in megabytes ever for this process. (Windows only)

  • PrivateWorkingSetMB – The amount of memory in megabytes in the process’s working set that isn’t shared with other processes. (Windows only)

  • ProcessorCount – The number of processors on the device. (macOS/iOS only)

  • ReadOperationCount – The number of read operations performed. (Windows only)

  • ReadTransferCount – The number of bytes read.

  • TotalPhysicalMemory – The total amount of physical memory on the device. (macOS/iOS only)

  • TotalWorkingSetMB - The amount of memory in megabytes in the process's working set.

  • VirtualSetMB - The amount of memory in megabytes in the process's virtual set. (macOS/iOS only)

  • WorkingSetPeakMB - The largest amount of memory in megabytes that was ever in the process's working set so far.

  • WriteOperationCount – The number of write operations performed. (Windows only)

  • WriteTransferCount – The number of bytes written. (Windows only)

Office.Performance.OPerfMon.HangDetected

Collected when an Office application experiences a hang of the user interface. The collected data is used to assess prevalence, impact, and assist in root cause analysis of hangs experienced by customers so that they can be addressed by the product team.

The following fields are collected:

  • DurationMs - duration of the hang in milliseconds.

  • Modules - list of Microsoft owned DLLs and memory address locations loaded into the Office application.

  • ProcessName - name of the Office application executable the hang occurred in. For example, excel.exe.

  • Stacks - list of call stacks (frame addresses) and associated CPU and Wait durations that were observed to be running at the point the hang occurred.

Office.Performance.OPerfMon.Profile

Collected when an Office application experiences unexpectedly poor performance in a critical end user feature, resulting in a poor user experience and/or hang of the user interface. The collected data is used to assess prevalence, impact, and assist in root cause analysis of hangs or poor performance experienced by customers so that they can be addressed by the product team.

The following fields are collected:

  • ActivityName - additional context data related to the problematic feature. Name of the feature or user activity that exhibited the performance issue.

  • DurationMs - duration of the hang in milliseconds.

  • InsightId - Unique identifier (GUID) generated on creation of this event payload.

  • Modules - list of Microsoft owned DLLs and memory address locations loaded into the Office application.

  • ProcessName - name of the Office application executable the issue occurred in. For example, excel.exe.

  • SourceSessionId - Office SessionId the issue occurred in.

  • Stacks - list of call stacks (frame addresses) and associated CPU and Wait durations that were observed during the execution of the feature experiencing the poor performance.

  • TypeId - Internal identifier specifying the type of performance issue identified (for example, UI Hang, Slow Performance)

Office.Performance.OPerfMon.SessionDelays

The event is triggered when the user closes an Office application. The collected data is used to assess the general user interface responsiveness health for the session including the number of minutes the user interacted with the product, and the recorded delay in keyboard and mouse input experienced by the user.

The following fields are collected:

  • DurationMs - total duration of user experienced delay, in milliseconds

  • InteractiveMinutes - total number of minutes the user interacted with the product

  • InvasiveDelayCount - total number of distinct delays the user experienced that were deemed to be invasive to their product usage experience.

  • SourceAppName - name of the application the session relates to

  • SourceSessionId - Office session ID of the session being reported

Office.PowerPoint.PPT.Android.RehearseView

This event is denoting that user has stopped the rehearsal session. In combination with Office.PowerPoint.PPT.Android.RehearseView.StartSession this will be the first indicator of any crashes or errors that user faces.

The following fields are collected:

  • ConnectionCreationTime - time taken to create service side connections.

  • CountDownAlertTime – Time for which countdown alert was displayed.

  • CountdownInitTime– Time between slideshow load completed and countdown started.

  • CritiqueSummary - Summary of what all critiques user saw with their counts.

  • ExitEventCode – Code to identify under which scenario user exit out of rehearse session, whether it was error scenario or successful exit.

  • FRETime - Time between FRE screen started to display until user dismissed it.

  • MicrophonePermissionTime - Time for which microphone permission alert was displayed until user select one of the options.

  • PauseRehearsingCount – Count of how many times user clicked on pause rehearsal.

  • RehearsalInitTime - Time taken by rehearsal to initialize.

  • ResumeRehearsingCount – Count of how many times user clicked on resume rehearsal.

  • Sessionid - This is speech frontdoor session ID. This is used to debug service logs.

  • SlideshowViewLoadTime – Time taken by slideshow to load.

Office.PowerPoint.PPT.Android.RehearseView.RehearsalSummaryPage

Event triggered when summary page is loaded. This event helps us in capturing the performance of summary page. It tells how much time it takes for rehearsal summary service page to load on client. It's required to keep the feature performant.

The following fields are collected:

  • PayloadCreationTime – This is the time taken in milliseconds to create payload.

  • PostUrlCallTime – This is the time taken in milliseconds to send the post Url call.

  • RehearseSessionid - This is speech frontdoor session ID. We can use this to debug service logs.

  • RequestPayloadSize – This is the size of the request payload.

  • ResourcesLoadTime – This is the time taken in milliseconds to load resources (js, css).

  • SummaryPageErrorReceived – This is a Boolean value that indicates if summary page was received or error occurred.

  • SummaryPageHtmlLoadTime – This is the time taken in milliseconds to load summarypageHtml.

  • SummaryPageLoadStartTime – This is the time taken in milliseconds receive first response from the server.

  • SummaryPageLoadTime – Time (in ms) taken to load summary page. This includes payload creation time

  • ThumbnailsCount – This is the total number of thumbnails that will be part of summary page.

Office.PowerPoint.PPT.Android.RehearseView.StartSession

Event triggered when user clicks on start session. This event helps us in capturing how many users are using the feature of Presenter coach on Android. When combined with Office.PowerPoint.PPT.Android.RehearseView it will tell us how many users successfully completed the rehearsal session and how many couldn’t. This is our first indicator of crashes or errors in the feature.

The following fields are collected:

  • None

Office.PowerPoint.PPT.Shared.RehearseView.Errors

[This event was previously named Office.PowerPoint.PPT.Android.RehearseView.Errors]

Event triggered when any error occurs. This event helps us know what errors that user has faced and will help keep the Presenter Coach performant on mobile.

The following fields are collected:

  • Session ID – rehearsal session ID

  • RehearsalEventCode – rehearsal error code

Office.PowerPoint.Rehearsal.SessionMetrics

Event triggered when the speech session is stopped for Presenter Coach. This event helps us in capturing some metrics for a rehearsal session in Presenter Coach. It helps in maintaining a high quality of service for this feature.

The following fields are collected:

  • ActualRehearseBootTimeInMs – This is the actual time taken for the connections to be created.

  • AdaptationTextSize – This is the size of the text that is sent to service.

  • AuthDurationInMs – This is the time taken in milliseconds for authentication (refresh the auth token).

  • AuthError – This describes the authentication error that occurred (if at all).

  • AvgFragmentLatencyInMs – This is the average round-trip time for network speech messages.

  • ConnectDurationInMs – This is the time taken in milliseconds for the session to complete the connection.

  • FirstAudioDelayInMs – This is the time taken in milliseconds for the first audio data to be received.

  • FRetriedOnOpenConnection – This is a Boolean that indicates whether retry happens for openconnection or not.

  • InitMediaCaptureLayerDurationInMs – This is the time taken in milliseconds to initialize the media/audio capture layer.

  • LocallyDroppedMessageCount – This is the total number of messages dropped locally.

  • NumReconnectAttemptsDuringSession – This indicates how many times the attempt was made to reconnect to speechservice.

  • NumTriesDuringEachReconnectAttempt – This is an array that indicates number of tries that were done during each reconnect attempt.

  • OpenFrontDoorConnectionDurationInMs – This is the time in milliseconds taken to open the connection to the FrontDoor service.

  • SendAdaptationTextDurationInMs – This is the time taken in milliseconds to send the adaptation text to the service.

  • ServiceDroppedMessageCount – This is the total number of messages dropped by the service.

  • SessionDurationInMs – This is the time duration of entire session from when user clicked start to when user clicked stop.

  • SessionId – This is the speech frontdoor session ID. We can use this to debug service logs.

  • SpeechClientResultEventsWithTimestamps – This is an array of error codes received along with the timestamps, which can help in debugging.

  • SpeechHResultsWithTimestamps – This is an array of error codes received along with the timestamps, which can help in debugging.

  • StartSpeechCaptureDurationInMs – This is the time taken in milliseconds to start speech capture.

  • StartSpeechServiceDurationInMs – This is an array of time taken to start speech session every time there's a reconnect, including first start speech session duration also.

  • TotalMessageCount – This is the total number of audio messages sent to the service.

  • WebSocketConnectDurationInMs – This is the time taken in milliseconds to complete the web socket connection.

Office.StickyNotes.Web.SDK.BootPerfMarkers

Triggered when both of the below conditions are true:

  • First sync is done
  • OneNote Sticky Notes boot has completed. OneNote Sticky Notes boot is said to be done when the one of the below four conditions is true:
    • Initial sync has completed
    • Initial sync has failed
    • Something is being displayed in notes list (either notes or fishbowl)
    • Something is being displayed in any note editor window

Performance markers for OneNote Sticky Notes (machine action) are required to compute the performance of OneNote Sticky Notes.

The following fields are collected:

  • Consent_AddInContentSourceLocation - Add In content source location 

  • Consent_AddInContentState - Add In content state 

  • Consent_ControllerConnectedServicesConsentTime - Indicates when the user chose the status of optional connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DiagnosticDataConsentTime - Indicates when the user provided the consent for diagnostic data. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DownloadContentConsentTime - Indicates when the user made the choice to enable or disable connected experiences that download online content. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_UserContentDependentConsentTime - Indicates when the user chose to enable or disable connected experiences that analyze content was made. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Data_App_Name - The name of the application that is providing the data. Allows us to identify which application is showing an issue so we know how to address it.

  • Data_App_Platform - The broad classification of the platform on which the app is running. Allows us to identify on which platforms an issue may be occurring so that we can correctly prioritize the issue.

  • Data_App_Version - The version of the application. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

  • Data_Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • Data_Device_Id - A unique identifier for the device. Allows us to identify the distribution of issues across a set of devices.

  • Data_EventName - A unique name of a OneNote's event. OneNote events use this custom field to specify a unique name due to an engineering limitation in the past.

  • Data_ExpirationDate - A date in numerical format indicates when this event will be stop sending from clients

  • Data_FeedEnabled - Identifies if feed is enabled. 

  • Data_HostApp - Identifies the host app name that launches a sub-app. 

  • Data_HostSessionId - Uniquely identifies the host app session for a sub-app 

  • Data_MemoryLoadPerfMetrics - perf markers for OneNote Sticky Notes.

  • Data_Namespace - A namespace of the event. Allows us to group the event into groups.

  • Data_OTelJS_Version - Version of OTel logger 

  • Data_SamplePolicy - Identifies if the sample policy is Measure or Critical  

  • Data_Session_Id - Uniquely identifies a given session of data. Allows us to identify the impact of issues by evaluating the number of sessions that are impacted and if there are common features of those sessions.

  • Data_SessionCorrelationId - The globally unique identifier for the host's session.

  • Data_ShortEventName - A short name of an event. Allows us to identify the event that was being sent from the client. 

  • Data_StickyNotesSDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it. 

  • Event_ReceivedTime - The time the event was logged in the service 

  • M365aInfo_EnrolledTenantId - Enrolled tenant ID 

  • User_ActiveUserTenantId - Active user tenant ID 

  • User_TelemetryRegion - Identifies the data boundary of the user 

Office.Taos.Hub.Windows.AppInstance

This event is triggered automatically on boot to record the performance of certain operations of the Office desktop application. This is used to measure/watch the performance of certain operations in the Office desktop application.

The following fields are collected:

  • AppInfo_Id - The App ID.

  • AppInfo_Version - Office desktop app version.

  • AppType - The type of the container, from which logs are emitted.

  • BridgeInstanceId - A unique ID given to the Office Windows app instance, used to corelate all the events from a single app session. We can't derive any PII from this ID.

  • DeviceInfo_Id - A unique device ID calculated by 1DS SDK.

  • DeviceInfo_Make - The device make.

  • DeviceInfo_Model - The device model.

  • DeviceInfo_NetworkCost - Network cost type of the user (Unmetered, metered, etc.)

  • DeviceInfo_NetworkType - The type of network (Wi-Fi, Wired, Unknown).

  • DeviceInfo_OsName - OS name installed in the user's device.

  • DeviceInfo_OsVersion - The OS version installed in the user's device.

  • DeviceInfo_SDKUid - Unique identifier for the SDK.

  • EventInfo_BaseEventType - The event type.

  • EventInfo_BaseType - The type of the event.

  • EventInfo_Level - The event level.

  • EventInfo_Name - The name of the event.

  • EventInfo_PrivTags - The event tags.

  • EventInfo_Source - The source of the event. For example, OneCollector

  • EventInfo_SdkVersion - 1DS SDK Version.

  • EventInfo_Time - The time of the event.

  • Feature - The name of the feature.

  • M365aInfo_EnrolledTenantId - The Enrollment TenantID.

  • MultiInstance - A boolean representing whether multiple instances of the app is opened or not.

  • PerformanceMarkerName - The name of the performance marker.

  • PerformanceMarkerTimestamp - The Performance Timestamp.

  • PerformanceMarkerUrl - The URL of the current loaded Office web.

  • PipelineInfo_AccountId - Aria Pipeline account ID

  • PipelineInfo_ClientCountry - The device country or region (based on IP address).

  • PipelineInfo_ClientIp - The first three octets of the IP address.

  • PipelineInfo_IngestionTime - Ingestion time of the event.

  • UserInfo_TimeZone - Time zone of the user.

Office.UX.OfficeInsider.CanShowOfficeInsiderSlab

Activity tracking whether the Office Insider slab can be shown to the user on the Account tab in the Office Backstage UI.

The following fields are collected:

  • Data_CanShow - Indicates whether the Office Insider Slab can be shown to the user on the Account tab in the Office Backstage UI.

  • Data_Event - Unused

  • Data_EventInfo - Unused

  • Data_Reason - Unused

Office.UX.OfficeInsider.RegisterCurrentInsider

Critical signal for tracking success or failure of registering users using Office Insider builds who weren't registered as Office Insiders before. Main scenario for this is current Office Insiders who joined Office Insider program before registration of Office Insiders was added.

The following fields are collected:

  • Data_RegisterInsider - Status of Office Insider registration

  • Data_RegisterInsiderHr - Result code for Office Insider registration

  • Data_RegistrationStateCurrent - Current registration state

  • Data_RegistrationStateDesired - Requested registration state

Office.UX.OfficeInsider.ShowOfficeInsiderDlg

Critical signal tracking user interaction with Join Office Insider dialog. It's used for identifying any issues in performing user-initiated changes such as joining or leaving Office Insider program and changing Office Insider level.

The following fields are collected:

  • Data_AcceptedContactMeNew - Indicates if a user has accepted to be contacted by Microsoft upon joining Office Insider program

  • Data_InsiderLevel - Insider Level on opening of "Join Office Insider" dialog

  • Data_InsiderLevelNew - Insider level on closing of "Join Office Insider" dialog

  • Data_IsInternalUser - Indicates whether the application runs under the credentials of a Microsoft corporate account.

  • Data_IsInternalUserInit - Indicates whether the code could determine whether the application runs under the credentials of a Microsoft corporate account.

  • Data_OpenNewsletterWebpage - Indicates whether Office Insider Newsletter Subscription link was triggered under condition that user has joined Office Insider program, Newsletter Subscription feature is enabled, and the user haven't canceled opening of Office Insider Newsletter Subscription webpage.

  • Data_RegisterInsider - Status of Office Insider registration

  • Data_RegisterInsiderHr - Result code for Office Insider registration

  • Data_RegistrationStateCurrent - Current registration state

  • Data_RegistrationStateDesired - Requested registration state

Office.Visio.Shared.VisioFileRender

This event captures file render time. This event helps us keep file render performance in check.

The following fields are collected:

  • Data_AvgTime: integer - Average time it took to render Visio drawing in a session

  • Data_CompositeSurfEnabled: bool - true is composite rendering mode is enabled

  • Data_Count: integer - Number of times Visio renders the drawing in a session

  • Data_FirstRenderTime: long - duration to render file on first launch in millisecond

  • Data_MaxTime: integer - Max time it took to render Visio drawing in a session

Office.Visio.VisioFileOpenReliability

This event collects File open perf data for Visio Dev16. This event is used to monitor performance of File open and associates it with file properties like file size for Visio Dev16. File properties enable us to debug and root cause issues faster.

The following fields are collected:

  • Data_CorrelationId: string -Document correlation identifier

  • Data_DocIsEnterpriseProtected: bool - true if document is protected with Windows information protection

  • Data_DocumentId: string - GUID of file path

  • Data_DurationToCompleteInMilliseconds: double - Duration to complete save as in millisecond

  • Data_DurationToCompleteInMillisecondsSquared: double -squared value for DurationToCompleteInMilliseconds

  • Data_ErrorCode: integer - Internal error code for file open failure

  • Data_Extension_Docs: string - File extension of diagram opened

  • Data_FileIOBytesRead: int - total bytes read while saving

  • Data_FileIOBytesReadSquared: int - squared value of Data_FileIOBytesRead

  • Data_FileIOBytesWritten: int - total bytes written while saving

  • Data_FileIOBytesWrittenSquared: int - squared value of Data_FileIOBytesWritten

  • Data_FileName: binary - Binary Hash of file name

  • Data_FileOpenDownloadDurationInMs: long -duration to download file in milliseconds

  • Data_FileOpenEndDurationInMs: long: -duration to open file in millisecond

  • Data_FileOpenTimeStamp: time: -Time stamp when file started opening

  • Data_FilePathHash: binary - GUID for file path

  • Data_FileSize: long - Document size in bytes

  • Data_FileType: string - File extension of diagram opened

  • Data_IsInternalFile: bool - true if file is an internal file. for example, Stencil

  • Data_IsIRM: bool - true if file is Information Right Protected

  • Data_IsReadOnly: bool - true if the file is read only

  • Data_IsSuccess: bool - true when file open was successful

  • Data_Location: string - location of the file like Local, SharePoint, OneDrive, WopiConsumer, WopiBusiness, GenericThirdPartyConsumer

  • Data_NetworkIOBytesRead: int - total network bytes read while saving

  • Data_NetworkIOBytesReadSquared: int - squared value of Data_NetworkIOBytesRead

  • Data_NetworkIOBytesWritten: int - total network bytes written while saving

  • Data_NetworkIOBytesWrittenSquared: int - squared value of NetworkIOBytesWritten

  • Data_OpenLocation: integer - Location of the file from which it was opened 0, Local, 1, Network, 2, SharePoint, 3 – Web

  • Data_Size_Docs: integer - Document size in bytes

  • Data_Tag: string - unique identifier to identify Save AS event

  • Data_WasSuccessful: bool - true if open as was successful

OneNote.App.SafeBootDialogActionTaken, Office.OneNote.Android.SafeBootDialogActionTaken, Office.Android.EarlyTelemetry.SafeBootDialogActionTaken

The critical signal used to track user response when a safe boot dialog is shown. Safe boot dialog is shown when we were unable to launch repeatedly. This is used to ensure critical regression detection for OneNote app and service health. User sees when they encounter critical boot crash bug. This info helps track if the crash cause has been resolved and the user can launch the app successfully.

The following fields are collected:

  • DIALOG_ACTION - Which dialog button did the user click on – Positive button or negative button

perf.event

The event is triggered when the user takes action to open conversations, events, or otherwise navigate in the app. Used for monitoring possible negative impact on performance of loading different parts of the app, for example to ensure when you first open the app, your inbox loads as quickly as possible.

The following fields are collected:

  • allSplits - start/end/label name of executed code blocks

  • app_start_show_message_list - that means there was a performance issue with the app start-up causing your inbox message list to take a long time to load

  • average - collects the number of reloads that happen on a conversation divided by the number of messages in that conversation.

  • batched_is_main_thread - Tells us whether the event happened on the main thread. Similar to is_main_thread, except batched_is_main_thread is sending data for multiple instances.

  • batched_is_treatment - Whether the current perf event is generated in a treatment flight, it's used when we measure and compare the performance data for control group and treatment group in a flight. Similar to is_treatment, except batched_is_treatment is sending data for multiple instances.

  • batched_time_elapsed - Tells us how long the performance event took to help us understand the severity of the performance issue. Similar to total_time_elapsed, except batched_time_elapsed is sending data for multiple instances.

  • batched_time_elapsed_average - Tells us the average amount of time the performance event took over all the instances in the batched_time_elasped field.

  • build_type - Helps us know the build type of the app. For example: release, debug.

  • event_type - tells us the type of performance event that caused a performance issue to help us detect issues related to a specific type.

  • extra_params - A developer can add additional parameters here to help give us more details about what could be causing this performance issue, that is, when did this action start and end, etc.

  • firstFrameSummary - information about how long it takes screens to start up

  • folder_number - The number of folders we have processed to display the folder hierarchy

  • has_work_profile - indicates whether the app is running under Android Work Profile or similar configuration, in order to correlate performance analysis to these environments.

  • is_treatment - whether the current perf event is generated in a treatment flight. It's used when we measure and compare the performance data for control group and treatment group in a flight.

  • memorySummary - information about amount of memory used

  • profiling_summary - provides performance information to help understand potential regressions

  • profilingBufferStats - information about the health of the internal profiler

  • runtime_performance_monitoring_data - provides the performance data (loading time, record count) when loading data in different parts of the app.

    • average_cost_time_ns - The average cost time measured in nanoseconds.
    • cost_type - Tells us whether this event is for measuring storage layer execution or total duration.
    • hx_object_type - Provides the detail programming object type of the measuring.
    • is_main_thread - Tells us whether this event only measures main thread execution time.
    • record_count - The number of records the underlying storage layer returns.
    • scope_name - Provides the name of UI page/components this event belongs to.
    • total_cost_time_ns - The total execution time measured in nanoseconds.
  • scenario - The scenario the user was in when this event was triggered

  • stage_durations - Split stage durations that can aid in the investigation of data anomalies

  • standard_probe_label - Provides the information of the sub steps of each user scenario when instrumented with Standard Probe. It helps us reduce the scope of the issue.

  • threadsSummary - information about number of threads used and their runtime state. For example, waiting, blocked, etc.

  • total_time_elapsed - Tells us how long the performance event took to help us understand the severity of the performance issue

  • version - the version of the scenario that triggered the event.

performance.record

This event collects performance metrics of the app. This allows us to detect and fix situations where the app memory usage and CPU usage becomes critically high or has other performance issues, which could cause your device to slow down.

The following fields are collected:

  • app_exit_metric - Tell us the metrics about counts of different performance types of foreground and background app exits, to help us understand app exits unexpectedly with negative performance reasons.

  • average_suspended_memory - Tells us the average amount of memory in use by the app when it’s suspended so we have something to compare, to help us understand the negative performance impact.

  • category - Tells us if the app is in the foreground or background at the time. Possible values include foreground and background.

  • cpu_usage - Tells us how much CPU was used by the app so we have something to compare, to help us understand the negative performance impact

  • cumulative_CPU_time - Tells us the total amount of CPU the app used with the measurement of duration of time, so we have something to compare, to help us understand the negative performance impact.

  • cumulative_GPU_time - Tells us the total amount of GPU time used by the app, so we have something to compare, to help us understand the negative battery life impact.

  • is_watch_app_installed - Tells us if the user is currently using an Apple Watch and whether it's installed to help us understand the negative performance impact due to the Watch

  • is_watch_paired - Tells us if the user is currently using an Apple Watch and whether it's paired with the device to help us understand the negative performance impact due to the Watch

  • is_watch_supported_and_active - Tells us if the user is currently using an Apple Watch and whether it's active to help us understand the negative performance impact due to the Watch

  • memoAry_used_percentage - Tells us what percentage of memory was used by the app so we have something to compare, to help us understand the negative performance impact

  • memory_used - Tells us how much memory was used by the app so we have something to compare, to help us understand the negative performance impact

  • peak_memory_usage - Tells us the largest amount of memory used by the app so we have something to compare, to help us understand the negative performance impact.

  • scroll_hitch_time_ratio - Tells us the ratio of the time spent hitching while scrolling on UI, to help us understand the negative UI performance impact.

wkwebview.terminate

This event is triggered when the user opens a conversation with a number of messages, and they put the app into background process for a while and then activate the app. This event lets us know what number of webview terminated during rendering and composing.

The following fields are collected:

  • is_foreground - is app in foreground when this event happened

  • scenario - the scenario of webview termination occurred (rendering or composing)

  • termination_process - the process during email rendering (reuse/rendering/cleaning) when this event happened

  • webview_reuse_count - the number of webview reused times when this event happened

Application activity error subtype

Errors in functionality of a feature or user experience.

android.anr

This event is triggered when "Application not responding" (ANR) occurs, and is used to monitor ANRs in the app and try to solve them by stack trace and other information.

The following fields are collected:

  • anr_timestamp - The timestamp when ANR occurs.

  • is_background - Whether ANR occurs in background.

  • main_thread_stacktrace - Main thread's stack trace when ANR occurs.

  • main_thread_state - Main thread's state trace when ANR occurs.

  • main_thread_trimmed_stacktrace - string value of main thread's trimmed stack trace when ANR occurs.

  • reason - The reason why ANR occurs.

  • reason_raw - Raw string of the reason why ANR occurs.

  • type - ANR type. For example, input dispatching timed out.

assertion

This event lets us detect when critical app errors occurred that would cause your app to crash or experience serious issues like causing you to see empty rows in your inbox.

The following fields are collected:

  • count - Total number of items associated with the error; for example, number of calendars that have errors

  • has_hx - Tells us the account is using our new sync service to help us detect issues caused by our sync service

  • host_name - the name of the service host that was involved in the error to help us detect issues related to a specific host

  • host_type - the type of host that was involved in the error to help us detect issues related to a specific host type

  • message - custom message for the assertion that is used to diagnose the issue

  • origin - the origin of the error in the code to help us detect issues related to a certain part of the code

  • stacktrace - the stack trace where the assertion occurred to help us detect issues related to a certain part of the code

  • type - the type of assertion error that occurred, for example, null_folder_name, compose_selected_null_account, to help us detect issues related to a certain part of the code

edit.contact.error

Allows us to detect and fix situations where errors were caused when you're trying to view or edit contacts through our app.

The following fields are collected:

  • errorType - the type of error that occurred to help us diagnose the issue

  • field - The contact field that the user was trying to edit to help us diagnose the issue

  • version - The version of the contact card service we're using to help us diagnose the issue

error.report

This event lets us detect when critical app errors occurred so that we can prevent issues that could cause your app to crash or prevent you from reading email.

The following fields are collected:

  • client-request-id - the client request identifier for the request that caused the error

  • date - the datestamp of the request that caused the error

  • error - the type of error, for example, get_mailbox_location_failed

  • error_body - the body of the error message

  • is_x_mailbox_anchor_set - whether the X-AnchorMailbox property was set on the request

  • reason - the reason for the error, that is, an error message

  • request-id - the server request identifier for the request that caused the error

  • source - the source of the error within the OM infrastructure, typically one of 'BE' or 'FE'

hx.critical.error

If we encounter a critical error because of calling an internal API incorrectly, we'll send this event to record which API we called incorrectly and where we called it in the code. This event is used to determine if/where Outlook is calling internal APIs incorrectly.

The following fields are collected:

  • actor_id - The identifier for which internal API failed

  • critical_error_type - The type of error

  • hx_tag - The identifier for where the error occurred

Office.AirSpace.Backend.Win32.GraphicsDriverSoftHang

Helps Microsoft separate long video card driver hangs from short ones, which in turn helps make decisions about which video card drivers may be having problems. The user's video card driver has caused Office to hang, but the impact of the hang e known yet

The following fields are collected:

  • Data_InDeviceCall - The method called on the video card that produced the hang

  • Data_Timeout - How long the hang lasted

Office.Android.ADALSignInUIPrompts

This event denotes that sign-in prompt came to the user, for school or work account. This event helps in understanding the health of signed in state of our apps and take appropriate actions, when we notice unexpected sign-in re-prompts.

The following fields are collected:

  • LastLoginDelta - The time delta from last successful login.

  • PreviousIdentityCredProviderState - Indicates the state of the account.

  • PreviousIdentityState - Indicates state of the account, like session expired.

  • SignInResultCode - Indicates the result code of sign-in prompt end.

  • UseCache - Indicates if we force prompted the user to provide the password again.

  • UserType - Indicates whether it's existing account or new account

Office.Android.AndroidAppDocsFileOperationEnds

Critical Docs Android Only (AppDocs) telemetry data for File New/Open/SaveAs end operations. This captures error codes for failures of these AppDocsOperations. Microsoft uses this to identify failures in various file operations and the exact layer at which the failure has occurred in Word, Excel, or PowerPoint.

The following fields are collected:

  • AccessMode - enumeration value for the access mode for the file. Values- None, ReadOnly, ReadOnlyUpgradable, ReadWrite

  • BlockingUIShown - Boolean to indicate if blocking UI was shown in the flow anywhere.

  • ContentUriAuthority - the authority of the content URL from SAF

  • Correlation - GUID for the correlation ID related to the operation

  • DocId - the document ID generated by AppDocs

  • DocInstanceId - DocInstanceId the document instance ID generated by AppDocs that is scoped to an operation instance on a document

  • DocIsEnterpriseProtected - Boolean to indicate if document is protected.

  • DocUserId - user ID from the MS auth layer

  • DocUserIdProvider - enumeration that represents the user ID provider, 0 = Unkown, 1 = LiveId, 2 = OrgId, 3 = SSPI, 4 = ADAL

  • DurationInMs - time in millisecond for the file operation to end

  • EndReason - enumeration value for the end reason. Values - None, Success, Failure, Cancel

  • ErrorCode - error code for the file operation

  • Extension - extension of the file being opened.

  • FileSourceLocation - enumeration value for file location. Possible values: None, Local, UncOrMappedNetworkDrive, SkyDrive, App, SharePoint, UnknownServer

  • FILETIME - Time of the event

  • FirstBCSClientError_Info - Error code information related to file conversions

  • HttpStatusCode - http response code for web service request

  • InitalizationReason - entry point for file open

  • K2FileIOHresult - Hresult code for File open operation end

  • LastBCSClientError_TagId - last error of BCS (binary conversion service) client

  • OfficeWebServiceApiStatusFlag - status flag for the web service request

  • OpEndEventId - tag that represents where the operation actually ended

  • OpFlags - Document operation param flags used by AppDocs layer.

  • OpSeqNum - A number that represents the sequencing of file operation related calls in AppDocs layer

  • OpType - operation type enumeration. Values: "None", "CreateDocument", "OpenDocument", "CopyDocument", "CloseDocument", "SaveDocument", "OpenVersion", "CloseVersion"

  • PreFetchState - enumeration for prefetch state of templates for new file create operations.

  • ProviderApp - the package name of the app from which file is opened

  • ScopeInstanceId - Scope Instance ID used to join data context to activities

  • Size - file size

  • State - enumeration value for the state of the file. Values: None, Creating, Created, CreateFailed, Opening, Opened, OpenFailed, Copying, Copied, CopyFailed, Closing, Closed, CloseFail

  • TemplateName - the binary template name of the document template from the template service, for example, TF10002009.dotx

  • UriScheme - scheme of the URL

Office.Android.AndroidAuthError

This event denotes core authentication failures during silent token refresh, loading sign in page from service and so on. This event helps in understanding the health of signed in state of our apps, sign in attempts that are made, and take appropriate actions, when we notice unexpected failures.

The following fields are collected:

  • ADALErrorCode - Indicates error code while showing sign-in prompt or silent token fetch attempt for work account.

  • ADALRawErrorCode - Indicates raw error code while showing sign-in prompt or silent token fetch attempt for work account.

  • ErrorGroup - Indicates the type of account like personal account or work account or on-premises work account.

  • IDCRLErrorCode - Indicates error code while showing sign-in prompt for personal account.

  • IDCRLRawErrorCode - Indicates raw error code while showing sign-in prompt for personal account.

  • LiveOAuthErrorCode - Indicates error code during silent token refresh attempt for personal account.

  • LiveOAuthRawErrorCode - Indicates raw error code during silent token refresh attempt for personal account.

  • NTLMErrorCode - Indicates error code while showing sign-in prompt for on-premises work account.

Office.Android.AndroidFileAsyncSaveStatus

Captures File async save status data and various error codes from different components. Microsoft uses this data to analyze if there's any user data loss in the app during saving of files in Word, Excel, or PowerPoint.

The following fields are collected:

  • FileExtension - file extension

  • FileIOSaveHResult - HResult for file save operation

  • FileIOSaveIsCopy - Boolean to indicate if operation is saving a copy.

  • FileSize - size of file

  • FileSourceLocation - enumeration for file source location. Values: None, Local, UncOrMappedNetworkDrive, SkyDrive, App, SharePoint, UnknownServer

Office.Android.AndroidFileOpenReliability

This captures File open status data and various error codes to identify what file open failures are expected versus unexpected and which part of the code is reporting them. Microsoft uses this data to analyze the reasons for file open failures and calculate critical metric like file open success rate in Word, Excel, or PowerPoint.

The following fields are collected:

  • AccessMode - Access mode enumeration

  • AppDocsFileOpenErrorCode - AppDocs error code for file open failure

  • ContentUriAuthority - authority of the content URL from SAF

  • DownloadCsiError - download error message from CSI

  • FileExtension - file extension

  • FileOpenEndErrorCode - Error code for file open failure

  • FileOpenStatus - File open status enumeration

  • FileSize - file size

  • FileSourceLocation - File Location enumeration

  • FirstBCSClientError_Info - last error of BCS (binary conversion service) client

  • IfWordFileOpencanceled - if file open was canceled by user in Word

  • InitializationReason - enumeration for the entry point for file open

  • IsAutoSaveDisabled - Is auto save disabled during file open

  • IsFileEmpty - Boolean to indicate if file is empty

  • K2FileIOHresult - Hresult for File operation end

  • OpenCsiError - file open error message in the CSI layer

  • OpEndEventId - tag where the operation actually ended

  • PPTHresult - Hresult in PPT

  • PPTIsExpectedError - PPT Error classification for file open expected/unexpected failure

  • PPTTag - error tag in PPT

  • ProviderApp - the package name of the app from which file is opened

  • ProviderFileSize - file size captured while opening file via file activation

  • State - File open state enumeration

  • UriScheme - Scheme of the URL

  • WordErrortag - error tag in Word

  • WordFileCorruptionReason - Reason for corruption due to which word file can fail in opening

  • WordFileOpenErrorCode - Word-specific file open error code.

  • WordFileTypeFromDod - File type determined by word based on actual file format

  • WordFileTypeFromExtension - File type determined by word based on file extension

Office.Android.AndroidFileSaveStatus

Critical to capture File save status data and various error codes from different components. Microsoft uses this data to analyze if there's any user data loss in the app during saving of files in Word, Excel, or PowerPoint.

The following fields are collected:

  • AccessMode - Values** - None, ReadOnly, ReadOnlyUpgradable, ReadWrite.

  • AppDocsEndReason - enumeration for File save Appdoc EndReason. Values: None, Success, Failure, Cancel.

  • AppDocsErrorCode - Final Error Code for file save failure

  • AppDocsTriggeringSaveDetails - field to indicate if AppDocs is triggering the save

  • DocInstanceId - DocInstanceId the document instance ID generated by AppDocs that is scoped to an operation instance on a document

  • ExcelFileSaveResult - Excel-specific HResult

  • FileExtension - Extension of file.

  • FileIOSaveErrorCode - Error code in FileIO

  • FileIOSaveHResult - Hresult in FileIO

  • FileIOSaveIsCopy - Boolean to indicate if this is a copy operation

  • FileSize - Size of file

  • FileSourceLocation - File location enumeration. Values: None, Local, UncOrMappedNetworkDrive, SkyDrive, App, SharePoint, UnknownServer

  • OpFlags - Operation flags for save

  • PPTFileSaveFailHresult - PPT hresult for save failure

  • PPTFileSaveFailTag - PPT tag for save failure

  • State - File Open state enumeration.

  • Values - None, Creating, Created, CreateFailed, Opening, Opened, OpenFailed, Copying, Copied, CopyFailed, Closing, Closed, CloseFail

  • WordFileCopyErrorTrackbackTag - trackback tag for failure is CopyDocument stage in Word

  • WordFileSaveCancelReason - trackback tag for cancels in word

  • WordFileSaveEid - Word-specific error code

  • WordFileSaveErrorTrackbackTag - trackback tag for save failures

  • WordFileSaveOpResult - enumeration for result status 0 if succeeded, 1 if failed, 2 if canceled

  • WordFileSaveSuccess - enumeration for Word-specific details for file save operation success.

Office.Android.AndroidOfficeActivationLatency

Critical data to collect end-to-end file open time for all file opens in Windows, Excel, PowerPoint apps. This is used by Microsoft to find out the metric for file open performance of our apps.

The following fields are collected:

  • ActivityTransitionTime - time required during a specific phase of app boot

  • AppActivationTimeInMs - time required during a specific phase of app boot

  • AppBootingOccured - Boolean to check if app boot is complete

  • ApplicationBootTime - time required during a specific phase of app boot

  • AppSuspendedDuringBoot - Boolean to check if app was suspended during boot

  • BlockingUIShownDuringFileOpen - Boolean to indicate if there was any blocking dialog during the file open operation

  • CachedInfoAvailable - Boolean to look for cached info specific to file open operation

  • DocumentRecoveryInvoked - Boolean to indicate if there was a document pending for recovery

  • EndToEndActivationTime - time taken to render the file for files opened from outside the app

  • EndToEndFileOpenTime - time taken to render the file for files opened from inside the app

  • FileOpenPhaseDurationInMs - file open operation time consumed by specific phase

  • FileSourceLocation - enumeration value for File location such as None, Local, UncOrMappedNetworkDrive, SkyDrive, App, SharePoint, UnknownServer

  • InitalizationReason - entry point for file open

  • InitialBootPhaseTime - time required during a specific phase of app boot

  • IsThisFirstLaunch - Boolean to indicate if this is the first launch of the app

  • LibrarySharingPhaseTime - time required during a specific phase of app boot

  • MinimumLibraryLoadPhaseTime - time required during a specific phase of app boot

  • MinimumLibraryLoadPhaseTime - time required during a specific phase of app boot

  • MinimumLibraryLoadPhaseTime - time required during a specific phase of app boot

  • OfficeActivityTime - time required during a specific phase of app boot

  • PostAppInitTimeInMs - time required during a specific phase of app boot

  • PPTRenderPhase - time related to specific phase in PPT rendering

  • PreAppInitTimeInMs - time required during a specific phase of app boot

  • PreMinimumLibraryLoadPhaseTime - time required during a specific phase of app boot

  • ProviderApp - the package name of the app from which file is opened

  • TelemetryReason - similar to InitialisationReason, but more detailed enumeration value regarding the entry point for File open.

  • UserDialogInterruptionDuringBoot - Boolean to indicate if there was any blocking dialog during the boot

  • XLRenderPhase - time related to specific phase in Excel rendering

Office.Android.AppDocsFileOperationEnds

Critical Docs Android Only (AppDocs) telemetry data for File New/Open/SaveAs end operations. This captures error codes for failures of these AppDocsOperations. Microsoft uses this to identify failures in various file operations and the exact layer at which the failure has occurred in Word, Excel, or PowerPoint.

The following fields are collected:

  • AccessMode - enumeration value for the access mode for the file. Values: None, ReadOnly, ReadOnlyUpgradable, ReadWrite

  • BlockingUIShown - Boolean to indicate if blocking UI was shown in the flow anywhere.

  • ContentUriAuthority - the authority of the content URL from SAF

  • Correlation - GUID for the correlation ID related to the operation

  • DocId - the document ID generated by AppDocs

  • DocInstanceId - DocInstanceId the document instance ID generated by AppDocs that is scoped to an operation instance on a document

  • DocIsEnterpriseProtected - Boolean to indicate if document is protected.

  • DocUserId - user ID from the MS auth layer

  • DocUserIdProvider - enumeration that represents the user ID provider, 0 = Unkown, 1 = LiveId, 2 = OrgId, 3 = SSPI, 4 = ADAL

  • DurationInMs - time in milliseconds for the file operation to end

  • EndReason - enumeration value for the end reason. Values: None, Success, Failure, Cancel

  • ErrorCode - error code for the file operation

  • Extension - first four characters of the extension of the file being opened.

  • FileSourceLocation - enumeration value for file location. Possible values: None, Local, UncOrMappedNetworkDrive, SkyDrive, App, SharePoint, UnknownServer

  • FILETIME - Time of the event

  • FirstBCSClientError_Info - Error code information related to file conversions

  • HttpStatusCode - HTTP response code for web service request

  • InitalizationReason - entry point for file open

  • K2FileIOHresult - Hresult code for File open operation end

  • LastBCSClientError_TagId - last error of BCS (binary conversion service) client

  • OfficeWebServiceApiStatusFlag - status flag for the web service request

  • OpEndEventId - tag that represents where the operation actually ended

  • OpFlags - Document operation param flags used by AppDocs layer.

  • OpSeqNum - A number that represents the sequencing of file operation related calls in AppDocs layer

  • OpType - operation type enumeration. Values: "None", "CreateDocument", "OpenDocument", "CopyDocument", "CloseDocument", "SaveDocument", "OpenVersion", "CloseVersion"

  • PreFetchState - enumeration for prefetch state of templates for new file create operations.

  • ProviderApp - the package name of the app from which file is opened

  • ScopeInstanceId - Scope Instance ID used to join data context to activities

  • Size - file size

  • State - enumeration value for the state of the file. Values: None, Creating, Created, CreateFailed, Opening, Opened, OpenFailed, Copying, Copied, CopyFailed, Closing, Closed, CloseFail

  • TemplateName - the binary template name of the document template from the template service, for example, TF10002009.dotx

  • UriScheme - scheme of the URL

Office.Android.AuthACEErrors

This event uses the Microsoft Account (MSA) to determine which user is attempting to sign in to the app and during that which telemetry in discussion is getting triggered as part of an unsuccessful attempt.

This event helps with MSA sign-in error distribution analysis, which helps in understanding reasons behind unsuccessful MSA sign-in flow end.

The following fields are collected:

  • ExceptionsName - indicates exception classes with regard to exception tags that occur during Microsoft account sign-in flow.

  • ExceptionsTag - indicates which inflow exceptions present in union are occurring for MSA-sign in flow.

  • IDCRLACEErrorCode - Gives error code occurring during MSA sign-in flow. Different error codes mentioned at %SRCROOT%\identity\coreapi\public\IdentityData.h

  • IDCRLAuthenticationStatusErrorCode - Indicates error codes for invalid status of Authentication result coming from Microsoft Account (MSA).

  • IDCRLUserInteractionMissingError - Indicates if Microsoft Account (MSA) sign-in flow invoked with showUI flag as false causing the hit.

Office.Android.BCS.Errors

Binary conversion Errors telemetry for Print and Share as PDF. Microsoft uses this to identify failure points during BCS conversions in Word, Excel, or PowerPoint.

The following fields are collected:

  • DocumentFileSize - File size.

  • FileExtension - First four characters of the extension of the file.

  • IsFileDirty - Boolean to indicate if there were unsaved changes in the file.

  • Location - File location enumeration. Values: OneDrive, SharePoint, Dropbox, Others

  • PDFConversionError - Tag at which error occurs for PDF conversion

  • PdfConversionErrorCode - PDF conversion error code

  • PdfConversionHRStatus - PDF conversion status code

  • PdfConversionResult - PDF Conversion result enumeration. Values: "Success", "Failed" and "Canceled"

  • PdfFileSize - Size of the PDF

Office.Android.ClientSideIAP

Critical Error telemetry for Database Failure while file browsing and adds places. Microsoft uses this to identify DB corruption issues in the apps that might hinder user to add places or browse through them from within the app in Word, Excel, or PowerPoint.

The following fields are collected:

  • ClientTransactionId - GUID passed to DSC for a specific Redemption request.

  • CollectionTime - time of subscription purchase completion

  • CountryCode - Client country or region code that is sent to DSC for client redemption request

  • GoPremiumEntryPoint - entry point for triggering purchase

  • IsActivateExistingSubscription - Boolean to indicate if there was an existing subscription that was activated

  • IsErrorRetriable - Boolean to indicate if redemption can be retried

  • IsPreviousPurchase - Boolean to indicate if activation occurred with a previous purchase of subscription

  • IsProvisioningTriggeredByRetry - Boolean to indicate if retry was involved

  • LanguageCode - Client language code that is sent to DSC for client redemption request

  • ProductIdentifier - SKU name that the client is trying to purchase

  • ProvisioningHttpStatusCode - Provisioning http status code

  • ProvisioningStatusCode - Provisioning status code

  • PurchaseOrderId - Purchase order identifier from Google/Samsung store

  • RedemptionTaskHR - HResult for redemption task of subscription

  • SubscriptionProvisioningSucceeded - Boolean for subscription provisioning result success

  • SubscriptionPurchaseHR - Hresult for subscription purchase task

  • SubscriptionType - enumeration for subscription type or SKUs.

  • TCID - Icon click the triggers the subscription flow

Office.Android.DBFailureCause

Critical Error telemetry for Database Failure while file browsing and adds places. Microsoft uses this to identify DB corruption issues in the apps that might hinder user to add places or browse through them from within the app in Word, Excel, or PowerPoint.

The following fields are collected:

  • ErrorAt - Tag Value: Information about the place where the Failure happened

  • ExceptionErrorMessage - verbose error message

Office.Android.EarlyTelemetry.ExpansionFilesErrors

Android Package Kit (APK) expansion files for the Microsoft 365 mobile app are supplementary resource files that Android app developers can publish along with their app. To make our Expansion files download mechanism more reliable, we're logging the cause of errors that occur either in downloading the expansion files or while reading the downloaded expansion files.

The following fields are collected:

  • Data_ClassName - Text representing the source code file name where there's an error.

  • Data_ErrorMessage - Text representing the operation that has failed.

  • Data_ExceptionMessage - An optional text field representing the cause of the exception.

  • Data_ExceptionType - An optional text field representing the name of the exception thrown from source code.

  • Data_MethodName - Text representing the method name in source code where there's an error.

Office.Android.EarlyTelemetry.ExtractionError

To reduce the size of Office Android apps, we apply compression to the resources in the final package. At run time, we first extract these resources before using them. Sometimes there are unexpected errors while performing extractions, which leads to app crashes.

Through this event we're collecting some diagnostic information related to extraction, like name of the resource being extracted, path where its extracted etc., free disk space available etc. This data is collected only when there are extraction errors.

We use this data to understand the cause of extraction failures, and to improve the user experience of our apps.

The following fields are collected:

  • Data_ArchiveName - Name of the resource that is being extracted.

  • Data_ArchivePath - Path where the resource is temporarily cached.

  • Data_ArchiveSizeKB - Size of the resource that is being extracted.

  • Data_ClassName - File name in source code where the error is encountered.

  • Data_ErrorDetail - Text describing more details about the cause of the error, like the error code etc.

  • Data_ErrorMessage - Text describing the type of error encountered during extraction.

  • Data_ExtractionDestinationPath - Path where the resource is to be saved after extraction.

  • Data_FreeDiskSpaceMB - The amount of free disk space available on the device measured in Mega Bytes.

  • Data_ItemToExtract - Name of the resource that is being extracted.

  • Data_MethodName - Method name in source code where the error is encountered.

Office.Android.EarlyTelemetry.RegistryErrors

This event captures any errors faced during Android registry access. This event data helps us in understanding the user errors and making the registry feature more robust.

The following fields are collected:

  • App – The application process sending the event.

  • AppVersionLong – The application version.

  • Data_StackTrace – The stacktrace of the error.

Office.Android.EarlyTelemetry.SharedLibraryLoadersearchAndloadLibraryError

We log this event in case there are errors while loading shared libraries. There can be library loading errors for two reasons 1) Installed Apk is incompatible with the device. 2) The library that we're trying to load may be corrupt, because of errors in extracting it due to low disk space, or low memory.

The following fields are collected:

  • Data_ExceptionMessage - Exception message thrown by Android API System.loadlibrary

  • Data_FreeSpaceInMB - Free space available on device

  • Data_nickName - Name of the library that couldn't be loaded.

Office.Android.EarlyTelemetry.SharedPrefServiceDataFetchAsync

This event is triggered when one Office Android app needs data from another Office Android app but fails to get the data. Microsoft uses this data to determine the reason for service failure and to maintain the health of the service.

The following fields are collected:

  • Data_ErrorInfo - This field contains information about the error due to which this event got triggered. This includes errors such as timeout. We also log the Office app package name in this field from which the data was requested.

  • Data_LoggingSessionId - This field logs the sessionId of the session that is logging this event.

Office.Android.EarlyTelemetry.SharedPrefServiceDataFetchSync

This event is triggered when an error occurs, for example, timeout or invalid service error, when one Office Android app needs but is unable to get data from other Office Android app installed on the user's device. This data is used to find the reason for the service failure and to maintain the health of the service and Office apps.

The following fields are collected:

  • Data_ErrorInfo - This field logs information about the error due to which this event got triggered. This includes errors such as timeout. We also log the Office app package name in this field from which the data was requested.

  • Data_LoggingSessionId - This field logs the sessionId of the session that is logging this event.

Office.Android.Intune.IntuneJavaCopyFailedAttempts

Critical Error telemetry to track failures for individual Intune APIs; This telemetry gets logged in case of errors to save local copy of Intune protected Cloud documents. Microsoft uses this data to identify errors during and after Intune enrollment within the app, post signing into the app with a work account.

The following fields are collected:

  • Data_FileCreationFailedErrorCode - Error code associated with the flow

Office.Android.Intune.IntuneJavaExceptionADALTokenForMAM

Critical Error telemetry to track failures for individual Intune APIs; This telemetry gets logged in case of errors to obtain the ADAL token for Intune resources. Microsoft uses this data to identify errors during Intune enrollment within the app, post signing into the app with a work account.

The following fields are collected:

  • Data_ErrorCode - Error code associated with the flow

Office.Android.Intune.IntuneJavaExceptionAppPolicy

Critical Error telemetry to track failures for individual Intune APIs; This telemetry gets logged in case of errors to call Intune APIs related to fetching policies for an identity for the current process. Microsoft uses this data to identify errors during and after Intune enrollment within the app, post signing into the app with a work account.

The following fields are collected:

  • None

Office.Android.Intune.IntuneJavaExceptionAppPolicyForContext

Critical Error telemetry to track failures for individual Intune APIs; This telemetry gets logged in case of errors to call Intune APIs related to fetching policies for an identity for the current activity. Microsoft uses this data to identify errors during and after Intune enrollment within the app, post signing into the app with a work account.

The following fields are collected:

  • None

Office.Android.Intune.IntuneJavaExceptionAuthenticationCallback

Critical Error telemetry to track failures for individual Intune APIs; This telemetry gets logged in case of errors to call Intune APIs related to registering for authentication callbacks for managed accounts. Microsoft uses this data to identify errors during and after Intune enrollment within the app, post signing into the app with a work account.

The following fields are collected:

  • None

Office.Android.Intune.IntuneJavaExceptionGetAccountStateSync

Critical Error telemetry to track failures for individual Intune APIs; This telemetry gets logged in case of errors to call Intune APIs related to managed account. Microsoft uses this data to identify errors during and after Intune enrollment within the app, post signing into the app with a work account.

The following fields are collected:

  • None

Office.Android.Intune.IntuneJavaExceptionGetIsSaveToLocationAllowed

Critical Error telemetry to track failures for individual Intune APIs; This telemetry gets logged in case of errors to fetch the policy related to save to local. Microsoft uses this data to identify errors during and after Intune enrollment within the app, post signing into the app with a work account.

The following fields are collected:

  • None

Office.Android.Intune.IntuneJavaExceptionGetPolicyForIdentity

Critical Error telemetry to track failures for individual Intune APIs; This telemetry gets logged in case of errors to call Intune APIs related to fetching policies for an identity. Microsoft uses this data to identify errors during and after Intune enrollment within the app, post signing into the app with a work account.

The following fields are collected:

  • None

Office.Android.Intune.IntuneJavaExceptionGetProtectionInfoFromDescriptor

Critical Error telemetry to track failures for individual Intune APIs; This telemetry gets logged in case of errors to call Intune APIs related to Protection Info. Microsoft uses this data to identify errors during and after Intune enrollment within the app, post signing into the app with a work account.

The following fields are collected:

  • None

Office.Android.Intune.IntuneJavaExceptionGetProtectionInfoFromPath

Critical Error telemetry to track failures for individual Intune APIs; This telemetry gets logged in case of errors to call Intune APIs related to Protection Info. Microsoft uses this data to identify errors during and after Intune enrollment within the app, post signing into the app with a work account.

The following fields are collected:

  • None

Office.Android.Intune.IntuneJavaExceptionGetUIPolicyIdentity

Critical Error telemetry to track failures for individual Intune APIs; This telemetry gets logged in case of errors to call Intune APIs related to fetching UI policies for a managed account. Microsoft uses this data to identify errors during and after Intune enrollment within the app, post signing into the app with a work account.

The following fields are collected:

  • None

Office.Android.Intune.IntuneJavaExceptionIsIdentityManaged

Critical Error telemetry to track failures for individual Intune APIs; This telemetry gets logged in case of errors to call Intune APIs related to identifying if an account is managed. Microsoft uses this data to identify errors during and after Intune enrollment within the app, post signing into the app with a work account.

The following fields are collected:

  • None

Office.Android.Intune.IntuneJavaExceptionNullEnrollmentManager

Critical Error telemetry to track failures for individual Intune APIs; This telemetry gets logged in case of errors to call Intune APIs related to registration of components for callback. Microsoft uses this data to identify errors during and after Intune enrollment within the app, post signing into the app with a work account.

The following fields are collected:

  • None

Office.Android.Intune.IntuneJavaExceptionProtect

Critical Error telemetry to track failures for individual Intune APIs; This telemetry gets logged in case of errors to call Intune APIs related to protecting a managed document. Microsoft uses this data to identify errors during and after Intune enrollment within the app, post signing into the app with a work account.

The following fields are collected:

  • None

Office.Android.Intune.IntuneJavaExceptionProtectFromDescriptorIfRequired

Critical Error telemetry to track failures for individual Intune APIs; This telemetry gets logged in case of errors to call Intune APIs related to protecting a managed document. Microsoft uses this data to identify errors during and after Intune enrollment within the app, post signing into the app with a work account.

The following fields are collected:

  • None

Office.Android.Intune.IntuneJavaExceptionRegisterAccountSync

Critical Error telemetry to track failures for individual Intune APIs; This telemetry gets logged in case of errors to call Intune APIs related to registering account Intune Management. Microsoft uses this data to identify errors during and after Intune enrollment within the app, post signing into the app with a work account.

The following fields are collected:

  • None

Office.Android.Intune.IntuneJavaExceptionSetUIPolicyIdentitySync

Critical Error telemetry to track failures for individual Intune APIs; This telemetry gets logged in case of errors to call Intune APIs related to setting policies for a managed account. Microsoft uses this data to identify errors during and after Intune enrollment within the app, post signing into the app with a work account.

The following fields are collected:

  • None

Office.Android.Intune.IntuneJavaExceptionUnregisterAccountSync

Critical Error telemetry to track failures for individual Intune APIs; This telemetry gets logged in case of errors to call Intune APIs related to remote wipe scenarios for Intune Management. Microsoft uses this data to identify errors during and after Intune enrollment within the app, post signing into the app with a work account.

The following fields are collected:

  • None

Office.Android.Intune.IntuneJavaExceptionUpdateToken

Critical Error telemetry to track failures for individual Intune APIs; This telemetry gets logged in case of errors to call Intune APIs related to update authorization token for a managed account. Microsoft uses this data to identify errors during and after Intune enrollment within the app, post signing into the app with a work account.

The following fields are collected:

  • None

Office.Android.LicenseActivationFailure

Critical Error telemetry to track failures to activate licenses for Office 365 accounts in Word, Excel, or PowerPoint. Microsoft uses this to analyze failures to activate a purchased Office 365 license.

The following fields are collected:

  • EntryPoint - Entrypoint enumeration for triggering the license activation flow

  • HResult - error code for the failure

  • IsGallatin - Boolean to check if it's a Gallatin account

  • MessageCode - enumeration to indicate the point of failure for activation

  • PreviousEntryPoint - Entrypoint enumeration for triggering the license activation flow

  • StateAfterActivation - enumeration to indicate licensing state of the app before the activation flow started

  • StateBeforeActivation - enumeration to indicate licensing state of the app before the activation flow started

  • UserAccountType - enumeration to indicate whether personal account or enterprise account.

Office.Android.MSASignInUIPrompts

This event denotes that sign-in prompt came to the user, for personal account. This event helps in understanding the health of signed in state of our apps and take appropriate actions, when we notice unexpected sign-in re-prompts.

The following fields are collected:

  • ExternalCacheRefreshError - Error code of token refresh attempt, before showing sign-in prompt.

  • LastLoginDelta - The time delta from last successful login.

  • MSAserverUAID - Correlation ID with service telemetry data.

  • PreviousIdentityState - Indicates state of the account, like session expired.

  • SignInResultCode - Indicates the result code of sign-in prompt end.

  • UseCache - Indicates if we force prompted the user to provide the password again.

  • UserType - Indicates whether it's existing account or new account

  • WasIdentitySignedOut - Indicates if account was in signed out state.

Office.Apple.Licensing.FetchCopilotServicePlanFailed

The event is triggered when the application fails to retrieve a Copilot license plan and is used to understand Copilot license failure rates and keep its features working as expected.

The following fields are collected:

  • None

Office.Apple.Licensing.Mac.DRActivationFailures

This event is collected for Office applications running under Apple platforms. The event is used for capturing digital river activation failures (the event logs the key and product that was used to activate, and the error code received). This event is used for detecting and helping troubleshoot activation failures (Digital River issues).

The following fields are collected:

  • Data_DigitalRiverID - Digital River product ID that maps to this Office product SKY

  • Data_Error - A string representing an activation error code.

  • Data_ProductKey - Product key that was attempted to be activated

  • Data_ProductKeyHash - An encoded product key being activated

Office.Apple.Licensing.Mac.GetMachineStatusErrors

This event is collected for Office applications running under Apple platforms. The event collects the error code returned while periodically checking the validity of a subscription license. The error code can signify server unavailability but also license expiration, machine count limit, invalid hardware ID, etc. This event is used to monitor the health of the Office Licensing Service but also to investigate issues related to subscription machine management.

The following fields are collected:

  • Data_Error - We collect a string representing an error code.

Office.Apple.MetricKit.AppLaunchDiagnostic

[This event has been removed from current builds of Office, but might still appear in older builds.]

The event is triggered when Office apps have issues when launching. The data is used to get additional information that helps with fixing bugs and keep Office apps secure and performing as expected.

The following fields are collected:

  • AppLaunchDiagnostic - A blob of text with data about the app launch error.

  • LaunchDurationMS - Indicates the time it took for the app to launch.

Office.Apple.MetricKit.CPUExceptionDiagnostic

[This event has been removed from current builds of Office, but might still appear in older builds.]

The event is triggered when Office apps have issues with executing CPU instructions. The data is used to get additional information that helps with fixing bugs and keep Office apps secure and performing as expected.

The following fields are collected:

  • CPUExceptionDiagnostic - A blob of text with data about the CPU error.

  • TotalCPUTimeMS - Indicates the total CPU time used during the exception.

  • TotalSampledTimeMS - Indicates the total time the app was sampled during the exception.

Office.Apple.MetricKit.Diagnostic

The event is triggered when Office apps fail to execute CPU instructions, complete the boot sequence, or write to the device's disk. It's also triggered when apps become unresponsive or crash. The event is used to get additional required diagnostic data including any logs that helps with keeping Office apps secure and performing as expected.

The following fields are collected:

  • Diagnostic - A string with the parsed diagnostic payload.

  • DiagnosticType - A string that specifies the type of diagnostics recorded: Crash, Hang, DiskWriteException, AppLaunch, or CPUException.

  • HangDurationMS - A string that contains the duration of a hang when DiagnosticType is Hang.

  • LaunchDurationMS - A string that contains the time it took for the app to launch when DiagnosticType is AppLaunch.

  • StackHash - A string identifier that represents an issue uniquely.

  • TerminationReason - A string that contains the reason of termination when DiagnosticType is Crash.

  • TotalCPUTimeMS - A string that contains the total CPU time when DiagnosticType is CPUException.

  • TotalSampledTimeMS - A string that contains the total sampled time when DiagnosticType is CPUException.

  • VirtualMemoryRegionInfo - A string that contains the virtual memory state when DiagnosticType is Crash.

  • WritesCausedKB - A string that contains the number of kilobytes written when DiagnosticType is DiskWriteException.

Office.Apple.MetricKit.DiagnosticMetadata

The event is triggered when Office apps fail to execute CPU instructions, complete the boot sequence, or write to the device's disk. It's also triggered when apps become unresponsive or crash. The event is used to get additional required diagnostic data that helps with keeping Office apps secure and performing as expected.

The following fields are collected:

  • DiagnosticType - A string that specifies the type of diagnostics recorded: Crash, Hang, DiskWriteException, AppLaunch, or CPUException.

  • HangDurationMS - A string that contains the duration of a hang when DiagnosticType is Hang.

  • LaunchDurationMS - A string that contains the time it took for the app to launch when DiagnosticType is AppLaunch.

  • StackHash - A string identifier that represents an issue uniquely.

  • TerminationReason - A string that contains the reason of termination when DiagnosticType is Crash.

  • TotalCPUTimeMS - A string that contains the total CPU time when DiagnosticType is CPUException.

  • TotalSampledTimeMS - A string that contains the total sampled time when DiagnosticType is CPUException.

  • VirtualMemoryRegionInfo - A string that contains the virtual memory state when DiagnosticType is Crash.

  • WritesCausedKB - A string that contains the number of kilobytes written when DiagnosticType is DiskWriteException.

Office.Apple.MetricKit.DiskWriteExceptionDiagnostic

[This event has been removed from current builds of Office, but might still appear in older builds.]

The event is triggered when Office apps have issues writing to the device’s disk. The data is used to get additional information that helps with fixing bugs and keep Office apps secure and performing as expected.

The following fields are collected:

  • DiskWriteExceptionDiagnostic - A blob of text with data about the disk writing error.

  • WritesCausedKB - Total writes caused in KB.

Office.Apple.MetricKit.HangDiagnostic

[This event has been removed from current builds of Office, but might still appear in older builds.]

The event is triggered when Office apps become unresponsive. The data is used to get additional information that helps with fixing bugs and keep Office apps secure and performing as expected.

The following fields are collected:

  • HangDiagnostic - A blob of text with data about the app being unresponsive.

  • HangDurationMS - Indicates the amount of time the app was unresponsive.

Office.Apple.RFSignOfferResult

The event is triggered when the application makes a network request to retail federation services to get a unique signature for a promotional offer. The data is used to determine the cause of promotional offer failures as well as error rates.

The following fields are collected:

  • Result - An integer enumerator value indicating the error (if any) that occurred during the network request to retail federation services.

Office.Extensibility.Sandbox.ODPErrorNotification

Tracks the various error notifications received from the sandbox. Used to detect the error scenarios in sandbox and there by fixing it, to improve productivity of the user.

The following fields are collected:

  • AppId - ID of the App

  • AppUrl - scrubbed app URL

  • Result - result error code

Office.FirstRun.Apple.MacONIOLKFirstRunStarted

This event is collected for Office applications running under Apple platforms. The event lets us know a user has entered first run experience. We use this event to figure out if the First-Run Experience (FRE) was started successfully.

The following fields are collected:

  • Data_FirstRunCollectionTime - A timestamp registering the time at which the flow was started.

Office.Fluid.LoopMobile.Activity.BridgeCall

The event occurs when the user performs an action that requires connectivity and allows us to track network reliability and performance metrics related to API calls made within the application, which we use to monitor that Loop is performing as expected.

The following fields are collected:

  • Activity_Duration - Duration it took to execute the user action.

  • Activity_Success - A flag indicating if the action succeeded or not.

  • Data_ErrorDescription - Description of the error if the action failed.

  • Data_EventName - Name of the underlying Bridge Call being made.

  • Data_FeatureName - Name of this activity: Bridge Call.

Office.Fluid.LoopMobile.Error.Unexpected

The event allows us to accurately gauge the impact of errors in our service driven code and determine what failures our customers are encountering. The event allows proper escalation with partner service teams to keep Loop working as expected.

The following fields are collected:

  • ErrorCode - Numeric code such as an HTTP status code or Apple error code.

  • ErrorCodeString - TypeScript error string.

  • ErrorDescription - A system metadata string that gives human readable context on the error and helps us to identify what might have failed.

  • ErrorDomain - Apple error domain string or constructed system metadata only string that explains the rough area of the error.

  • ErrorSubcode - Additional numeric code used to identify errors in authentication scenarios.

  • ErrorTag - An inner version of "Tag" used to uniquely identify an inner error.

  • ErrorType - Type of error.

  • Tag - Used to uniquely identify an error.

Office.Graphics.ARCExceptions

This exception reporting information is important for assessing the overall health of the graphics stack, as well as identifying parts of the code where failures are occurring at high frequency, in order to prioritize investigation. This exception reporting information is important for assessing the overall health of the graphics stack, and identifying parts of the code where failures are occurring at high frequency. This helps an engineer to determine which rendering failures are impacting the most users, enabling us to prioritize our investigations toward fixing issues that will have the greatest user benefit.

The following fields are collected:

  • Data_HResult - The error code returned from failure

  • Data_TagCount - The count of each failure that occurred

  • Data_TagID - The identifier of the failure that occurred

Office.OfficeMobile.PersonalizedCampaigning.Errors

To raise awareness about the features of Microsoft 365 mobile app that users haven't yet explored, Microsoft 365 mobile app integrates with IRIS to support in-app and push notifications. In case of in-app notifications, it captures errors that happen while pulling or displaying notification and when user interactions with the notification as well as providing feedback to IRIS server. In case of push notifications, it captures errors that happen while displaying notification, and when user interacts with the notification.

The following fields are collected:

  • Class - Name of the class where error occurred

  • CreativeId - The ID of notification that uniquely identifies the notification and its content.

  • ErrorDetails - Details on the error

  • ErrorMessage - Error message.

  • ErrorReason - The underlying reason for the error

  • Method - Name of the function where error occurred.

  • RequestParams - Request parameters used when contacting the IRIS server to pull the notification.

  • SurfaceId - ID of the surface where the notification will be shown.

Office.OneNote.Memory.ReactOptionsOnError

Triggered when an error occurs (machine action) and is required for crash investigation.

Error types include:

  • Any call to Javascript function after Global Exception has been raised
  • Any WebServer error when DeveloperSettings.UseWebDebugger is true

The following fields are collected:

  • Consent_AddInContentSourceLocation - Add In content source location 

  • Consent_AddInContentState - Add In content state 

  • Consent_ControllerConnectedServicesConsentTime - Indicates when the user chose the status of optional connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DiagnosticDataConsentTime - Indicates when the user provided the consent for diagnostic data. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Data_ErrorCode - Error Code

  • Event_ReceivedTime - The time the event was logged in the service 

  • M365aInfo_EnrolledTenantId - Enrolled tenant ID 

  • User_ActiveUserTenantId - Active user tenant ID 

  • User_TelemetryRegion - Identifies the data boundary of the user 

Office.OneNote.Memory.ReactOptionsOnJSException

Triggered when a JS exception occurs (machine action) and is required for crash investigation.

The following fields are collected:

  • Consent_AddInContentSourceLocation - Add In content source location 

  • Consent_AddInContentState - Add In content state 

  • Consent_ControllerConnectedServicesConsentTime - Indicates when the user chose the status of optional connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DiagnosticDataConsentTime - Indicates when the user provided the consent for diagnostic data. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DownloadContentConsentTime - Indicates when the user made the choice to enable or disable connected experiences that download online content. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_UserContentDependentConsentTime - Indicates when the user chose to enable or disable connected experiences that analyze content was made. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Data_ErrorCallstack - Error Callstack

  • Data_ErrorMessage - Error Message

  • Data_IsFatal - Identifies fatal error.

  • Event_ReceivedTime - The time the event was logged in the service 

  • M365aInfo_EnrolledTenantId - Enrolled tenant ID 

  • User_ActiveUserTenantId - Active user tenant ID 

  • User_TelemetryRegion - Identifies the data boundary of the user 

Office.OneNoteIntegrations.Memory.SDX.SDXException

Triggered when an unexpected event occurs (machine action) and is required for crash investigation.

The following fields are collected:

  • Consent_AddInContentSourceLocation - Add In content source location 

  • Consent_AddInContentState - Add In content state 

  • Consent_ControllerConnectedServicesConsentTime - Indicates when the user chose the status of optional connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DiagnosticDataConsentTime - Indicates when the user provided the consent for diagnostic data. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DownloadContentConsentTime - Indicates when the user made the choice to enable or disable connected experiences that download online content. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_UserContentDependentConsentTime - Indicates when the user chose to enable or disable connected experiences that analyze content was made. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Data_App_Name - The name of the application that is providing the data. Allows us to identify which application is showing an issue so we know how to address it.

  • Data_App_Version - The version of the application. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

  • Data_Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • Data_Device_Id - A unique identifier for the device. Allows us to identify the distribution of issues across a set of devices.

  • Data_Error_Code - Error Code

  • Data_Error_ErrorGroup - Error Group

  • Data_Error_Tag - Error Tag

  • Data_ErrorCode1 - Error Code 1

  • Data_ErrorCode2 - Error Code 2

  • Data_ErrorTag - Error Tag

  • Data_ErrorType - Error Type

  • Data_EventName - A unique name of a OneNote's event. OneNote events use this custom field to specify a unique name due to an engineering limitation in the past.

  • Data_ExpirationDate - A date in numerical format indicates when this event will be stop sending from clients

  • Data_HostApp - Identifies the host app name that launches a sub-app. 

  • Data_Namespace - A namespace of the event. Allows us to group the event into groups.

  • Data_OTelJS_Version - Version of OTel logger 

  • Data_SamplePolicy - Identifies if the sample policy is Measure or Critical 

  • Data_Session_Id - Uniquely identifies a given session of data. Allows us to identify the impact of issues by evaluating the number of sessions that are impacted and if there are common features of those sessions.

  • Data_SessionCorrelationId - The globally unique identifier for the host's session.

  • Data_ShortEventName - A short name of an event. Allows us to identify the event that was being sent from the client. 

  • DeviceInfo_OsName - The name of the device OS 

  • DeviceInfo_OsVersion - The version of the operating system 

  • Event_ReceivedTime - The time the event was logged in the service 

  • M365aInfo_EnrolledTenantId - Enrolled tenant ID 

  • User_ActiveUserTenantId - Active user tenant ID 

  • User_TelemetryRegion - Identifies the data boundary of the user 

Office.OneNoteIntegrations.Memory.SDX.Trace

These are diagnostic traces which aren't logged immediately but put into a ring buffer. They're flushed only when an exception occurs which is also being caught and logged as a separate data event. These diagnostic traces supplement the exceptions being logged while investigating crashes. The exception may occur anywhere in the OneNote Sticky Notes experience.

The exception which is logged as a separate data event helps in identifying its origin. The corresponding diagnostic traces that are logged with this event provide additional information to investigate the issue further.

The following fields are collected:

  • Consent_AddInContentSourceLocation - Add In content source location 

  • Consent_AddInContentState - Add In content state 

  • Consent_ControllerConnectedServicesConsentTime - Indicates when the user chose the status of optional connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DiagnosticDataConsentTime - Indicates when the user provided the consent for diagnostic data. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DownloadContentConsentTime - Indicates when the user made the choice to enable or disable connected experiences that download online content. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_UserContentDependentConsentTime - Indicates when the user chose to enable or disable connected experiences that analyze content was made. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Data_App_Name - The name of the application that is providing the data. Allows us to identify which application is showing an issue so we know how to address it.

  • Data_App_Version - The version of the application. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

  • Data_Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • Data_Device_Id - A unique identifier for the device. Allows us to identify the distribution of issues across a set of devices.

  • Data_ErrorCode1 - Error Code 1

  • Data_ErrorCode2 - Error Code 2

  • Data_ErrorTag - Error Tag

  • Data_ErrorType - Error Type

  • Data_EventName - A unique name of a OneNote's event. OneNote events use this custom field to specify a unique name due to an engineering limitation in the past.

  • Data_ExpirationDate - A date in numerical format indicates when this event will be stop sending from clients

  • Data_HostApp - Identifies the host app name that launches a sub-app. 

  • Data_Message - Error Message

  • Data_Namespace - A namespace of the event. Allows us to group the event into groups.

  • Data_OTelJS_Version - Version of OTel logger 

  • Data_SamplePolicy - Identifies if the sample policy is Measure or Critical  

  • Data_SDX_SessionId - Session ID of the Add-in 

  • Data_Session_Id - Uniquely identifies a given session of data. Allows us to identify the impact of issues by evaluating the number of sessions that are impacted and if there are common features of those sessions.

  • Data_SessionCorrelationId - The globally unique identifier for the host's session.

  • Data_ShortEventName - A short name of an event. Allows us to identify the event that was being sent from the client. 

  • Data_Stack - The stacktrace of the error.

  • DeviceInfo_OsName - The name of the device OS 

  • DeviceInfo_OsVersion - The version of the operating system 

  • Event_ReceivedTime - The time the event was logged in the service 

  • M365aInfo_EnrolledTenantId - Enrolled tenant ID 

  • User_ActiveUserTenantId - Active user tenant ID 

  • User_TelemetryRegion - Identifies the data boundary of the user 

Office.Outlook.Desktop.Calendar.AcceptCalShareNavigateToSharedFolder.Error

Collects information when any failure occurs when while Navigation to shared Calendar. This data is used to monitor the health of the calendar sharing API and Outlooks interaction with shared calendars.

The following fields are collected:

  • FailedCaseHResult - The error code returned from Failure

Office.Outlook.Desktop.EDP.EDPOpenStoreFailure

Success or failure to open the Enterprise Data Protection protected mail store based on result of Windows API call to get the key to decrypt the store. We use this diagnose one of the top Enterprise Data Protection issues, which can prevent Outlook from booting. Primary cause of failure is Outlooks interaction with Windows APIs used to decrypt the store key.

The following fields are collected:

  • HVA Activity - with custom data fields

  • IsFlightOn – Indicates whether the EDPDecryption Flight is enabled

Office.Outlook.Desktop.NdbCorruptionResult

Office.Outlook.Desktop.NdbCorruptionResult and Office.Outlook.Desktop.NDBCorruptStore.Warning are collected when we detect corruption in a user's PST/OST. When we detect corruption, Microsoft collects the format of the database, the place where detected it, and a small amount of context about the corruption. OST/PST corruption prevents users from accessing their emails. We actively monitor this data for anomalous activity. We aim to investigate and diagnose issues to limit loss of customer data.

The following fields are collected:

  • 0 - The Process name that reported corruption

  • 1 - Bool indicating if the user chooses new file or not

  • 2 - the number of other processes that have the database open

Office.Outlook.Desktop.NDBCorruptStore.Warning

Office.Outlook.Desktop.NdbCorruptionResult and Office.Outlook.Desktop.NDBCorruptStore.Warning are collected when we detect corruption in a user's PST/OST. When we detect corruption, Microsoft collects the format of the database, the place where detected it, and a small amount of context about the corruption. OST/PST corruption prevents users from accessing their emails. We actively monitor this data for anomalous activity. We aim to investigate and diagnose issues to limit loss of customer data.

The following fields are collected:

  • CollectionTime - collection time

  • Context - Corrupt Store Context, where corruption was detected

  • CreatedWithVersion – (Optional) field with version of store

  • Details – Details about the crash

  • NdbType - Store Type, can be 0 = NdbUndefined, 1 = NdbSmall, 2 = NdbLarge, 3 = NdbTardis

  • ProcessName - Process Name causing the store to get corrupted

  • PstVersion - Version of the MSPST32.DLL

  • Version - Version of store file format

Office.Outlook.Desktop.OutlookCalendarUsageErr.MeetRcpt.ForwardActions.Rule.O16

Collects success and failure of the Forward, Forward as Attachment, and Forward as iCalendar action for Single, Recurring, and Exceptional Meeting Responses in the Mail, Calendar, and Inspector Outlook view. The failure rate of the Forward, Forward as Attachment, and Forward as iCalendar actions are actively monitored for anomalies. Anomalous statistics indicate a failure Outlooks ability to conduct core calendar operations. This data is also used to diagnose other Calendar-related issues that may be detected.

The following fields are collected:

  • CountExceptionForward - Count of the forwarded Meetings Exceptions

  • CountExceptionForwardAsiCal - Count of the forwarded Meetings Exceptions as an iCal

  • CountExceptionForwardInSplit - Count of the forwarded Meetings Exceptions from the Split Menu in Ribbon

  • CountExceptionForwardWithAttach - Count of the forwarded Meetings Exceptions as an Attachment

  • CountRecurringForward - Count of the forwarded Recurring Meetings

  • CountRecurringForwardAsiCal - Count of the forwarded Recurring Meetings as an iCal

  • CountRecurringForwardInSplit - Count of the forwarded Recurring Meetings from the Split Menu in Ribbon

  • CountRecurringForwardWithAttach - Count of the forwarded Recurring Meetings as an Attachment

  • CountSingleForward - Count of the forwarded Single Meetings

  • CountSingleForwardAsiCal - Count of the forwarded Single Meetings as an iCal

  • CountSingleForwardInSplit - Count of the forwarded Single Meetings from the Split Menu in Ribbon

  • CountSingleForwardWithAttach - Count of the forwarded Single Meetings as an Attachment

  • HResult - ErrorCode

  • OlkViewName - Indicates Mail, Calendar, or Inspector View

Office.Outlook.Desktop.OutlookCalendarUsageErr.MeetRcpt.ReplyActions.Rule.O16

Collects success and failure of the Reply, Reply All, Reply With IM, and Reply All with IM action for Single, Recurring, and Exception Meeting Responses in the Mail, Calendar, and Inspector Outlook view. The failure rate of the Reply, Reply All, Reply With IM, and Reply All with IM actions are actively monitored for anomalies. Anomalous statistics indicate a failure Outlooks ability to conduct core calendar operations. This data is also used to diagnose other Calendar-related issues that may be detected.

The following fields are collected:

  • CountExceptionReply - Count of the Meetings Reply on exceptions

  • CountExceptionReplyAll - Count of the Meetings ReplyAll on exceptions

  • CountExceptionReplyAllWithIM - Count of the Meetings ReplyAll with IM on exceptions

  • CountExceptionReplyWithIM - Count of the Meetings Reply with IM on exceptions

  • CountRecurringReply - Count of the Recurring Meetings Reply

  • CountRecurringReplyAll - Count of the Recurring Meetings ReplyAll

  • CountRecurringReplyAllWithIM - Count of the Recurring Meetings ReplyAll with IM

  • CountRecurringReplyWithIM - Count of the Recurring Meetings Reply with IM

  • CountSingleReply - Count of the Single Meetings Reply

  • CountSingleReplyAll- Count of the Single Meetings ReplyAll

  • CountSingleReplyAllWithIM - Count of the Single Meetings ReplyAll with IM

  • CountSingleReplyWithIM - Count of the Single Meetings Reply with IM

  • HResult - ErrorCode

  • OlkViewName - Indicates Mail, Calendar, or Inspector View

Office.Outlook.Desktop.OutlookPrivsDlgSingleUser.LoadFail

This rule collects Calendar Sharing errors when adding a new user (of type EX or SMTP) from the Address book. This data is used to diagnose and resolve issues detected in the Calendar Sharing dialog.

The following fields are collected:

  • CountAccountWizardEnd - How many times the legacy wizard dialog ended

  • CountCreatePIMAccount - How many times user created a PIM Profile

Office.Outlook.Mac.MacOLKAsserts

Used to identify user impacting issues in Outlook that may manifest as crashes or degraded functionality.

The following fields are collected:

  • Category - type of assert

  • CollectionTime - time when assert is collected

Office.Outlook.Mac.MacOLKErrors

Used to identify user impacting issues in Outlook that may manifest as crashes or degraded functionality.

The following fields are collected:

  • Category - type of error

  • CollectionTime - time when error is collected

  • ThreadId - identifier for the thread

Office.StickyNotes.Web.SDK.ActionDispatchFailed

Triggered when action dispatch fails (machine action) and is required for crash investigation.

The following fields are collected:

  • Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • baseData_properties_version - Version of properties such as PostChannel and PrivacyGuardPlugin 

  • Consent_AddInContentSourceLocation - Add In content source location 

  • Consent_AddInContentState - Add In content state 

  • Consent_ControllerConnectedServicesConsentTime - Indicates when the user chose the status of optional connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Culture_UiLanguage - Always logged blank 

  • Data_App_Name - The name of the application that is providing the data. Allows us to identify which application is showing an issue so we know how to address it.

  • Data_App_Platform - The broad classification of the platform on which the app is running. Allows us to identify on which platforms an issue may be occurring so that we can correctly prioritize the issue.

  • Data_App_Version - The version of the application. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

  • Data_AppInfo_Id - Name of the host application 

  • Data_AppInfo_Version - Version of the host application 

  • Data_Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • Data_Device_Id - A unique identifier for the device. Allows us to identify the distribution of issues across a set of devices.

  • Data_Error_Code - Error Code

  • Data_Error_ErrorGroup - Error Group

  • Data_Error_Tag - Error Tag

  • Data_ErrorCode1 - Error Code 1

  • Data_ErrorCode2 - Error Code 2

  • Data_ErrorTag - Error Tag

  • Data_ErrorType - Error Type

  • Data_EventName - A unique name of a OneNote's event. OneNote events use this custom field to specify a unique name due to an engineering limitation in the past.

  • Data_ExpirationDate - A date in numerical format indicates when this event will be stop sending from clients

  • Data_FeedEnabled - Identifies if feed is enabled. 

  • Data_HostApp - Identifies the host app name that launches a sub-app. 

  • Data_HostSessionId - Uniquely identifies the host app session for a sub-app 

  • Data_Namespace - A namespace of the event. Allows us to group the event into groups.

  • Data_OTelJS_Sink - Sink used by OTel logger. It's always logged blank. 

  • Data_OTelJS_Version - Version of OTel logger 

  • Data_SamplePolicy - Identifies if the sample policy is Measure or Critical  

  • Data_SDX_BrowserToken - Identifier that sits in the browser's cache 

  • Data_SDX_HostJsVersion - This is the platform-specific version of Office.js (for example, outlook web16.01.js) This contains the API surface for ad ins 

  • Data_SDX_Id - The GUID of an Add-in, which uniquely identifies it 

  • Data_SDX_InstanceId - Represents Add in document pair 

  • Data_SDX_MarketplaceType - Indicates where the Add-in installed from 

  • Data_SDX_OfficeJsVersion - This is the version of Office.js that will redirect to the platform-specific version. 

  • Data_SDX_SessionId - Session ID of the Add-in 

  • Data_SDX_Version - Version of the Add-in 

  • Data_Session_Id - Uniquely identifies a given session of data. Allows us to identify the impact of issues by evaluating the number of sessions that are impacted and if there are common features of those sessions.

  • Data_SessionCorrelationId - The globally unique identifier for the host's session.

  • Data_ShortEventName - A short name of an event. Allows us to identify the event that was being sent from the client. 

  • Data_StickyNotesSDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it. 

  • Data_User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • Data_User_PrimaryIdentityHash - A pseudonymous identifier that represents the current user.

  • Data_User_PrimaryIdentitySpace - The type of identity contained in the PrimaryIdentityHash. One of MSACID, OrgIdCID, or UserObjectId.

  • Data_User_TenantId - The tenant that a user's subscription is tied to. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant.

  • DeviceInfo_BrowserName - Browser Name 

  • DeviceInfo_BrowserVersion - Browser Version 

  • DeviceInfo_Id - The globally unique device identifier for a device 

  • DeviceInfo_OsName - The name of the device OS 

  • DeviceInfo_OsVersion - The version of the operating system 

  • Event_ReceivedTime - The time the event was logged in the service 

  • M365aInfo_EnrolledTenantId - Enrolled tenant ID 

  • OriginalRoutingGeo - Identifies if the original routing geo is eu or not. 

  • Session_SamplingValue - A value in (0, 1) 

  • User_ActiveUserTenantId - Active user tenant ID 

  • User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • User_TelemetryRegion - Identifies the data boundary of the user 

  • UserInfo_TimeZone - The user's time zone relative to UTC.

  • WAC_ApplicationMode - Always logged blank 

  • WAC_ApplicationModeExtended - Always logged blank 

  • WAC_BrowserLanguage - Always logged blank 

  • WAC_ContentLanguage - Always logged blank 

  • WAC_Datacenter - Always logged blank 

  • WAC_Host - Always logged blank 

  • WAC_IsBusinessUser - Always logged blank 

  • WAC_IsEdu - Always logged blank 

  • WAC_IsSynthetic - Always logged blank 

  • WAC_OsVersion - Always logged blank 

  • WAC_Ring - Always logged blank 

  • WAC_ServerDocId - Server Document ID for the document that was scanned. It's always logged as blank. 

  • WAC_SessionOrigin - Always logged blank 

Office.StickyNotes.Web.SDK.BadDraftKey

Triggered when an exception occurs while converting draft key to ID (machine action) and is required for crash investigation.

The following fields are collected:

  • Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • baseData_properties_version - Version of properties such as PostChannel and PrivacyGuardPlugin 

  • Browser_Name - Always logged blank 

  • Browser_Version - Always logged blank 

  • Consent_AddInContentSourceLocation - Add In content source location 

  • Consent_AddInContentState - Add In content state 

  • Consent_ControllerConnectedServicesConsentTime - Indicates when the user chose the status of optional connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DiagnosticDataConsentTime - Indicates when the user provided the consent for diagnostic data. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DownloadContentConsentTime - Indicates when the user made the choice to enable or disable connected experiences that download online content. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_UserContentDependentConsentTime - Indicates when the user chose to enable or disable connected experiences that analyze content was made. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Culture_UiLanguage - Always logged blank 

  • Data_App_Name - The name of the application that is providing the data. Allows us to identify which application is showing an issue so we know how to address it.

  • Data_App_Platform - The broad classification of the platform on which the app is running. Allows us to identify on which platforms an issue may be occurring so that we can correctly prioritize the issue.

  • Data_App_Version - The version of the application. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

  • Data_AppInfo_Id - Name of the host application 

  • Data_AppInfo_Version - Version of the host application 

  • Data_Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • Data_Error_Code - Error Code

  • Data_Error_ErrorGroup - Error Group

  • Data_Error_Tag - Error Tag

  • Data_ErrorCode1 - Error Code 1

  • Data_ErrorCode2 - Error Code 2

  • Data_ErrorTag - Error Tag

  • Data_ErrorType - Error Type

  • Data_EventName - A unique name of a OneNote's event. OneNote events use this custom field to specify a unique name due to an engineering limitation in the past.

  • Data_ExpirationDate - A date in numerical format indicates when this event will be stop sending from clients

  • Data_FeedEnabled - Identifies if feed is enabled. 

  • Data_HostApp - Identifies the host app name that launches a sub-app. 

  • Data_HostSessionId - Uniquely identifies the host app session for a sub-app 

  • Data_Namespace - A namespace of the event. Allows us to group the event into groups.

  • Data_OTelJS_Sink - Sink used by OTel logger. It's always logged blank. 

  • Data_OTelJS_Version - Version of OTel logger 

  • Data_SamplePolicy - Identifies if the sample policy is Measure or Critical 

  • Data_SDX_AssetId - ONLY exists for store Add-ins. OMEX gives the Add in an AssetId when it goes into Store. It's always logged blank. 

  • Data_SDX_BrowserToken - Identifier that sits in the browser's cache 

  • Data_SDX_HostJsVersion - This is the platform-specific version of Office.js (for example, outlook web16.01.js) This contains the API surface for ad ins 

  • Data_SDX_Id - The GUID of an Add-in, which uniquely identifies it 

  • Data_SDX_InstanceId - Represents Add in document pair 

  • Data_SDX_MarketplaceType - Indicates where the Add-in installed from 

  • Data_SDX_OfficeJsVersion - This is the version of Office.js that will redirect to the platform-specific version. 

  • Data_SDX_SessionId - Session ID of the Add-in 

  • Data_SDX_Version - Version of the Add-in 

  • Data_Session_Id - Uniquely identifies a given session of data. Allows us to identify the impact of issues by evaluating the number of sessions that are impacted and if there are common features of those sessions.

  • Data_SessionCorrelationId - The globally unique identifier for the host's session.

  • Data_ShortEventName - A short name of an event. Allows us to identify the event that was being sent from the client. 

  • Data_StickyNotesSDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it. 

  • Data_User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • Data_User_PrimaryIdentityHash - A pseudonymous identifier that represents the current user.

  • Data_User_PrimaryIdentitySpace - The type of identity contained in the PrimaryIdentityHash. One of MSACID, OrgIdCID, or UserObjectId.

  • Data_User_TenantId - The tenant that a user's subscription is tied to. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant.

  • DeviceInfo_BrowserName - Browser Name 

  • DeviceInfo_BrowserVersion - Browser Version 

  • DeviceInfo_Id - The globally unique device identifier for a device 

  • DeviceInfo_OsName - The name of the device OS 

  • DeviceInfo_OsVersion - The version of the operating system 

  • Event_ReceivedTime - The time the event was logged in the service 

  • M365aInfo_EnrolledTenantId - Enrolled tenant ID 

  • OriginalRoutingGeo - Identifies if the original routing geo is eu or not. 

  • Session_SamplingValue - A value in (0, 1) 

  • User_ActiveUserTenantId - Active user tenant ID 

  • User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • User_TelemetryRegion - Identifies the data boundary of the user 

  • UserInfo_Language - Current language setting of the device to help us detect issues affecting certain languages 

  • UserInfo_TimeZone - The user's time zone relative to UTC.

  • WAC_ApplicationMode - Always logged blank 

  • WAC_ApplicationModeExtended - Always logged blank 

  • WAC_BrowserLanguage - Always logged blank 

  • WAC_ContentLanguage - Always logged blank 

  • WAC_Datacenter - Always logged blank 

  • WAC_Host - Always logged blank 

  • WAC_IsBusinessUser - Always logged blank 

  • WAC_IsEdu - Always logged blank 

  • WAC_IsSynthetic - Always logged blank 

  • WAC_OsVersion - Always logged blank 

  • WAC_Ring - Always logged blank 

  • WAC_ServerDocId - Server Document ID for the document that was scanned. It's always logged as blank. 

  • WAC_SessionOrigin - Always logged blank 

  • WAC_UiHost - Always logged blank 

  • WAC_UiHostIntegrationType - Always logged blank 

Office.StickyNotes.Web.SDK.FatalSyncError

Triggered when a 400 error occurs (machine action) and is required for crash investigation.

The following fields are collected:

  • Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • baseData_properties_version - Version of properties such as PostChannel and PrivacyGuardPlugin 

  • Browser_Name - Always logged blank 

  • Browser_Version - Always logged blank 

  • Consent_AddInContentSourceLocation - Add In content source location 

  • Consent_AddInContentState - Add In content state 

  • Consent_ControllerConnectedServicesConsentTime - Indicates when the user chose the status of optional connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DiagnosticDataConsentTime - Indicates when the user provided the consent for diagnostic data. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Culture_UiLanguage - Always logged blank 

  • Data_App_Name - The name of the application that is providing the data. Allows us to identify which application is showing an issue so we know how to address it.

  • Data_App_Platform - The broad classification of the platform on which the app is running. Allows us to identify on which platforms an issue may be occurring so that we can correctly prioritize the issue.

  • Data_App_Version - The version of the application. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

  • Data_AppInfo_Id - Name of the host application 

  • Data_AppInfo_Version - Version of the host application 

  • Data_Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • Data_Device_Id - A unique identifier for the device. Allows us to identify the distribution of issues across a set of devices.

  • Data_Error_Code - Error Code

  • Data_Error_ErrorGroup - Error Group

  • Data_Error_Tag - Error Tag

  • Data_ErrorCode1 - Error Code 1

  • Data_ErrorCode2 - Error Code 2

  • Data_ErrorTag - Error Tag

  • Data_ErrorType - Error Type

  • Data_EventName - A unique name of a OneNote's event. OneNote events use this custom field to specify a unique name due to an engineering limitation in the past.

  • Data_ExpirationDate - A date in numerical format indicates when this event will be stop sending from clients

  • Data_FeedEnabled - Identifies if feed is enabled. 

  • Data_HostApp - Identifies the host app name that launches a sub-app. 

  • Data_HostSessionId - Uniquely identifies the host app session for a sub-app 

  • Data_Namespace - A namespace of the event. Allows us to group the event into groups.

  • Data_OTelJS_Sink - Sink used by OTel logger. It's always logged blank. 

  • Data_OTelJS_Version - Version of OTel logger 

  • Data_SamplePolicy - Identifies if the sample policy is Measure or Critical 

  • Data_SDX_AssetId - ONLY exists for store Add-ins. OMEX gives the Add in an AssetId when it goes into Store. It's always logged blank. 

  • Data_SDX_BrowserToken - Identifier that sits in the browser's cache 

  • Data_SDX_HostJsVersion - This is the platform-specific version of Office.js (for example, outlook web16.01.js) This contains the API surface for ad ins 

  • Data_SDX_Id - The GUID of an Add-in, which uniquely identifies it 

  • Data_SDX_InstanceId - Represents Add in document pair 

  • Data_SDX_MarketplaceType - Indicates where the Add-in installed from 

  • Data_SDX_OfficeJsVersion - This is the version of Office.js that will redirect to the platform-specific version. 

  • Data_SDX_SessionId - Session ID of the Add-in 

  • Data_SDX_Version - Version of the Add-in 

  • Data_Session_Id - Uniquely identifies a given session of data. Allows us to identify the impact of issues by evaluating the number of sessions that are impacted and if there are common features of those sessions.

  • Data_SessionCorrelationId - The globally unique identifier for the host's session.

  • Data_ShortEventName - A short name of an event. Allows us to identify the event that was being sent from the client. 

  • Data_StickyNotesSDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it. 

  • Data_User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • Data_User_PrimaryIdentityHash - A pseudonymous identifier that represents the current user.

  • Data_User_PrimaryIdentitySpace - The type of identity contained in the PrimaryIdentityHash. One of MSACID, OrgIdCID, or UserObjectId.

  • Data_User_TenantId - The tenant that a user's subscription is tied to. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant.

  • DeviceInfo_BrowserName - Browser Name 

  • DeviceInfo_BrowserVersion - Browser Version 

  • DeviceInfo_Id - The globally unique device identifier for a device 

  • DeviceInfo_OsName - The name of the device OS 

  • DeviceInfo_OsVersion - The version of the operating system 

  • Event_ReceivedTime - The time the event was logged in the service 

  • M365aInfo_EnrolledTenantId - Enrolled tenant ID 

  • OriginalRoutingGeo - Identifies if the original routing geo is eu or not. 

  • Session_SamplingValue - A value in (0, 1) 

  • User_ActiveUserTenantId - Active user tenant ID 

  • User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • User_TelemetryRegion - Identifies the data boundary of the user 

  • UserInfo_Language - Current language setting of the device to help us detect issues affecting certain languages 

  • UserInfo_TimeZone - The user's time zone relative to UTC.

  • WAC_ApplicationMode - Always logged blank 

  • WAC_ApplicationModeExtended - Always logged blank 

  • WAC_BrowserLanguage - Always logged blank 

  • WAC_ContentLanguage - Always logged blank 

  • WAC_Datacenter - Always logged blank 

  • WAC_Host - Always logged blank 

  • WAC_IsBusinessUser - Always logged blank 

  • WAC_IsEdu - Always logged blank 

  • WAC_IsSynthetic - Always logged blank 

  • WAC_OsVersion - Always logged blank 

  • WAC_Ring - Always logged blank 

  • WAC_ServerDocId - Server Document ID for the document that was scanned. It's always logged as blank. 

  • WAC_SessionOrigin - Always logged blank 

  • WAC_UiHost - Always logged blank 

  • WAC_UiHostIntegrationType - Always logged blank 

Office.StickyNotes.Web.SDK.NoteReferencesCountLoggingFailed

Triggered when an exception occurs while logging count of note references (machine action) and is required for crash investigation.

The following fields are collected:

  • Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • baseData_properties_version - Version of properties such as PostChannel and PrivacyGuardPlugin 

  • Browser_Name - Always logged blank 

  • Browser_Version - Always logged blank 

  • Consent_AddInContentSourceLocation - Add In content source location 

  • Consent_AddInContentState - Add In content state 

  • Consent_ControllerConnectedServicesConsentTime - Indicates when the user chose the status of optional connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DiagnosticDataConsentTime - Indicates when the user provided the consent for diagnostic data. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DownloadContentConsentTime - Indicates when the user made the choice to enable or disable connected experiences that download online content. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_UserContentDependentConsentTime - Indicates when the user chose to enable or disable connected experiences that analyze content was made. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Culture_UiLanguage - Always logged blank 

  • Data_App_Name - The name of the application that is providing the data. Allows us to identify which application is showing an issue so we know how to address it.

  • Data_App_Platform - The broad classification of the platform on which the app is running. Allows us to identify on which platforms an issue may be occurring so that we can correctly prioritize the issue.

  • Data_App_Version - The version of the application. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

  • Data_Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • Data_Device_Id - A unique identifier for the device. Allows us to identify the distribution of issues across a set of devices.

  • Data_Error_Code - Error Code

  • Data_Error_ErrorGroup - Error Group

  • Data_Error_Tag - Error Tag

  • Data_ErrorCode1 - Error Code 1

  • Data_ErrorCode2 - Error Code 2

  • Data_ErrorTag - Error Tag

  • Data_ErrorType - Error Type

  • Data_EventName - A unique name of a OneNote's event. OneNote events use this custom field to specify a unique name due to an engineering limitation in the past.

  • Data_ExpirationDate - A date in numerical format indicates when this event will be stop sending from clients

  • Data_FeedEnabled - Identifies if feed is enabled. 

  • Data_HostApp - Identifies the host app name that launches a sub-app. 

  • Data_HostSessionId - Uniquely identifies the host app session for a sub-app 

  • Data_Namespace - A namespace of the event. Allows us to group the event into groups.

  • Data_OTelJS_Sink - Sink used by OTel logger. It's always logged blank. 

  • Data_OTelJS_Version - Version of OTel logger 

  • Data_SamplePolicy - Identifies if the sample policy is Measure or Critical 

  • Data_SDX_AssetId - ONLY exists for store Add-ins. OMEX gives the Add in an AssetId when it goes into Store. It's always logged blank. 

  • Data_SDX_BrowserToken - Identifier that sits in the browser's cache 

  • Data_SDX_HostJsVersion - This is the platform-specific version of Office.js (for example, outlook web16.01.js) This contains the API surface for ad ins 

  • Data_SDX_Id - The GUID of an Add-in, which uniquely identifies it 

  • Data_SDX_InstanceId - Represents Add in document pair 

  • Data_SDX_MarketplaceType - Indicates where the Add-in installed from 

  • Data_SDX_OfficeJsVersion - This is the version of Office.js that will redirect to the platform-specific version. 

  • Data_SDX_SessionId - Session ID of the Add-in 

  • Data_SDX_Version - Version of the Add-in 

  • Data_Session_Id - Uniquely identifies a given session of data. Allows us to identify the impact of issues by evaluating the number of sessions that are impacted and if there are common features of those sessions.

  • Data_SessionCorrelationId - The globally unique identifier for the host's session.

  • Data_ShortEventName - A short name of an event. Allows us to identify the event that was being sent from the client. 

  • Data_StickyNotesSDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it. 

  • DeviceInfo_BrowserName - Browser Name 

  • DeviceInfo_BrowserVersion - Browser Version 

  • Event_ReceivedTime - The time the event was logged in the service 

  • M365aInfo_EnrolledTenantId - Enrolled tenant ID 

  • OriginalRoutingGeo - Identifies if the original routing geo is eu or not. 

  • Release_IsOutOfServiceFork - It's always logged as true or blank 

  • Session_SamplingValue - A value in (0, 1) 

  • User_ActiveUserTenantId - Active user tenant ID 

  • User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • User_TelemetryRegion - Identifies the data boundary of the user 

  • WAC_ApplicationMode - Always logged blank 

  • WAC_ApplicationModeExtended - Always logged blank 

  • WAC_BrowserLanguage - Always logged blank 

  • WAC_ContentLanguage - Always logged blank 

  • WAC_Datacenter - Always logged blank 

  • WAC_Host - Always logged blank 

  • WAC_IsBusinessUser - Always logged blank 

  • WAC_IsEdu - Always logged blank 

  • WAC_IsSynthetic - Always logged blank 

  • WAC_OsVersion - Always logged blank 

  • WAC_Ring - Always logged blank 

  • WAC_ServerDocId - Server Document ID for the document that was scanned. It's always logged as blank. 

  • WAC_SessionOrigin - Always logged blank 

Office.StickyNotes.Web.SDK.ProfilePictureFetchError

Triggered when an error occurs while setting the profile picture (user action) and is required for crash investigation.

The following fields are collected:

  • Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • baseData_properties_version - Version of properties such as PostChannel and PrivacyGuardPlugin 

  • Browser_Name - Always logged blank 

  • Browser_Version - Always logged blank 

  • Consent_AddInContentSourceLocation - Add In content source location 

  • Consent_AddInContentState - Add In content state 

  • Consent_ControllerConnectedServicesConsentTime - Indicates when the user chose the status of optional connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DiagnosticDataConsentTime - Indicates when the user provided the consent for diagnostic data. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DownloadContentConsentTime - Indicates when the user made the choice to enable or disable connected experiences that download online content. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_UserContentDependentConsentTime - Indicates when the user chose to enable or disable connected experiences that analyze content was made. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Culture_UiLanguage - Always logged blank 

  • Data_App_Name - The name of the application that is providing the data. Allows us to identify which application is showing an issue so we know how to address it.

  • Data_App_Platform - The broad classification of the platform on which the app is running. Allows us to identify on which platforms an issue may be occurring so that we can correctly prioritize the issue.

  • Data_App_Version - The version of the application. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

  • Data_AppInfo_Id - Name of the host application 

  • Data_AppInfo_Version - Version of the host application 

  • Data_Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • Data_EventName - A unique name of a OneNote's event. OneNote events use this custom field to specify a unique name due to an engineering limitation in the past.

  • Data_ExpirationDate - A date in numerical format indicates when this event will be stop sending from clients

  • Data_FeedEnabled - Identifies if feed is enabled. 

  • Data_HostApp - Identifies the host app name that launches a sub-app. 

  • Data_HostSessionId - Uniquely identifies the host app session for a sub-app 

  • Data_Message - Error message

  • Data_Namespace - A namespace of the event. Allows us to group the event into groups.

  • Data_OTelJS_Sink - Sink used by OTel logger. It's always logged blank. 

  • Data_OTelJS_Version - Version of OTel logger 

  • Data_SamplePolicy - Identifies if the sample policy is Measure or Critical 

  • Data_SDX_BrowserToken - Identifier that sits in the browser's cache 

  • Data_SDX_HostJsVersion - This is the platform-specific version of Office.js (for example, outlook web16.01.js) This contains the API surface for ad ins 

  • Data_SDX_Id - The GUID of an Add-in, which uniquely identifies it 

  • Data_SDX_InstanceId - Represents Add in document pair 

  • Data_SDX_MarketplaceType - Indicates where the Add-in installed from 

  • Data_SDX_OfficeJsVersion - This is the version of Office.js that will redirect to the platform-specific version. 

  • Data_SDX_SessionId - Session ID of the Add-in 

  • Data_SDX_Version - Version of the Add-in 

  • Data_Session_Id - Uniquely identifies a given session of data. Allows us to identify the impact of issues by evaluating the number of sessions that are impacted and if there are common features of those sessions.

  • Data_SessionCorrelationId - The globally unique identifier for the host's session.

  • Data_ShortEventName - A short name of an event. Allows us to identify the event that was being sent from the client. 

  • Data_StickyNotesSDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it. 

  • Data_User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • Data_User_PrimaryIdentityHash - A pseudonymous identifier that represents the current user.

  • Data_User_PrimaryIdentitySpace - The type of identity contained in the PrimaryIdentityHash. One of MSACID, OrgIdCID, or UserObjectId.

  • Data_User_TenantId - The tenant that a user's subscription is tied to. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant.

  • DeviceInfo_BrowserName - Browser Name 

  • DeviceInfo_BrowserVersion - Browser Version 

  • DeviceInfo_Id - The globally unique device identifier for a device 

  • DeviceInfo_OsName - The name of the device OS 

  • DeviceInfo_OsVersion - The version of the operating system 

  • Event_ReceivedTime - The time the event was logged in the service 

  • M365aInfo_EnrolledTenantId - Enrolled tenant ID 

  • OriginalRoutingGeo - Identifies if the original routing geo is eu or not. 

  • Release_IsOutOfServiceFork - It's always logged as true or blank 

  • Session_SamplingValue - A value in (0, 1) 

  • User_ActiveUserTenantId - Active user tenant ID 

  • User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • User_TelemetryRegion - Identifies the data boundary of the user 

  • UserInfo_Language - Current language setting of the device to help us detect issues affecting certain languages 

  • UserInfo_TimeZone - The user's time zone relative to UTC.

  • WAC_ApplicationMode - Always logged blank 

  • WAC_ApplicationModeExtended - Always logged blank 

  • WAC_BrowserLanguage - Always logged blank 

  • WAC_ContentLanguage - Always logged blank 

  • WAC_Datacenter - Always logged blank 

  • WAC_Host - Always logged blank 

  • WAC_IsBusinessUser - Always logged blank 

  • WAC_IsEdu - Always logged blank 

  • WAC_IsSynthetic - Always logged blank 

  • WAC_OsVersion - Always logged blank 

  • WAC_Ring - Always logged blank 

  • WAC_ServerDocId - Server Document ID for the document that was scanned. It's always logged as blank. 

  • WAC_SessionOrigin - Always logged blank 

  • WAC_UiHost - Always logged blank 

  • WAC_UiHostIntegrationType - Always logged blank 

Office.StickyNotes.Web.SDK.ReactCrash

Triggered when a react crash ocurs (machine action) and is required for crash investigation.

The following fields are collected:

  • Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • baseData_properties_version - Version of properties such as PostChannel and PrivacyGuardPlugin 

  • Browser_Name - Always logged blank 

  • Browser_Version - Always logged blank 

  • Consent_AddInContentSourceLocation - Add In content source location 

  • Consent_AddInContentState - Add In content state 

  • Consent_ControllerConnectedServicesConsentTime - Indicates when the user chose the status of optional connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number. 

  • Consent_DiagnosticDataConsentTime - Indicates when the user provided the consent for diagnostic data. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DownloadContentConsentTime - Indicates when the user made the choice to enable or disable connected experiences that download online content. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_UserContentDependentConsentTime - Indicates when the user chose to enable or disable connected experiences that analyze content was made. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Culture_UiLanguage - Always logged blank 

  • Data_App_Name - The name of the application that is providing the data. Allows us to identify which application is showing an issue so we know how to address it.

  • Data_App_Platform - The broad classification of the platform on which the app is running. Allows us to identify on which platforms an issue may be occurring so that we can correctly prioritize the issue.

  • Data_App_Version - The version of the application. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

  • Data_AppInfo_Id - Name of the host application 

  • Data_AppInfo_Version - Version of the host application 

  • Data_Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • Data_Error_Code - Error Code

  • Data_Error_Tag - Error Tag

  • Data_ErrorCode1 - Error Code 1

  • Data_ErrorCode2 - Error Code 2

  • Data_ErrorTag - Error Tag

  • Data_EventName - A unique name of a OneNote's event. OneNote events use this custom field to specify a unique name due to an engineering limitation in the past.

  • Data_ExpirationDate - A date in numerical format indicates when this event will be stop sending from clients

  • Data_FeedEnabled - Identifies if feed is enabled. 

  • Data_HostApp - Identifies the host app name that launches a sub-app. 

  • Data_HostSessionId - Uniquely identifies the host app session for a sub-app 

  • Data_Namespace - A namespace of the event. Allows us to group the event into groups.

  • Data_OTelJS_Sink - Sink used by OTel logger. It's always logged blank. 

  • Data_OTelJS_Version - Version of OTel logger 

  • Data_SamplePolicy - Identifies if the sample policy is Measure or Critical 

  • Data_SDX_BrowserToken - Identifier that sits in the browser's cache 

  • Data_SDX_HostJsVersion - This is the platform-specific version of Office.js (for example, outlook web16.01.js) This contains the API surface for ad ins 

  • Data_SDX_Id - The GUID of an Add-in, which uniquely identifies it 

  • Data_SDX_InstanceId - Represents Add in document pair 

  • Data_SDX_MarketplaceType - Indicates where the Add-in installed from 

  • Data_SDX_OfficeJsVersion - This is the version of Office.js that will redirect to the platform-specific version. 

  • Data_SDX_SessionId - Session ID of the Add-in 

  • Data_SDX_Version - Version of the Add-in 

  • Data_Session_Id - Uniquely identifies a given session of data. Allows us to identify the impact of issues by evaluating the number of sessions that are impacted and if there are common features of those sessions.

  • Data_SessionCorrelationId - The globally unique identifier for the host's session.

  • Data_ShortEventName - A short name of an event. Allows us to identify the event that was being sent from the client. 

  • Data_StickyNotesSDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it. 

  • Data_User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • Data_User_PrimaryIdentityHash - A pseudonymous identifier that represents the current user.

  • Data_User_PrimaryIdentitySpace - The type of identity contained in the PrimaryIdentityHash. One of MSACID, OrgIdCID, or UserObjectId.

  • Data_User_TenantId - The tenant that a user's subscription is tied to. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant.

  • DeviceInfo_BrowserName - Browser Name 

  • DeviceInfo_BrowserVersion - Browser Version 

  • DeviceInfo_Id - The globally unique device identifier for a device 

  • DeviceInfo_OsName - The name of the device OS 

  • DeviceInfo_OsVersion - The version of the operating system 

  • Event_ReceivedTime - The time the event was logged in the service 

  • M365aInfo_EnrolledTenantId - Enrolled tenant ID 

  • OriginalRoutingGeo - Identifies if the original routing geo is eu or not. 

  • Release_IsOutOfServiceFork - It's always logged as true or blank 

  • Session_SamplingValue - A value in (0, 1) 

  • User_ActiveUserTenantId - Active user tenant ID 

  • User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • User_TelemetryRegion - Identifies the data boundary of the user 

  • UserInfo_Language - Current language setting of the device to help us detect issues affecting certain languages 

  • UserInfo_TimeZone - The user's time zone relative to UTC.

  • WAC_ApplicationMode - Always logged blank 

  • WAC_ApplicationModeExtended - Always logged blank 

  • WAC_BrowserLanguage - Always logged blank 

  • WAC_ContentLanguage - Always logged blank 

  • WAC_Datacenter - Always logged blank 

  • WAC_Host - Always logged blank 

  • WAC_IsBusinessUser - Always logged blank 

  • WAC_IsEdu - Always logged blank 

  • WAC_IsSynthetic - Always logged blank 

  • WAC_OsVersion - Always logged blank 

  • WAC_Ring - Always logged blank 

  • WAC_ServerDocId - Server Document ID for the document that was scanned. It's always logged as blank. 

  • WAC_SessionOrigin - Always logged blank 

  • WAC_UiHost - Always logged blank 

  • WAC_UiHostIntegrationType - Always logged blank 

Office.StickyNotes.Web.SDK.SDKException

Triggered when an unexpected event occurs (machine action) and is required for crash investigation.

The following fields are collected:

  • Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • baseData_properties_version - Version of properties such as PostChannel and PrivacyGuardPlugin 

  • Browser_Name - Always logged blank 

  • Browser_Version - Always logged blank 

  • Consent_AddInContentSourceLocation - Add In content source location 

  • Consent_AddInContentState - Add In content state 

  • Consent_ControllerConnectedServicesConsentTime - Indicates when the user chose the status of optional connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DiagnosticDataConsentTime - Indicates when the user provided the consent for diagnostic data. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DownloadContentConsentTime - Indicates when the user made the choice to enable or disable connected experiences that download online content. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_UserContentDependentConsentTime - Indicates when the user chose to enable or disable connected experiences that analyze content was made. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Culture_UiLanguage - Always logged blank 

  • Data_App_Name - The name of the application that is providing the data. Allows us to identify which application is showing an issue so we know how to address it.

  • Data_App_Platform - The broad classification of the platform on which the app is running. Allows us to identify on which platforms an issue may be occurring so that we can correctly prioritize the issue.

  • Data_App_Version - The version of the application. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

  • Data_Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • Data_Device_Id - A unique identifier for the device. Allows us to identify the distribution of issues across a set of devices.

  • Data_Error_Code - Error Code

  • Data_Error_ErrorGroup - Error Group

  • Data_Error_Tag - Error Tag

  • Data_ErrorCode1 - Error Code 1

  • Data_ErrorCode2 - Error Code 2

  • Data_ErrorTag - Error Tag

  • Data_ErrorType - Error Type

  • Data_EventName - A unique name of a OneNote's event. OneNote events use this custom field to specify a unique name due to an engineering limitation in the past.

  • Data_ExpirationDate - A date in numerical format indicates when this event will be stop sending from clients

  • Data_FeedEnabled - Identifies if feed is enabled. 

  • Data_HostApp - Identifies the host app name that launches a sub-app. 

  • Data_HostSessionId - Uniquely identifies the host app session for a sub-app 

  • Data_Namespace - A namespace of the event. Allows us to group the event into groups.

  • Data_OTelJS_Sink - Sink used by OTel logger. It's always logged blank. 

  • Data_OTelJS_Version - Version of OTel logger 

  • Data_SamplePolicy - Identifies if the sample policy is Measure or Critical 

  • Data_SDX_AssetId - ONLY exists for store Add-ins. OMEX gives the Add in an AssetId when it goes into Store. It's always logged blank. 

  • Data_SDX_BrowserToken - Identifier that sits in the browser's cache 

  • Data_SDX_HostJsVersion - This is the platform-specific version of Office.js (for example, outlook web16.01.js) This contains the API surface for ad ins 

  • Data_SDX_Id - The GUID of an Add-in, which uniquely identifies it 

  • Data_SDX_InstanceId - Represents Add in document pair 

  • Data_SDX_MarketplaceType - Indicates where the Add-in installed from 

  • Data_SDX_OfficeJsVersion - This is the version of Office.js that will redirect to the platform-specific version. 

  • Data_SDX_SessionId - Session ID of the Add-in 

  • Data_SDX_Version - Version of the Add-in 

  • Data_Session_Id - Uniquely identifies a given session of data. Allows us to identify the impact of issues by evaluating the number of sessions that are impacted and if there are common features of those sessions.

  • Data_SessionCorrelationId - The globally unique identifier for the host's session.

  • Data_ShortEventName - A short name of an event. Allows us to identify the event that was being sent from the client. 

  • Data_StickyNotesSDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it. 

  • DeviceInfo_BrowserName - Browser Name 

  • DeviceInfo_BrowserVersion - Browser Version 

  • Event_ReceivedTime - The time the event was logged in the service 

  • M365aInfo_EnrolledTenantId - Enrolled tenant ID 

  • OriginalRoutingGeo - Identifies if the original routing geo is eu or not. 

  • Release_IsOutOfServiceFork - It's always logged as true or blank 

  • Session_SamplingValue - A value in (0, 1) 

  • User_ActiveUserTenantId - Active user tenant ID 

  • User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • User_TelemetryRegion - Identifies the data boundary of the user 

  • WAC_ApplicationMode - Always logged blank 

  • WAC_ApplicationModeExtended - Always logged blank 

  • WAC_BrowserLanguage - Always logged blank 

  • WAC_ContentLanguage - Always logged blank 

  • WAC_Datacenter - Always logged blank 

  • WAC_Host - Always logged blank 

  • WAC_IsBusinessUser - Always logged blank 

  • WAC_IsEdu - Always logged blank 

  • WAC_IsSynthetic - Always logged blank 

  • WAC_OsVersion - Always logged blank 

  • WAC_Ring - Always logged blank 

  • WAC_ServerDocId - Server Document ID for the document that was scanned. It's always logged as blank. 

  • WAC_SessionOrigin - Always logged blank

Office.StickyNotes.Web.SDK.TextAndCharMetadataLengthMismatch

Triggered when there's a length mismatch between text and char metadata (machine action) and is required for crash investigation.

The following fields are collected:

  • Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • baseData_properties_version - Version of properties such as PostChannel and PrivacyGuardPlugin 

  • Browser_Name - Always logged blank 

  • Browser_Version - Always logged blank 

  • Consent_AddInContentSourceLocation - Add In content source location 

  • Consent_AddInContentState - Add In content state 

  • Consent_ControllerConnectedServicesConsentTime - Indicates when the user chose the status of optional connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DiagnosticDataConsentTime - Indicates when the user provided the consent for diagnostic data. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DownloadContentConsentTime - Indicates when the user made the choice to enable or disable connected experiences that download online content. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_UserContentDependentConsentTime - Indicates when the user chose to enable or disable connected experiences that analyze content was made. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Culture_UiLanguage - Always logged blank 

  • Data_App_Name - The name of the application that is providing the data. Allows us to identify which application is showing an issue so we know how to address it.

  • Data_App_Platform - The broad classification of the platform on which the app is running. Allows us to identify on which platforms an issue may be occurring so that we can correctly prioritize the issue.

  • Data_App_Version - The version of the application. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

  • Data_AppInfo_Id - Name of the host application 

  • Data_AppInfo_Version - Version of the host application 

  • Data_Audience - Identifies "Dogfood", "Insiders", "Microsoft" or "Production" 

  • Data_Error_Code - Error Code

  • Data_Error_Tag - Error Tag

  • Data_ErrorCode1 - Error Code 1

  • Data_ErrorCode2 - Error Code 2

  • Data_ErrorTag - Error Tag

  • Data_EventName - A unique name of a OneNote's event. OneNote events use this custom field to specify a unique name due to an engineering limitation in the past.

  • Data_ExpirationDate - A date in numerical format indicates when this event will be stop sending from clients

  • Data_FeedEnabled - Identifies if feed is enabled. 

  • Data_HostApp - Identifies the host app name that launches a sub-app. 

  • Data_HostSessionId - Uniquely identifies the host app session for a sub-app 

  • Data_Namespace - A namespace of the event. Allows us to group the event into groups.

  • Data_OTelJS_Sink - Sink used by OTel logger. It's always logged blank. 

  • Data_OTelJS_Version - Version of OTel logger 

  • Data_SamplePolicy - Identifies if the sample policy is Measure or Critical 

  • Data_SDX_BrowserToken - Identifier that sits in the browser's cache 

  • Data_SDX_HostJsVersion - This is the platform-specific version of Office.js (for example, outlook web16.01.js) This contains the API surface for ad ins 

  • Data_SDX_Id - The GUID of an Add-in, which uniquely identifies it 

  • Data_SDX_InstanceId - Represents Add in document pair 

  • Data_SDX_MarketplaceType - Indicates where the Add-in installed from 

  • Data_SDX_OfficeJsVersion - This is the version of Office.js that will redirect to the platform-specific version. 

  • Data_SDX_SessionId - Session ID of the Add-in 

  • Data_SDX_Version - Version of the Add-in 

  • Data_Session_Id - Uniquely identifies a given session of data. Allows us to identify the impact of issues by evaluating the number of sessions that are impacted and if there are common features of those sessions.

  • Data_SessionCorrelationId - The globally unique identifier for the host's session.

  • Data_ShortEventName - A short name of an event. Allows us to identify the event that was being sent from the client. 

  • Data_StickyNotesSDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it. 

  • Data_User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • Data_User_PrimaryIdentityHash - A pseudonymous identifier that represents the current user.

  • Data_User_PrimaryIdentitySpace - The type of identity contained in the PrimaryIdentityHash. One of MSACID, OrgIdCID, or UserObjectId.

  • Data_User_TenantId - The tenant that a user's subscription is tied to. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant.

  • DeviceInfo_BrowserName - Browser Name 

  • DeviceInfo_BrowserVersion - Browser Version 

  • DeviceInfo_Id - The globally unique device identifier for a device 

  • DeviceInfo_OsName - The name of the device OS 

  • DeviceInfo_OsVersion - The version of the operating system 

  • Event_ReceivedTime - The time the event was logged in the service 

  • M365aInfo_EnrolledTenantId - Enrolled tenant ID 

  • OriginalRoutingGeo - Identifies if the original routing geo is eu or not. 

  • Session_SamplingValue - A value in (0, 1) 

  • User_ActiveUserTenantId - Active user tenant ID 

  • User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • User_TelemetryRegion - Identifies the data boundary of the user 

  • UserInfo_Language - Current language setting of the device to help us detect issues affecting certain languages 

  • UserInfo_TimeZone - The user's time zone relative to UTC.

  • WAC_ApplicationMode - Always logged blank 

  • WAC_ApplicationModeExtended - Always logged blank 

  • WAC_BrowserLanguage - Always logged blank 

  • WAC_ContentLanguage - Always logged blank 

  • WAC_Datacenter - Always logged blank 

  • WAC_Host - Always logged blank 

  • WAC_IsBusinessUser - Always logged blank 

  • WAC_IsEdu - Always logged blank 

  • WAC_IsSynthetic - Always logged blank 

  • WAC_OsVersion - Always logged blank 

  • WAC_Ring - Always logged blank 

  • WAC_ServerDocId - Server Document ID for the document that was scanned. It's always logged as blank. 

  • WAC_SessionOrigin - Always logged blank 

  • WAC_UiHost - Always logged blank 

  • WAC_UiHostIntegrationType - Always logged blank 

Office.StickyNotes.Web.SDK.Trace

These are diagnostic traces which aren't logged immediately but put into a ring buffer. They're flushed only when an exception occurs which is also being caught and logged as a separate data event. These diagnostic traces supplement the exceptions being logged while investigating crashes. The exception may occur anywhere in one of the following experiences:

  1. Feed experience in OneNote for Windows 10
  2. Feed experience in OneNote Win32 desktop application
  3. Feed experience in OneNote Online
  4. Feed experience in Outlook Web App
  5. Feed experience in Microsoft Edge sidebar
  6. OneNote Sticky Notes

The exception which is logged as a separate data event helps in identifying its origin. The corresponding diagnostic traces that are logged with this event provide additional information to investigate the issue further.

The following fields are collected:

  • Audience - Identifies “Dogfood”, “Insiders”, “Microsoft” or “Production” 

  • baseData_properties_version - Version of properties such as PostChannel and PrivacyGuardPlugin 

  • Browser_Name - Always logged blank 

  • Browser_Version - Always logged blank 

  • Consent_AddInContentSourceLocation - Add In content source location 

  • Consent_AddInContentState - Add In content state 

  • Consent_ControllerConnectedServicesConsentTime - Indicates when the user chose the status of optional connected experiences. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DiagnosticDataConsentTime - Indicates when the user provided the consent for diagnostic data. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_DownloadContentConsentTime - Indicates when the user made the choice to enable or disable connected experiences that download online content. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Consent_UserContentDependentConsentTime - Indicates when the user chose to enable or disable connected experiences that analyze content was made. The date will appear as either a human readable date or as a machine encoded date that looks like a large number.

  • Culture_UiLanguage - Always logged blank 

  • Data_App_Name - The name of the application that is providing the data. Allows us to identify which application is showing an issue so we know how to address it.

  • Data_App_Platform - The broad classification of the platform on which the app is running. Allows us to identify on which platforms an issue may be occurring so that we can correctly prioritize the issue.

  • Data_App_Version - The version of the application. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it.

  • Data_AppInfo_Id - Name of the host application 

  • Data_AppInfo_Version - Version of the host application 

  • Data_Audience - Identifies “Dogfood”, “Insiders”, “Microsoft” or “Production” 

  • Data_CharMetadataLength - Length of character metadata

  • Data_ComponentStack - The component stack of the error boundary.

  • Data_ConnectingInMS - Time (in ms) to retry realtime connection.

  • Data_DeltaToken - Delta Token

  • Data_Device_Id - A unique identifier for the device. Allows us to identify the distribution of issues across a set of devices.

  • Data_Endpoint - Identifies "ConnectedNotes", "NoteReferences" or "Notes"

  • Data_EndsInMS - Rate limit wait time (in ms)

  • Data_ErrorCode - Error Code

  • Data_ErrorCode1 - Error Code 1

  • Data_ErrorCode2 - Error Code 2

  • Data_ErrorMessage - Error Message

  • Data_ErrorStack - The stacktrace of the error.

  • Data_ErrorTag - Error Tag

  • Data_ErrorType - Error Type

  • Data_EventName - A unique name of a OneNote's event. OneNote events use this custom field to specify a unique name due to an engineering limitation in the past.

  • Data_ExpirationDate - A date in numerical format indicates when this event will be stop sending from clients

  • Data_FeedEnabled - Identifies if feed is enabled. 

  • Data_HostApp - Identifies the host app name that launches a sub-app. 

  • Data_HostSessionId - Uniquely identifies the host app session for a sub-app 

  • Data_HttpCode - HTTP code of the failure

  • Data_HttpStatus - Response code

  • Data_InstanceId - Instance ID

  • Data_IsSyncScore - Boolean to indicate if this is sync score

  • Data_Key - Draft JS Key

  • Data_Media - Remote Media ID

  • Data_MediaId - Local Media ID

  • Data_Message - Error Message

  • Data_Name - Helps in distinguishing between same trace events triggered from different points

  • Data_Namespace - A namespace of the event. Allows us to group the event into groups.

  • Data_NewOperation - Type of new operation

  • Data_NoteId - Note ID

  • Data_Operation - Type of operation

  • Data_OperationId - ID of the failed operation

  • Data_OperationPriority - Priority of the failed operation

  • Data_OperationRetryCount - Retry count of the failed operation

  • Data_OperationType - Type of operation

  • Data_OTelJS_Sink - Sink used by OTel logger. It's always logged blank. 

  • Data_OTelJS_Version - Version of OTel logger 

  • Data_Parsed - Boolean to indicate if error body is missing

  • Data_RequestId - ID of the failed request

  • Data_RequestPriority - Request priority

  • Data_ResultId - ID of the failed result

  • Data_Retry - Boolean to indicate if retry is set to true or false

  • Data_RetryAfterInt - Retry-After header parsed to an integer

  • Data_RetryAfterRaw - Raw Retry-After header

  • Data_RetryInMs - Time (in ms) to retry image download.

  • Data_SamplePolicy - Identifies if the sample policy is Measure or Critical 

  • Data_Scope - Helps in distinguishing between same trace events triggered from different points

  • Data_SDX_AssetId - ONLY exists for store Add-ins. OMEX gives the Add in an AssetId when it goes into Store. It's always logged blank. 

  • Data_SDX_BrowserToken - Identifier that sits in the browser's cache 

  • Data_SDX_HostJsVersion - This is the platform-specific version of Office.js (for example, outlook web16.01.js) This contains the API surface for ad ins 

  • Data_SDX_Id - The GUID of an Add-in, which uniquely identifies it 

  • Data_SDX_InstanceId - Represents Add in document pair 

  • Data_SDX_MarketplaceType - Indicates where the Add-in installed from 

  • Data_SDX_OfficeJsVersion - This is the version of Office.js that will redirect to the platform-specific version. 

  • Data_SDX_SessionId - Session ID of the Add-in 

  • Data_SDX_Version - Version of the Add-in 

  • Data_ServiceRequestId - request-id error response header

  • Data_ServiceXCalculatedBETarget - x-calculatedbetarget error response header

  • Data_Session_Id - Uniquely identifies a given session of data. Allows us to identify the impact of issues by evaluating the number of sessions that are impacted and if there are common features of those sessions.

  • Data_SessionCorrelationId - The globally unique identifier for the host's session.

  • Data_ShortEventName - A short name of an event. Allows us to identify the event that was being sent from the client. 

  • Data_Stack - The stacktrace of the error.

  • Data_StickyNotesSDKVersion - Version number indicating the version of Sticky Notes the user is using. Allows us to identify which versions of the product are showing an issue so that we can correctly prioritize it. 

  • Data_TextLength - Length of text

  • Data_ToVersion - Version to which database is upgrading

  • Data_Type - Type of action

  • Data_User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • Data_User_PrimaryIdentityHash - A pseudonymous identifier that represents the current user.

  • Data_User_PrimaryIdentitySpace - The type of identity contained in the PrimaryIdentityHash. One of MSACID, OrgIdCID, or UserObjectId.

  • Data_User_TenantId - The tenant that a user's subscription is tied to. Allows us to classify issues and identify whether a problem is widespread or isolated to a set of users or a specific tenant.

  • DeviceInfo_BrowserName - Browser Name 

  • DeviceInfo_BrowserVersion - Browser Version 

  • DeviceInfo_Id - The globally unique device identifier for a device 

  • DeviceInfo_OsName - The name of the device OS 

  • DeviceInfo_OsVersion - The version of the operating system 

  • Event_ReceivedTime - The time the event was logged in the service 

  • M365aInfo_EnrolledTenantId - Enrolled tenant ID 

  • OriginalRoutingGeo - Identifies if the original routing geo is eu or not. 

  • Release_IsOutOfServiceFork - It's always logged as true or blank 

  • Session_SamplingValue - A value in (0, 1) 

  • User_ActiveUserTenantId - Active user tenant ID 

  • User_IsAnonymous - Identifies if the current user is anonymous. It's always logged as false or blank. 

  • User_TelemetryRegion - Identifies the data boundary of the user 

  • UserInfo_Language - Current language setting of the device to help us detect issues affecting certain languages 

  • UserInfo_TimeZone - The user's time zone relative to UTC.

  • WAC_ApplicationMode - Always logged blank 

  • WAC_ApplicationModeExtended - Always logged blank 

  • WAC_BrowserLanguage - Always logged blank 

  • WAC_ContentLanguage - Always logged blank 

  • WAC_Datacenter - Always logged blank 

  • WAC_Host - Always logged blank 

  • WAC_IsBusinessUser - Always logged blank 

  • WAC_IsEdu - Always logged blank 

  • WAC_IsSynthetic - Always logged blank 

  • WAC_NetworkDownlink - Always logged blank

  • WAC_NetworkDownlinkMax - Always logged blank

  • WAC_NetworkRTT - Always logged blank

  • WAC_NetworkSaveData - Always logged blank

  • WAC_OsVersion - Always logged blank 

  • WAC_Ring - Always logged blank 

  • WAC_ServerDocId - Server Document ID for the document that was scanned. It's always logged as blank. 

  • WAC_SessionOrigin - Always logged blank 

  • WAC_UiHost - Always logged blank 

  • WAC_UiHostIntegrationType - Always logged blank 

Office.System.SystemHealthAsserts

The errors this event identifies help us understand when the customer experience is degrading. Many of these ShipAsserts lead to crashes and this information makes it possible to fix many of those. Collects ShipAsserts from the product, which helps to identify errors.

The following fields are collected:

  • Count – The count of each assert reported

  • EndTime – Time at which the last assert reported occurred

  • ErrorGroup – A bucketing identifier for each assert

  • FirstTimeStamp – The first time at which the assert occurred

  • Trackback – A unique identifier for a specific assert

Office.System.SystemHealthErrorsEtwShim

Used to identify customer impacting issues within the running app that may manifest as crashes or degraded functionality. Records errors that occur during process run time.

The following fields are collected:

  • EndTime – The time at which the last error reported occurred

  • Trackback – A unique identifier for a specific error

  • ErrorGroup – A bucketing identifier for each error

  • Count – The count of each error

  • FirstTimeStamp – The first time at which the error occurred

Office.System.SystemHealthErrorsUlsAndAsserts

Used to identify customer impacting issues within the running app that may manifest as crashes or degraded functionality. Records errors that occur during process run time.

The following fields are collected:

  • EndTime – The time at which the last error reported occurred

  • Trackback – A unique identifier for a specific error

  • ErrorGroup – A bucketing identifier for each error

  • Count – The count of each error

  • FirstTimeStamp – The first time at which the error occurred

Office.System.SystemHealthErrorsUlsWorkaround

Used to identify customer impacting issues within the running app that may manifest as crashes or degraded functionality. Records errors that occur during process runtime

The following fields are collected:

  • EndTime – The time at which the last error reported occurred

  • Trackback – A unique identifier for a specific error

  • ErrorGroup – A bucketing identifier for each error

  • Count – The count of each error

Office.System.SystemHealthErrorsWithoutTag

Used to identify customer impacting issues within the running app that may manifest as crashes or degraded functionality. Records errors that occur during process runtime.

The following fields are collected:

Count - The count of each error

  • EndTime - The time at which the last error reported occurred

  • ErrorCode – An identifier for the error

  • ErrorGroup - A bucketing identifier for each error

  • ErrorId – An identifier for the error

  • FirstTimeStamp - The first time at which the error occurred

  • Trackback - A unique identifier for a specific error

Office.System.SystemHealthErrorsWithTag

Used to identify customer impacting issues within the running app that may manifest as crashes or degraded functionality. Records errors that occur during process runtime.

The following fields are collected:

  • Count - The count of each error

  • EndTime - The time at which the last error reported occurred

  • ErrorCode – An identifier for the error

  • ErrorGroup - A bucketing identifier for each error

  • ErrorId – An identifier for the error

  • FirstTimeStamp - The first time at which the error occurred

  • Trackback - A unique identifier for a specific error

Office.Taos.Hub.Windows.Error

This event gets triggered when the control goes to error state. This event is used to record the details of the error occurred.

The following fields are collected:

  • AppInfo_Id - The App ID.

  • AppInfo_Version - Office desktop app version.

  • AppType - The type of the container, from which logs are emitted.

  • BridgeInstanceId - A unique ID given to the Office windows app instance, used to corelate all the events from a single app session. We can't derive any PII from this ID.

  • DeviceInfo_Id - A unique device ID calculated by 1DS SDK.

  • DeviceInfo_Make - The device make.

  • DeviceInfo_Model - The device model.

  • DeviceInfo_NetworkCost - Network cost type of the user (Unmetered, metered, etc.)

  • DeviceInfo_NetworkType - The type of network (Wi-Fi, Wired, Unknown).

  • DeviceInfo_OsName - OS name installed in the user's device.

  • DeviceInfo_OsVersion - The OS version installed in the user's device.

  • DeviceInfo_SDKUid - Unique identifier for the SDK.

  • EventInfo_BaseEventType - The event type.

  • EventInfo_BaseType - The type of the event.

  • EventInfo_Level - The event level.

  • EventInfo_Name - The name of the event.

  • EventInfo_PrivTags - The event tags.

  • EventInfo_Source - The source of the event. For example, OneCollector

  • EventInfo_SdkVersion - 1DS SDK Version.

  • EventInfo_Time - The time of the event.

  • Failure_Detail - Method name in which error occurred.

  • Failure_Signature - Signature of the failure.

  • Feature - The name of the feature.

  • M365aInfo_EnrolledTenantId - The Enrollment TenantID.

  • Message - The error message.

  • PerformanceMarkerTimestamp - The Performance Timestamp.

  • PipelineInfo_AccountId - Aria Pipeline account ID

  • PipelineInfo_ClientCountry - The device country or region (based on IP address).

  • PipelineInfo_ClientIp - The first three octets of the IP address.

  • PipelineInfo_IngestionTime - Ingestion time of the event.

  • UserInfo_TimeZone - Time zone of the user.

RenewIdentityFailure

Collected when a user attempts to open an IRM protected doc or apply IRM protections. It contains the information needed to be able to properly investigate and diagnose issues that happen when failed to renew user certificates.

The following fields are collected:

  • AppInfo.ClientHierarchy - Client hierarchy, which indicates the application runs in production environment or developer environment

  • AppInfo.Name - Application name.

  • AppInfo.Version - Application version

  • Failure.Category - The category of the failure "UnhandledError"

  • Failure.Detail - The detailed info of the failure

  • Failure.Id - Failure ID

  • Failure.Signature - The signature of the failure, which is same as the event name

  • iKey - Logging service server ID

  • RMS.HRESULT - The result of renewing user certificate

  • RMS.ScenarioId - Scenario ID defined by Rights Management Service Client

  • RMS.SDKVersion - The version of Rights Management Service Client

save.error

Allows us to detect and fix situations where there was an error when you attempted to save a file. It tracks errors caused by failures to save a file, including a descriptive error message to help us resolve the issue.

The following fields are collected:

  • error - The type of error that happened to help us detect and resolve issues related to a specific error type

  • file_type - The type of file the user tried to save (such as .doc)

  • origin - Where the file save attempt originated from (such as from an email) so we can detect issues associated with saving a file from a specific place in the app

  • token_type - the type of token used to authenticate the account in order to save the file to help us detect authentication issues associated with saving a file

wkwebview.error

This event lets us detect when web view errors occurred when composing or reading email so that we can prevent issues that could cause your app can’t compose email or read email.

The following fields are collected:

  • description - description for the error

  • error_code - error code for WKError

  • function_name - JavaScript function name when error

  • js_exception_column_number - The column number where JavaScript exception occurred

  • js_exception_line_number - The line number where JavaScript exception occurred

  • js_exception_message - The exception message when JavaScript exception occurred

  • js_exception_source_url - The source URL where JavaScript exception occurred

  • scenario - where the error occurred. It’s an enum. Possible values are old_renderer, react_renderer, and composing.

Device connectivity and configuration​ data events

The following are the data subtypes in this category:

Device connectivity and configuration subtype

Network connection state and device settings, such as memory.

application.did.receive.memory.warning

This event is sent when Apple tells us that the application is running out of memory. It tells us that we have introduced an issue with memory management on your device.

The following fields are collected:

  • current_memory_used - Tells us the amount of memory used by the application at the point the application has run out of memory.

  • current_memory_used_percentage - Tell us the percentage of memory used by the application out of the total memory available at the point the application has run out of memory.

  • currentVC - Tells us the view that is currently showing when the application has run out of memory.

  • has_hx - Tells us the account is using our new sync service to help us detect issues caused by our sync service

  • is_watch_app_installed - Tells us if the user is currently using an Apple Watch and whether it's installed to help us understand the negative performance impact due to the Watch

  • is_watch_paired - Tells us if the user is currently using an Apple Watch and whether it's paired with the device to help us understand the negative performance impact due to the Watch

  • is_watch_supported_and_active - Tells us if the user is currently using an Apple Watch and whether it's active to help us understand the negative performance impact due to the Watch

  • rn_initialized - Tell us if React Native has been initialized at the point the application has run out of memory.

  • running_time - Tell us the amount of time that app has spent running at the time the application has run out of memory.

conversation.memory.leak

Allows us to detect situations where our email conversation view is causing us to use up more memory on your device that expected.

The following fields are collected:

  • No fields or added data are collected. Only logs are collected if there's a memory leak related to a conversation thread.

core.data.corruption

Allows us to detect situations where we can't show you your email or calendar because where we store your email on your device has become corrupted.

The following fields are collected:

core.data.corruption.user.reset

Allows us to detect situations where you have deleted or reset your account in our app and it was caused by a corruption in email data we've stored on your device.

The following fields are collected:

  • errorSource - dictates where the corruption occurred whether during save or create

core.data.diagnostics

Allows us to detect and fix situations where our email storage is using up too much of your device storage space.

The following fields are collected:

  • db_size_megabytes - tracks the size of the core data database rounded to the nearest 25 megabytes and with a maximum megabyte of 500

general.properties.log

This event collects information that allows us to categorize and classify issues within the Outlook app that are related to accessibility and device settings. This categorization is necessary to prioritize the impact of issues on customers.

The following fields are collected for iOS:

  • alternate_app_icon- Tell us the alternate app icon that user currently selected by the application

  • app_lock_disabled_reason - Tells us if the applock feature is disabled by us, if so for what reason

  • app_lock_state - Tells us if the applock feature is turned_on/turned_off on a device

  • bold_text - Tells us if the device has bold text turned on to help us detect issues related to bold text

  • closed_captioning - Tells us if the user has turned on closed captioning on their device to help us detect issues related to closed captioning

  • connected_apps_sync_state - Tells us if the user has turned on connected app sync to help us detect issues related to this setting.

  • contacts_sort_by - Tracks whether the contacts are sorted by either first name or last name

  • darker_system_colors - Tells us if the user has turned on darkening of system colors on their device to help us detect issues related to this setting

  • default_density_setting - The default density mode the user should get the first time they experience inbox density

  • gray_scale - Tells us if the user has turned on gray scale on their device to help us detect issues related to this setting

  • guided_access - Tells us if the user has turned on guided access on their device to help us detect issues related to this setting

  • has_custom_app_language - indicates whether user set a custom Outlook app language that is different from the device language setting.

  • invert_colors - Tells us if the user has turned on the setting to invert colors on their device to help us detect issues related to this setting

  • left_swipe_setting - Tells us which mail triage action the user has set for their left swipe setting.

  • message_ordering_mode - Tells us which setting the user has chosen to order their messages in the reading pane, either newest on top or newest on bottom.

  • mono_audio - Tells us if the user has turned on the setting for mono audio on their device to help us detect issues related to this setting

  • reduce_motion - Tells us if the user has turned on the setting for reducing motion on their device to help us detect issues related to this setting

  • reduce_transparency - Tells us if the user has turned on the setting to reduce transparency on their device to help us detect issues related to this setting

  • right_swipe_setting - Tells us which mail triage action the user has set for their right swipe setting.

  • speak_screen - Tells us if the user has turned on the setting for mono audio on their device to help us detect issues related to this setting

  • speak_selection - Tells us if the user has turned on the setting for Speak Selection on their device to help us detect issues related to this setting

  • switch_control - Tells us if the user has turned on the setting for Switch Control on their device to help us detect issues related to this setting

  • telemetry_data_boundary - The geographical region to which telemetry events are sent for the device

  • voice_over - Tells us if the user has turned on the setting for voiceover on their device to help us detect issues related to this setting

The following fields are collected for Android:

  • braille - Tells us if the user has turned on the setting to invert colors on their device to help us detect issues related to this setting

  • caption - Tells us if the user has turned on closed captioning on their device to help us detect issues related to closed captioning

  • color_inversion - Tells us if the user has turned on the setting to invert colors on their device to help us detect issues related to this setting

  • density_setting - The custom (user-selected) density mode currently in use by the application

  • fab_tap_behavior – Tells us the selected tap behavior (single press or tap & hold) for the floating action button we have on our main screens to compose an email, create an event, etc.

  • high_contrast - Tells us if the user has turned on the setting for high contrast on their device to help us detect issues related to this setting

  • large_text - Tells us if the device has large text setting turned on to help us detect issues related to this setting

  • left_swipe_setting - Tells us which mail triage action the user has set for their left swipe setting.

  • oem_preinstall - Tells us if our app was pre-installed on the device (this applies to Samsung devices only)

  • pinned_tabs - Tells us the tabs user has chosen to pin to navigation bar, and their order.

  • right_swipe_setting - Tells us which mail triage action the user has set for their right swipe setting.

  • supported_abis - Tells us what kind of application binary interfaces (ABIs) are supported by the device platform to help us detect issues related to this setting

  • switch_access - Tells us if the user has turned on the setting for Switch Access on their device to help us detect issues related to this setting

  • talkback - Tells us if the user has turned on the setting for talkback on their device to help us detect issues related to this setting

  • theme_color - The custom (user-selected) theme color currently in use by the application

  • unpinned_tabs - Tells us the tabs user has chosen to unpin from navigation bar, and their order.

  • webview_kernel_version: The Chromium kernel version of webview on the device to help us detect compatibility issues related to the version of webview.

  • webview_package_name: The package name of webview on the device to help us detect compatibility issues related to the version of webview.

  • webview_package_version: The package version of webview on the device to help us detect compatibility issues related to the version of webview.

low.storage.warning

This is needed to monitor if our app suddenly takes up most of your device storage due to high memory usage by indicating when the device is low on storage.

The following fields are collected:

  • free_bytes - the amount of free storage space available on the device​

Office.AirSpace.AirSpaceLocalBlocklistDriverUpdated

User has updated a video card driver that was previously causing Office crashes and thus no longer being used to render. Informs Microsoft that users who were once in a suboptimal rendering state are once again in the recommended rendering state.

The following fields are collected:

  • Data_BlockedDriverVersion - Version of the driver that was blocklisted.

  • Data_DeviceId -identifier of the video card device that was blocklisted.

  • Data_UpdatedDriverVersion - Version of the updated driver

Office.AirSpace.AirSpaceLocalBlocklistInfo

Details on the user's video card driver that has caused multiple recent crashes of Office applications. Office won't use this video card in this Office session (using software rendering instead) until the driver is updated. Informs Microsoft of video card drivers that are causing problems in Office so trends can be identified and the user of impact of such drivers can be analyzed. Tell Microsoft how many users are in this suboptimal state.

The following fields are collected:

  • Data_AllAppsBlocked - Whether all Office apps are blocklisted

  • Data_BlockedDeviceId - identifier of the video card device that was blocklisted

  • Data_BlockedDriverVersion - Version of the driver that was blocklisted

  • Data_CrashHistory - A string that represents the history of video card driver caused crashes for analysis

  • Data_SecsBetweenCrashes - How frequently driver card crashes are occurring

Office.AirSpace.AirSpaceWinCompIsEnabled

Whether the latest Office low-level rendering platform based on Windows Composition is being used.

As the latest Office low-level rendering platform is developed and begins to be released to customers, this allows Microsoft to see how many users are on each version to ensure the platform remains bug-free.

The following fields are collected:

  • Data_WinCompEnabled -Whether the Windows Composition-based backend is in use

Office.AirSpace.Backend.Win32.GraphicsDriverHangDetectorBlocklistApp

User's video card has been detected as causing long or unrecoverable hangs. Office won't use this video card in this Office session (using software rendering instead) until the driver is updated. Informs Microsoft of video card drivers that are causing problems in Office so trends can be identified and the user of impact of such drivers can be analyzed. Also helps in informing how many users are in this suboptimal state.

The following fields are collected:

  • Data_AppName - Which app has encountered video card driver hangs

Office.AirSpace.Backend.Win32.GraphicsDriverHangDetectorRegistryWrite

Office has identified that the user's video card driver has caused a hang that should be analyzed at the next Office application boot. Used to determine whether using a different video card driver or adapter would offer a better user experience. As patterns occur, Microsoft may make adjustments to keep the Office experience as smooth as possible.

The following fields are collected:

  • Data_HangDetected - Whether a hang was detected

  • Data_InDeviceCall - Which video card rendering call Office was in when the hang occurred

  • Data_Timeout - How long the hang lasted, if it recovered

  • Data_UnrecoverableCommand - Whether the hang in this video card rendering command is typically recoverable.

Office.AirSpace.Backend.Win32.LocalBlocklistActivity

Details on the user's video card driver that has caused multiple recent crashes of Office applications. Office won't use this video card in this Office session (using software rendering instead) until the driver is updated. Informs Microsoft of video card drivers that are causing problems in Office so trends can be identified and the user of impact of such drivers can be analyzed. Tell Microsoft how many users are in this suboptimal state.

The following fields are collected:

  • Data.AllAppsBlocked - Whether all Office apps are blocklisted

  • Data.BlockedDeviceId - identifier of the video card device that was blocked

  • Data.BlockedDriverVersion - Version of the driver that was blocklisted

  • Data.CrashHistory System.String - A string that represents the history of video card driver caused crashes for analysis

  • Data.SecsBetweenCrashes - How frequently driver card crashes are occurring

Office.AirSpace.Backend.Win32.LocalBlocklistDriverUpdatedActivity

User has updated a video card driver that was previously causing Office crashes and thus no longer being used to render. Informs Microsoft that users who were once in a suboptimal rendering state are once again in the recommended rendering state.

The following fields are collected:

  • Data_BlockedDeviceId - identifier of the video card device that was blocklisted

  • Data_BlockedDriverVersion - Version of the driver that was blocklisted

  • Data_UpdatedDriverVersion - Version of the updated driver

Office.Apple.PenTelemetry

This event is triggered when an Apple Pencil is used in the Microsoft 365 app for iOS on an iPad. The data is used to record iPad’s input peripherals to help determine whether inking scenarios and Apple Pencil inputs are performing as expected.

The following fields are collected:

  • None

Office.ClickToRun.Ads.SDX.AdRequest

This event is collected from free versions of Office applications running on the Windows platform. This event is triggered when the Office application attempts to retrieve a new advertisement. The event reports the latency communicating to the advertisement network, metadata about the retrieved advertisement, and any error information if retrieval is unsuccessful.

The following fields are collected:

  • Data_AdRequestId - A unique identifier for ad retrieval attempts

  • Data_AdService - The advertisement platform associated with retrieved ad content

  • Data_AdType - The type of advertisement

  • Data_AuctionId - A unique identifier for ad placement auction

  • Data_CreativeId - A unique identifier for shown ad content

  • Data_ErrorCode - The code associated with the error.

  • Data_ErrorMessage - A human-readable description of the error

  • Data_ErrorType - The type of error

  • Data_HttpStatus - The status in the response from the advertisement platform

Office.Graphics.SpriteMemCorrupt

Reports any errors detected in the sprite memory accounting telemetry. Critical for assessing health of the graphics memory usage telemetry. This information is needed to validate the correctness of our SpriteMem telemetry.

The following fields are collected:

  • Data_CurrentSpriteMem - Total amount of memory that is actively allocated to hold sprites (images) that result in screen content.

  • Data_Function - The name of the function that is attempting to release sprite memory.

  • Data_SpriteMemToRemove - Amount of memory to be removed from sprite allocation.

Office.PowerPoint.PPT.Shared.NoInternetConnectivity

Collected whenever PowerPoint detects there's no internet connectivity. Microsoft uses this data to get diagnostic information about the user's internet connection to be able to understand how that impacts connectivity to Office services.

The following fields are collected:

  • Data_IsNexusDetected:bool - shows whether we got the Internet connectivity status when calling Nexus service (value true) or when calling generic web service API call (value false)

Office.ServiceabilityManager.OfficeSvcMgrProfile

This event is triggered when Office Serviceability Manager starts, and is critical for providing accurate insights related to Deployment Status and Application and Add-in crashes within customer's tenant by allowing us to generate insights for the IT Admin to be able to confidently roll out updates for their enterprise machines.

The following fields are collected:

  • DeviceIdJoinToken - used to join Telemetry data from Health and Deployment Status with other Functional Data, which is collected via the Services pipeline.

  • TenantAssociationKeyStamped - a Boolean flag used to determine the number of Managed devices in the Office eco-system.