télémétrie dotnetup

Note

dotnetup est disponible en préversion publique. Ses fonctionnalités et son comportement peuvent changer avant la disponibilité générale.

dotnetup inclut une fonctionnalité de télémétrie qui collecte les données d’utilisation et les envoie à Microsoft lorsque vous exécutez les commandes dotnetup. Les données d’utilisation incluent des informations d’exception lorsque dotnetup plante. L’équipe .NET utilise ces données pour comprendre comment les utilisateurs utilisent l’outil et résoudre les problèmes.

Comment refuser

La télémétrie est activée par défaut. Pour désactiver, définissez la variable d’environnement DOTNET_CLI_TELEMETRY_OPTOUT sur 1 ou true.

Il s’agit de la même variable qui désactive les données de télémétrie pour le SDK .NET et l’interface CLI. Pour plus d’informations, consultez la télémétrie du SDK .NET et de l’interface CLI .NET.

Avis de premier lancement

La première fois que vous exécutez dotnetup, il affiche ce message :

dotnetup collects usage data to help improve your experience. You can opt out by setting the DOTNET_CLI_TELEMETRY_OPTOUT environment variable to '1'. Learn more: https://aka.ms/dotnetup-telemetry

Pour masquer cette notification sans désactiver la télémétrie, définissez la variable d’environnement DOTNET_NOLOGO sur 1 ou true.

Points de données

La fonctionnalité de télémétrie ne collecte pas de données personnelles, telles que les noms d’utilisateur ou les adresses e-mail. Il n’analyse pas votre code et n’extrait pas les données au niveau du projet. dotnetupenvoie les données de manière sécurisée aux serveurs Microsoft avec la technologie Azure Monitor.

dotnetup collecte les données suivantes :

  • Horodatage de l’appel.
  • Commande que vous exécutez, telle que install, updateou list.
  • Version dotnetup et SHA du commit.
  • Le système d’exploitation et l’architecture.
  • Si dotnetup s’exécute dans un environnement d’intégration continue (CI).
  • Si dotnetup s’exécute à partir d’un agent LLM, tel que GitHub Copilot.
  • Code de sortie, ou état de réussite ou d’échec.
  • Pour les échecs : le type d’erreur, la catégorie d’erreur, les détails d’erreur nettoyés sans chemins de fichier et la trace de pile sans messages d’exception.

Télémétrie des exceptions d’incident

En cas de plantage de dotnetup, il collecte le nom de l’exception et la trace de pile du code dotnetup. Il n’inclut pas les messages d’exception, car ils peuvent contenir des entrées utilisateur. Cette approche est la même que l’approche utilisée par le sdk .NET. Pour plus d’informations, consultez Télémétrie des exceptions d’incident.

Détection de l’agent CI et LLM

dotnetuputilise la même détection d’environnement CI et la détection de l’agent LLM que le SDK .NET. Pour obtenir la liste des variables d’environnement qu’il vérifie, consultez détection de l’intégration continue et détection LLM.

Variable Description
DOTNET_CLI_TELEMETRY_OPTOUT Désactive la télémétrie lorsqu’elle est définie sur 1 ou true.
DOTNET_NOLOGO Masque l’avis de première exécution lorsqu’il est défini sur 1 ou true. La télémétrie reste activée.
DOTNET_CLI_TELEMETRY_STORAGE_PATH Modifie le répertoire dans lequel dotnetup stocke localement les données de télémétrie avant de téléverser les données.
DOTNET_CLI_TELEMETRY_SHUTDOWN_TIMEOUT_MS Dans les environnements CI, modifie la durée maximale, en millisecondes, que dotnetup attend avant d’envoyer des données de télémétrie avant de se fermer. La valeur par défaut est 20 000.

Confidentialité

Si vous pensez que la télémétrie collecte des données sensibles ou que Microsoft gère les données de manière non sécurisée ou inappropriée, créez un problème dans le référentiel dotnet/sdk.

Pour plus d’informations, consultez la Déclaration de confidentialité de Microsoft.

Voir aussi