dotnetup telemetry

Uwaga

dotnetup jest dostępna w publicznej wersji zapoznawczej. Jego funkcje i zachowanie mogą ulec zmianie przed ogólną dostępnością.

dotnetupZawiera funkcję telemetrii, która zbiera dane użycia i wysyła je do Microsoft podczas uruchamiania poleceń dotnetup. Dane użycia zawierają informacje o wyjątkach, gdy dotnetup ulega awarii. Zespół .NET używa tych danych, aby zrozumieć, jak ludzie używają narzędzia, i aby naprawiać problemy.

Jak zrezygnować

Dane telemetryczne są domyślnie włączone. Aby zrezygnować, ustaw zmienną środowiskową DOTNET_CLI_TELEMETRY_OPTOUT na 1 lub true.

Jest to ta sama zmienna, która wyłącza dane telemetryczne dla zestawu SDK .NET i interfejsu wiersza polecenia. Aby uzyskać więcej informacji, zobacz .NET SDK i telemetria interfejsu wiersza polecenia platformy .NET.

Powiadomienie o pierwszym uruchomieniu

Przy pierwszym uruchomieniu dotnetupjest wyświetlany następujący komunikat:

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

Aby ukryć to powiadomienie bez wyłączania telemetrii, ustaw zmienną DOTNET_NOLOGO środowiskową na 1 lub true.

Punkty danych

Funkcja telemetrii nie zbiera danych osobowych, takich jak nazwy użytkowników lub adresy e-mail. Nie skanuje ono kodu i nie wyodrębnia danych na poziomie projektu. dotnetupwysyła dane bezpiecznie do serwerów Microsoft za pomocą technologii Azure Monitor.

dotnetup zbiera następujące dane:

  • Sygnatura czasowa wywołania.
  • Uruchamiane polecenie, takie jak install, updatelub list.
  • Wersja dotnetup i SHA commitu.
  • System operacyjny i architektura.
  • Czy dotnetup działa w środowisku ciągłej integracji (CI).
  • Czy dotnetup uruchamia się za pośrednictwem agenta LLM, takiego jak GitHub Copilot.
  • Kod zakończenia lub stan powodzenia lub niepowodzenia.
  • W przypadku awarii: typ błędu, kategoria błędu, oczyszczone szczegóły błędu bez ścieżek plików i ślad stosu bez komunikatów o wyjątkach.

Telemetria wyjątku krytycznego

Jeśli dotnetup ulegnie awarii, zbiera nazwę wyjątku i ślad stosu kodu dotnetup. Nie zawiera komunikatów o wyjątkach, ponieważ mogą zawierać dane wejściowe użytkownika. Takie podejście jest takie samo jak podejście używane przez zestaw SDK .NET. Aby uzyskać więcej informacji, zobacz Telemetria awarii z wyjątkiem.

Wykrywanie agentów CI i LLM

dotnetupużywa tego samego wykrywania środowiska ciągłej integracji i wykrywania agenta LLM co zestaw SDK .NET. Aby uzyskać listę sprawdzanych zmiennych środowiskowych, zobacz Wykrywanie ciągłej integracji i wykrywanie LLM.

Variable Opis
DOTNET_CLI_TELEMETRY_OPTOUT Wyłącza telemetrię po ustawieniu wartości 1 lub true.
DOTNET_NOLOGO Ukrywa powiadomienie o pierwszym uruchomieniu po ustawieniu wartości 1 lub true. Telemetria pozostaje włączona.
DOTNET_CLI_TELEMETRY_STORAGE_PATH Zmienia katalog, w którym dotnetup lokalnie przechowuje dane telemetryczne przed ich przesłaniem.
DOTNET_CLI_TELEMETRY_SHUTDOWN_TIMEOUT_MS W środowiskach CI określa maksymalny czas (w milisekundach), przez jaki dotnetup czeka na wysłanie danych telemetrycznych przed zakończeniem. Wartość domyślna to 20 000.

Prywatność

Jeśli uważasz, że dane telemetryczne zbierają poufne dane lub że Microsoft obchodzi się z danymi w sposób niezabezpieczony lub niewłaściwy, zgłoś problem w repozytorium dotnet/sdk.

Aby uzyskać więcej informacji, zobacz Zasady zachowania poufności informacji firmy Microsoft.

Informacje dodatkowe

  • Ostatnia aktualizacja o