-
Notifications
You must be signed in to change notification settings - Fork 908
Telemetry
Azure Data Studio collects telemetry data, which is used to help understand how to improve the product. For example, this usage data helps to debug issues, such as slow start-up times, and to prioritize new features. While we appreciate the insights this data provides, we also know that not everyone wants to send usage data and you can disable telemetry as described in disable telemetry reporting. You can also read our privacy statement to learn more.
Azure Data Studio and this page refer to three different types of data with respect to telemetry.
Crash Reports - Crash reports collect diagnostic information when Azure Data Studio crashes and sends it to Microsoft to help understand why the crash occurred and what changes are needed to prevent the crash in the future.
Error Telemetry - Error telemetry collects information about errors that do not crash the application but are unexpected.
Usage Data - Usage data collects information about how features are used and perform in Azure Data Studio which helps us prioritize future product improvements.
With the telemetry.telemetryLevel
user setting, you can control the different types of telemetry we send with a single setting. Here is a table of the different types of data sent with each value of telemetry.telemetryLevel
:
Crash Reports | Error Telemetry | Usage Data | |
---|---|---|---|
all | ✓ | ✓ | ✓ |
error | ✓ | ✓ | - |
crash | ✓ | - | - |
off | - | - | - |
For example, if you don't want to send any telemetry data to Microsoft, you can set the telemetry.telemetryLevel
user setting to off
.
From File > Preferences > Settings (macOS: Azure Data Studio > Preferences > Settings), search for telemetry
, and set the Telemetry: Telemetry Level setting to off
. This will silence all telemetry events from Azure Data Studio going forward. Telemetry information may have been collected and sent up until the point when you disable the setting.
If you use the JSON editor for your settings, add the following line:
"telemetry.telemetryLevel": "off"
Azure Data Studio lets you add features to the product by installing Microsoft and third-party extensions. These extensions may be collecting their own usage data and may not be controlled by the telemetry.telemetryLevel
setting. Consult the specific extension's documentation to learn about its telemetry reporting and whether it can be disabled.
Extension authors may refer to the Telemetry extension authors guide for guidance on implementing telemetry best practices within their extension.
If you'd like to review the telemetry events in Azure Data Studio as they are sent, you can enable tracing and it will record telemetry events. Using the Developer: Set Log Level... command and select log level Trace. To view the logging output, go to the Output panel (kb(workbench.action.output.toggleOutput)
) and pick Telemetry from the dropdown.
When tracing telemetry events, the events are also logged to a local file telemetry.log
, which you can view using the Developer: Open Log File... command and choosing Telemetry from the dropdown.
In addition to supporting the General Data Protection Regulation (GDPR), the Azure Data Studio team takes privacy very seriously. That's both for Microsoft as a company and specifically within the Azure Data Studio team.
To ensure GDPR compliance, we made several updates to Azure Data Studio, these include:
- Making it easier to opt out of telemetry collection by placing a notification in product for all existing and new users.
- Reviewing and classifying the telemetry that we send.
- Ensuring that we have valid data retention policies in place for any data we do collect, for example crash dumps.
In short, we have worked hard to do the right thing, for all users, as these practices apply to all geographies, not just Europe.
One question we expect people to ask is to see the data we collect. However, we don't have a reliable way to do this as Azure Data Studio does not have a 'sign-in' experience that would uniquely identify a user. We do send information that helps us approximate a single user for diagnostic purposes (this is based on a hash of the network adapter NIC on the desktop and a randomly assigned UUID on the web) but this is not guaranteed to be unique. For example, virtual machines (VMs) often rotate NIC IDs or allocate from a pool. This technique is sufficient to help us when working through problems, but it is not reliable enough for us to 'provide your data'.
We expect our approach to evolve as we learn more about GDPR and the expectations of our users. We greatly appreciate the data users do send to us, as it is very valuable and Azure Data Studio is a better product for everyone because of it. And again, if you are worried about privacy, we offer the ability to disable sending telemetry as described in disable telemetry reporting.
Documentation
- Get Started
- Install Azure Data Studio
- Telemetry
- Microsoft Ready 2019 Lab
- MS Docs Overview
- Debug Trace Logging
- Troubleshoot Azure Authentication Issues
- FAQ
Contributing
- How to Contribute
- Developer Getting Started
- Submitting Bugs and Suggestions
- Localization
- Troubleshooting Build Issues
- Engineering FAQ
- How to update typings files
- Importing and using modules
- UI Guidelines
- Angular UI Guidelines
- Contributor License Agreement
- Azure Data Studio Tests
- Why is the Azure Data Studio license different than the repository license?
Tool Services
Extensibility Reference
- Getting Started
- Extensibility API
- Contribution Points
- Context Variables
- Servers and Data Explorer Tree Views
- Debugging with VS Code
- Extension Authoring
- Building multiple insight widgets
- Microsoft Ignite lab
- List of Extensions
- Replace sqlops namespace
Project Management