使用情况遥测

从 4.1.0 版本开始，Node-RED 每天会收集一次匿名的使用情况信息，并与 Node-RED 团队共享。作为回报，Node-RED 会在有新版本可用时通知用户。

此信息仅在用户选择加入共享后才会与 Node-RED 团队共享。如果用户拒绝共享其信息，则不会有任何数据发送回团队。

为什么？

与所有软件一样，保持其最新状态非常重要。随着欧盟的《网络弹性法案》等立法即将出台，我们希望采取积极主动的方法，帮助用户保持其 Node-RED 环境的更新和安全。

使用情况遥测有两个目的：

1. 它允许我们在应用程序内通知用户有可用更新。
2. 它使我们能够更好地了解 Node-RED 的使用情况；例如正在使用的版本、偏好的操作系统等。

过去，我们衡量 Node-RED 用户群规模和范围的唯一方法是通过次要指标，例如 npm 和 docker 提供的高级统计数据，或社区论坛的总体活跃度。这些并不能为我们提供足够有用的信息来帮助理解 Node-RED 的使用情况。

收集哪些数据？

在 4.1.0 版本中，收集的信息包括：

• 一个随机生成的实例标识符，以便我们对报告进行去重处理
• Node-RED 版本
• Node.JS 版本
• 操作系统类型/版本/架构

它不包含：

• 任何个人信息
• 任何流配置信息
• 任何与安全相关的用户特定信息
• 任何超出 Node-RED 范围的信息

数据是如何收集的？

如果用户选择接收更新通知，一个任务将在 Node-RED 启动 30 分钟后（或在他们选择加入时）运行，之后每 24 小时运行一次。

数据通过 HTTPS 发送到由 Node-RED 项目托管的端点。

数据如何处理？

报告将被汇总为每日使用记录。单个报告最多保留 90 天。

谁有权访问数据？

原始数据仅对核心团队提交者（Team Committers）开放。

汇总数据将在一个公开的仪表板上提供给公众查阅。注意：在撰写本文时，我们尚未发布此功能，因此我们几乎没有数据来构建仪表板。一旦可用，本文档将更新以链接到该仪表板，并将在社区内进行宣传。

如何选择退出？

我们希望您能认识到及时了解可用更新的价值，并通过选择加入来帮助我们维护该项目。

但是，如果您想选择退出，有多种方法可以做到。

编辑器设置

当您首次打开 Node-RED 4.1 或更高版本的编辑器时，如果您尚未选择加入或退出，系统会询问您是否愿意接收更新通知。

您可以随时通过编辑器设置对话框更改您的偏好。

settings.js 文件

您也可以通过您的设置文件来启用/禁用遥测功能。

如果您有一个已存在的设置文件，您需要添加一个 telemetry 部分。对于新安装的 Node-RED，默认的设置文件已经有这个部分，但 enabled 选项被注释掉了。移除行首的 // 并将值更改为 false。

    telemetry: {
        enabled: false,
        /**
         * If telemetry is enabled, the runtime will log a message when an update is available.
         * The editor will also notify the user if a new version of Node-RED
         * is available. Set the following property to false to disable this editor notification.
         */
        updateNotification: true
    },

其他

您还可以使用 --no-telemetry 命令行标志，或通过设置 NODE_RED_DISABLE_TELEMETRY 环境变量来禁用遥测功能。

更新通知

启用使用情况遥测功能后，作为发送信息的回应，Node-RED 会在有新版本可用时得到通知。这将在编辑器中生成一个通知，帮助您了解何时需要升级。

此通知可以通过设置文件中的 telemetry.updateNotification 设置来禁用；它不能在编辑器内部禁用。

当有可用更新时，运行时也会记录日志；此日志无法禁用。