Skip to main content

Telemetry

Gatsby包含遥测功能,该功能收集匿名使用信息,这些信息用于帮助改善所有用户的Gatsby. 盖茨比用户群增长非常迅速. 重要的是,我们的小型团队和更大的社区必须更好地了解使用模式,因此我们可以最好地决定如何设计未来的功能并确定当前工作的优先级.

在安装Gatsby以及首次运行它时,系统会通知您.

How to opt-out

用户可以始终选择通过gatsby telemetry --disable退出遥测- gatsby telemetry --disable或将环境变量GATSBY_TELEMETRY_DISABLED设置为1

Why?

匿名聚合用户分析使我们能够根据人们使用Gatsby的方式和时间来确定修复和功能的优先级. 由于盖茨比(Gatsby)的大部分功能都围绕社区插件和启动程序展开,因此我们希望收集有关使用和可靠性的信息,以便确保高质量的生态系统.

这就提出了一个问题:我们将如何使用遥测数据来改善生态系统? 一些示例很有帮助:

  • 我们将能够了解通常一起使用哪些插件. 这将使我们能够在公共插件库中显示此信息,并根据此数据构建更多相关的入门和教程.
  • 我们将能够在初学者展示柜中展示不同初学者的受欢迎程度.
  • 我们将能够更详细地了解用户在每个构建阶段(例如,开发,构建等)遇到的错误类型. 这将使我们提高工具的质量,并把时间集中在解决更常见,令人沮丧的问题上.
  • 我们将能够揭示不同插件和启动器的可靠性,并检测其中哪些往往更容易出错. 我们可以使用这些数据来评估质量指标,并改善我们的插件和启动器的质量.
  • 我们将能够看到不同构建阶段的时间,以指导我们重点关注优化工作.

What do we track?

我们跟踪常规用法的详细信息,包括命令调用,构建过程状态更新,性能度量和错误. 我们使用这些指标来更好地了解使用模式. 这些指标将直接使我们能够更好地决定如何设计将来的功能并确定当前工作的优先级.

具体来说,我们为所有遥测事件收集以下信息:

  • 发生的时间戳
  • 调用命令(例如builddevelop
  • 盖茨比机ID. 这是使用UUID生成的,并存储在〜/ .config / gatsby / config.json的全局gatsby配置中.
  • 唯一的会话ID. 这是在每次使用UUID运行时生成的.
  • 当前工作目录的单向哈希或git remote的哈希
  • 常规操作系统级别信息(操作系统,版本,CPU体系结构以及命令是否在CI中运行)
  • 当前的盖茨比版本

对原始数据的访问受到严格控制,我们无法从数据集中识别单个用户. 它是匿名的,无法追溯到用户.

What about sensitive data? (e.g. secrets)

我们执行其他步骤以确保安全数据(例如,用于存储构建过程中的机密信息的环境变量) 不会进入我们的分析. 我们会剥离此敏感数据的日志,错误消息等 ,以确保我们永远不会访问此敏感数据.

您可以通过将环境变量GATSBY_TELEMETRY_DEBUG设置为1来打印遥测数据而不是通过发送来查看Gatsby遥测发送的所有信息.


Edit this page on GitHub
Docs
Tutorials
Plugins
Blog
Showcase

by  ICOPY.SITE