跳到主要内容

SmartAgent Version 10.3.0

发布日期：2026 年 8 月 7 日

版本概述​

SmartAgent 10.3.0 新增支持 Podman 5.6.0 及批量启动容器监控；同时集成 JavaAgent 9.16.1、DotnetAgent 6.16.2、PythonAgent 8.8.0、GoAgent 5.1.0、SDKAgent 5.17.0、NodejsAgent 8.0.2、NginxAgent 3.10.3、logsAgent 3.0.3 等子探针升级。

  • ✨ Podman：支持监控 Podman 5.6.0 及批量启动容器场景

  • ✨ JavaAgent 9.16.1：新增 JDBC DBM SQL 注释传播；适配 lettuce 6.5/6.6 及宝蓝德 BES；支持自定义错误名及 GenAI 能力增强；优化应用启动速度；修复探针 httpclient 日志输出到控制台、JBoss LogManager 初始化失败等问题

  • ✨ GoAgent 5.1.0：支持 Go aarch64 1.22/1.23、HTTPS Server、多数据库驱动及 Kafka（Sarama）采集

  • ✨ PythonAgent 8.8.0 / SDKAgent 5.17.0：增强大模型可观测能力（时间片/截断、token 汇总、用户/会话 ID）

  • 🔧 通用优化：内置过滤 Elasticsearch 及 Oracle rwrun 进程注入；优化 containerd root 路径识别

升级建议
  • 使用 Podman 5.6.0、大模型可观测、JDBC DBM 或 Go aarch64 1.22/1.23 的场景应优先升级；
  • 受 Spring Cloud Gateway 响应头重复、探针 httpclient 日志输出到应用控制台、JBoss LogManager 初始化失败、Nginx JS 插码越界读 或 logsAgent license 恢复后未重新采集 问题影响的用户，建议尽快升级。

Linux x86_64 系统​

支持平台版本​

  • One 平台：V2.2.2 及以上版本

集成探针版本​

  • JavaAgent: 9.16.1
  • DotnetAgent：6.16.2
  • PHPAgent：8.7.0
  • PythonAgent：8.8.0
  • NodejsAgent：8.0.2
  • NginxAgent: 3.10.3
  • ApacheAgent：3.5.0
  • SDKAgent：5.17.0
  • GoAgent：5.1.0
  • logsAgent：3.0.3

新增功能​

  1. 支持监控 Podman 5.6.0。
  2. 支持监控 Podman 批量启动容器场景。

功能优化与修复​

1. JavaAgent 升级至 9.16.1​

新增功能

  • 新增 JDBC DBM SQL 注释传播能力（支持 service/full/disabled 传播模式）。
  • 支持根据规则自定义错误名。
  • 适配 lettuce 6.5、6.6；适配兼容 Java preview class。
  • 适配宝蓝德 bes-11.5.0 容器；适配宝蓝德 bes-9.5.5.7266 数据库连接池与线程池。
  • es_restclient_endpoint 包含数字的分段使用问号替换。
  • span 中 tag gen_ai.user.id / gen_ai.conversation.id 重命名为 framework.user.id / framework.conversation.id。
  • spring-ai：在 Transaction 上汇总 GenAI token 用量。
  • 过滤常见 HTTP 请求头敏感字段。

功能优化

  • 规避 JDK 1.7 使用 -XX:-UseSplitVerifier 导致探针离线（影响范围：JavaAgent 9.10.0～9.15.0，对应 SmartAgent 9.10.0～10.2.1）。
  • 基于类方法采集的请求属性异步线程增量上报可能丢失。
  • 优化部分场景应用启动速度。

修复 Bug

  • 过滤 JDBC 批处理返回的 SUCCESS_NO_INFO/EXECUTE_FAILED 哨兵值，避免负数写入 rowsReturned（影响范围：JavaAgent 8.0.0～9.15.0，对应 SmartAgent 6.0.0～10.2.1）。
  • 避免 CTAS SQL 误触发执行计划（影响范围：JavaAgent 8.0.0～9.15.0，对应 SmartAgent 6.0.0～10.2.1）。
  • 数据库名解析：getCatalog() 返回空串时回退默认 <default>（影响范围：JavaAgent 8.0.0～9.15.0，对应 SmartAgent 6.0.0～10.2.1）。
  • 修复 Spring Cloud Gateway 场景下游 APM 响应头重复添加问题（影响范围：JavaAgent 8.0.0～9.15.0，对应 SmartAgent 6.0.0～10.2.1）。
  • 解决探针的 httpclient 日志可能输出到应用控制台的问题（影响范围：JavaAgent 9.13.0～9.16.1，对应 SmartAgent 10.0.0～10.2.1）。
  • 解决 JBoss 初始化 LogManager 失败的问题（影响范围：JavaAgent 9.13.0～9.16.1，对应 SmartAgent 10.0.0～10.2.1）。

2. DotnetAgent 升级至 6.16.2​

新增功能

  • 适配 .NET 9.0。

3. PythonAgent 升级至 8.8.0​

