可观测性后端【免费下载链接】highlighthighlight.io: The open source, full-stack monitoring platform. Error monitoring, session replay, logging, distributed tracing, and more.项目地址https://gitcode.com/gh_mirrors/hi/highlight点击查看免费下载导读本文以 highlight.io 开源仓库中 docs-content/general/changelog 目录下的官方 Changelog 系列第 12 期至第 29 期为骨架完整还原 highlight.io 从开源发布、Logging 产品从 Alpha 走向成熟到 Tracing / Grafana / ClickHouse 检索演进这一整条产品与技术路线。你将看到每个版本中具体落地了什么能力、对应的仓库实现与配置在哪里、以及这些功能如何串联 Session Replay、Error Monitoring、Logging、Tracing 四大模块。适合正在使用或计划自托管 highlight.io、以及关注全栈可观测性平台架构演进的开发者阅读。Changelog 是什么一个持续演进的可观测性平台的时间线Changelog 总览页 的核心定位很简单Stay up to date with what we work on week over week——以周为单位记录 highlight.io 的功能迭代。它通过 DocsCardGroup 的形式汇总了从第 12 期到第 29 期共 18 个版本的更新卡片每张卡片用一句话概括该期重点版本核心主题Changelog 29 (4/2)Group matching、Logs drawer、Duration prefixes、自托管改进Changelog 28 (3/6)Related resources、搜索查询演进、日志关联回 tracesChangelog 27 (12/22)Grafana 支持、阶梯定价、Tracing flame graph、服务端环境数据Changelog 26 (11/08)客户端网络请求脱敏、Tracing beta 改进、Next.js tracing、Java 11 支持Changelog 25 (10/03)GitHub 栈追踪设置、Next.js Edge runtime、大体积 session 导出Changelog 24 (09/11)GitHub 增强栈追踪、会话搜索迁移 ClickHouse、Algora 开源赏金、错误标签嵌入Changelog 23 (08/22)错误列表视觉指示、新会话轮询、Pino.js 支持、Alerts 重新设计Changelog 22 (08/07)Remix SDK、Render.com Log Stream、Go/Python SDK 更新Changelog 21 (06/21)GitHub Auth、邀请检测、AllContributor AppChangelog 20 (06/06)用户管理、新日志连接器Kinesis、Fluent Forward、Filesystem、LoguruChangelog 19 (05/22)Demo 项目、评论 UI 改版、Winston transport、Canvas 录制增强Changelog 18 (04/26)Error boundary 改进、GitHub ticket 集成、hobby 部署文档Changelog 17 (04/07)新 Setup 页面、会话缓存开关、告警不再强制依赖 SlackChangelog 16 (03/19)Logging 进入 Alpha、Nest.js 支持Changelog 15 (03/11)Devtools goto 按钮、Slack 告警链接到具体实例、产品落地页Changelog 14 (03/03)新注册流程、回放抖动修复、Python 指南新首页Changelog 13 (02/24)CommandBar、HackerNews 发布、SDK 贡献文档、DocSearchChangelog 12 (02/17)开源发布、错误状态即时更新、React Router 升级、Python/Cloudflare SDK从这张时间线可以清晰看到 highlight.io 的三个演进阶段第 12–15 期为开源化与基础体验打磨期第 16–23 期以 Logging 产品从 Alpha 走向生态扩展为核心第 24–29 期则是错误检索、Tracing 与数据基础设施ClickHouse、Grafana、LLM 嵌入的深化期。下文按这四个产品主题展开。一、开源与体验基础第 12–15 期的奠基工作1.1 开源发布与社区运营Changelog 12、13Changelog 1202/17是里程碑节点highlight.io 正式开源源码托管在 GitHub当前仓库即其镜像根目录含 README.md、go.work 与 package.json 等工程文件。同期还发布了若干 Python SDKFlask、Django、Azure Functions以及 Cloudflare 集成。紧接着的 Changelog 1302/24做了三件社区向的事CommandBar在 Dashboard 中按Cmd K即可搜索 sessions、errors 等字段配合 Algolia 驱动的 DocSearch把键盘优先的检索体验带入产品与文档。SDK 贡献指引由于整个 SDK 体系基于 OpenTelemetry官方认为为你的框架添加一个 SDK 并不太难并开放了协作通道对应文档目录见 docs-content/general/4_company。HackerNews 发布作为项目早期增长事件被记录在案属于项目历史陈述非本仓库可验证的性能指标。1.2 前端体验与注册流程Changelog 12、14、15错误状态即时更新Changelog 12使用 Apollo 的optimisticResponses机制修改错误状态后 UI 立即反馈无需等待网络往返。前端 GraphQL 层对应 frontend/src/graph 目录graphql 配置见 frontend/codegen.yml。路由性能Changelog 12升级 React Router切换 errors/sessions 页面更流畅。新注册流程Changelog 14发布了全新的 signup 流程。回放抖动修复Changelog 14、15针对 Session Replay 时间轴上的 inactive 时间段与 UI 重复重置问题做了多轮修复并修复了多会话间时间缓存的问题。Devtools goto 按钮Changelog 15在 devtools 面板中错误、网络请求、日志条目都支持一键跳转到对应位置减少排查时的导航成本。Slack 告警链接到具体实例Changelog 15此前 Slack 告警只链接到错误组error group现在改为直接链接到具体出错实例点击即可进入对应会话。二、Logging 产品的从 0 到 1第 16–23 期的生态扩张2.1 Logging Alpha 与接入生态Changelog 16、19、20、23Changelog 1603/19宣布Logging 进入 Alpha可访问app.highlight.io/logs体验。此后每一期都在扩充接入方式Nest.jsChangelog 16新增 Nest.js 指南对应 sdk/highlight-nest。Winston transportChangelog 19发布 Winston.js 的 Highlight transport——照常使用 Winston 打日志Highlight 自动捕获并展示。四个新日志连接器Changelog 20AWS Kinesis / Firehose用于从基础设施或其他服务接入日志后端实现见 backend/integrations/cloudflare 之外的 backend/http/firehose.goFluent Forward兼容 Fluent Forward 协议的系统AWS 等可以直接对接Filesystem从文件系统读取日志对应 Docker 等场景LoguruPython 生态的日志库接入。这些连接器让 highlight.io 能轻松对接 AWS、Docker、自建 VM 与 Python 应用。Pino.jsChangelog 23加入 Pino.js 支持sdk/pinoNode.js 生态又添一员。从仓库结构可以印证这套多接入方式的设计日志统一进入 backend/clickhouse 存储层由 backend/otel 解析 OpenTelemetry 数据而 e2e/python 目录中则提供了 kafka、openai、azure、gcp 等多种 Python 接入的端到端示例。2.2 服务端环境数据与可搜索性Changelog 22、27Service Name / VersionChangelog 22Python 与 Go SDK 新增service_name与service_version参数让日志更容易被搜索。Go SDK 的入口配置见 sdk/highlight-go。服务端环境数据自动上报Changelog 27服务端 SDK 可以自动把运行环境信息导出到 Highlight 报告无需手动配置为服务端错误提供更多上下文。2.3 告警与提示体验Changelog 17、23告警不再强制依赖 SlackChangelog 17修复了没有 Slack 频道就难以配置告警的问题。Alerts 重新设计Changelog 23告警表单进入系列改版流程。告警的触发评估逻辑在后端有完整实现可参考 backend/alerts含 alerts.go、sessionalerts.go、logalerts.go以及 backend/temp-alerts/temp-alerts.go。三、错误检索与可观测性深化第 24–29 期的数据基础设施升级3.1 会话搜索迁移 ClickHouseChangelog 24会话搜索推出全新 UI 并完全迁移到 ClickHouse支撑带来更快的搜索体验与搜索键的实时预览。这在仓库中有完整印证存储层会话数据的 ClickHouse 读写集中在 backend/clickhouse/sessions.go、backend/clickhouse/sessions_test.go查询构建通用查询逻辑见 backend/clickhouse/querybuilder.go检索语法基于 ANTLR 的 antlr/SearchGrammar.g4 定义搜索文法对应解析实现在 backend/queryparser 与 backend/parser。3.2 搜索查询的语法演进Changelog 28Changelog 283/6对搜索做了四点细化全部可以在 SearchGrammar.g4 中找到对应设计空白字符推入隐藏通道不再在文法里跳过空白而是把空白推入 lexer 的 hidden channel这样仍然能从 lexer 拿到空白 token——这正是 ANTLR 中- channel(HIDDEN)的典型用法为后续精确定位 token 位置服务过滤器视觉标签逻辑更新即使 parser 无法把表达式拆解成子表达式也能在视觉上更好地处理分组错误提示移出输入框搜索输入框上方展示错误信息错误 token 红色高亮产生语法错误的 token 获得红色背景便于用户快速定位。同时仓库还提供了后端 DSL 解析器的 Go 实现 backend/parser/parser.go 及测试 backend/parser/parser_test.go说明搜索语法在前端交互与后端查询是分层协作的。3.3 日志与 Trace 的关联闭环Changelog 28Highlight 的核心设计理念是没有任何错误是孤立发生的。Changelog 28 实现了日志关联回 traces每次 Highlight 在代码路径中实例化的新 span 都会携带traceIdtraceId用于把 span 与其生命周期内的所有活动尤其是子 span 的创建关联起来现在日志也会被打上最近的traceId标签从而打通日志与追踪之间的关联。这意味着在错误详情页你会看到Related session、Related logs、Related trace按钮见下方图 1从 Session Replay 页面也有对称的关联入口Traces 页面则能链回相关会话。3.4 Group Matching从最近的错误到最近的错误组Changelog 29Changelog 294/2把错误匹配从最近的错误对象升级为最近的错误组之前在单个项目可能多达数百万的错误对象中查找最近邻现在先匹配到项目内约千级的错误组error group再把该组的 embedding 以加权平均的方式调整。官方给出的动机是此前使用的是近似最近邻索引ANN存在漏匹配的可能改为错误组匹配不仅性能更好匹配质量也可能更高。这属于用向量检索优化错误归组的探索与 Changelog 24 中为每个错误保存 LLM embedding的实验一脉相承。3.5 日志查看器嵌入资源面板与 Duration 前缀Changelog 29Logs drawerChangelog 29把日志查看器直接嵌入 Resources Panel减少页面跳转、加速排查见下方图 2。这是对 Changelog 28Related Resources方向的延续——进一步强化 Session Replay、Errors、Logs、Traces 之间的结缔组织。Duration 前缀Changelog 29此前时长一律以纳秒表达过于繁琐现在支持小时、分钟、秒、毫秒、微秒等多种前缀查询体验更友好。3.6 Grafana 集成与阶梯定价Changelog 27Grafana 支持Changelog 27可把前端与后端应用的指标可视化到 Grafana统一查看网络请求延迟、应用错误与后端 traces并支持聚合查询类型p50、p99 等。SDK 自动捕获的性能/可用性指标之外也支持上报自定义指标与 traces。阶梯定价Changelog 27按量付费改为 $50 基础档随用量增大单价递减。定价模型对应后端 backend/pricingpricing.go、billing.go。四、Session Replay 与追踪持续打磨的两大能力线4.1 Session Replay 的录制与回放改进Changelog 14、17、19、22、23、25Session Replay 是 highlight.io 的招牌能力相关改进贯穿始终回放流畅性Changelog 14/15 修复回放抖动与多会话时间缓存问题Changelog 23 为 devtools 中的长列表增加视觉指示器随回放自动推进并提示条目在当前时间戳之前还是之后。会话缓存开关Changelog 17对运行高内存栈如 Canvas 录制、大量 DOM 变更的用户本地回放可能拖慢浏览器标签页因此新增配置项可关闭 session caching。该能力说明见 docs-content/general/6_product-features/1_session-replay/player-session-caching.md。Canvas 录制Changelog 19、22Changelog 19 处理单页多层叠 Canvas的复杂场景用 Canvas 快照 blob 视频并捕获多层 Canvas 帧Changelog 22 修复了 WebGL 双缓冲导致的透明帧问题并开放手动快照manual snapshotting。仅记录含错误会话Changelog 19会话量巨大的用户可选择error-only recording——仅当会话抛出错误时才录制否则该会话不进 Dashboard。会话导出Changelog 25Canvas 渲染体积巨大容易超出导出时限现在把每个 Canvas chunk 渲染为独立的 mp4 文件从而在 Lambda 超时限制内完成导出。对应实现见 backend/lambda-functions/sessionExport。Slack 嵌入Changelog 21在会话评论中 某个 Slack 频道时会截取该会话截图并嵌入 Slack 消息为讨论补充上下文。4.2 Tracing 的持续投入Changelog 26、27网络请求内嵌 traceChangelog 26Session Replay 的网络请求中直接展示关联的 trace。新的火焰图Changelog 26全新 flame graph 帮助可视化延迟来源Changelog 27 又针对密集火焰图做了纵向展开优化使其更易读。Next.js 内置 OTel 接入Changelog 26Highlight 可直接消费 Next.js 内置的 OpenTelemetry 插桩在 Node runtime 免费获得 request/response spans并分别提供 Page Router 与 App Router 的 walkthrough 及 Edge Runtime 支持说明。4.3 客户端网络请求脱敏Changelog 26支持在客户端对网络请求做脱敏处理敏感数据在到达 Highlight 服务器之前就被清除。Web 客户端提供requestResponseSanitizer函数供自定义请求/响应清洗逻辑。这是数据隐私方向的典型能力配合 docs-content/general/6_product-features 中关于隐私模式的文档一起使用效果最佳。五、开发者与开源生态SDK、自托管与社区机制5.1 SDK 矩阵持续扩张版本新增 SDK / 能力Changelog 12Python Flask、Django、Azure Functions、CloudflareChangelog 13Go Fiber、Python FastAPI新增 SDK 贡献指南Changelog 16Nest.jsChangelog 19Winston.js transportChangelog 20AWS Kinesis、Fluent Forward、Filesystem、Loguru 连接器Changelog 21Python 3.11 支持Changelog 22Remix SDKv0、Python/Go 的 service_name 与 service_versionChangelog 23Pino.jsChangelog 25Next.js Edge runtimePage App RouterChangelog 26Next.js 内置 OTel 消费、Java 11对应到仓库SDK 均位于 sdk 目录如 sdk/highlight-go、sdk/highlight-py、sdk/highlight-nest、sdk/pino 等端到端验证示例在 e2e 目录如 e2e/nextjs、e2e/python并遵循统一的 e2e/README.md。5.2 自托管与 Hobby DeployChangelog 13、17、18、21、29自托管是 highlight.io 的持续投入方向Hobby Deploy 文档上线Changelog 18区别于用于开发 highlight.io 自身的 dev deployhobby deploy 面向低流量自托管场景。脱离 localhost 假设Changelog 21此前 hobby deploy 假定托管在localhost修复方式是向 Docker 容器传入REACT_APP_PRIVATE_GRAPH_URI与REACT_APP_PUBLIC_GRAPH_URI从而可以在任意域名上运行。run-hobby.sh 简化Changelog 29不再需要单独执行yarn。查看 docker/run-hobby.sh 可见其现在的流程依次执行 docker/telemetry.sh、加载 docker/env.sh 环境变量、启动基础设施 docker/start-infra.sh、拉取镜像后以docker compose -f compose.hobby.yml up --detach backend frontend启动前后端。Changelog 29 同时提到基础设施故障自动重启与OTel 数据导出优化。其余自托管相关脚本与编排文件见 docker 目录compose.hobby.yml、compose.yml 等。5.3 用户管理与社区协作机制Changelog 20、21、24用户管理Changelog 20支持创建、查看、删除团队邀请并优化了邀请邮件文案。GitHub 登录Changelog 21通过 Firebase 认证与主邮箱关联支持 GitHub 注册同时新增邀请检测——用户在注册时自动检查是否有可加入的工作区邀请避免团队在用 Highlight 但新成员没走邀请链接的尴尬。AllContributor AppChangelog 21接入 AllContributor GitHub App 以自动记录贡献者。Algora 开源赏金Changelog 24在 Algora 平台发布小型 bug 赏金由社区认领核心团队得以聚焦高优先级工作。Demo 项目Changelog 19官方把自己的生产数据管道汇入 demo 项目用户可以在上面体验各功能。5.4 错误边界与 GitHub 增强栈追踪Changelog 18、24、25Error boundary 改进Changelog 18不再要求额外导入.css文件并做了大量设计更新。GitHub 增强栈追踪Changelog 24把 GitHub 集成扩展为栈追踪直链仓库文件——错误堆栈中的每一帧都能跳转到 GitHub 仓库中的对应源码文件Changelog 25 进一步把该设置项直接放到栈追踪旁边免去在设置页里翻找。仓库侧的实现与后端集成有关可参考 backend/integrations/github 与错误栈处理工具 backend/stacktraces/stacktraces.go。六、LLM 嵌入与错误检索实验Changelog 24Changelog 24 记录了一个值得关注的前瞻性实验错误标签嵌入Error tag embeddings。团队把 LLM embedding 应用到错误数据上为每个错误保存 embedding 并使其可搜索——即用自然语言描述去检索/分类错误。这与第 29 期的 Group Matching用错误组 embedding 的加权平均替代 ANN 最近邻形成完整的技术闭环先为错误生成语义向量再以错误组为单位做匹配既提升性能又规避 ANN 漏匹配问题。这也是 highlight.io 把 AI 能力引入可观测性数据检索的一条清晰的实验路径。结语一条值得借鉴的全栈可观测性演进路径回看 Changelog 12 到 29highlight.io 的演进逻辑清晰可循先开源、打基础开源发布 注册/路由/回放等基础体验打磨建立社区再扩生态、补全产品以 OpenTelemetry 为底座快速铺开 SDK 与日志连接器Logging 从 Alpha 走向多语言、多协议支持后做深数据、强化联动会话搜索迁移 ClickHouse、搜索语法演进、日志与 trace 关联闭环、错误语义检索与 Group Matching、Grafana 集成最终把 Session Replay、Errors、Logs、Traces 编织成一张互相跳转、可交叉检索的全栈可观测网络。对于开发者而言这套 Changelog 不只是产品新闻更是一份可对照仓库源码逐项验证的演进档案每个宣称的能力几乎都能在 backend、frontend、sdk、docker 中找到对应实现与测试值得在选型与自托管时反复查阅。赞分享可观测性后端【免费下载链接】highlighthighlight.io: The open source, full-stack monitoring platform. Error monitoring, session replay, logging, distributed tracing, and more.项目地址https://gitcode.com/gh_mirrors/hi/highlight点击查看免费下载相关推荐PyO3 Changelog 深度解读从 0.1 到 0.29 的版本演进与技术路线图PyO3 Changelog 深度解读从 0.1 到 0.29 的版本演进与技术路线图 PyO3 是 Rust 语言与 CPython / PyPy / Gr开发工具AureusERP CHANGELOG 深度解读从 v1.0.0 到 v1.6.0 的开源 ERP 架构演进路线图AureusERP CHANGELOG 深度解读从 v1.0.0 到 v1.6.0 的开源 ERP 架构演进路线图 导读 本文以仓库根目录 CHANGELOG企业应用后端Quickwit CHANGELOG 深度解读从 0.1.0 到 0.9.0 的演进路线与技术里程碑Quickwit CHANGELOG 深度解读从 0.1.0 到 0.9.0 的演进路线与技术里程碑 本指南以 Quickwit 官方 CHANGELOG.m搜索引擎可观测性日志分析链路追踪后端全文检索上一篇Kronos金融大模型双粒度Token化架构深度解析与量化投资实践验证下一篇Android Iconify 终极指南如何快速集成多套矢量图标到你的应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考