Telemetria di .NET SDK e .NET CLI
Il .NET SDK include una funzionalità di telemetria che raccoglie i dati di utilizzo e li invia a Microsoft quando vengono usati i comandi .NET CLI . I dati di utilizzo includono informazioni sulle eccezioni quando la CLI di .NET va in crash. L'interfaccia della riga di comando di .NET include .NET SDK ed è il set di verbi che consentono di compilare, testare e pubblicare le app .NET. I dati di telemetria consentono al team .NET di comprendere come vengono usati gli strumenti in modo che possano essere migliorati. Le informazioni sugli errori consentono al team di risolvere i problemi e correggere i bug.
I dati raccolti vengono pubblicati in modo aggregato nella Creative Commons Attribution License. Alcuni dei dati raccolti vengono pubblicati su .NET CLI dati di telemetria.
Ambito
dotnet ha due funzioni: per eseguire le app e per eseguire i comandi dell'interfaccia della riga di comando. La telemetria non viene raccolta quando si utilizza dotnet per avviare un'applicazione nel formato seguente:
dotnet [path-to-app].dll
La telemetria viene raccolta quando si utilizza uno dei comandi della CLI di .NET , ad esempio:
dotnet builddotnet packdotnet run
Come rifiutare esplicitamente
La funzionalità di telemetria di .NET SDK è abilitata per impostazione predefinita per le distribuzioni Microsoft dell'SDK. Per rifiutare esplicitamente la funzionalità di telemetria, impostare la variabile di ambiente DOTNET_CLI_TELEMETRY_OPTOUT su 1 o true.
Quando si verifica un'installazione corretta, una singola voce di telemetria viene inviata anche dall'installer di .NET SDK. Per rifiutare esplicitamente, impostare la variabile di ambiente DOTNET_CLI_TELEMETRY_OPTOUT prima di installare .NET SDK.
Importante
Per annullare dopo l'avvio dell'installatore: chiudere l'installatore, impostare la variabile di ambiente, quindi eseguire nuovamente l'installatore con tale valore impostato.
Rivelazione
.NET SDK visualizza testo simile al seguente quando si esegue per la prima volta uno dei comandi della .NET CLI (ad esempio, dotnet build). Il testo può variare leggermente a seconda della versione dell'SDK in esecuzione. Questa esperienza di "prima esecuzione" è il modo in cui Microsoft invia una notifica sulla raccolta dei dati.
Telemetry
---------
The .NET tools collect usage data in order to help us improve your experience. The data is collected by Microsoft and shared with the community. You can opt-out of telemetry by setting the DOTNET_CLI_TELEMETRY_OPTOUT environment variable to '1' or 'true' using your favorite shell.
Read more about .NET CLI Tools telemetry: https://aka.ms/dotnet-cli-telemetry
Per disabilitare questo messaggio e il messaggio di benvenuto .NET, impostare la variabile di ambiente DOTNET_NOLOGO su true. Nota che questa variabile non influisce sulla disattivazione dei dati di telemetria.
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 progetto, ad esempio nome, repository o autore. Non estrae il contenuto di alcun file di dati a cui le tue app accedono o che creano, né esegue il dump di qualsiasi memoria occupata dagli oggetti delle tue app, né il contenuto degli appunti. I dati vengono inviati in modo sicuro ai server Microsoft usando tecnologia di monitoraggio di Azure, con accesso limitato e pubblicati con controlli di sicurezza rigorosi da sistemi di archiviazione di Azure sicuri.
La protezione della privacy è importante per noi. Se si sospetta che la telemetria stia raccogliendo dati sensibili o che i dati vengano gestiti in modo non sicuro o inappropriato, inviare un problema nel repository dotnet/sdk o inviare un messaggio di posta elettronica a dotnet@microsoft.com per l'analisi.
La funzionalità di telemetria raccoglie i dati seguenti:
| Versioni dell'SDK | Dati |
|---|---|
| Tutto | Timestamp della chiamata. |
| Tutto | Comando richiamato (ad esempio, "build"), con hash a partire dalla versione 2.1. |
| Tutto | Indirizzo IP a tre ottetti usato per determinare la posizione geografica. |
| Tutto | Sistema operativo e versione. |
| Tutto | ID di runtime (RID) in cui è in esecuzione l'SDK. |
| Tutto | Versione di .NET SDK. |
| Tutto | Profilo di telemetria: valore facoltativo usato solo con esplicito consenso esplicito dell'utente e usato internamente in Microsoft. |
| >=2.0 | Argomenti e opzioni dei comandi: vengono raccolti diversi argomenti e opzioni (non stringhe arbitrarie). Consulta opzioni raccolte. Hash eseguito dopo la versione 2.1.300. |
| >=2.0 | Indica se l'SDK è in esecuzione in un contenitore. |
| >=2.0 | Framework di destinazione (dall'evento TargetFramework), con hash a partire dalla versione 2.1. |
| >=2.0 | Indirizzo MAC (Hashed Media Access Control) (SHA256). |
| >=2.0 | Directory di lavoro corrente con hash. |
| >=2.0 | Rapporto di installazione riuscita, con nome file exe dell'installer con hash. |
| >=2.1.300 | Versione del kernel. |
| >=2.1.300 | Rilascio/versione di libc. |
| >=3.0.100 | Indica se l'output è stato reindirizzato (true o false). |
| >=3.0.100 | In caso di arresto anomalo dell'interfaccia della riga di comando/SDK, viene indicato il tipo di eccezione e la relativa traccia dello stack (solo il codice dell'interfaccia della riga di comando/SDK è incluso nella traccia dello stack inviata). Per ulteriori dettagli, consultare la telemetria delle eccezioni di arresto anomalo. |
| >=5.0.100 | Hashed TargetFrameworkVersion usato per la compilazione (proprietà MSBuild) |
| >=5.0.100 | RuntimeIdentifier con hash usato per la compilazione (proprietà MSBuild) |
| >=5.0.100 | Hashed SelfContained utilizzato per la compilazione (proprietà MSBuild) |
| >=5.0.100 | Hash di UseApphost utilizzato per la compilazione (proprietà MSBuild) |
| >=5.0.100 | Hashed OutputType usato per la compilazione (proprietà MSBuild) |
| >=5.0.201 | Hashed PublishReadyToRun usato per la compilazione (proprietà MSBuild) |
| >=5.0.201 | Hashed PublishTrimmed usato per la compilazione (proprietà MSBuild) |
| >=5.0.201 | Hashed PublishSingleFile usato per la compilazione (proprietà MSBuild) |
| >=5.0.202 | Tempo trascorso dall'avvio del processo fino all'accesso al metodo principale del programma CLI, che misura il tempo di avvio dell'host e del runtime. |
| >=5.0.202 | Tempo trascorso per il passaggio che aggiunge gli strumenti .NET al percorso alla prima esecuzione. |
| >=5.0.202 | Tempo trascorso per visualizzare l'avviso di primo utilizzo alla prima esecuzione. |
| >=5.0.202 | Tempo trascorso per la generazione del certificato ASP.NET al primo avvio. |
| >=5.0.202 | Tempo trascorso per analizzare l'input CLI. |
| >=6.0.100 | Architettura del sistema operativo |
| >=6.0.104 | Hashed PublishReadyToRunUseCrossgen2 usato per la compilazione (proprietà MSBuild) |
| >=6.0.104 | Hashed Crossgen2PackVersion usato per la compilazione (proprietà MSBuild) |
| >=6.0.104 | Hashed CompileListCount utilizzato per la compilazione (proprietà MSBuild) |
| >=6.0.104 | Hash di _ReadyToRunCompilationFailures usato per la build (proprietà MSBuild) |
| >=6.0.300 | Se l'interfaccia a riga di comando è stata richiamata da un ambiente di integrazione continua. Per altre informazioni, vedere rilevamento dell'integrazione continua. |
| >=7.0.100 | Hash PublishAot usato per la compilazione (proprietà MSBuild) |
| >=7.0.100 | Protocollo di pubblicazione hashed utilizzato per la compilazione (proprietà MSBuild) |
| >=8.0.100 | TargetPlatformIdentifier con hash usato per la compilazione (proprietà MSBuild) |
| >=8.0.100 | Hashed HybridGlobalization usato per la compilazione (proprietà MSBuild) |
| >=8.0.100 | Indica se viene usato .NET Blazor WebAssembly SDK. |
| >=8.0.100 | Indica se viene usato .NET WebAssembly SDK. |
| >=8.0.100 | Indica se viene usato .NET MAUI. |
| >=8.0.100 | Indica se viene usato .NET Mobile SDK. |
| >=8.0.100 | Indica se vengono usati altri SDK per dispositivi mobili (ad esempio: Avalonia, Uno). |
| >=8.0.100 | Indica se viene usato Mono AOT. |
| >=8.0.100 | Indica se la funzionalità di stripping IL del Mono AOT viene utilizzata. |
| >=8.0.100 | Indica se viene usato l'interprete Mono. |
| >=8.0.100 | Indica se viene usata la modalità libreria per dispositivi mobili. |
| >=8.0.100 | Indica se viene usato NativeAOT. |
| >=8.0.100 | Usata la versione del pacchetto di runtime Mono. |
Opzioni raccolte
Alcuni comandi inviano dati aggiuntivi. Un subset di comandi invia il primo argomento:
| Comando | Dati del primo argomento inviati |
|---|---|
dotnet help <arg> |
Si sta effettuando una ricerca nella Guida del comando. |
dotnet new <arg> |
Nome del modello (con hash). |
dotnet add <arg> |
La parola package o reference. |
dotnet remove <arg> |
La parola package o reference. |
dotnet list <arg> |
La parola package o reference. |
dotnet sln <arg> |
La parola add, listo remove. |
dotnet nuget <arg> |
La parola delete, localso push. |
dotnet workload <subcommand> <arg> |
La parola install, update, list, search, uninstall, repair, restore e il nome del carico di lavoro (con hash). |
dotnet tool <subcommand> <arg> |
La parola install, update, list, search, uninstall, run e il nome dello strumento dotnet (con hash). |
Se vengono usati, un subset di comandi invia opzioni selezionate, insieme ai relativi valori:
| Opzione | Comandi |
|---|---|
--verbosity |
Tutti i comandi |
--language |
dotnet new |
--configuration |
dotnet build, dotnet clean, dotnet publish, dotnet run, dotnet test |
--framework |
dotnet build, dotnet clean, dotnet publish, dotnet run, dotnet test, dotnet vstest |
--runtime |
dotnet build, dotnet publish |
--platform |
dotnet vstest |
--logger |
dotnet vstest |
--sdk-package-version |
dotnet migrate |
Quando l'SDK non riesce a risolvere un comando predefinito, qualsiasi resolver di comandi che risolve correttamente il comando invia un hash del nome del comando insieme al nome del sistema di risoluzione dei comandi.
Ad eccezione di --verbosity e --sdk-package-version, tutti gli altri valori vengono hashati a partire da .NET Core 2.1.100 SDK.
Telemetria del motore di template
Il comando di creazione di istanze del modello dotnet new raccoglie dati aggiuntivi per i modelli creati da Microsoft, a partire da .NET Core 2.1.100 SDK:
--framework--auth
Telemetria degli errori di arresto anomalo
Se la CLI/SDK di .NET si blocca, raccoglie il nome dell'eccezione e la traccia dello stack del codice della CLI/SDK. Queste informazioni vengono raccolte per valutare i problemi e migliorare la qualità di .NET SDK e dell'interfaccia della riga di comando. Questo articolo fornisce informazioni sui dati raccolti. Fornisce anche suggerimenti su come gli utenti che creano la propria versione di .NET SDK possono evitare la divulgazione accidentale di informazioni personali o riservate.
L'interfaccia della riga di comando .NET raccoglie informazioni solo per le eccezioni CLI/SDK, non per le eccezioni nella tua applicazione. I dati raccolti contengono il nome dell'eccezione e la traccia dello stack. Questa stack trace è di codice CLI/SDK.
L'esempio seguente illustra il tipo di dati raccolti:
System.IO.IOException
at System.ConsolePal.WindowsConsoleStream.Write(Byte[] buffer, Int32 offset, Int32 count)
at System.IO.StreamWriter.Flush(Boolean flushStream, Boolean flushEncoder)
at System.IO.StreamWriter.Write(Char[] buffer)
at System.IO.TextWriter.WriteLine()
at System.IO.TextWriter.SyncTextWriter.WriteLine()
at Microsoft.DotNet.Cli.Utils.Reporter.WriteLine()
at Microsoft.DotNet.Tools.Run.RunCommand.EnsureProjectIsBuilt()
at Microsoft.DotNet.Tools.Run.RunCommand.Execute()
at Microsoft.DotNet.Tools.Run.RunCommand.Run(String[] args)
at Microsoft.DotNet.Cli.Program.ProcessArgs(String[] args, ITelemetry telemetryClient)
at Microsoft.DotNet.Cli.Program.Main(String[] args)
Rilevamento dell'integrazione continua
Per determinare se la .NET CLI è in esecuzione in un ambiente di integrazione continua, verifica la presenza e i valori di diverse variabili di ambiente note impostate dai fornitori CI comuni.
Di seguito è riportato l'elenco completo delle variabili di ambiente e le operazioni eseguite con i relativi valori. Si noti che in ogni caso, il valore della variabile di ambiente non viene mai raccolto, usato solo per impostare un flag booleano.
| Variabili | Fornitore | Azione |
|---|---|---|
| TF_BUILD | Azure Pipelines | Analizzare un valore booleano |
| GITHUB_ACTIONS | GitHub Actions | Analizzare un valore booleano |
| APPVEYOR | Appveyor | Analizzare un valore booleano |
| CI | Molti/più | Analizzare un valore booleano |
| TRAVIS | Travis CI | Analizzare un valore booleano |
| CIRCLECI | Circle CI | Analizzare un valore booleano |
| CODEBUILD_BUILD_ID, AWS_REGION | Amazon Web Services CodeBuild | Verifica se tutti sono presenti e non nulli |
| BUILD_ID, BUILD_URL | Jenkins | Controllare se tutti sono presenti e non Null |
| BUILD_ID, PROJECT_ID | Google Cloud Build | Controllare che tutti siano presenti e non nulli |
| TEAMCITY_VERSION | TeamCity | Controllare se presente e non Null |
| JB_SPACE_API_URL | JetBrains Space | Controllare se presente e non Null |
Evitare la divulgazione accidentale di informazioni
I collaboratori .NET e chiunque altro esegua una versione di .NET SDK creata da soli deve considerare il percorso del codice sorgente dell'SDK. Se si verifica un arresto anomalo durante l'uso di un SDK .NET che è una compilazione di debug personalizzata o configurata con file di simboli di compilazione personalizzati, il percorso del file di origine DELL'SDK dal computer di compilazione viene raccolto come parte dell'analisi dello stack e non viene eseguito l'hashing.
Per questo motivo, le build personalizzate di .NET SDK non devono trovarsi nelle directory i cui nomi di percorso espongono informazioni personali o riservate.
