dotnetup telemetry

Note

dotnetup è disponibile in anteprima pubblica. Le funzionalità e il comportamento potrebbero cambiare prima della disponibilità generale.

dotnetup include una funzionalità di telemetria che raccoglie i dati di utilizzo e li invia a Microsoft quando si eseguono dotnetup comandi. I dati di utilizzo includono informazioni sulle eccezioni quando dotnetup si arresta in modo anomalo. Il team .NET usa questi dati per comprendere in che modo gli utenti usano lo strumento e per risolvere i problemi.

Come rifiutare esplicitamente

La telemetria è attivata per impostazione predefinita. Per disattivare, impostare la DOTNET_CLI_TELEMETRY_OPTOUT variabile di ambiente su 1 o true.

Si tratta della stessa variabile che disattiva i dati di telemetria per .NET SDK e CLI. Per altre informazioni, vedere .NET SDK e telemetria di .NET CLI.

Avviso di prima esecuzione

La prima volta che si esegue dotnetup, viene visualizzato questo messaggio:

dotnetup collects usage data to help improve your experience. You can opt out by setting the DOTNET_CLI_TELEMETRY_OPTOUT environment variable to '1'. Learn more: https://aka.ms/dotnetup-telemetry

Per nascondere questo avviso senza disattivare i dati di telemetria, impostare la DOTNET_NOLOGO variabile di ambiente su 1 o true.

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 i dati a livello di progetto. dotnetupinvia i dati in modo sicuro ai server Microsoft con tecnologia Monitoraggio di Azure.

dotnetup raccoglie i dati seguenti:

  • Timestamp dell'invocazione.
  • Il comando che esegui, ad esempio install, update o list.
  • La versione dotnetup e il commit SHA.
  • Il sistema operativo e l'architettura.
  • Se dotnetup viene eseguito in un ambiente di integrazione continua (CI).
  • Se dotnetup viene eseguito da un agente LLM, ad esempio GitHub Copilot.
  • Codice di uscita o stato di esito positivo o negativo.
  • Per gli errori: il tipo di errore, la categoria di errore, i dettagli dell'errore sanificati senza percorsi di file e l'analisi dello stack senza messaggi di eccezione.

Telemetria degli errori di arresto anomalo

Se dotnetup si arresta in modo anomalo, raccoglie il nome dell'eccezione e la traccia dello stack del codice dotnetup. Non include i messaggi di eccezione, perché possono contenere l'input dell'utente. Questo approccio è identico a quello usato dall'SDK di .NET. Per ulteriori dettagli, consultare la telemetria delle eccezioni di arresto anomalo.

Rilevamento degli agenti CI e LLM

dotnetupusa lo stesso rilevamento dell'ambiente CI e il rilevamento dell'agente LLM di .NET SDK. Per l'elenco delle variabili di ambiente che controlla, vedere Rilevamento dell'integrazione continua e rilevamento LLM.

Variable Descrizione
DOTNET_CLI_TELEMETRY_OPTOUT Disattiva i dati di telemetria quando è impostato su 1 o true.
DOTNET_NOLOGO Nasconde l'avviso di prima esecuzione quando è impostato su 1 o true. La telemetria rimane attiva.
DOTNET_CLI_TELEMETRY_STORAGE_PATH Modifica la directory in cui dotnetup archivia localmente i dati di telemetria prima che li carichi.
DOTNET_CLI_TELEMETRY_SHUTDOWN_TIMEOUT_MS Negli ambienti CI cambia il tempo massimo, in millisecondi, che dotnetup attende prima di inviare i dati di telemetria prima di essere chiuso. Il valore predefinito è 20.000.

Riservatezza

Se si ritiene che la telemetria raccolga dati sensibili o che Microsoft gestisca i dati in modo non sicuro o inappropriato, aprire una segnalazione nel repository dotnet/sdk.

Per altre informazioni, vedere l'Informativa sulla privacy microsoft.

Vedere anche

  • Ultimo aggiornamento: