{"id":1921,"library":"azure-cli-telemetry","title":"Microsoft Azure CLI Telemetry Package","description":"The `azure-cli-telemetry` package is an internal component of the Microsoft Azure CLI. Its primary function is to collect anonymous usage data and diagnostic information to help improve the CLI's reliability and performance. [2, 4] It is not typically intended for direct consumption or installation by end-users or for standalone application development. [6, 7, 8, 9] The package maintains a stable, though infrequent, release cadence, with its functionality primarily managed through the broader `azure-cli` releases. [6]","status":"active","version":"1.1.0","language":"en","source_language":"en","source_url":"https://github.com/Azure/azure-cli","tags":["azure","cli","telemetry","microsoft","internal"],"install":[{"cmd":"pip install azure-cli-telemetry","lang":"bash","label":"Install via pip (Discouraged for direct use)"}],"dependencies":[{"reason":"Used for sending telemetry data to Azure Application Insights.","package":"applicationinsights","optional":false},{"reason":"Used for managing file locks, likely for telemetry payload handling or process coordination.","package":"portalocker","optional":false},{"reason":"This package is an internal dependency of the main Azure CLI and relies on core CLI components. [9]","package":"azure-cli-core","optional":false}],"imports":[],"quickstart":{"code":"# This library is an internal dependency of the Azure CLI and is not designed for direct interaction by end-users.\n# Telemetry collection, which this package facilitates, can be configured or disabled\n# via the Azure CLI's configuration settings.\n# To disable telemetry for the Azure CLI:\n# az config set core.collect_telemetry=False\n# For more information on Azure CLI configuration, refer to the official Microsoft documentation.","lang":"bash","description":"This library is an internal dependency of the Azure CLI and is not designed for direct interaction by end-users. Direct programmatic use is not recommended, and there is no public API or quickstart for standalone usage. Telemetry collection, which this package facilitates, is controlled via the Azure CLI's configuration settings."},"warnings":[{"fix":"Do not install or use `azure-cli-telemetry` as a standalone dependency in end-user applications. Rely on the `azure-cli` package and its official public interfaces for Azure interactions.","message":"This library is an internal component of the Azure CLI and is not intended for direct installation or programmatic use by end-users. Its internal APIs are not stable and may change without notice, potentially breaking user applications if directly depended upon. [6, 7, 8, 9]","severity":"gotcha","affected_versions":"All versions"},{"fix":"Use the Azure CLI configuration command: `az config set core.collect_telemetry=False`. You can verify the setting with `az config get core.collect_telemetry`.","message":"Telemetry collection by the Azure CLI (which this package enables) is opt-out and enabled by default. To disable telemetry, you must use the `az config set core.collect_telemetry=False` command within the Azure CLI itself, rather than trying to configure this Python package directly. [4, 14]","severity":"gotcha","affected_versions":"All versions"},{"fix":"While `azure-cli` versions 2.40.0 and later addressed some update issues for telemetry, generally avoid manually updating this component. If issues persist, a full reinstallation of the Azure CLI is recommended. [18, 22]","message":"The version of the `azure-cli-telemetry` package (e.g., 1.1.0) is independent of the main `azure-cli` version (e.g., 2.85.0). Users might encounter issues where the telemetry component appears 'stuck' at an older version even after upgrading the main CLI. [18]","severity":"gotcha","affected_versions":"< 2.40.0 of azure-cli (fix applied in later CLI versions, but the version independence remains)"}],"env_vars":null,"last_verified":"2026-04-09T00:00:00.000Z","next_check":"2026-07-08T00:00:00.000Z"}