Telemetria

Ehhez a funkcióhoz a Microsoft.Testing.Extensions.Telemetry NuGet-csomag szükséges.

Jótanács

A Microsoft.Testing.Platform.MSBuild használatakor (ami tranzitívan szerepel az MSTest, az NUnit, és az xUnit futók között) a bővítmény automatikusan regisztrálódik a NuGet csomag telepítésekor — és nincs szükség kódmódosításra. A következő szakaszban a manuális regisztrációra csak akkor van szükség, ha letiltotta az automatikusan létrehozott belépési pontot a beállítással <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>.

Manuális regisztráció

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

Microsoft. A Testing.Platform (MTP) telemetriai adatokat gyűjt, amelyek a termék fejlesztésének megértésére szolgálnak. Ezek a használati adatok például segítenek a hibakeresésben, például a lassú indítási időkben és az új funkciók rangsorolásában. Bár értékeljük ezeket az betekintéseket, szabadon kikapcsolhatja a telemetriát. További információ a telemetriáról: adatvédelmi nyilatkozat.

Telemetriai adatok típusai

Az MTP csak használati adatok típusú telemetriát gyűjt. A használati adatok segítségével megtudhatja, hogyan használják fel a szolgáltatásokat, és hol töltik az időt a tesztalkalmazás végrehajtásakor. Ez segít a termékfejlesztések rangsorolásában.

Telemetriajelentés letiltása

A telemetria letiltásához állítsa TESTINGPLATFORM_TELEMETRY_OPTOUT vagy DOTNET_CLI_TELEMETRY_OPTOUT környezeti változót 1értékre.

Közzététel

Az MTP a következőhöz hasonló szöveget jelenít meg a végrehajtható fájl első futtatásakor. A kimeneti szöveg kissé eltérhet a futó MTP-verziótól függően. Ez az "első futtatás" élmény az, ahogyan a Microsoft értesíti Önt az adatgyűjtésről.

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

Adatpontok

A telemetriai funkció nem gyűjt személyes adatokat, például felhasználóneveket vagy e-mail-címeket. Nem ellenőrzi a kódot, és nem nyer ki project szintű adatokat, például adattárat vagy szerzőt, kinyeri a végrehajtható fájl nevét, és kivonatolt formában küldi el.

Nem nyeri ki az alkalmazások által elért vagy létrehozott adatfájlok tartalmát, az alkalmazások objektumai által foglalt memória tartalmát, vagy a vágólap tartalmát.

A rendszer biztonságosan továbbítja az adatokat a Microsoft-kiszolgálóknak az Azure Monitor technológiával, korlátozott hozzáféréssel tárolva, és szigorú biztonsági ellenőrzés alatt teszi közzé a biztonságos Azure Storage rendszerekből.

Az adatvédelem fontos a Microsoft számára! Ha azt gyanítja, hogy a telemetriai adatok bizalmas adatokat gyűjtenek, vagy az adatokat nem biztonságosan vagy nem megfelelően kezelik, küldjön egy hibát a microsoft/testfx GitHub adattárban, vagy küldjön e-mailt dotnet@microsoft.com vizsgálat céljából.

A telemetria funkció a következő adatpontokat gyűjti össze:

Verzió	Adat
Összes	.NET futtatókörnyezet verziója.
Összes	Alkalmazás mód, például "kiszolgáló".
Összes	A sikertelen tesztelési újrapróbálkozések száma.
Összes	Az elvégzett teszt újrapróbálkozásainak száma.
Összes	Sikertelen tesztek száma.
Összes	Az elvégzett tesztek száma.
Összes	Futtatott tesztek száma.
Összes	Az általad használt bővítmények DisplayName hash-elt értékként.
Összes	Ha a platform hibakereső buildjét használják.
Összes	Ha a hibakereső hozzá lett kapcsolva a folyamathoz.
Összes	Ha használták a tesztszűrőt.
Összes	Ha Hot reload engedélyezve van.
Összes	Ha az alkalmazás összeomlott.
Összes	Ha az alkalmazás NativeAOT néven fut.
Összes	Ha az adattár a mi saját adattárunk. A telemetry:isDevelopmentRepository beállítása alapján.
Összes	A használt tesztkörnyezet neve kivonatolt értékként.
Összes	A végrehajtható fájl neve (amely általában megegyezik a project nevével) kivonatolt értékként.
Összes	Operációs rendszer, verzió és architektúra.
Összes	Folyamatarchitektúra.
Összes	Futtatókörnyezet azonosító (RID). További információ: .NET RID-katalógus.
Összes	Az alkalmazás kilépési kódja.
Összes	A földrajzi hely meghatározásához használt három oktett IP-cím.
Összes	A hívás időbélyege, a végrehajtás különböző lépéseinek kezdési és befejezési időbélyege.
Összes	A platform verziója.
Összes	A bővítmények verziója.
Összes	A tesztadapter verziója.
Összes	Útmutató események korrelálásához egy futónál.
1.0.3	Útmutató egy tesztfuttatás eseményeinek korrelációjához.

Folyamatos integráció felismerés

Annak észlelése érdekében, hogy a .NET parancssori felület folyamatos integrációs környezetben fut-e, a .NET parancssori felület több jól ismert környezeti változó jelenlétét és értékeit mintavételezi, amelyeket a közös CI-szolgáltatók állítottak be.

A környezeti változók teljes listája és az értékükkel végzett műveletek részletes listája az alábbi táblázatban található:

Környezeti változó(k)	Szolgáltató	Akció
APPVEYOR	Appveyor	Logikai érték elemzése.
BUILD_ID, BUILD_URL	Jenkins	Ellenőrizze, hogy mindegyik jelen van-e, és nem null értékű-e.
BUILD_ID, PROJECT_ID	Google Cloud Build	Ellenőrizze, hogy mindegyik jelen van-e, és nem null értékű-e.
CI	Több/legtöbb	Logikai érték elemzése.
CIRCLECI	Circle CI	Logikai érték elemzése.
CODEBUILD_BUILD_ID, AWS_REGION	Amazon Web Services CodeBuild	Ellenőrizze, hogy mindegyik jelen van-e, és nem null értékű-e.
GITHUB_ACTIONS	GitHub Actions	Logikai érték elemzése.
JB_SPACE_API_URL	JetBrains Space	Ellenőrizze, hogy jelen van-e és nem null értékű-e.
TEAMCITY_VERSION	TeamCity	Ellenőrizze, hogy jelen van-e és nem null értékű-e.
TF_BUILD	Azure Pipelines	Logikai érték elemzése.
TRAVIS	Travis CI	Logikai érték elemzése.