Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cette fonctionnalité nécessite le package NuGet Microsoft.Testing.Extensions.Telemetry .
Conseil / Astuce
Lors de l’utilisation de Microsoft.Testing.Platform.MSBuild (inclus transitivement par MSTest, NUnit et les exécuteurs xUnit), cette extension est inscrite automatiquement lorsque vous installez son package NuGet , sans modification du code nécessaire. L’inscription manuelle dans la section suivante est requise uniquement si vous avez désactivé le point d’entrée généré automatiquement en définissant <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>.
Inscription manuelle
var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddAppInsightsTelemetryProvider();
Microsoft.Testing.Platform collecte des données de télémétrie, qui sont utilisées pour vous aider à comprendre comment améliorer le produit. Par exemple, ces données d’utilisation permettent de déboguer des problèmes, tels que des temps de démarrage lents, et de hiérarchiser les nouvelles fonctionnalités. Même si ces informations sont appréciées, vous êtes libre de désactiver la télémétrie. Pour plus d’informations sur la télémétrie, consultez déclaration de confidentialité.
Types de données de télémétrie
La télémétrie collectée par Microsoft.Testing.Platform est uniquement du type Données d’utilisation. Les données d’utilisation sont utilisées pour comprendre comment les fonctionnalités sont consommées et où le temps est passé lors de l’exécution de l’application de test. Cela permet de hiérarchiser les améliorations du produit.
Désactiver la création de rapports de télémétrie
Pour désactiver la télémétrie, définissez TESTINGPLATFORM_TELEMETRY_OPTOUT ou DOTNET_CLI_TELEMETRY_OPTOUT variable d’environnement sur 1.
Divulgation
Microsoft.Testing.Platform affiche du texte similaire à ce qui suit lorsque vous exécutez votre exécutable pour la première fois. Le texte de sortie peut varier légèrement en fonction de la version Microsoft.Testing.Platform que vous exécutez. Cette expérience de « première exécution » est la façon dont Microsoft vous avertit de la collecte de données.
Telemetry
---------
Microsoft.Testing.Platform collects usage data in order to help us improve your experience.
The data is collected by Microsoft and are not shared.
You can opt-out of telemetry by setting the TESTINGPLATFORM_TELEMETRY_OPTOUT
or DOTNET_CLI_TELEMETRY_OPTOUT environment variable to '1' or 'true' using your favorite shell.
Read more about Microsoft.Testing.Platform telemetry: https://aka.ms/testingplatform-telemetry
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 de niveau project, telles que le référentiel ou l'auteur, il extrait le nom de votre exécutable et l'envoie sous forme hachée.
Il n'extrait pas le contenu des fichiers de données accessibles ou créés par vos applications, ni les extraits de la mémoire occupée par les objets de vos applications, ni le contenu du presse-papiers.
Les données sont envoyées en toute sécurité aux serveurs Microsoft à l’aide de la technologie Azure Monitor, détenues sous des access restreintes et publiées sous des contrôles de sécurité stricts à partir de systèmes de Azure Storage sécurisés.
La protection de votre confidentialité est importante pour Microsoft ! Si vous soupçonnez que les données de télémétrie collectent des données sensibles ou que les données sont gérées de manière non sécurisée ou inappropriée, envoyez un problème dans le référentiel microsoft/testfx GitHub ou envoyez un e-mail à dotnet@microsoft.com pour examen.
La fonctionnalité de télémétrie collecte les points de données suivants :
| Version | Données |
|---|---|
| Tous | Version du runtime .NET. |
| Tous | Mode d’application, tel que « serveur ». |
| Tous | Nombre de nouvelles tentatives de test ayant échoué. |
| Tous | Nombre de nouvelles tentatives de test qui ont réussi. |
| Tous | Nombre de tests ayant échoué. |
| Tous | Nombre de tests réussis. |
| Tous | Nombre de tests exécutés. |
| Tous | La DisplayName des extensions que vous utilisez, sous forme de valeur hachée. |
| Tous | Si une build de débogage de la plateforme est utilisée. |
| Tous | Si le débogueur était attaché au processus. |
| Tous | Si le filtre de tests a été utilisé. |
| Tous | Si Hot reload est activé. |
| Tous | Si l’application s’est écrasée. |
| Tous | Si l’application s’exécute en tant que NativeAOT. |
| Tous | Si le référentiel est notre propre référentiel. En fonction du paramètre telemetry:isDevelopmentRepository dans testingplatformconfig.json. |
| Tous | Nom de l’infrastructure de test que vous utilisez, en tant que valeur de hachage. |
| Tous | Nom de votre exécutable (qui est généralement identique au nom du projet), en tant que valeur hachée. |
| Tous | Système d’exploitation, version et architecture. |
| Tous | Architecture de processus. |
| Tous | ID d’exécution (RID). Pour plus d’informations, consultez .NET catalogue RID. |
| Tous | Code de sortie de l’application. |
| Tous | Adresse IP de trois octets utilisée pour déterminer l’emplacement géographique. |
| Tous | Horodatage de l’appel, horodatage du début et de la fin des différentes étapes de l’exécution. |
| Tous | Version de la plateforme. |
| Tous | Version de vos extensions. |
| Tous | Version de votre adaptateur de test. |
| Tous | Guide pour mettre en corrélation des événements à partir d’un seul exécuteur. |
| 1.0.3 | Guid pour mettre en corrélation les événements à partir d’une seule exécution de test. |
Détection continue de l’intégration
Pour détecter si l’interface CLI .NET s’exécute dans un environnement d’intégration continue, la CLI .NET sonde pour la présence et les valeurs de plusieurs variables d'environnement bien connues fixées par les fournisseurs CI courants.
La liste complète des variables d’environnement, et ce qui est fait avec leurs valeurs, est détaillée dans le tableau suivant :
| Variable(s) d’environnement | Fournisseur | Action |
|---|---|---|
APPVEYOR |
Appveyor | Analyser la valeur booléenne. |
BUILD_ID, BUILD_URL |
Jenkins | Vérifier si tous sont présents et non null. |
BUILD_ID, PROJECT_ID |
Google Cloud Build (service de construction Google Cloud) | Vérifier si tous sont présents et non null. |
CI |
Beaucoup/La plupart | Analyser la valeur booléenne. |
CIRCLECI |
CircleCI | Analyser la valeur booléenne. |
CODEBUILD_BUILD_ID, AWS_REGION |
Amazon Web Services CodeBuild, un service de compilation automatisée et intégrée. | Vérifier si tous sont présents et non null. |
GITHUB_ACTIONS |
GitHub Actions | Analyser la valeur booléenne. |
JB_SPACE_API_URL |
JetBrains Space | Vérifier si présent et non null. |
TEAMCITY_VERSION |
TeamCity | Vérifier si présent et non null. |
TF_BUILD |
Azure Pipelines | Analyser la valeur booléenne. |
TRAVIS |
Travis CI | Analyser la valeur booléenne. |
Collaborer avec nous sur GitHub
La source de ce contenu se trouve sur GitHub, où vous pouvez également créer et examiner les problèmes et les demandes de tirage. Pour plus d’informations, consultez notre guide du contributeur.
