Telemetría

El CLI de astro recopila datos anónimos de telemetría sobre el uso general. La participación es opcional, y puedes excluirte en cualquier momento.

¿Por qué se recopila la telemetría?

Los datos anónimos de telemetría constituyen una parte importante de nuestro proceso de priorización de la hoja de ruta. Le da a nuestro equipo central visibilidad sobre tendencias generales en el uso de funciones, puntos de dolor y configuración, lo que nos ayuda a tomar decisiones más informadas sobre en qué trabajar a continuación.

¿Qué se está recopilando?

Rastreamos información general de uso sobre Astro y diferentes opciones de configuración que soportamos. Específicamente, rastreamos los siguientes datos anónimos:

• Comando invocado (astro build, astro dev, astro preview, etc.)
• Versión de Astro
• Información general de la máquina (ej. número de CPUs, macOS/Windows/Linux, entorno de CI, etc.)
• Entorno de desarrollo (ej. si el CLI fue invocado por un agente de programación con IA)
• Información general de configuración (Integraciones, adaptadores, opciones de markdown, etc.)
• Información de error sanitizada
• Uso de la barra de herramientas (ej. apps integradas en uso)

Esta lista se audita regularmente para garantizar su precisión. Puedes auditar la telemetría tú mismo localmente configurando la variable de entorno DEBUG=”astro:telemetry” al ejecutar el CLI de Astro. Mientras estás en modo debug, los eventos de telemetría solo se registran en la consola.

Un ejemplo de un evento de telemetría podría verse así:

{
  "cliCommand": "dev",
  "config": {
    "markdownPlugins": [],
    "adapter": "@astrojs/vercel",
    "integrations": ["@astrojs/mdx", "@astrojs/rss"],
    "markdown": {
      "syntaxHighlight": "shiki"
    }
  }
}

¿Qué pasa con los datos sensibles?

No recopilamos ninguna métrica que pueda contener datos sensibles. Esto incluye, pero no se limita a: variables de entorno, información de identificación personal, rutas de archivos, contenidos de archivos, logs, trazas de pila, información remota de git, o mensajes de error de JavaScript sin sanitizar.

Tomamos tu privacidad muy en serio. Puedes leer nuestra política de privacidad para saber más.

¿Cómo se protege mi data?

Los datos recopilados por el CLI de Astro son completamente anónimos y solo significativos en forma agregada. Los datos que almacenamos no son rastreables a la fuente, y solo están disponibles para un pequeño subconjunto del equipo de mantenedores centrales de Astro para ayudar a informar la priorización de nuestra hoja de ruta.

El CLI de Astro no rastrea, recopila ni almacena información de identificación personal (PII). Los datos de telemetría que rastreamos nunca han sido y nunca serán vendidos o monetizados de ninguna forma.

¿Cómo me excluyo?

Siempre puedes excluirte ejecutando astro telemetry disable en la raíz de cualquier directorio de un proyecto Astro. Esto desactivará la telemetría en toda tu máquina, no solo en el directorio del proyecto donde lo ejecutes:

npx astro telemetry disable

Puedes volver a activar la telemetría en cualquier momento ejecutando astro telemetry enable en la raíz de cualquier directorio de un proyecto Astro. Esto activará la telemetría en toda tu máquina, no solo en el proyecto donde lo ejecutes:

npx astro telemetry enable

También puedes excluirte configurando la variable de entorno: ASTRO_TELEMETRY_DISABLED=1. Si esta variable de entorno está configurada cuando Astro se ejecuta, se desactivará toda la telemetría.