新增功能

  • 添加大模型对话时间片/截断指标。
  • 添加大模型调用链汇总 token 使用情况和用户 id/会话 id tag。
  • 大模型是否采集 input/output 开关作用范围扩展到更多 span kind。
  • 大模型过滤用户 id/会话 id 为 unknown 的情况。
  • profiling 功能去掉敏感化。

4. NginxAgent 升级至 3.10.3​

修复 Bug

  • 修复 js 插码检查可能越界读问题（影响范围：NginxAgent 1.1.0～3.10.2，对应 SmartAgent 1.2.3～10.2.1）。

5. SDKAgent 升级至 5.17.0​

新增功能

  • 适配 AI 可观测相关指标；大模型 token/耗时指标添加用户 id 维度。
  • 大模型内容长度限制支持可配置。
  • 请求头敏感字段脱敏；调用链大模型用户 id/会话 id 调整。
  • 支持 es 后端详情混淆；适配异常提取规则。
  • 添加大模型时间片/截断指标。

修复 Bug

  • machine 未下发环境 id 属性时，探针清空环境 id（影响范围：SDKAgent 5.15.x～5.16.x，对应 SmartAgent 10.0.0～10.2.1）。
  • 补充 serverless 模式事件上报 agentuid（影响范围：SDKAgent 5.17.0 之前版本，对应 SmartAgent 10.3.0 之前版本）。

6. logsAgent 升级至 3.0.3​

新增功能

  • 日志原文包含不支持编码导致 LogsData 序列化失败时，打印日志路径。

修复 Bug

  • license 失效后恢复时重置 last_modify_time，解决 license 恢复后未重新采集日志问题（影响范围：logsAgent 3.0.3 之前版本，对应 SmartAgent 10.3.0 之前版本）。

7. GoAgent 升级至 5.1.0​

新增功能

  • 支持 Go aarch64 1.22.x 和 1.23.x，提升不同 Go 版本下的类型识别和运行兼容性。
  • 支持 HTTPS Server 请求采集。
  • 解除 Go 内置 database/sql 采集仅支持 MySQL 的限制，新增对 Oracle、PostgreSQL、SQLite 数据库驱动的连接识别和信息采集。
  • 支持基于 IBM Sarama v1.45.1 的 Kafka 生产、消费链路采集。
  • 新增常见 Go 错误的结构化解析能力，覆盖 xerrors、RabbitMQ、Redis、PostgreSQL、MySQL、RocketMQ、TChannel、Sarama 等组件的典型错误场景。
  • 增加写入探针日志文件。

功能优化

  • 采集性能优化：降低类型解析、重复处理及内存分配开销，大幅提升高并发场景下的采集性能。
  • 运行稳定性优化：支持空闲协程上下文自动回收，减少长期运行产生的上下文堆积。

8. NodejsAgent 升级至 8.0.2​

新增功能

  • 新增对 Mongoose 原生连接（mongoose.createConnection()）的支持，可采集通过 db.collection() 发起的数据库操作。

功能优化

  • 采集性能优化：精简事件监听机制，对 Agent 内部处理流程进行了性能优化，减少运行时开销。

9. SmartAgent 自身优化​

  • 内置过滤 Elasticsearch 及 Oracle rwrun 进程的注入。
  • 优化 containerd root 路径识别。

Linux ARM64 系统​

支持平台版本​

  • One 平台：V2.2.2 及以上版本

集成探针版本​

  • JavaAgent: 9.16.1
  • DotnetAgent：6.16.2
  • PHPAgent：8.7.0
  • PythonAgent：8.8.0
  • NginxAgent: 3.10.3
  • SDKAgent：5.17.0
  • GoAgent：5.1.0
  • logsAgent：3.0.3

新增功能​

  1. 支持监控 Podman 5.6.0。
  2. 支持监控 Podman 批量启动容器场景。

功能优化与修复​

平台说明

本平台的功能更新与 Linux x86_64 系统基本一致，主要差异为探针支持范围。

功能优化与修复

  • 同 Linux x86_64（含 JavaAgent 9.16.1、DotnetAgent、PythonAgent、NginxAgent、SDKAgent、logsAgent、GoAgent 升级及 SmartAgent 自身优化）
  • 不包含 NodejsAgent、ApacheAgent 升级（ARM64 暂不支持）

注意事项

  • ARM64 平台暂不支持 NodejsAgent、ApacheAgent

Windows x86_64 平台​

支持平台版本​

  • One 平台：V2.2.2 及以上版本

集成探针版本​

  • JavaAgent: 9.16.1
  • DotnetAgent：6.16.2
  • logsAgent：3.0.3

功能优化与修复​

1. JavaAgent 升级至 9.16.1​

（同 Linux x86_64）

2. DotnetAgent 升级至 6.16.2​

新增功能

  • 适配 .NET 9.0。

3. logsAgent 升级至 3.0.3​

（同 Linux x86_64）

4. SmartAgent 自身优化​

  • 内置过滤 Elasticsearch 及 Oracle rwrun 进程的注入。

兼容性说明​

平台兼容性​

操作系统支持架构最低 One 版本
Linuxx86_64V2.2.2
LinuxARM64V2.2.2
Windowsx86_64V2.2.2