Telemetrie

Tato funkce vyžaduje balíček NuGet Microsoft.Testing.Extensions.Telemetry .

Návod

Pokud používáte Microsoft.Testing.Platform.MSBuild (zahrnutý přenosně pomocí msTest, NUnit a xUnit runnerů), toto rozšíření se automaticky zaregistruje při instalaci balíčku NuGet – nevyžaduje se žádné změny kódu. Ruční registrace v následující části se vyžaduje pouze v případě, že jste zakázali automaticky vygenerovaný vstupní bod nastavením <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>.

Ruční registrace

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

Microsoft.Testing.Platform shromažďuje telemetrická data, která slouží k pochopení toho, jak produkt vylepšit. Údaje o využití pomáhají například ladit problémy, jako je pomalé spouštění aplikací, a stanovovat priority nových funkcí. I když tyto přehledy oceníte, můžete zakázat telemetrii. Další informace o telemetrii najdete v prohlášení o zásadách ochrany osobních údajů.

Typy telemetrických dat

Microsoft.Testing.Platform shromažďuje pouze telemetrii typu data o využití. Data o využití slouží k pochopení využití funkcí a času stráveného při provádění testovací aplikace. To pomáhá určit prioritu vylepšení produktů.

Zakázat odesílání telemetrie

Pokud chcete zakázat telemetrii, nastavte TESTINGPLATFORM_TELEMETRY_OPTOUT nebo DOTNET_CLI_TELEMETRY_OPTOUT proměnnou prostředí na 1.

Zveřejnění

Microsoft.Testing.Platform při prvním spuštění spustitelného souboru zobrazí text podobný následujícímu. Výstupní text se může mírně lišit v závislosti na verzi Microsoft.Testing.Platform, kterou používáte. Toto prostředí "první spuštění" je způsob, jakým vás Microsoft upozorní na shromažďování dat.

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

Datové body

Funkce telemetrie neshromažďuje osobní údaje, jako jsou uživatelská jména nebo e-mailové adresy. Neskenuje váš kód a neextrahuje data na úrovni project, jako je úložiště nebo autor, extrahuje název vašeho spustitelného souboru a odesílá je ve formě hash.

Neextrahuje obsah žádných datových souborů, které jsou přístupné nebo vytvořené vašimi aplikacemi, výpisy paměti, které zabírají objekty vašich aplikací, ani obsah schránky.

Data se bezpečně odesílají na servery Microsoftu pomocí technologie Azure Monitor, která se uchovává v omezeném access a publikuje se pod přísnými bezpečnostními kontrolami ze zabezpečených systémů Azure Storage.

Ochrana osobních údajů je pro Microsoft důležitá! Pokud máte podezření, že telemetrie shromažďuje citlivá data nebo jsou nezabezpečená nebo nevhodně zpracována, založte problém v úložišti microsoft/testfx GitHub nebo odešlete e-mail na dotnet@microsoft.com pro šetření.

Funkce telemetrie shromažďuje následující datové body:

Verze	Údaje
Všichni	.NET verze modulu runtime.
Všichni	Režim aplikace, například "server".
Všichni	Počet selhání při opakování testů.
Všichni	Počet opakování testů, které proběhly.
Všichni	Počet testů, které selhaly
Všichni	Počet úspěšných testů
Všichni	Počet spuštěných testů
Všichni	DisplayName rozšíření, která používáte, ve formě hashované hodnoty.
Všichni	Pokud se použije ladicí verze platformy.
Všichni	Pokud byl debugger připojen k procesu.
Všichni	Pokud byl použit filtr testů.
Všichni	Pokud je povolená Hot reload.
Všichni	Pokud dojde k chybě aplikace.
Všichni	Pokud je aplikace spuštěná jako NativeAOT.
Všichni	Pokud je úložiště naším vlastním úložištěm. Na základě nastavení telemetry:isDevelopmentRepository v testingplatformconfig.json.
Všichni	Název testovací architektury, kterou používáte, jako hodnota hash.
Všichni	Název spustitelného souboru (který je obvykle stejný jako název projektu), jako zašifrovaná hodnota.
Všichni	Operační systém, verze a architektura
Všichni	Architektura procesů
Všichni	ID běhového prostředí (RID). Další informace najdete v tématu .NET Katalog identifikátorů RID.
Všichni	Ukončovací kód aplikace.
Všichni	Tři osmičkové IP adresy používané k určení zeměpisného umístění.
Všichni	Časové razítko vyvolání, časové razítko spuštění a ukončení různých kroků během provádění.
Všichni	Verze platformy.
Všichni	Verze vašich rozšíření.
Všichni	Verze testovacího adaptéru
Všichni	GUID ke korelaci událostí z jednoho běžce
1.0.3	Guid ke korelaci událostí z jednoho běhu testu

Detekce kontinuální integrace

Aby bylo možné zjistit, jestli je rozhraní příkazového řádku .NET spuštěné v prostředí kontinuální integrace, .NET rozhraní příkazového řádku testuje přítomnost a hodnoty několika známých proměnných prostředí, které nastavují běžní poskytovatelé CI.

Úplný seznam proměnných prostředí a toho, co se provádí s jejich hodnotami, je podrobně popsán v následující tabulce:

Proměnná(y) prostředí	Poskytovatel	Akce
APPVEYOR	Appveyor	Analyzovat logickou hodnotu.
BUILD_ID, BUILD_URL	Jenkins	Zkontrolujte, jestli jsou všechny přítomny a nejsou nulové.
BUILD_ID, PROJECT_ID	Google Cloud Build	Zkontrolujte, jestli jsou všechny přítomny a nejsou nulové.
CI	Mnoho/Většina	Analyzovat logickou hodnotu.
CIRCLECI	Kruh CI	Analyzovat logickou hodnotu.
CODEBUILD_BUILD_ID, AWS_REGION	Amazon Web Services CodeBuild	Zkontrolujte, jestli jsou všechny přítomny a nejsou nulové.
GITHUB_ACTIONS	GitHub Actions	Analyzovat logickou hodnotu.
JB_SPACE_API_URL	JetBrains Space	Zkontrolujte, jestli existuje a není null.
TEAMCITY_VERSION	TeamCity	Zkontrolujte, jestli existuje a není null.
TF_BUILD	Azure Pipelines	Analyzovat logickou hodnotu.
TRAVIS	Travis CI	Analyzovat logickou hodnotu.