『.NET Core CLI工具文檔』（二）.NET Core 工具遙測（應用信息收集）

說明：本文是我的翻譯文章，因爲我的水平有限，有不對的地方請你們幫忙更正。
原文：.NET Core Tools Telemetry
翻譯：.NET Core 工具遙測（應用信息收集）

.NET Core 工具包含收集使用信息的 遙測功能。對於 .NET 團隊瞭解如何使用工具以便於能夠提高它們是重要的。

收集的數據是匿名的，並將發佈一個彙總的形式，在 知識共享署名許可協議 下供微軟和社區工程師使用。

適用範圍

dotnet 命令是用於啓動應用程序和 .NET Core 工具。dotnet 命令它自己不會收集遙測數據。它是 dotnet 命令經過運行 .NET Core 工具來收集遙測數據。

.NET Core 命令（遙測未啓用）：

• dotnet

• dotnet [path-to-app]

.NET Core 工具 命令 （遙測啓用），例如：

• dotnet build

• dotnet pack

• dotnet restore

• dotnet run

行爲

默認狀況下 .NET Core 工具遙測功能是啓用的。你能夠選擇退出遙感功能，經過設置一個環境變量 DOTNET_CLI_TELEMETRY_OPTOUT （例如：在 macOS/Linux 上的 export，在 Windows 上的 set）爲 true （例如：「true」，1）。

數據點

該功能收集如下幾部分數據：

• 正在使用的命令（例如： 「build」、「restore」）

• 命令退出代碼

• 對於測試項目，正在使用的測試器

• 調用的時間戳

• 使用的框架

• 運行時的 IDs 是否與當前 「runtimes」 節點一致

• 當前正在使用的 CLI 版本

該功能不會收集任何我的數據，好比用戶名或者電子郵件。它不掃描你的代碼，不提取任何能夠視爲敏感語句的項目級別數據，例如名稱，倉庫地址，或者做者（若是你在你的 project.json 設置這些）。咱們想知道工具如何被使用，而不是你使用工具生成什麼。若是你發現敏感的數據被收集，這是一個錯誤。請 提交一個 issue，它將會被修復。

許可協議

微軟 .NET Core 分配的許可協議是 MICROSOFT .NET LIBRARY EULA。爲了啓動遙感，這個包括 「DATA」 部分從新輸出在下面。

.NET NuGet packages 使用這個相同的許可協議，可是未開啓遙感（參考上面的 適用範圍）。

2.      DATA.  The software may collect information about you and your use of
the software, and send that to Microsoft. Microsoft may use this information
to improve our products and services. You can learn more about data collection
and use in the help documentation and the privacy statement at
http://go.microsoft.com/fwlink/?LinkId=528096 . Your use of the software
operates as your consent to these practices.

說明

當你首次運行一個命令（例如：dotnet restore）時，.NET Core 工具顯示下面的文字。這個「首次運行」體驗是微軟如何通知你關於數據收集。一樣的體驗，最初填充你的 NuGet 緩存在 .NET Core SDK 中，避免去 NuGet.org（或者其它 NuGet 源）請求這些庫。

Welcome to .NET Core!
---------------------

Learn more about .NET Core @ https://aka.ms/dotnet-docs. Use dotnet --help to
see available commands or go to https://aka.ms/dotnet-cli-docs.

Telemetry
---------

The .NET Core tools collect usage data in order to improve your experience.
The data is anonymous and does not include commandline arguments. The data is
collected by Microsoft and shared with the community.

You can opt out of telemetry by setting a DOTNET_CLI_TELEMETRY_OPTOUT
environment variable to 1 using your favorite shell.

You can read more about .NET Core tools telemetry @ https://aka.ms/dotnet-cli-
telemetry.

Configuring...
--------------

A command is running to initially populate your local package cache, to
improve restore speed and enable offline access. This command will take up to
a minute to complete and will only happen once.