Skip to content

Commit 2d46cfc

Browse files
Update ssma-diagnostic-data-collection.md [PLEASE SQUASH] (#35990)
* Learn Editor: Update ssma-diagnostic-data-collection.md WIP * Proposed refresh of old section --------- Co-authored-by: Randolph West MSFT <97149825+rwestMSFT@users.noreply.github.com>
1 parent af2ca1c commit 2d46cfc

1 file changed

Lines changed: 60 additions & 24 deletions

File tree

docs/ssma/ssma-diagnostic-data-collection.md

Lines changed: 60 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,10 @@ description: Learn about usage and diagnostic data collection in SQL Server Migr
44
author: nilabjaball
55
ms.author: niball
66
ms.reviewer: randolphwest
7-
ms.date: 09/24/2024
7+
ms.date: 12/03/2025
88
ms.service: sql
99
ms.subservice: ssma
10-
ms.topic: conceptual
10+
ms.topic: how-to
1111
ms.collection:
1212
- sql-migration-content
1313
---
@@ -17,45 +17,81 @@ SQL Server Migration Assistant (SSMA) contains Internet-enabled features that ca
1717

1818
## Collected data
1919

20-
SSMA might collect standard computer information and information about use and performance that might be transmitted to Microsoft and analyzed for purposes of improving the quality, security, and reliability of SSMA. SSMA doesn't collect your name, address, or any other data related to an identified or identifiable individual. For details, see the [Microsoft Privacy Statement](https://www.microsoft.com/privacy/privacystatement), and [SQL Server privacy supplement](../sql-server/sql-server-privacy.md).
20+
SSMA might collect standard computer information and information about use and performance that might be transmitted to Microsoft and analyzed for purposes of improving the quality, security, and reliability. SSMA doesn't collect your name, address, or any other data related to an identified or identifiable individual. For details, see the [Microsoft Privacy Statement](https://www.microsoft.com/privacy/privacystatement), and [SQL Server privacy supplement](../sql-server/sql-server-privacy.md).
2121

2222
## Enable or disable usage and diagnostic data collection in SSMA
2323

2424
The following registry entry allows you to opt in or out of data collection:
2525

26-
- RegEntry name = `DisableTelemetry`
26+
| Configuration | Registry entry | Entry type | Values |
27+
| --- | --- | --- | --- |
28+
| Opt in or out of data collection | `DisableTelemetry` | `STRING` | `True` is for opting out.<br />`False` or not present is for opting in. |
29+
| Check for new version during startup | `DisableAutoUpdate` | `STRING` | `True` is for opting out.<br />`False` or not present is for opting in. |
2730

28-
Entry type `STRING`: `True` is for opting out; `False` or not present is for opting in.
31+
Depending on the migration source, the entry should be placed under one of the following registry keys:
2932

30-
Additionally, automatic checks for newer tool versions during start-up can be disabled by adding the following entry:
33+
| Registry key (Default) | Registry key (32-bit app on 64-bit) |
34+
| --- | --- |
35+
| **SSMA for Access** | |
36+
| `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server Migration Assistant for Access` | `HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Microsoft SQL Server Migration Assistant for Access` |
37+
| **SSMA for Db2** | |
38+
| `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server Migration Assistant for DB2` | `HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Microsoft SQL Server Migration Assistant for DB2` |
39+
| **SSMA for MySQL** | |
40+
| `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server Migration Assistant for MySQL` | `HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Microsoft SQL Server Migration Assistant for MySQL` |
41+
| **SSMA for Oracle** | |
42+
| `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server Migration Assistant for Oracle` | `HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Microsoft SQL Server Migration Assistant for Oracle` |
43+
| **SSMA for Sybase** | |
44+
| `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server Migration Assistant for Sybase` | `HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Microsoft SQL Server Migration Assistant for Sybase` |
3145

32-
- RegEntry name = `DisableAutoUpdate`
46+
## Configure SSMA feedback policy using Group Policy Objects (GPO)
3347

34-
Entry type `STRING`: `True` is for opting out; `False` or not present is for opting in.
48+
SQL Server Migration Assistant (SSMA) supports centralized control of feedback collection through a setting in the Windows registry. You can add or modify this registry entry using Group Policy Management to enable or disable feedback feature usage and diagnostic data.
3549

36-
Depending on the migration source, the entry should be placed under one of the following registry keys:
50+
### Registry details
51+
52+
- **Registry hive**: `HKEY_CURRENT_USER`
53+
- **Path**: `Software\Policies\Microsoft\Microsoft SQL Server Migration Assistant\Feedback`
54+
- **Value name**: `ProductFeedbackDisabled`
55+
- **Value type**: `REG_DWORD`
56+
57+
| Value | Description |
58+
| --- | --- |
59+
| `0` | Feedback enabled |
60+
| `1` | Feedback disabled |
61+
62+
### Add the registry entry via Group Policy Management
63+
64+
To deploy this policy using Group Policy Management, follow these steps:
65+
66+
1. Open **Group Policy Management** (`gpmc.msc`).
67+
68+
1. Select the **Domain** or **Organizational Unit (OU)** where the policy should apply.
3769

38-
- For SQL Server Migration Assistant for Access:
70+
Since the registry location is under `HKEY_CURRENT_USER`, ensure that the GPO is linked to an OU containing user accounts.
3971

40-
Subkey = `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server Migration Assistant for Access`
41-
Subkey (32-bit application installed on 64-bit OS) = `HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Microsoft SQL Server Migration Assistant for Access`
72+
1. Right-click the domain or target OU, and select **Create a GPO in this domain, and Link it here...**.
4273

43-
- For SQL Server Migration Assistant for Db2:
74+
1. Name the GPO. For example, `SSMA Feedback Policy`.
4475

45-
Subkey = `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server Migration Assistant for DB2`
46-
Subkey (32-bit application installed on 64-bit OS) = `HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Microsoft SQL Server Migration Assistant for DB2`
76+
1. Right-click the newly created GPO and select **Edit**.
4777

48-
- For SQL Server Migration Assistant for MySQL:
78+
1. Navigate to **User Configuration** > **Preferences** > **Windows Settings** > **Registry**.
4979

50-
Subkey = `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server Migration Assistant for MySQL`
51-
Subkey (32-bit application installed on 64-bit OS) = `HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Microsoft SQL Server Migration Assistant for MySQL`
80+
1. Create a **New Registry Item**.
5281

53-
- For SQL Server Migration Assistant for Oracle:
82+
1. Configure the settings as follows:
5483

55-
Subkey = `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server Migration Assistant for Oracle`
56-
Subkey (32-bit application installed on 64-bit OS) = `HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Microsoft SQL Server Migration Assistant for Oracle`
84+
| Field | Value |
85+
| --- | --- |
86+
| **Action** | Update (recommended) |
87+
| **Hive** | `HKEY_CURRENT_USER` |
88+
| **Key Path** | `Software\Policies\Microsoft\Microsoft SQL Server Migration Assistant\Feedback` |
89+
| **Value Name** | `ProductFeedbackDisabled` |
90+
| **Value Type** | `REG_DWORD` |
91+
| **Value Data** | `0` (enable feedback) or `1` (disable feedback) |
5792

58-
- For SQL Server Migration Assistant for Sybase:
93+
1. Verify the applied setting using the following PowerShell script:
5994

60-
Subkey = `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server Migration Assistant for Sybase`
61-
Subkey (32-bit application installed on 64-bit OS) = `HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Microsoft SQL Server Migration Assistant for Sybase`
95+
```powershell
96+
Get-ItemProperty -Path "HKCU:\Software\Policies\Microsoft\Microsoft SQL Server Migration Assistant\Feedback" -Name ProductFeedbackDisabled
97+
```

0 commit comments

Comments
 (0)