diff --git a/DATA_AND_PRIVACY.md b/DATA_AND_PRIVACY.md index dd46dd2285..81dc855e63 100644 --- a/DATA_AND_PRIVACY.md +++ b/DATA_AND_PRIVACY.md @@ -30,7 +30,11 @@ _If you want to find diagnostic data events in the source code, these two links - [C++ events](https://github.com/search?q=repo%3Amicrosoft%2FPowerToys+ProjectTelemetryPrivacyDataTag&type=code) ### General -
| Event Name | Description | @@ -43,6 +47,18 @@ _If you want to find diagnostic data events in the source code, these two linksMicrosoft.PowerToys.GeneralSettingsChanged | Logs changes made to general settings within PowerToys. |
|---|---|---|---|
| Microsoft.PowerToys.Install_Fail | +Triggered when the PowerToys installation process encounters an error and fails to complete. | +||
| Microsoft.PowerToys.Repair_Cancel | +Triggered when a PowerToys repair operation is cancelled by the user before completion. | +||
| Microsoft.PowerToys.Repair_Fail | +Triggered when the PowerToys repair operation fails to complete successfully due to an error. | +||
| Microsoft.PowerToys.Runner_Launch | Indicates when the PowerToys Runner is launched. | @@ -59,6 +75,18 @@ _If you want to find diagnostic data events in the source code, these two linksMicrosoft.PowerToys.ScoobeStartedEvent | Triggered when SCOOBE (Secondary Out-of-box experience) starts. |
| Microsoft.PowerToys.ShortcutConflictControlClickedEvent | +Triggered when a user clicks on the Shortcut Conflict Control button in the PowerToys Settings UI Dashboard. | +||
| Microsoft.PowerToys.ShortcutConflictDetectedEvent | +Triggered when keyboard shortcut conflicts are detected in the PowerToys Settings UI Dashboard. | +||
| Microsoft.PowerToys.ShortcutConflictResolvedEvent | +Triggered when a keyboard shortcut conflict is resolved in the PowerToys Settings UI. | +||
| Microsoft.PowerToys.TrayFlyoutActivatedEvent | Indicates when the tray flyout menu is activated. | @@ -67,6 +95,14 @@ _If you want to find diagnostic data events in the source code, these two linksMicrosoft.PowerToys.TrayFlyoutModuleRunEvent | Logs when a utility from the tray flyout menu is run. |
| Microsoft.PowerToys.UnInstall_Cancel | +Triggered when the PowerToys uninstallation process is cancelled by the user before completion. | +||
| Microsoft.PowerToys.UnInstall_Fail | +Triggered when the PowerToys uninstallation process fails to complete successfully due to an error. | +||
| Microsoft.PowerToys.Uninstall_Success | Logs when PowerToys is successfully uninstalled (who would do such a thing!). | @@ -82,11 +118,19 @@ _If you want to find diagnostic data events in the source code, these two links
| Event Name | Description | ||
|---|---|---|---|
| Microsoft.PowerToys.OobeModuleRunEvent | +Triggered when a user clicks to run or launch a PowerToys module directly from the OOBE (out-of-box experience) interface. | +||
| Microsoft.PowerToys.OobeSectionEvent | Occurs when OOBE is shown to the user. | @@ -99,10 +143,18 @@ _If you want to find diagnostic data events in the source code, these two linksMicrosoft.PowerToys.OobeStartedEvent | Indicates when the out-of-box experience has been initiated. |
| Microsoft.PowerToys.OobeVariantAssignmentEvent | +This event logs A/B testing assignments for experimental features, helping track which users are in control or alternate groups for feature experiments. | +
| Event Name | Description | @@ -170,7 +222,11 @@ _If you want to find diagnostic data events in the source code, these two links
|---|
| Event Name | Description | @@ -190,7 +246,11 @@ _If you want to find diagnostic data events in the source code, these two links
|---|
| Event Name | Description | @@ -218,7 +278,11 @@ _If you want to find diagnostic data events in the source code, these two links
|---|
| Event Name | Description | @@ -235,18 +299,14 @@ _If you want to find diagnostic data events in the source code, these two linksMicrosoft.PowerToys.ColorPicker_Settings | Triggered when the settings for the Color Picker are accessed or modified. |
|---|---|---|---|
| Microsoft.PowerToys.ColorPickerCancelledEvent | -Occurs when a color picking action is cancelled by the user. | -||
| Microsoft.PowerToys.ColorPickerShowEvent | -Triggered when the Color Picker UI is displayed on the screen. | -
| Event Name | Description | @@ -259,10 +319,6 @@ _If you want to find diagnostic data events in the source code, these two linksMicrosoft.PowerToys.CmdNotFoundInstallEvent | Triggered when a Command Not Found is installed. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Microsoft.PowerToys.CmdNotFoundInstanceCreatedEvent | -Occurs when an instance of a Command Not Found is created. | -|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Microsoft.PowerToys.CmdNotFoundUninstallEvent | Triggered when Command Not Found is uninstalled after being previously installed. | @@ -271,7 +327,11 @@ _If you want to find diagnostic data events in the source code, these two links ### Command Palette -
| Event Name | Description | @@ -335,7 +395,11 @@ _If you want to find diagnostic data events in the source code, these two links
|---|
| Event Name | Description | @@ -344,10 +408,26 @@ _If you want to find diagnostic data events in the source code, these two linksMicrosoft.PowerToys.CropAndLock_ActivateReparent | Triggered when the cropping interface is activated for reparenting the cropped content. |
|---|---|---|---|
| Microsoft.PowerToys.CropAndLock_ActivateScreenshot | +Triggered when the screenshot mode is activated in Crop and Lock. | +||
| Microsoft.PowerToys.CropAndLock_ActivateThumbnail | Occurs when the thumbnail view for cropped content is activated. | ||
| Microsoft.PowerToys.CropAndLock_CreateReparentWindow | +Triggered when a reparent window is created in Crop and Lock mode. | +||
| Microsoft.PowerToys.CropAndLock_CreateScreenshotWindow | +Triggered when a screenshot window is created in Crop and Lock mode. | +||
| Microsoft.PowerToys.CropAndLock_CreateThumbnailWindow | +Triggered when a thumbnail window is created in Crop and Lock mode.<-/td> + | ||
| Microsoft.PowerToys.CropAndLock_EnableCropAndLock | Triggered when Crop and Lock is enabled. | @@ -358,8 +438,28 @@ _If you want to find diagnostic data events in the source code, these two links
| Event Name | +Description | +
|---|---|
| Microsoft.PowerToys.CursorWrap_EnableCursorWrap | +Triggered when Cursor Wrap is enabled or disabled. | +
| Event Name | Description | @@ -387,7 +487,11 @@ _If you want to find diagnostic data events in the source code, these two links
|---|
| Event Name | Description | @@ -404,6 +508,10 @@ _If you want to find diagnostic data events in the source code, these two linksMicrosoft.PowerToys.FancyZones_EnableFancyZones | Occurs when FancyZones is enabled. |
|---|---|---|---|
| Microsoft.PowerToys.FancyZones_Error | +Triggered when an error occurs within the FancyZones module. This event logs critical errors to help diagnose and troubleshoot issues with FancyZones functionality, such as failures to set up Windows hooks or other system-level operations required for window management. | +||
| Microsoft.PowerToys.FancyZones_KeyboardSnapWindowToZone | Triggered when a window is snapped to a zone using the keyboard. | @@ -416,10 +524,6 @@ _If you want to find diagnostic data events in the source code, these two linksMicrosoft.PowerToys.FancyZones_MoveOrResizeStarted | Triggered when a window move or resize action is initiated. |
| Microsoft.PowerToys.FancyZones_MoveSizeEnd | -Occurs when the moving or resizing of a window has ended. | -||
| Microsoft.PowerToys.FancyZones_OnKeyDown | Triggered when a key is pressed down while interacting with zones. | @@ -432,10 +536,6 @@ _If you want to find diagnostic data events in the source code, these two linksMicrosoft.PowerToys.FancyZones_Settings | Triggered when FancyZones settings are accessed or modified. |
| Microsoft.PowerToys.FancyZones_SettingsChanged | -Occurs when there is a change in the FancyZones settings. | -||
| Microsoft.PowerToys.FancyZones_SnapNewWindowIntoZone | Triggered when a new window is snapped into a zone. | @@ -456,10 +556,50 @@ _If you want to find diagnostic data events in the source code, these two linksMicrosoft.PowerToys.FancyZones_CLICommand | Triggered when a FancyZones CLI command is executed, logging the command name and success status. |
| Microsoft.PowerToys.FancyZonesEditorStartEvent | +Triggered when the FancyZones Editor application starts. This logs the initialization of the editor UI, which is used to create and configure custom zone layouts. | +||
| Microsoft.PowerToys.FancyZonesEditorStartFinishEvent | +Triggered when the FancyZones Editor has completed loading and is ready for user interaction. | +
| Event Name | +Description | +
|---|---|
| Microsoft.PowerToys.FileLocksmith_EnableFileLocksmith | +Triggered when File Locksmith is enabled. | +
| Microsoft.PowerToys.FileLocksmith_Invoked | +Occurs when File Locksmith is invoked. | +
| Microsoft.PowerToys.FileLocksmith_InvokedRet | +Triggered when File Locksmith invocation returns a result. | +
| Microsoft.PowerToys.FileLocksmith_QueryContextMenuError | +Occurs when there is an error querying the context menu for File Locksmith. | +
| Event Name | Description | @@ -496,6 +636,10 @@ _If you want to find diagnostic data events in the source code, these two linksMicrosoft.PowerToys.MarkdownFilePreviewed | Triggered when a Markdown file is previewed in File Explorer. |
|---|---|---|---|
| Microsoft.PowerToys.MarkdownFilePreviewError | +Triggered when there is an error previewing a Markdown file in File Explorer. | +||
| Microsoft.PowerToys.PdfFileHandlerLoaded | Occurs when a PDF file handler is loaded. | @@ -504,6 +648,10 @@ _If you want to find diagnostic data events in the source code, these two linksMicrosoft.PowerToys.PdfFilePreviewed | Triggered when a PDF file is previewed in File Explorer. |
| Microsoft.PowerToys.PdfFilePreviewError | +Triggered when there is an error previewing a PDF file in File Explorer. | +||
| Microsoft.PowerToys.PowerPreview_Enabled | Occurs when preview is enabled. | @@ -520,6 +668,10 @@ _If you want to find diagnostic data events in the source code, these two linksMicrosoft.PowerToys.PowerPreview_TweakUISettings_InitSet__ErrorLoadingFile | Triggered when there is an error loading a file during Tweak UI settings initialization. |
| Microsoft.PowerToys.PowerPreview_TweakUISettings_SetConfig__InvalidJSONGiven | +Triggered when invalid JSON is provided to the Power Preview settings configuration | +||
| Microsoft.PowerToys.PowerPreview_TweakUISettings_SuccessfullyUpdatedSettings | Occurs when the Tweak UI settings for Power Preview are successfully updated. | @@ -528,6 +680,10 @@ _If you want to find diagnostic data events in the source code, these two linksMicrosoft.PowerToys.QoiFilePreviewed | Triggered when a QOI file is previewed in File Explorer. |
| Microsoft.PowerToys.QoiFilePreviewError | +Triggered when there is an error previewing a QOI (Quite OK Image) file in File Explorer. | +||
| Microsoft.PowerToys.SvgFileHandlerLoaded | Occurs when an SVG file handler is loaded. | @@ -542,32 +698,12 @@ _If you want to find diagnostic data events in the source code, these two links
| Event Name | -Description | -
|---|---|
| Microsoft.PowerToys.FileLocksmith_EnableFileLocksmith | -Triggered when File Locksmith is enabled. | -
| Microsoft.PowerToys.FileLocksmith_Invoked | -Occurs when File Locksmith is invoked. | -
| Microsoft.PowerToys.FileLocksmith_InvokedRet | -Triggered when File Locksmith invocation returns a result. | -
| Microsoft.PowerToys.FileLocksmith_QueryContextMenuError | -Occurs when there is an error querying the context menu for File Locksmith. | -
| Event Name | Description | @@ -583,7 +719,11 @@ _If you want to find diagnostic data events in the source code, these two links
|---|
| Event Name | Description | @@ -600,10 +740,22 @@ _If you want to find diagnostic data events in the source code, these two linksMicrosoft.PowerToys.HostsFileEditorOpenedEvent | Fires when Hosts File Editor is opened. |
|---|---|---|---|
| Microsoft.PowerToys.HostEditorStartEvent | +Triggered when the Hosts File Editor application starts. This logs the initialization of the Hosts File Editor UI with a timestamp. | +||
| Microsoft.PowerToys.HostEditorStartFinishEvent | +Triggered when the Hosts File Editor has completed loading and is ready for user interaction. | +
| Event Name | Description | @@ -620,10 +772,18 @@ _If you want to find diagnostic data events in the source code, these two linksMicrosoft.PowerToys.ImageResizer_InvokedRet | Fires when the Image Resizer operation is completed and returns a result. |
|---|---|---|---|
| Microsoft.PowerToys.ImageResizer_QueryContextMenuError | +Triggered when there is an error querying the context menu for Image Resizer. | +
| Event Name | Description | @@ -636,10 +796,22 @@ _If you want to find diagnostic data events in the source code, these two linksMicrosoft.PowerToys.KeyboardManager_AppSpecificShortcutRemapCount | Logs the number of application-specific shortcut remaps configured by the user. |
|---|---|---|---|
| Microsoft.PowerToys.KeyboardManager_AppSpecificShortcutToKeyRemapInvoked | +Logs each instance when an application-specific shortcut-to-key remap is used. | +||
| Microsoft.PowerToys.KeyboardManager_AppSpecificShortcutToShortcutRemapInvoked | Logs each instance when an application-specific shortcut-to-shortcut remap is used. | ||
| Microsoft.PowerToys.KeyboardManager_Error | +Triggered when an error occurs in Keyboard Manager. This logs the error code, error message, and the method name where the error occurred. | +||
| Microsoft.PowerToys.KeyboardManager_ErrorSendingKeyAndShortcutRemapLoadedConfiguration | +Triggered when there is an error sending remapping configuration telemetry. This occurs when Keyboard Manager fails to report the loaded key and shortcut remap configurations | +||
| Microsoft.PowerToys.KeyboardManager_DailyAppSpecificShortcutToKeyRemapInvoked | Logs the daily count of application-specific shortcut-to-key remaps executed by the user. | @@ -703,7 +875,11 @@ _If you want to find diagnostic data events in the source code, these two links
| Event Name | Description | @@ -727,7 +903,11 @@ _If you want to find diagnostic data events in the source code, these two links
|---|
| Event Name | Description | @@ -740,10 +920,18 @@ _If you want to find diagnostic data events in the source code, these two linksMicrosoft.PowerToys.MouseHighlighter_StartHighlightingSession | Occurs when a new highlighting session is started. |
|---|---|---|---|
| Microsoft.PowerToys.MouseHighlighter_StartSpotlightSession | +Triggered when a spotlight session is started in Mouse Highlighter. This occurs when the user activates the spotlight mode. | +
| Event Name | Description | @@ -767,7 +955,11 @@ _If you want to find diagnostic data events in the source code, these two links
|---|
| Event Name | Description | @@ -783,7 +975,11 @@ _If you want to find diagnostic data events in the source code, these two links
|---|
| Event Name | Description | @@ -835,7 +1031,11 @@ _If you want to find diagnostic data events in the source code, these two links
|---|
| Event Name | Description | @@ -867,7 +1067,11 @@ _If you want to find diagnostic data events in the source code, these two links
|---|
| Event Name | Description | @@ -900,10 +1104,18 @@ _If you want to find diagnostic data events in the source code, these two linksMicrosoft.PowerToys.Peek_Settings | Triggered when the settings for Peek are modified. |
|---|---|---|---|
| Microsoft.PowerToys.Peek_SpaceModeEnabled | +Triggered when the Space key activation mode is enabled or disabled in Peek | +
| Event Name | Description | @@ -935,7 +1147,11 @@ _If you want to find diagnostic data events in the source code, these two links
|---|
| Event Name | Description | @@ -976,14 +1192,14 @@ _If you want to find diagnostic data events in the source code, these two linksMicrosoft.PowerToys.RunPluginsSettingsEvent | Triggered when the settings for PowerToys Run plugins are accessed or modified. |
|---|---|---|---|
| Microsoft.PowerToys.WindowWalker_EnableWindowWalker | -Triggered when the Window Walker plugin is enabled. | -
| Event Name | Description | @@ -999,7 +1215,11 @@ _If you want to find diagnostic data events in the source code, these two links
|---|
| Event Name | Description | @@ -1012,10 +1232,22 @@ _If you want to find diagnostic data events in the source code, these two linksMicrosoft.PowerToys.RegistryPreview_EnableRegistryPreview | Occurs when Registry Preview is enabled. |
|---|---|---|---|
| Microsoft.PowerToys.RegistryPreviewEditorStartEvent | +Triggered when the Registry Preview application starts. This logs the initialization of the Registry Preview UI with a timestamp. | +||
| Microsoft.PowerToys.RegistryPreviewEditorStartFinishEvent | +Triggered when the Registry Preview application has completed loading and is ready for user interaction. | +
| Event Name | Description | @@ -1035,7 +1267,11 @@ _If you want to find diagnostic data events in the source code, these two links
|---|
| Event Name | Description | @@ -1051,7 +1287,11 @@ _If you want to find diagnostic data events in the source code, these two links
|---|
| Event Name | Description | @@ -1075,15 +1315,15 @@ _If you want to find diagnostic data events in the source code, these two links
|---|
| Event Name | Description | ||
|---|---|---|---|
| Microsoft.PowerToys.Projects_CLIUsage | -Logs usage of command-line arguments for launching apps. | -||
| Microsoft.PowerToys.Workspaces_CreateEvent | Triggered when a new workspace is created. | @@ -1105,13 +1345,21 @@ _If you want to find diagnostic data events in the source code, these two linksTriggered when a workspace is launched. | |
| Microsoft.PowerToys.Workspaces_Settings | -Logs changes to workspaces settings. | +Microsoft.PowerToys.WorkspacesEditorStartEvent | +Triggered when the Workspaces Editor application starts. This logs the initialization of the Workspaces Editor UI with a timestamp. | +
| Microsoft.PowerToys.WorkspacesEditorStartFinishEvent | +Triggered when the Workspaces Editor has completed loading and is ready for user interaction. |
| Event Name | Description |
|---|