Microsoft.Testing.Platform 遙測
Microsoft.Testing.Platform 會收集遙測數據，其用來協助瞭解如何改善產品。 例如，此使用方式資料有助於針對問題 (例如啟動時間緩慢) 進行偵錯，同時還能排定新功能的優先順序。 雖然這些深入解析值得讚賞，但您可以放心停用遙測。 如需遙測的詳細資訊，請參閱隱私權聲明。
遙測資料的類型
Microsoft.Testing.Platform只會收集使用量數據類型的遙測。 使用方式資料可用來了解功能的使用方式，以及執行測試應用程式時所花費的時間。 這有助於排定產品改善的優先順序。
停用遙測報告
若要停用遙測，請將 TESTINGPLATFORM_TELEMETRY_OPTOUT 或 DOTNET_CLI_TELEMETRY_OPTOUT 環境變數設定為 1。
公開
Microsoft.Testing.Platform 當您第一次執行可執行檔時，會顯示類似下列的文字。 輸出文字可能會因您執行的版本 Microsoft.Testing.Platform 而稍有不同。 這個「第一次執行」經驗是 Microsoft 如何通知您有關資料收集。
Telemetry
---------
Microsoft.Testing.Platform collects usage data in order to help us improve your experience.
The data is collected by Microsoft and are not shared.
You can opt-out of telemetry by setting the TESTINGPLATFORM_TELEMETRY_OPTOUT
or DOTNET_CLI_TELEMETRY_OPTOUT environment variable to '1' or 'true' using your favorite shell.
Read more about Microsoft.Testing.Platform telemetry: https://aka.ms/testingplatform-telemetry
資料點
遙測功能不會收集個人資料，例如使用者名稱或電子郵件地址。 執行器不會掃描程式碼，也不會擷取專案層級資料 (例如存放庫或作者)，其會擷取可執行檔的名稱，並以雜湊形式傳送該資訊。
該變數不會擷取您應用程式存取或建立的任何資料檔案內容、您應用程式物件佔用的任何記憶體傾印，或剪貼簿的內容。
資料使用 Azure 監視器技術安全地傳送至 Microsoft 伺服器、在限制存取下保留，並在嚴格安全性控制下從安全的 Azure 儲存體系統發佈。
保護您的隱私權對我們而言很重要！ 如果您懷疑遙測收集敏感性資料或資料處理的方式不安全或不適當，請在 microsoft/testfx GitHub 存放庫中提出問題，或傳送電子郵件至 dotnet@microsoft.com 以進行調查。
遙測功能會收集下列資料點：
| 版本 | 資料 |
|---|---|
| 全部 | .NET 執行階段版本。 |
| 全部 | 應用程式模式，例如「伺服器」。 |
| 全部 | 失敗的測試重試計數。 |
| 全部 | 通過的測試重試計數。 |
| 全部 | 失敗的測試計數。 |
| 全部 | 通過的測試計數。 |
| 全部 | 執行的測試計數。 |
| 全部 | 您使用之延伸模組的 DisplayName，作為雜湊值。 |
| 全部 | 如果使用平台的偵錯組建。 |
| 全部 | 如果偵錯工具已附加至程序。 |
| 全部 | 如果已使用測試篩選條件。 |
| 全部 | 如果已啟用熱重新載入。 |
| 全部 | 如果應用程式損毀。 |
| 全部 | 如果應用程式以 NativeAOT 的形式執行。 |
| 全部 | 如果存放庫是我們自己的存放庫。 根據 testingplatformconfig.json 中的 telemetry:isDevelopmentRepository 設定。 |
| 全部 | 您所使用的測試架構名稱，作為雜湊值。 |
| 全部 | 可執行檔的名稱 (這通常與專案的名稱相同)，作為雜湊值。 |
| 全部 | 作業系統、版本和結構。 |
| 全部 | 程序結構。 |
| 全部 | 執行階段識別碼 (RID)。 如需詳細資訊，請參閱 .NET RID 目錄。 |
| 全部 | 應用程式的結束代碼。 |
| 全部 | 用來判斷地理位置的三個八位元 IP 位址。 |
| 全部 | 叫用的時間戳記、執行中各種步驟的開始和結束時間戳記。 |
| 全部 | 平台的版本。 |
| 全部 | 延伸模組的版本。 |
| 全部 | 測試配接器的版本。 |
| 全部 | Guid 用以將來自單一執行器的事件相互關聯。 |
| 1.0.3 | Guid 用以將來自單一測試回合的事件相互關聯。 |
持續整合偵測
為了偵測 .NET CLI 是否在「持續整合」環境中執行，.NET CLI 會探查一般 CI 提供者設定的數個已知環境變數是否存在和這些變數的值。
下表詳述環境變數的完整清單及使用其值完成的工作：
| 環境變數 | 提供者 | 動作 |
|---|---|---|
APPVEYOR |
Appveyor | 剖析布林值。 |
BUILD_ID, BUILD_URL |
Jenkins | 檢查所有項目是否存在且非 null。 |
BUILD_ID, PROJECT_ID |
Google Cloud Build | 檢查所有項目是否存在且非 null。 |
CI |
多/最多 | 剖析布林值。 |
CIRCLECI |
Circle CI | 剖析布林值。 |
CODEBUILD_BUILD_ID, AWS_REGION |
Amazon Web Services CodeBuild | 檢查所有項目是否存在且非 null。 |
GITHUB_ACTIONS |
GitHub 動作 | 剖析布林值。 |
JB_SPACE_API_URL |
JetBrains Space | 檢查是否存在且非 null。 |
TEAMCITY_VERSION |
TeamCity | 檢查是否存在且非 null。 |
TF_BUILD |
Azure Pipelines | 剖析布林值。 |
TRAVIS |
Travis CI | 剖析布林值。 |
