Condividi tramite


Raccolta di dati di telemetria dall'interfaccia della riga di comando di ML.NET

L'interfaccia della riga di comando di ML.NET include una funzionalità di telemetria che raccoglie dati di utilizzo anonimi che vengono aggregati per l'uso da Microsoft.

Come Microsoft usa i dati

Il team di prodotto usa i dati di telemetria dell'interfaccia della riga di comando di ML.NET per capire come migliorare gli strumenti che propone. Se i clienti utilizzano raramente una particolare attività di Machine Learning, ad esempio, il team di prodotto indaga sul motivo e usa i risultati per stabilire le priorità delle funzionalità da sviluppare in futuro. I dati di telemetria dell'interfaccia della riga di comando di ML.NET sono utili anche per il debug dei problemi, ad esempio gli arresti anomali del sistema e le anomalie di codice.

Nonostante il team di prodotto gradisca disporre di questo tipo di informazioni, Microsoft è consapevole che non tutti gli utenti sono disposti a inviare i dati. Informazioni su come disabilitare i dati di telemetria.

Ambito

Il comando mlnet avvia l'interfaccia della riga di comando di ML.NET, ma non raccoglie i dati di telemetria.

La funzionalità di telemetria non è abilitata quando si esegue il comando mlnet con nessun altro comando collegato. Ad esempio:

  • mlnet
  • mlnet --help

La funzionalità di telemetria è abilitata quando si esegue un comando dell'interfaccia della riga di comando di ML.NET, ad esempio mlnet classification.

Rifiutare esplicitamente la raccolta dati

La funzionalità di telemetria dell'interfaccia della riga di comando di ML.NET è abilitata per impostazione predefinita.

Rifiutare esplicitamente la funzionalità di telemetria impostando la variabile di ambiente MLDOTNET_CLI_TELEMETRY_OPTOUT su 1 o true. Questa variabile di ambiente viene applicata a livello globale allo strumento dell'interfaccia della riga di comando di ML.NET.

Punti dati raccolti

La funzionalità raccoglie i dati seguenti:

  • Il comando che è stato richiamato, ad esempio classification
  • Nomi dei parametri della riga di comando usati (ovvero "dataset, label-col, output-path, train-time, verbosity")
  • Indirizzo MAC con hash: ID univoco e anonimo dal punto di vista crittografico (SHA256) per un computer
  • Il timestamp di una chiamata
  • Indirizzo IP a tre ottetti (non l'indirizzo IP completo) usato solo per determinare la posizione geografica
  • Nome di tutti gli argomenti e dei parametri usati. Non i valori del cliente, ad esempio le stringhe
  • Nome di file del set di dati con hash
  • Bucket delle dimensioni di file del set di dati
  • Sistema operativo e la sua versione
  • Valore dei comandi attività ML: valori categorici, ad esempio regression, classification e recommendation
  • Versione dell'interfaccia della riga di comando ML.NET (ovvero 0.3.27703.4)

I dati vengono inviati ai server Microsoft in modalità protetta grazie alla tecnologia Azure Application Insights, conservati con accesso limitato e usati in base a severi controlli di sicurezza da parte di sistemi di archiviazione di Azure.

Punti dati non raccolti

La funzionalità di telemetria non raccoglie:

  • dati personali, ad esempio i nomi utente
  • nomi dei set di dati
  • dati dei set di dati

Se si sospetta che la funzionalità di telemetria dell'interfaccia della riga di comando di ML.NET raccolga dati sensibili o che i dati raccolti siano gestiti in modo inappropriato o non sicuro, segnalare un problema nel repository di ML.NET.

Licenza

La distribuzione dell'interfaccia della riga di comando di ML.NET da parte di Microsoft è concessa secondo le Condizioni di licenza software Microsoft: libreria .NET Microsoft. Per informazioni dettagliate sulla raccolta e l'elaborazione dei dati, vedere la sezione intitolata "DATA".

Divulgazione

Quando si esegue un comando dell'interfaccia della riga di comando di ML.NET per la prima volta, ad esempio mlnet classification, lo strumento dell'interfaccia della riga di comando di ML.NET visualizza un avviso sulla divulgazione di informazioni che spiega come rifiutare esplicitamente la funzionalità di telemetria. Il testo potrebbe variare lievemente in funzione della versione dell'interfaccia della riga di comando in esecuzione.

Vedi anche