OpenRAG遥测系统解析匿名使用统计如何实现与关闭【免费下载链接】openragOpenRAG is a comprehensive, single package Retrieval-Augmented Generation platform built on Langflow, Docling, and Opensearch.项目地址: https://gitcode.com/GitHub_Trending/open/openragOpenRAG 是一个基于 Langflow、Docling 和 Opensearch 的一体化 RAG检索增强生成平台。它内置了一套匿名遥测Telemetry系统用于收集版本、操作系统、GPU 等使用统计信息帮助维护者了解用户的真实使用环境。本文将完整解析 OpenRAG 遥测的工作原理、采集了哪些数据并给出 3 种快速关闭遥测的方法。一、OpenRAG 遥测是什么为什么需要它对于开源项目来说有多少人用、在什么环境下用、哪些功能被频繁使用这些问题决定了后续开发的方向。OpenRAG 因此内置了遥测后端遥测基于 Scarf记录应用启动、文档摄入、连接器同步、聊天请求等关键事件前端遥测基于 Segment 的页面浏览与按钮点击统计且仅当显式配置了写入密钥时才生效自托管场景默认关闭。遥测采用发射后不管fire-and-forget策略事件在后台异步发送永远不会阻塞你的正常操作即使网络不通或遥测服务不可用OpenRAG 的功能也完全不受影响。二、遥测到底采集了哪些数据这是用户最关心的问题。打开 client.py 可以看到每条事件携带的字段整理如下数据项示例值说明版本openrag_versionOpenRAG 版本号操作系统os、os_version如 linux / windows / macos 及版本GPU 信息gpu_available、gpu_count、cuda_available仅布尔值和数量不含显卡型号细节事件类别category如 DOCUMENT_INGESTION消息 IDmessage_id如 ORB_APP_STARTED时间戳timestampUTC 时间⚠️不会采集的内容你的文档内容、文件名、聊天提问、检索到的知识片段、API 密钥、IP 定位等敏感信息。遥测只反映你用了什么功能而非你用了什么数据。三、事件体系类别 消息 ID 的双层设计OpenRAG 的后端遥测由三个文件构成位于 src/utils/telemetry/ 目录category.py定义 13 类事件大类覆盖应用启停、OpenSearch 建索引、文档摄入与处理、认证、连接器、任务、聊天、错误、设置变更、新手引导等message_id.py定义具体事件 ID统一采用ORB_前缀OpenRAG Backend格式为ORB_类别_动作[_状态]例如ORB_DOC_INGEST_COMPLETE文档摄入完成、ORB_AUTH_FAILED认证失败client.py负责组装事件、控制重试最多 3 次指数退避并发送。这种大类 精确 ID的设计让维护者既能按功能模块做宏观统计又能追踪某个具体环节比如有多少人的连接器同步失败了的微观表现。四、前端遥测默认关闭的可选开关前端部分由 analytics.ts 和 analytics-provider.tsx 实现逻辑非常克制只有当服务端下发了SEGMENT_WRITE_KEY时才会初始化采集否则track/page全部直接返回在 docker-compose.yml 中该变量的默认值为空字符串——也就是说普通用户自行部署 OpenRAG 时前端遥测天然处于关闭状态即使开启上报的也是页面浏览、按钮点击这类交互行为不涉及任何文档或对话内容。五、如何关闭 OpenRAG 遥测3 种方法方法 1设置 DO_NOT_TRACK 环境变量推荐一键关闭后端遥测在 client.py 中每次发送前都会检查该变量。将以下任意值写入你的.env文件或容器环境变量DO_NOT_TRACKtruetrue、1、yes、on均生效。设置后所有后端遥测事件在入口处即被拦截不会发出任何网络请求。方法 2保持前端 SEGMENT_WRITE_KEY 为空自托管部署中你无需做任何事——docker-compose.yml 默认就是空的。如果你手动设置过该变量将其删除或置空即可关闭前端统计。方法 3断网 / 代理屏蔽兜底方案由于遥测走的是独立的 HTTPS 端点且失败时静默处理你也可以在防火墙层面屏蔽相关域名。但这属于治标优先推荐方法 1。 额外提示OpenRAG 还支持独立的 IBM Instana APM 应用性能监控它默认关闭INSTANA_ENABLED默认 false与遥测互不影响。其数据导出边界与关闭方式详见官方文档 docs/docs/reference/observability.mdx。六、总结OpenRAG 的遥测设计体现了开源项目数据收集的三条好原则最小化只上报版本、系统、GPU、功能事件 ID不碰用户数据非侵入异步发送、失败静默关闭零成本一个环境变量即可透明所有采集字段和事件 ID 都明文写在 src/utils/telemetry/ 中可随时审计。如果你希望在保留遥测的同时确认它确实关闭了可以在设置DO_NOT_TRACKtrue后查看后端日志会出现DO_NOT_TRACK is enabled的调试记录。放心使用 OpenRAG 构建你的 RAG 应用吧——你的文档内容始终只留在你的服务器上。【免费下载链接】openragOpenRAG is a comprehensive, single package Retrieval-Augmented Generation platform built on Langflow, Docling, and Opensearch.项目地址: https://gitcode.com/GitHub_Trending/open/openrag创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/16 22:30:17 · 阅读 1.2k OpenRAG遥测系统解析：匿名使用统计如何实现与关闭
OpenRAG遥测系统解析匿名使用统计如何实现与关闭【免费下载链接】openragOpenRAG is a comprehensive, single package Retrieval-Augmented Generation platform built on Langflow, Docling, and Opensearch.项目地址: https://gitcode.com/GitHub_Trending/open/openragOpenRAG 是一个基于 Langflow、Docling 和 Opensearch 的一体化 RAG检索增强生成平台。它内置了一套匿名遥测Telemetry系统用于收集版本、操作系统、GPU 等使用统计信息帮助维护者了解用户的真实使用环境。本文将完整解析 OpenRAG 遥测的工作原理、采集了哪些数据并给出 3 种快速关闭遥测的方法。一、OpenRAG 遥测是什么为什么需要它对于开源项目来说有多少人用、在什么环境下用、哪些功能被频繁使用这些问题决定了后续开发的方向。OpenRAG 因此内置了遥测后端遥测基于 Scarf记录应用启动、文档摄入、连接器同步、聊天请求等关键事件前端遥测基于 Segment 的页面浏览与按钮点击统计且仅当显式配置了写入密钥时才生效自托管场景默认关闭。遥测采用发射后不管fire-and-forget策略事件在后台异步发送永远不会阻塞你的正常操作即使网络不通或遥测服务不可用OpenRAG 的功能也完全不受影响。二、遥测到底采集了哪些数据这是用户最关心的问题。打开 client.py 可以看到每条事件携带的字段整理如下数据项示例值说明版本openrag_versionOpenRAG 版本号操作系统os、os_version如 linux / windows / macos 及版本GPU 信息gpu_available、gpu_count、cuda_available仅布尔值和数量不含显卡型号细节事件类别category如 DOCUMENT_INGESTION消息 IDmessage_id如 ORB_APP_STARTED时间戳timestampUTC 时间⚠️不会采集的内容你的文档内容、文件名、聊天提问、检索到的知识片段、API 密钥、IP 定位等敏感信息。遥测只反映你用了什么功能而非你用了什么数据。三、事件体系类别 消息 ID 的双层设计OpenRAG 的后端遥测由三个文件构成位于 src/utils/telemetry/ 目录category.py定义 13 类事件大类覆盖应用启停、OpenSearch 建索引、文档摄入与处理、认证、连接器、任务、聊天、错误、设置变更、新手引导等message_id.py定义具体事件 ID统一采用ORB_前缀OpenRAG Backend格式为ORB_类别_动作[_状态]例如ORB_DOC_INGEST_COMPLETE文档摄入完成、ORB_AUTH_FAILED认证失败client.py负责组装事件、控制重试最多 3 次指数退避并发送。这种大类 精确 ID的设计让维护者既能按功能模块做宏观统计又能追踪某个具体环节比如有多少人的连接器同步失败了的微观表现。四、前端遥测默认关闭的可选开关前端部分由 analytics.ts 和 analytics-provider.tsx 实现逻辑非常克制只有当服务端下发了SEGMENT_WRITE_KEY时才会初始化采集否则track/page全部直接返回在 docker-compose.yml 中该变量的默认值为空字符串——也就是说普通用户自行部署 OpenRAG 时前端遥测天然处于关闭状态即使开启上报的也是页面浏览、按钮点击这类交互行为不涉及任何文档或对话内容。五、如何关闭 OpenRAG 遥测3 种方法方法 1设置 DO_NOT_TRACK 环境变量推荐一键关闭后端遥测在 client.py 中每次发送前都会检查该变量。将以下任意值写入你的.env文件或容器环境变量DO_NOT_TRACKtruetrue、1、yes、on均生效。设置后所有后端遥测事件在入口处即被拦截不会发出任何网络请求。方法 2保持前端 SEGMENT_WRITE_KEY 为空自托管部署中你无需做任何事——docker-compose.yml 默认就是空的。如果你手动设置过该变量将其删除或置空即可关闭前端统计。方法 3断网 / 代理屏蔽兜底方案由于遥测走的是独立的 HTTPS 端点且失败时静默处理你也可以在防火墙层面屏蔽相关域名。但这属于治标优先推荐方法 1。 额外提示OpenRAG 还支持独立的 IBM Instana APM 应用性能监控它默认关闭INSTANA_ENABLED默认 false与遥测互不影响。其数据导出边界与关闭方式详见官方文档 docs/docs/reference/observability.mdx。六、总结OpenRAG 的遥测设计体现了开源项目数据收集的三条好原则最小化只上报版本、系统、GPU、功能事件 ID不碰用户数据非侵入异步发送、失败静默关闭零成本一个环境变量即可透明所有采集字段和事件 ID 都明文写在 src/utils/telemetry/ 中可随时审计。如果你希望在保留遥测的同时确认它确实关闭了可以在设置DO_NOT_TRACKtrue后查看后端日志会出现DO_NOT_TRACK is enabled的调试记录。放心使用 OpenRAG 构建你的 RAG 应用吧——你的文档内容始终只留在你的服务器上。【免费下载链接】openragOpenRAG is a comprehensive, single package Retrieval-Augmented Generation platform built on Langflow, Docling, and Opensearch.项目地址: https://gitcode.com/GitHub_Trending/open/openrag创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考