astro
CLI 会收集关于一般使用情况的匿名遥测数据。参与是可选的,您可以随时选择退出。
为什么要收集遥测数据?
匿名遥测数据是我们路线图优先级制定过程中的重要组成部分。它使我们的核心团队能够深入了解功能使用、痛点和配置的广泛趋势,从而帮助我们就是否继续开发做出更明智的决定。
收集了哪些数据?
我们跟踪 Astro 的一般使用信息以及我们支持的不同配置选项。具体来说,我们跟踪以下匿名数据:
- 调用的命令(
astro build
、astro dev
、astro preview
等) - Astro 版本
- 一般机器信息(例如 CPU 数量、macOS/Windows/Linux、CI 环境等)
- 一般配置信息(集成、适配器、Markdown 选项等)
- 已清理的错误信息
- 工具栏使用情况(例如正在使用的内置应用程序)
此列表会定期审计以确保其准确性。您可以通过在运行 Astro CLI 时设置 DEBUG=”astro:telemetry”
环境变量,在本地自行审计遥测数据。在调试模式下,遥测事件仅会记录到控制台。
一个遥测事件示例可能如下所示:
{ "cliCommand": "dev", "config": { "markdownPlugins": [], "adapter": "@astrojs/vercel", "integrations": ["@astrojs/mdx", "@astrojs/rss"], "markdown": { "syntaxHighlight": "shiki" } }}
敏感数据呢?
我们不收集任何可能包含敏感数据的指标。这包括但不限于:环境变量、个人身份信息、文件路径、文件内容、日志、堆栈跟踪、Git 远程信息或未清理的 JavaScript 错误消息。
我们非常重视您的隐私。您可以阅读我们的隐私政策以了解更多信息。
我的数据如何受到保护?
Astro CLI 收集的数据是完全匿名的,并且仅以聚合形式才有意义。我们存储的数据无法追溯到来源,并且仅供 Astro 核心维护者团队的一小部分人员使用,以帮助指导我们的路线图优先级。
Astro CLI 不跟踪、不收集、不存储个人身份信息 (PII)。我们跟踪的遥测数据从未也永远不会以任何形式出售或货币化。
如何选择退出?
您可以通过在任何 Astro 项目目录的根目录下运行 astro telemetry disable
命令来随时选择退出。这将禁用您整台机器的遥测功能,而不仅仅是您运行该命令的项目目录。
npx astro telemetry disable
您可以随时通过在任何 Astro 项目目录的根目录下运行 astro telemetry enable
命令来重新启用遥测功能。这将启用您整台机器的遥测功能,而不仅仅是您运行该命令的项目。
npx astro telemetry enable
您也可以通过设置环境变量:ASTRO_TELEMETRY_DISABLED=1
来选择退出。如果在 Astro 运行时设置了此环境变量,它将禁用所有遥测功能。