Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time

Telemetry Guide

By default, Microsoft collects anonymous usage data in order to improve the user experience. The usage data collected allows the team to prioritize features and bug fixes.

Microsoft Privacy statement:

Table of Contents

  1. How do we anonymize the data?
  2. What do we collect
  3. How do I opt out?
  4. Additional Information

How do we anonymize data?

Hashed random UUID: a cryptographically (SHA256) anonymous and unique ID per user.

What do we collect?


Environment data points give the team insight into commonly used platforms and allow the team to prioritize features, bug fixes, and packaging.

  • Platform name
  • Platform version
  • Target Server edition and version
  • Connection Type (Azure vs. Single Instance)
  • Python version
  • Product version
  • Locale
  • Shell type

Measurement data points allow the team to be proactive in improving performance.

  • Start time
  • End time
  • Session duration

Abnormal process termination.

  • Error flag to indicate type of shutdown.

How do I opt out?

The mssql-cli Tools telemetry feature is enabled by default. Opt-out of the telemetry feature by setting the MSSQL_CLI_TELEMETRY_OPTOUT environment variable to true or 1.

MacOS/Linux (bash)

Additional Information

What does the anonymous usage data actually look like?

For those interested, anonymous usage data of the previous session will always be outputted to a telemetry file in the user's configuration directory. It can be found right next to the location of the configuration file.

MacOSX & Linux
Partial sample of log content
    "name": "mssqlcli",
    "properties": {
      "Reserved.SequenceNumber": 1,
      "Reserved.EventId": "e6f0bdab-65b0-4e79-87a4-b05fa514c92d",
      "Reserved.SessionId": "3fa7361c-50ff-4bff-8a55-f22bdc26452d",