Телеметрия

Неофициальный перевод сообщества.

CLI astro собирает анонимные данные телеметрии об общем использовании. Участие необязательно, и вы можете отказаться в любой момент.

Зачем собирается телеметрия?

Анонимные данные телеметрии — важная часть процесса приоритизации нашей дорожной карты. Они дают основной команде представление о широких тенденциях использования функций, болевых точках и конфигурации, что помогает принимать более обоснованные решения о следующих задачах.

Что именно собирается?

Мы отслеживаем общую информацию об использовании Astro и различных поддерживаемых опциях конфигурации. В частности, собираются следующие анонимные данные:

• Вызванная команда (astro build, astro dev, astro preview и т.д.)
• Версия Astro
• Общая информация о машине (например, число CPU, macOS/Windows/Linux, среда CI и т.д.)
• Среда разработки (например, какой AI-агент для кодирования вызвал CLI, если применимо)
• Общая информация о конфигурации (интеграции, адаптеры, опции markdown и т.д.)
• Санитизированная информация об ошибках
• Использование панели инструментов (например, встроенные приложения)

Этот список регулярно проверяется на актуальность. Вы можете проверить телеметрию локально, установив переменную окружения DEBUG="astro:telemetry" при запуске CLI Astro. В режиме отладки события телеметрии только выводятся в консоль.

Пример события телеметрии может выглядеть так:

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

А что с конфиденциальными данными?

Мы не собираем метрики, которые могут содержать конфиденциальные данные. Это включает, но не ограничивается: переменные окружения, персонально идентифицируемую информацию, пути к файлам, содержимое файлов, логи, stack trace, информацию об удалённом git-репозитории или несанитизированные сообщения об ошибках JavaScript.

Мы очень серьёзно относимся к вашей конфиденциальности. Подробнее — в нашей политике конфиденциальности.

Как защищены мои данные?

Данные, собираемые CLI Astro, полностью анонимны и значимы только в агрегированном виде. Хранимые данные не позволяют отследить источник и доступны лишь небольшой части основной команды Astro для планирования дорожной карты.

CLI Astro не отслеживает, не собирает и не хранит персонально идентифицируемую информацию (PII). Данные телеметрии, которые мы отслеживаем, никогда не продавались и не будут продаваться или монетизироваться в какой-либо форме.

Как отказаться?

Вы всегда можете отказаться, выполнив astro telemetry disable в корне любого проекта Astro. Это отключит телеметрию на всей вашей машине, а не только в каталоге проекта:

npx astro telemetry disable

Повторно включить телеметрию можно командой astro telemetry enable в корне любого проекта Astro. Это включит телеметрию на всей машине, а не только в одном проекте:

npx astro telemetry enable

Также можно отказаться, установив переменную окружения: ASTRO_TELEMETRY_DISABLED=1. Если эта переменная установлена при запуске Astro, вся телеметрия будет отключена.