遥测

Vercel Inc.（Vercel）可能会收集有关你使用 Turborepo 的遥测数据，如下所述。遥测数据使我们能够通过收集有关 Turborepo 和 Vercel 平台使用情况和主机信息的匿名数据来监控和改进 Turborepo 和 Vercel 平台。这些数据可能用于广泛识别、排除故障或响应影响用户的问题。

¥Vercel Inc. (Vercel) may collect telemetry data about your use of Turborepo as explained below. Telemetry data allows us to monitor and improve Turborepo and the Vercel platform by collecting anonymous data about its usage and host information. The data may be used to broadly identify, troubleshoot, or respond to issues that impact users.

遥测数据的收集是可选的。如果你不想收集遥测数据，你可以禁用 opt-out。

¥Collection of telemetry data is optional. If you do not want telemetry data collected, you may opt-out.

为什么

¥Why

遥测使我们能够准确衡量所有用户的 Turborepo 功能使用情况、痛点和自定义设置。这些数据使我们能够更好地根据大众需求定制 Turborepo，确保其持续增长、相关性和一流的开发者体验。此外，这些数据使我们能够验证改进是否正在改善所有应用的基准。

¥Telemetry allows us to accurately gauge Turborepo feature usage, pain points, and customization across all users. This data enables us to better tailor Turborepo to the masses, ensuring its continued growth, relevance, and best-in-class developer experience. Furthermore, this data allows us to verify if improvements are improving the baseline of all applications.

收集哪些内容

¥What is collected

我们跟踪一般使用信息，具体来说，我们使用随机标识符通过匿名遥测数据跟踪以下内容：

¥We track general usage information, specifically, we track the following with anonymized telemetry data using random identifiers:

  • 调用的命令（turbo run、turbo prune、turbo gen 等）

    ¥Command invoked (turbo run, turbo prune, turbo gen, etc.)

  • turbo 版本

    ¥Version of turbo

  • 常规机器信息（例如 CPU 数量、macOS/Windows/Linux，以及命令是否在 CI 中运行）

    ¥General machine information (e.g. number of CPUs, macOS/Windows/Linux, whether or not the command was run within CI)

  • 应用大小（工作区总数）

    ¥Size of application (total number of workspaces)

  • 我们不会收集任何可能包含敏感数据的指标。这包括但不限于：任务名称、包名称、敏感参数或标志值、环境变量、文件路径或文件内容。

    ¥We DO NOT collect any metrics which may contain sensitive data. This includes, but is not limited to: task names, package names, sensitive argument or flag values, environment variables, file paths, or contents of files.

注意：此列表会定期审核，以确保其准确性。

¥Note: This list is regularly audited to ensure its accuracy.

你可以通过设置以下环境变量来准确查看正在收集的内容：TURBO_TELEMETRY_DEBUG=1。

¥You can view exactly what is being collected by setting the following environment variable: TURBO_TELEMETRY_DEBUG=1.

此外，可以通过直接浏览 events 文件来查看所有可能的事件。

¥Additionally, all possible events can be viewed by browsing the events file directly.

如何退出？

¥How do I opt out?

禁用

¥Disable

你可以通过运行以下命令退出：

¥You may opt out-by running:

Terminal
turbo telemetry disable

你也可以通过设置以下任意环境变量来退出：

¥You can also opt out by setting any of the following environment variables:

状态

¥Status

你可以随时通过运行以下命令检查遥测收集的状态：

¥You may check the status of telemetry collection at any time by running:

Terminal
turbo telemetry status

启用

¥Enable

如果你想重新加入该计划，可以运行以下命令重新启用遥测：

¥You may re-enable telemetry if you'd like to re-join the program by running the following:

Terminal
turbo telemetry enable