telemetría dotnetup

Note

dotnetup está en versión preliminar pública. Sus características y comportamiento pueden cambiar antes de la disponibilidad general.

dotnetupincluye una característica de telemetría que recopila datos de uso y los envía a Microsoft al ejecutar dotnetup comandos. Los datos de uso incluyen información de excepciones cuando dotnetup se bloquea. El equipo de .NET usa estos datos para comprender cómo las personas usan la herramienta y solucionar problemas.

Cómo darse de baja

La telemetría está activada de forma predeterminada. Para desactivar esta opción, establezca la variable de entorno 1 en DOTNET_CLI_TELEMETRY_OPTOUT o true.

Esta es la misma variable que desactiva la telemetría del SDK y la CLI de .NET. Para más información, consulte .NET SDK y telemetría de la CLI de .NET.

Aviso de primera ejecución

La primera vez que ejecute dotnetup, se muestra este mensaje:

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

Para ocultar este aviso sin desactivar la telemetría, establezca la variable de entorno DOTNET_NOLOGO en 1 o true.

Puntos de datos

La característica de telemetría no recopila datos personales, como nombres de usuario o direcciones de correo electrónico. No examina el código y no extrae datos de nivel de proyecto. dotnetupenvía los datos de forma segura a los servidores de Microsoft con tecnología Azure Monitor.

dotnetup recopila los datos siguientes:

  • Marca de tiempo de la invocación.
  • Comando que se ejecuta, como install, updateo list.
  • La versión dotnetup y el SHA del commit.
  • El sistema operativo y la arquitectura.
  • Si dotnetup se ejecuta en un entorno de integración continua (CI).
  • Tanto si dotnetup se ejecuta desde un agente LLM, como GitHub Copilot.
  • El código de salida, o el estado de éxito o error.
  • Para fallos: el tipo de error, la categoría de error, los detalles de error saneados sin rutas de acceso de archivo y el seguimiento de la pila sin mensajes de excepción.

Telemetría de las excepciones de bloqueo

Si dotnetup se bloquea, recopila el nombre de la excepción y el seguimiento de pila del código dotnetup. No incluye mensajes de excepción, ya que pueden contener entradas de usuario. Este enfoque es el mismo que el que usa el SDK de .NET. Para más información, consulte Telemetría de las excepciones de bloqueo.

Detección de agentes de CI y LLM

dotnetupusa la misma detección del entorno de CI y la detección del agente LLM que el SDK de .NET. Para obtener la lista de variables de entorno que comprueba, consulte Detección de integración continua y detección de LLM.

Variable Descripción
DOTNET_CLI_TELEMETRY_OPTOUT Desactiva la telemetría cuando se establece en 1 o true.
DOTNET_NOLOGO Oculta el aviso de primera ejecución cuando se establece en 1 o true. La telemetría permanece activa.
DOTNET_CLI_TELEMETRY_STORAGE_PATH Cambia el directorio donde dotnetup almacena la telemetría localmente antes de subir los datos.
DOTNET_CLI_TELEMETRY_SHUTDOWN_TIMEOUT_MS En entornos de CI, cambia el tiempo máximo, en milisegundos, durante el que dotnetup espera para enviar telemetría antes de salir. El valor predeterminado es 20 000.

Privacidad

Si cree que la telemetría recopila datos confidenciales o que Microsoft trata los datos de forma no segura o inapropiada, abra un problema en el repositorio dotnet/sdk.

Para obtener más información, consulte la Declaración de privacidad de Microsoft.

Consulte también

  • Se actualizó por última vez el