Skip to content

Commit f571f48

Browse files
authored
Clean up (#3378)
* Clean up * Fix icon
1 parent 8f86746 commit f571f48

File tree

1 file changed

+29
-14
lines changed

1 file changed

+29
-14
lines changed

docs/fundamentals/dashboard/microsoft-collected-dashboard-telemetry.md

Lines changed: 29 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Microsoft-collected dashboard telemetry
33
description: Learn about what telemetry the .NET Aspire dashboard sends and how to opt out.
4-
ms.date: 3/25/2025
4+
ms.date: 05/08/2025
55
---
66

77
# Microsoft-collected dashboard telemetry
@@ -12,38 +12,53 @@ The .NET Aspire dashboard collects diagnostic data to help developers monitor an
1212

1313
.NET Aspire dashboard usage telemetry is collected only when running the dashboard from Visual Studio or Visual Studio Code. Telemetry is gathered while the dashboard is open in the browser, unless you have [opted out](#how-to-opt-out) of telemetry collection.
1414

15-
## How to opt out
15+
## How to opt-out
1616

17-
Starting with .NET Aspire 9.2, dashboard usage telemetry is enabled by default. Dashboard usage telemetry is not collected in early version. This feature aligns with the following IDE versions:
17+
Starting with .NET Aspire 9.3, dashboard usage telemetry is enabled by default. Dashboard usage telemetry isn't collected in early version. This feature aligns with the following IDE versions:
1818

1919
- Visual Studio: 17.14 or later.
20-
- C# Dev Kit: [VSC RELEASE VERSION] or later.
20+
- C# Dev Kit: 1.18.25 or later.
2121

22-
- Set the `DOTNET_DASHBOARD_ENABLE_TELEMETRY` environment variable to `false`. This will apply to all users accessing the Aspire dashboard.
23-
- Disable telemetry collection in the host IDE. Learn how to opt out in [Visual Studio](/visualstudio/ide/visual-studio-experience-improvement-program) or [Visual Studio Code](https://code.visualstudio.com/docs/configure/telemetry#_disable-telemetry-reporting).
22+
To opt-out of telemetry collection, set the `DOTNET_DASHBOARD_ENABLE_TELEMETRY` environment variable to `false`. This will apply to all users accessing the .NET Aspire dashboard:
23+
24+
### [PowerShell](#tab/powershell)
25+
26+
```powershell
27+
$env:DOTNET_DASHBOARD_ENABLE_TELEMETRY = "false"
28+
```
29+
30+
### [Bash](#tab/bash)
31+
32+
```bash
33+
export DOTNET_DASHBOARD_ENABLE_TELEMETRY=false
34+
```
35+
36+
---
37+
38+
Alternatively, you can opt-out of telemetry collection by disabling telemetry collection in the host IDE. Learn how to opt out in [Visual Studio](/visualstudio/ide/visual-studio-experience-improvement-program) or [Visual Studio Code](https://code.visualstudio.com/docs/configure/telemetry#_disable-telemetry-reporting).
2439

2540
## Disclosure
2641

2742
When dashboard usage telemetry is enabled, there's a disclosure statement at the bottom of the settings panel, informing you that telemetry is enabled. This disclosure statement appears anytime usage telemetry is enabled.
2843

2944
## Data points
3045

31-
.NET Aspire dashboard usage telemetry doesn't collect personal data, such as, IP addresses or use browser fingerprinting. It doesn't scan your code and doesn't extract source code, authorship, or deployment configuration. The data is sent securely to Microsoft using [https://azure.microsoft.com/services/monitor/](Azure Monitor) through existing telemetry APIs in Visual Studio and Visual Studio Code.
46+
.NET Aspire dashboard usage telemetry doesn't collect personal data, such as, IP addresses or use browser fingerprinting. It doesn't scan your code and doesn't extract source code, authorship, or deployment configuration. The data is sent securely to Microsoft using [Azure Monitor](/azure/azure-monitor/) through existing telemetry APIs in Visual Studio and Visual Studio Code.
3247

33-
Protecting your privacy is important to Microsoft. If you suspect that telemetry is collecting sensitive data or the data is being insecurely or inappropriately handled, file an issue in the [:::image type="icon" source="../../media/github-mark.svg border="false"::: GitHub dotnet/aspire](https://github.com/dotnet/aspire) repository for investigation.
48+
Protecting your privacy is important to Microsoft. If you suspect that telemetry is collecting sensitive data or the data is being insecurely or inappropriately handled, file an issue in the :::image type="icon" source="../../media/github-mark.svg" border="false"::: [GitHub dotnet/aspire](https://github.com/dotnet/aspire) repository for investigation.
3449

35-
The .NET Aspire dashboard doesn't collect telemetry on Visual Studio versions `< 17.14` or C# Dev Kit versions `< [VSC RELEASE VERSION]`. It collects the following data:
50+
The .NET Aspire dashboard doesn't collect telemetry on Visual Studio versions `< 17.14` or C# Dev Kit versions `< 1.18.25`. It collects the following data:
3651

3752
| .NET Aspire dashboard versions | Data | Notes |
3853
|--|--|--|
3954
| 9.3 | Page navigation history. | Includes page settings. |
4055
| 9.3 | Resource types being used. | Custom resource type names are not sent to Microsoft. |
41-
| 9.3 | Request user agent. | |
56+
| 9.3 | Request user agent. | |
4257
| 9.3 | Invoked dashboard commands. | Custom command names are not sent to Microsoft. |
43-
| 9.3 | Request language and set dashboard language. | |
44-
| 9.3 | Resource restart times. | |
45-
| 9.3 | OTel data processing times. | |
46-
| 9.3 | Dashboard-related unhandled exceptions. | |
58+
| 9.3 | Request language and set dashboard language. | |
59+
| 9.3 | Resource restart times. | |
60+
| 9.3 | OTel data processing times. | |
61+
| 9.3 | Dashboard-related unhandled exceptions. | |
4762

4863
## See also
4964

0 commit comments

Comments
 (0)