dotnetup telemetry

Note

dotnetup sedang dalam pratinjau publik. Fitur dan perilakunya mungkin berubah sebelum ketersediaan umum.

dotnetup termasuk fitur telemetri yang mengumpulkan data penggunaan dan mengirimkannya ke Microsoft saat Anda menjalankan perintah dotnetup. Data penggunaan mencakup informasi pengecualian saat dotnetup crash. Tim .NET menggunakan data ini untuk memahami bagaimana orang menggunakan alat dan untuk memperbaiki masalah.

Cara menolak

Telemetri aktif secara default. Untuk menonaktifkan, atur variabel lingkungan DOTNET_CLI_TELEMETRY_OPTOUT ke 1 atau true.

Ini adalah variabel yang sama yang menonaktifkan telemetri untuk .NET SDK dan CLI. Untuk informasi selengkapnya, lihat .NET SDK dan telemetri CLI .NET.

Pemberitahuan saat pertama kali dijalankan

Pertama kali Anda menjalankan dotnetup, ini menunjukkan pesan ini:

dotnetup collects usage data to help improve your experience. You can opt out by setting the DOTNET_CLI_TELEMETRY_OPTOUT environment variable to '1'. Learn more: https://aka.ms/dotnetup-telemetry

Untuk menyembunyikan pemberitahuan ini tanpa menonaktifkan telemetri, atur DOTNET_NOLOGO variabel lingkungan ke 1 atau true.

Titik data

Fitur telemetri tidak mengumpulkan data pribadi, seperti nama pengguna atau alamat email. Ini tidak memindai kode Anda, dan tidak mengekstrak data tingkat proyek. dotnetupmengirimkan data dengan aman ke server Microsoft dengan teknologi Azure Monitor.

dotnetup mengumpulkan data berikut:

  • Tanda waktu pemanggilan.
  • Perintah yang Anda jalankan, seperti install, update, atau list.
  • Versi dotnetup dan SHA commit.
  • Sistem operasi dan arsitektur.
  • Apakah dotnetup berjalan di lingkungan integrasi berkelanjutan (CI).
  • Apakah dotnetup dijalankan oleh agen LLM, seperti GitHub Copilot.
  • Kode keluar, atau status keberhasilan atau kegagalan.
  • Untuk kegagalan: jenis kesalahan, kategori kesalahan, detail kesalahan yang dibersihkan tanpa jalur file, dan jejak tumpukan tanpa pesan pengecualian.

Telemetri pengecualian kerusakan

Jika dotnetup mengalami crash, sistem mengumpulkan nama exception dan stack trace kode dotnetup. Ini tidak menyertakan pesan pengecualian, karena dapat berisi input pengguna. Pendekatan ini sama dengan pendekatan yang digunakan .NET SDK. Untuk informasi selengkapnya, lihat telemetri pengecualian Crash .

Deteksi agen CI dan LLM

dotnetupmenggunakan deteksi lingkungan CI dan deteksi agen LLM yang sama dengan SDK .NET. Untuk daftar variabel lingkungan yang diperiksanya, lihat Deteksi integrasi berkelanjutan dan deteksi LLM.

Variable Deskripsi
DOTNET_CLI_TELEMETRY_OPTOUT Menonaktifkan telemetri saat diatur ke 1 atau true.
DOTNET_NOLOGO Menyembunyikan pemberitahuan eksekusi pertama saat diatur ke 1 atau true. Telemetri tetap aktif.
DOTNET_CLI_TELEMETRY_STORAGE_PATH Mengubah direktori tempat dotnetup menyimpan telemetri secara lokal sebelum mengunggah data.
DOTNET_CLI_TELEMETRY_SHUTDOWN_TIMEOUT_MS Di lingkungan CI, ini mengubah waktu tunggu maksimum, dalam milidetik, sebelum dotnetup mengirim telemetri sebelum keluar. Defaultnya adalah 20.000.

Privasi

Jika Anda berpikir bahwa telemetri mengumpulkan data sensitif, atau bahwa Microsoft menangani data dengan tidak aman atau tidak pantas, ajukan masalah di repositori dotnet/sdk.

Untuk informasi selengkapnya, lihat Pernyataan Privasi Microsoft.

Baca juga