dotnetup telemetry

Hinweis

dotnetup befindet sich in der öffentlichen Vorschau. Die Features und das Verhalten können sich vor der allgemeinen Verfügbarkeit ändern.

dotnetupenthält ein Telemetriefeature, das Nutzungsdaten sammelt und an Microsoft sendet, wenn Sie dotnetup-Befehle ausführen. Die Nutzungsdaten enthalten Informationen zu Ausnahmen, wenn dotnetup abstürzt. Das .NET Team verwendet diese Daten, um zu verstehen, wie Personen das Tool verwenden und um Probleme zu beheben.

So melden Sie sich ab

Telemetrie ist standardmäßig aktiviert. Um dies zu deaktivieren, legen Sie die DOTNET_CLI_TELEMETRY_OPTOUT Umgebungsvariable auf 1 oder true.

Dies ist dieselbe Variable, die Telemetrie für das .NET SDK und die CLI deaktiviert. Weitere Informationen finden Sie unter .NET SDK und .NET CLI-Telemetrie.

Hinweis zum ersten Start

Beim ersten Ausführen dotnetupwird diese Meldung angezeigt:

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

Um diesen Hinweis auszublenden, ohne Telemetrie zu deaktivieren, legen Sie die DOTNET_NOLOGO Umgebungsvariable auf 1 oder true fest.

Datenpunkte

Das Telemetriefeature sammelt keine personenbezogenen Daten, z. B. Benutzernamen oder E-Mail-Adressen. Es überprüft deinen Code nicht und extrahiert keine Daten auf Projektebene. dotnetupsendet die Daten sicher an Microsoft Server mit Azure Monitor Technologie.

dotnetup sammelt die folgenden Daten:

  • Der Zeitstempel des Aufrufs.
  • Der Befehl, den Sie ausführen, z. B. install, update oder list.
  • Die dotnetup Version und der Commit-SHA.
  • Das Betriebssystem und die Architektur.
  • Gibt an, ob dotnetup in einer CI-Umgebung (Continuous Integration) ausgeführt wird.
  • Gibt an, ob dotnetup von einem LLM-Agenten, z. B. GitHub Copilot, ausgeführt wird.
  • Der Beendigungscode oder der Erfolgs- oder Fehlerstatus.
  • Für Fehler: der Fehlertyp, die Fehlerkategorie, bereinigte Fehlerdetails ohne Dateipfade und die Stapelablaufverfolgung ohne Ausnahmemeldungen.

Telemetrie zu Absturzausnahmen

Wenn dotnetup abstürzt, werden der Name der Ausnahme und die Stapelablaufverfolgung des dotnetup-Codes erfasst. Es enthält keine Ausnahmemeldungen, da sie Benutzereingaben enthalten können. Dieser Ansatz entspricht dem Ansatz, den das .NET SDK verwendet. Weitere Informationen finden Sie unter Telemetrie zu Absturzausnahmen.

ERKENNUNG von CI- und LLM-Agenten

dotnetupverwendet die gleiche ERKENNUNG der CI-Umgebung und die LLM-Agent-Erkennung wie das .NET SDK. Eine Liste der von ihr überprüften Umgebungsvariablen finden Sie unter CI-Erkennung und LLM-Erkennung.

Variable Description
DOTNET_CLI_TELEMETRY_OPTOUT Deaktiviert telemetrie bei Festlegung auf 1 oder true.
DOTNET_NOLOGO Blendet die Benachrichtigung zur ersten Ausführung aus, wenn sie auf 1 oder true gesetzt ist. Telemetrie bleibt aktiviert.
DOTNET_CLI_TELEMETRY_STORAGE_PATH Ändert das Verzeichnis, in dem dotnetup Telemetriedaten lokal speichert, bevor die Daten hochgeladen werden.
DOTNET_CLI_TELEMETRY_SHUTDOWN_TIMEOUT_MS Ändert in CI-Umgebungen die maximale Zeit in Millisekunden, die dotnetup wartet, um Telemetrie zu senden, bevor es beendet wird. Der Standardwert ist 20.000.

Datenschutz

Wenn Sie der Meinung sind, dass die Telemetrie vertrauliche Daten sammelt oder dass Microsoft die Daten unsicher oder unangemessen behandelt, geben Sie ein Problem im dotnet/sdk-Repository an.

Weitere Informationen finden Sie in den Datenschutzbestimmungen von Microsoft.

Siehe auch