Condividi tramite


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

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

Utilizzo dei dati da parte di Microsoft

Il team del prodotto utilizza i dati di telemetria di ML.NET CLI per comprendere come migliorare gli strumenti. Ad esempio, se i clienti usano raramente una determinata attività di Machine Learning, il team del prodotto esamina il motivo e usa i risultati per classificare in ordine di priorità lo sviluppo di funzionalità. La telemetria dell'interfaccia a riga di comando di ML.NET aiuta anche a eseguire il debug di problemi come arresti anomali e anomalie del codice.

Anche se il team del prodotto apprezza queste informazioni, sappiamo anche che non tutti vogliono inviare questi dati. Informazioni su come disabilitare i dati di telemetria.

Ambito

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

La telemetria non è abilitata quando si esegue il mlnet comando senza altri comandi collegati. Per esempio:

  • mlnet
  • mlnet --help

La 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 ML.NET è abilitata per impostazione predefinita.

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

Punti dati raccolti

La funzionalità raccoglie i dati seguenti:

  • Quale comando è 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: un ID crittograficamente anonimo (SHA256) e univoco per una macchina
  • Timestamp di una chiamata
  • Indirizzo IP a tre ottetti (non indirizzo IP completo) usato solo per determinare la posizione geografica
  • Nome di tutti gli argomenti/parametri utilizzati. Non i valori del cliente, ad esempio stringhe
  • Nome file del set di dati con hash
  • Categoria delle dimensioni dei file del set di dati
  • Sistema operativo e la sua versione
  • Valore dei comandi dell'attività ML: valori categorici, come regression, classification, e recommendation
  • ML.NET versione dell'interfaccia della riga di comando (ovvero 0.3.27703.4)

I dati vengono inviati in modo sicuro ai server Microsoft usando la tecnologia Azure Application Insights , mantenuti con accesso limitato e usati in controlli di sicurezza rigorosi dai sistemi di archiviazione di Azure sicuri.

Punti dati non raccolti

La funzionalità di telemetria non raccoglie:

  • dati personali, ad esempio nomi utente
  • nomi file del set di dati
  • dati dai file del set di dati

Se si sospetta che la telemetria dell'interfaccia della riga di comando di ML.NET stia raccogliendo dati sensibili o che i dati vengano gestiti in modo non sicuro o inappropriato, inviare un problema nel repository ML.NET per l'analisi.

Licenza

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

Rivelazione

Quando si esegue per la prima volta un comando ML.NET CLI, come mlnet classification, lo strumento dell'interfaccia della riga di comando di ML.NET visualizza il testo di divulgazione che indica come rifiutare esplicitamente i dati di telemetria. Il testo può variare leggermente a seconda della versione della CLI in esecuzione.

Vedere anche