Novu自托管如何关闭遥测:设置NOVU_TELEMETRY环境变量

发布时间:2026/9/10 22:06:03
Novu自托管如何关闭遥测:设置NOVU_TELEMETRY环境变量 Novu自托管如何关闭遥测设置NOVU_TELEMETRY环境变量【免费下载链接】novuThe open-source communication infrastructure for agents and products项目地址: https://gitcode.com/GitHub_Trending/no/novuNovu 自托管实例默认会向 Novu 团队发送匿名遥测数据。如果你的部署出于数据合规或隐私考虑希望不再上报任何使用统计可以通过把.env中的NOVU_TELEMETRY设置为false来关闭它然后重启 Docker 容器即可生效。本文适用于按 Docker Compose 方式部署的自托管 Novu。先了解 Novu 自托管会收集什么根据 遥测文档Novu 不会采集你 API、数据库或第三方工具中的任何数据自托管实例上报的信息全部经过匿名化处理。其中分两类Keep Alive Beacon心跳Novu 服务器每小时发送一次 ping用于确认实例运行正常。这一数据无论遥测开关状态如何都会发送关闭NOVU_TELEMETRY并不会停止它这是文档明确说明的边界。Usage Statistics使用统计遥测开启时服务器定期上报用户、组织、事件、通知等匿名数量。文档给出的示例报文如下文档示例实际字段值取决于你的实例{ eventCount: 1, integrationCount: [ { count: 1, providerId: example }, { count: 1, providerId: novu } ], orgCount: 1, subscriberCount: 1, timestamp: 2024-10-04T11:54:30, topicCount: 3, totalSteps: 10, userCount: 3, workflowCount: 6 }关闭遥测后停止的正是第二类数据。准备条件确认 .env 文件位置以下操作的前提是你已经用 Docker Compose 完成了自托管部署参见 Deploy with Docker且 Novu 服务正在运行。.env文件由官方安装脚本 setup.sh 创建脚本会下载docker-compose.yml和.env.example为JWT_SECRET、STORE_ENCRYPTION_KEY、NOVU_SECRET_KEY生成随机值然后基于.env.example生成.env并以docker compose up -d启动服务。目标目录默认是当前目录下的./novu可通过NOVU_DIR环境变量改为其他目录。因此.env与docker-compose.yml位于同一目录后续所有命令都在该目录下执行。设置 NOVU_TELEMETRYfalse 并重启按 遥测文档 给出的步骤操作进入.env文件所在目录即步骤一确认的 Novu 部署目录。用编辑器打开.env查找NOVU_TELEMETRY。将NOVU_TELEMETRY的值改为false即写成NOVU_TELEMETRYfalse重启容器使新值生效docker compose up -ddocker compose up -d只会在配置变化时重建受影响的容器不会删除数据。需要注意仓库自带的 .env.example 中没有预置NOVU_TELEMETRY一行。如果打开.env后搜索不到该变量直接在上面追加NOVU_TELEMETRYfalse即可——从 worker 侧的遥测实现 可以看到判断逻辑是process.env.NOVU_TELEMETRY ! false即只有显式设置为字符串false才会关闭变量缺失或设为其他值都会保持遥测开启。结果确认文档给出的成功条件很直接容器重启完成后Novu 即以遥测关闭状态运行。如需在代码层面核对生效条件可查看 userInfoService.usecase.ts每日遥测任务只在IS_SELF_HOSTEDtrue、NOVU_ENTERPRISEfalse且NOVU_TELEMETRY不为false时才会把统计数据发送到 Novu Trace 服务。你的.env中NOVU_TELEMETRYfalse且服务已用docker compose up -d重启后这条上报路径即被跳过。已知限制与替代路径如前所述Keep Alive Beacon 每小时一次的 ping 不受该开关控制文档明确其无论遥测开启与否都会被收集。如果你的目标是彻底切断与 Novu 服务器的所有出站连接这个环境变量做不到需要自行在网络层处理。除了环境变量文档也提到可以在Admin Settings管理设置界面中关闭遥测作为替代路径本文按标题要求走环境变量方式两者达到的效果一致。修改只影响后续的上报行为不会改变已存储的任何业务数据重启期间容器会短暂重启若实例正在承载生产流量请在低峰期执行。【免费下载链接】novuThe open-source communication infrastructure for agents and products项目地址: https://gitcode.com/GitHub_Trending/no/novu创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

关于本文作者

来自尧图内容编辑团队

尧图内容编辑团队 内容团队

尧图内容编辑团队

本文由尧图网络内容编辑团队执笔。团队由资深项目经理、前端工程师与设计师组成,所有内容均来自亲手交付的真实项目,先讲清问题、再给出可落地的解法。尧图深耕北京网站建设十年,服务过京华建材集团、智造科技等各行业客户,把一线经验沉淀为可复用的行业观察。

  • 十年建站经验,覆盖建材、制造、服务、文创等
  • 项目经理把关选题与事实准确性
  • 工程师与设计师联合撰写专业细节
  • 统一编辑规范,保证文风与排版一致
  • 每月复盘转化数据,迭代选题方向

延伸阅读

相关资讯与近期热门内容

深度阅读推荐

建站决策前值得细读的三篇

网站改版的5个关键决策
2024-08-12

网站改版的5个关键决策

什么时候该改版、改到什么程度、如何避免流量掉光,京华建材集团改版复盘给出答案。

获取专属建站方案

看完文章,把您的行业与预算告诉我们,免费获取一份量身定制的官网建设方案与报价。

立即免费咨询