Телеметрия

Для этой функции требуется пакет NuGet Microsoft.Testing.Extensions.Telemetry .

Подсказка

При использовании Microsoft.Testing.Platform.MSBuild (включается транзитивно msTest, NUnit и xUnit runners), это расширение регистрируется автоматически при установке пакета NuGet — изменения кода не требуются. Регистрация вручную в следующем разделе требуется только в том случае, если вы отключили автоматическую точку входа, задав параметр <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>.

Регистрация вручную

var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddAppInsightsTelemetryProvider();

Microsoft.Testing.Platform собирает данные телеметрии, которые помогают понять, как улучшить продукт. Например, эти данные об использовании помогают отлаживать проблемы, такие как медленное время запуска, а также определять приоритеты новых функций. Хотя эти аналитические сведения ценятся, вы можете отключить телеметрию. Дополнительные сведения о телеметрии см. в заявлении о конфиденциальности.

Типы данных телеметрии

Microsoft.Testing.Platform собирает только телеметрию типа "Данные об использовании". Данные об использовании используются для понимания использования функций и времени, затрачиваемого при выполнении тестового приложения. Это помогает определить приоритеты улучшений продукта.

Отключите отчеты телеметрии

Чтобы отключить данные телеметрии, задайте для переменной среды TESTINGPLATFORM_TELEMETRY_OPTOUT или DOTNET_CLI_TELEMETRY_OPTOUT значение 1.

Раскрытие

Microsoft.Testing.Platform отображает текст, аналогичный следующему при первом запуске исполняемого файла. Выходной текст может немного отличаться в зависимости от используемой вами версии Microsoft.Testing.Platform. Эта процедура "первый запуск" — это способ, которым корпорация Майкрософт уведомляет вас о сборе данных.

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

Точки данных

Функция телеметрии не собирает персональные данные, такие как имена пользователей или адреса электронной почты. Он не сканирует код и не извлекает данные уровня project, например репозиторий или автор, извлекает имя исполняемого файла и отправляет его в хэшируемой форме.

Он не извлекает содержимое ни одного из файлов данных, к которым обращаются или которые создаются вашими приложениями, дампы памяти, занятой объектами ваших приложений, или содержимое буфера обмена.

Данные безопасно отправляются на серверы Майкрософт с использованием технологии Azure Monitor, удерживаемой под ограниченным доступом, и публикуются под строгими мерами безопасности из защищенных систем Azure Storage.

Защита конфиденциальности важна для Майкрософт! Если вы подозреваете, что данные телеметрии собирают конфиденциальные данные или данные небезопасно обрабатываются, отправьте сообщение о проблеме в репозитории microsoft/testfx GitHub или отправьте сообщение электронной почты в dotnet@microsoft.com для расследования.

Функция телеметрии собирает следующие точки данных:

Версия	Данные
Все	версия среды выполнения .NET
Все	Режим приложения, например "сервер".
Все	Количество повторных попыток теста, которые завершилось сбоем.
Все	Количество повторных попыток теста, завершившихся успешно.
Все	Количество тестов, которые завершилися сбоем.
Все	Количество пройденных тестов.
Все	Количество запущенных тестов.
Все	DisplayName расширений, которые вы используете, в виде хэшированного значения.
Все	Если используется отладочная сборка платформы.
Все	Если отладчик был присоединен к процессу.
Все	Если использовался фильтр тестов.
Все	Если Hot reload включен.
Все	Если приложение завершилось сбоем.
Все	Если приложение работает как NativeAOT.
Все	Если репозиторий является нашим собственным репозиторием. На основе параметра telemetry:isDevelopmentRepository в testingplatformconfig.json.
Все	Имя используемой платформы тестирования в качестве хэшированного значения.
Все	Имя исполняемого файла (которое обычно совпадает с именем проекта), в виде хэшированного значения.
Все	Операционная система, версия и архитектура.
Все	Архитектура процесса.
Все	Идентификатор среды выполнения (RID). Дополнительные сведения см. в разделе .NET RID-каталог.
Все	Код выхода приложения.
Все	Три октета IP-адреса, используемые для определения географического расположения.
Все	Метка времени вызова, метка времени начала и окончания различных шагов выполнения.
Все	Версия платформы.
Все	Версия ваших расширений.
Все	Версия тестового адаптера.
Все	GUID для корреляции событий из одного исполнителя.
1.0.3	Guid для сопоставления событий из одного тестового запуска.

Обнаружение непрерывной интеграции

Чтобы определить, выполняется ли .NET CLI в среде непрерывной интеграции, .NET CLI проверяет наличие и значения нескольких известных переменных среды, которые задают общие поставщики CI.

Полный список переменных среды и их значения см. в следующей таблице.

Переменные среды	Поставщик	Действие
APPVEYOR	Appveyor	Анализ логического значения.
BUILD_ID, BUILD_URL	Дженкинс	Проверьте, присутствуют ли все и не равны NULL.
BUILD_ID, PROJECT_ID	Google Cloud Build	Проверьте, присутствуют ли все и не равны NULL.
CI	Многие или большинство	Анализ логического значения.
CIRCLECI	Circle CI	Анализ логического значения.
CODEBUILD_BUILD_ID, AWS_REGION	Amazon Web Services CodeBuild (сервис для автоматизации сборки и тестирования)	Проверьте, присутствуют ли все и не равны NULL.
GITHUB_ACTIONS	GitHub Actions	Анализ логического значения.
JB_SPACE_API_URL	JetBrains Space	Проверьте, присутствует ли и не является NULL.
TEAMCITY_VERSION	TeamCity	Проверьте, присутствует ли и не является NULL.
TF_BUILD	Azure Pipelines (конвейеры Azure)	Анализ логического значения.
TRAVIS	Трэвис CI	Анализ логического значения.