技术博客

阅读约 5 分钟

DataBuff v0.1.8 发版通告

DataBuff v0.1.8 已就绪:日志详情钉死 ingest 生成的 log_id(GitHub #73);LLM Trace 里的 prompt / completion 不再是 \uXXXX;登录页和侧栏能看到 Maven 打进去的真实版本号。远程 MCP 工具在 fat-jar 里也能跑。相对 v0.1.7:32 commits,Schema 迁移 V008(log_id)

本版亮点

  • 日志详情钉 log_id(#73):ingest 为每条日志生成 32 位 hex 写入 log_dc_record.log_id;详情按这条 id 取行。原先 time_ns 在 DUPLICATE KEY 表上不唯一,高吞吐时会点到别人的行。老数据空 id 仍按 time_ns(有服务时加 service_id)查。
  • GenAI / LLM Trace 可读:属性名以 gen_ai. / gen.ai. / llm. 开头的 span,查询时解码 unicode 转义。无这些前缀的普通 span 不动。
  • 产品版本号:登录页脚和侧栏用户菜单读取 Maven build-info。
  • 远程 MCP:fat-jar 里补上 MCP JSON SPI,远程 SSE / Streamable HTTP 工具能被 LLM 对话真正调到。
  • ResourceIgnoreFilteringest.trace.ignore-resources / ignore-resource-regex 真正绑到过滤 Bean。
  • SkyWalking SQL 标准化:ingest 侧把 SW SQL 按既有规则归一,和 OTel 路径口径一致。
  • 服务实例 Top 5:排行按 service_instance 分组。
  • Trace / 日志柱状图筛选:点柱筛选可开关、可重置。
  • 文档:补了 Nginx / eBPF 接入手册(手册,不是本版新做探活产品或自研 eBPF Agent)。

怎么用:日志详情

升到 v0.1.8 后新写入的日志带 log_id。列表点进详情按这条 id 取行,再用时间窗口裁剪。升级时先跑完 V008 再滚 web / ingest,新 Web 会 SELECT log_id

日志分析列表:数量统计、状态分布和日志表格
图 1 · 日志分析列表页(尚未点进详情)
日志详情抽屉与列表当前行一致
图 2 · 点开抽屉后正文、实例、Trace ID 跟列表那一行一致;查询按 log_id 取行,页面不单独展示这个 id

怎么用:LLM Trace

探针按 OpenTelemetry GenAI 语义约定打了 gen_ai.*(或 gen.ai.* / llm.*)时,打开 Trace 会在查询阶段解开 \uXXXX。本版没有单独的 LLM 分析页,就是链路详情里能把 prompt / completion 读出来。

调用链详情里 gen_ai.prompt 显示中文原文
图 3 · LLM Trace:gen_ai.prompt / completion 按原文显示,不再是 unicode 转义串

怎么用:确认版本与实例

登录页脚和侧栏用户菜单读取 Maven build-info。服务详情「基础信息」切到「按实例排行Top5」时,排行按 service_instance 分组。

登录页脚显示产品版本 0.1.8
图 4 · 登录页脚的 0.1.8 来自 Maven build-info
侧栏显示版本 0.1.8
图 5 · 登录后侧栏同一串版本号
服务详情基础信息按实例排行Top5
图 6 · 基础信息 → 按实例排行Top5,service-a-1 / 2 / 3 分开展示

安装与升级

新装请按 Docker 安装部署;已有环境换版本请按 升级与卸载。本版含 Schema 迁移 V008log_id + 告警结构化列,schema_version → 8),升级脚本会自动跑迁移;K8s 本版不支持原地升级,需卸载后重装。

# 新用户安装(全新安装,会清理旧安装目录与 data/)
curl -fsSL https://databuff.ai/databuff/ai-apm-install.sh | bash

# 现有用户升级(就地升级,保留 data/ 观测数据)
curl -fsSL https://databuff.ai/databuff/ai-apm-update.sh | bash

体验与反馈

GitHub Release v0.1.8 · 仓库