Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Questa funzionalità richiede il pacchetto NuGet Microsoft.Testing.Extensions.Telemetry .
Suggerimento
Quando si usa Microsoft.Testing.Platform.MSBuild (incluso transitivamente da MSTest, NUnit e runner xUnit), questa estensione viene registrata automaticamente quando si installa il pacchetto NuGet, senza necessità di modifiche al codice. La registrazione manuale nella sezione seguente è necessaria solo se il punto di ingresso generato automaticamente è stato disabilitato impostando <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>.
Registrazione manuale
var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddAppInsightsTelemetryProvider();
Microsoft.Testing.Platform raccoglie i dati di telemetria, usati per comprendere come migliorare il prodotto. Ad esempio, questi dati di utilizzo consentono di eseguire il debug di problemi, ad esempio tempi di avvio lenti e di assegnare priorità alle nuove funzionalità. Sebbene queste informazioni siano apprezzate, è possibile disabilitare i dati di telemetria. Per altre informazioni sui dati di telemetria, vedere informativa sulla privacy.
Tipi di dati di telemetria
Microsoft.Testing.Platform raccoglie solo telemetria di tipo dati di utilizzo. I dati di utilizzo vengono usati per comprendere in che modo vengono utilizzate le funzionalità e dove viene impiegato il tempo durante l'esecuzione dell'app di test. Ciò consente di classificare in ordine di priorità i miglioramenti del prodotto.
Disabilitare la creazione di report di telemetria
Per disabilitare i dati di telemetria, impostare una variabile d'ambiente TESTINGPLATFORM_TELEMETRY_OPTOUT o DOTNET_CLI_TELEMETRY_OPTOUT su 1.
Rivelazione
Microsoft.Testing.Platform visualizza testo simile al seguente quando si esegue per la prima volta il file eseguibile. Il testo di output può variare leggermente a seconda della versione Microsoft.Testing.Platform in esecuzione. Questa esperienza di "prima esecuzione" è il modo in cui Microsoft invia una notifica sulla raccolta dei dati.
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
Punti dati
La funzionalità di telemetria non raccoglie dati personali, ad esempio nomi utente o indirizzi di posta elettronica. Non analizza il codice e non estrae dati a livello di project, ad esempio repository o autore, estrae il nome del file eseguibile e lo invia in formato hash.
Non estrae il contenuto dei file di dati a cui accedono o che sono creati dalle tue app, né esegue il dump di alcuna memoria occupata dagli oggetti delle tue app o il contenuto degli appunti.
I dati vengono inviati in modo sicuro ai server Microsoft usando la tecnologia Azure Monitor, mantenuti con restrizioni access e pubblicati in controlli di sicurezza rigorosi da sistemi di Azure Storage sicuri.
La protezione della privacy è importante per Microsoft. Se si sospetta che la telemetria stia raccogliendo dati sensibili o che i dati vengano gestiti in modo non sicuro o non appropriato, inviare un problema nel repository microsoft/testfx GitHub o inviare un messaggio di posta elettronica a dotnet@microsoft.com per l'analisi.
La funzionalità di telemetria raccoglie i punti dati seguenti:
| Versione | Dati |
|---|---|
| Tutto | .NET versione di runtime. |
| Tutto | Modalità applicazione, ad esempio "server". |
| Tutto | Numero di tentativi di test non riusciti. |
| Tutto | Conteggio dei tentativi di test superati. |
| Tutto | Numero di test non riusciti. |
| Tutto | Numero di test superati. |
| Tutto | Numero di test eseguiti. |
| Tutto | Il DisplayName delle estensioni che stai usando, sotto forma di valore hash. |
| Tutto | Se viene usata la build di debug della piattaforma. |
| Tutto | Se il debugger è stato collegato al processo. |
| Tutto | Se è stato utilizzato il filtro dei test. |
| Tutto | Se Hot reload è abilitato. |
| Tutto | Se l'applicazione si è arrestata in modo anomalo. |
| Tutto | Se l'applicazione è in esecuzione come NativeAOT. |
| Tutto | Se il repository è il nostro repository. In base all’impostazione di telemetry:isDevelopmentRepository in testingplatformconfig.json. |
| Tutto | Il nome del framework di test che stai utilizzando, rappresentato come un valore hash. |
| Tutto | Nome del file eseguibile (di solito uguale al nome del progetto), come valore hash. |
| Tutto | Sistema operativo, versione e architettura. |
| Tutto | Architettura del processo. |
| Tutto | ID runtime (RID). Per altre informazioni, vedere .NET Catalogo RID. |
| Tutto | Codice di uscita dell'applicazione. |
| Tutto | Indirizzo IP a tre ottetti usato per determinare la posizione geografica. |
| Tutto | Timestamp della chiamata, timestamp dell'inizio e della fine dei vari passaggi dell'esecuzione. |
| Tutto | Versione della piattaforma. |
| Tutto | Versione delle tue estensioni. |
| Tutto | Versione dell'adattatore di test. |
| Tutto | Guida per correlare gli eventi da un singolo runner. |
| 1.0.3 | Guida per correlare gli eventi di una singola esecuzione di test. |
Rilevamento continuo dell'integrazione
Per rilevare se l'interfaccia della riga di comando di .NET è in esecuzione in un ambiente di integrazione continua, l'interfaccia della riga di comando .NET verifica la presenza e i valori di diverse variabili di ambiente note impostate dai provider di integrazione continua comuni.
L'elenco completo delle variabili di ambiente e le operazioni eseguite con i relativi valori è dettagliato nella tabella seguente:
| Variabili di ambiente | Fornitore | Azione |
|---|---|---|
APPVEYOR |
Appveyor | Analizzare il valore booleano. |
BUILD_ID, BUILD_URL |
Jenkins | Controllare se tutti sono presenti e non nulli. |
BUILD_ID, PROJECT_ID |
Google Cloud Build | Controllare se tutti sono presenti e non nulli. |
CI |
Molti/più | Analizzare il valore booleano. |
CIRCLECI |
Circle CI | Analizzare il valore booleano. |
CODEBUILD_BUILD_ID, AWS_REGION |
Amazon Web Services CodeBuild | Controllare se tutti sono presenti e non nulli. |
GITHUB_ACTIONS |
GitHub Actions | Analizzare il valore booleano. |
JB_SPACE_API_URL |
Spazio JetBrains | Controllare se presente e non null. |
TEAMCITY_VERSION |
TeamCity | Controllare se presente e non null. |
TF_BUILD |
Azure Pipelines | Analizzare il valore booleano. |
TRAVIS |
Travis CI | Analizzare il valore booleano. |
Collabora con noi su GitHub
L'origine di questo contenuto è disponibile in GitHub, in cui è anche possibile creare ed esaminare i problemi e le richieste pull. Per ulteriori informazioni, vedere la guida per i collaboratori.
