說明:本文是個人翻譯文章,由於個人水平有限,有不對的地方請大家幫忙更正。 原文: ".NET Core Tools Telemetry" 翻譯: ".NET Core 工具遙測(應用信息收集)" .NET Core 工具遙測(應用信息收集) .NET Core 工具包含收集使用信息的 "遙測功能" ...
說明:本文是個人翻譯文章,由於個人水平有限,有不對的地方請大家幫忙更正。
原文:.NET Core Tools Telemetry
翻譯:.NET Core 工具遙測(應用信息收集)
.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.