Java agent - 发行说明

• 修复了 agent HTTP 通信的请求超时问题。

• 支持更多 Redis 调用。
• 支持 JAX-WS 注解和 Webmethods 组件。
• 现已支持 Jakarta EE 9+。
• 支持代理身份验证的 NTLM 认证。
• 增强了 UUID 生成，以避免性能下降问题。
• 支持在实例分布 选项卡中显示实例 IP 地址。

问题修复：

---

版本 5.9.1

2023 年 3 月 1 日

安全问题修复 (ZVE-2023-0246)：

---

版本 5.9

2023 年 2 月 20 日

新功能：

---

版本 5.8

2023 年 1 月 13 日

新功能：

---

版本 5.7.1

2022 年 12 月 5 日

问题修复：

---

版本 5.7.0

2022 年 11 月 14 日

增强：

• agent 仅支持 Java 8 及以上版本（已停止支持 Java 6 和 7）。
• agent 现使用 TLSv1.3（如 JRE 支持）或 TLSv1.2 与 Site24x7 通信。
• 通信失败时，新增最多三次的分析器数据发送重试机制。

---

版本 5.6

2022 年 9 月 13 日

增强：

• 实现了以下线程分析增强：
  • 线程分析默认启用，每八小时运行一次，每次持续五分钟，有助于识别并自动插桩慢速方法。
    注意

    您也可以手动禁用线程分析。

  • 不再列出长时间运行的方法，而是切换为树状模型，保留调用栈结构并在每个栈元素上包含附加信息。
  • 支持基于事务的分析（仅在按需分析模式下）。
    注意

    除固定间隔采样外，分析器现在还会采集分析期间收到的前几个请求。

  • 分析期间收集的线程转储与其他数据一同发送至服务器（仅在按需分析模式下）。
    注意

    最多保存 5 个转储。这些转储将本地保存，推送至 Site24x7 服务器后即删除。

  • 同时收集前 N 个资源消耗最多的线程的信息，包括 CPU 时间、内存分配和调用栈。
• 支持通过 Java agent 触发线程转储以用于 IT 自动化。

---

版本 5.5

2022 年 8 月 10 日

增强：

• 支持 Micronaut 框架。
• 支持 Cassandra Datastax 4.x。
• 支持跟踪 Spring WebClient 中的 HTTP 调用（阻塞调用）。
• 支持 JMX 查询名称中含空格。
• 支持 HttpURLConnection 的分布式追踪。
• 收集 Spring Core 和 Spring Cloud Function JAR 版本，用于 Spring4Shell 漏洞报告。

---

版本 5.4.1

2022 年 1 月 6 日

增强：

• 已移除 log4j 库中的易受攻击类（Agent 使用 log4j v1.2.17）。下一版本将使用最新版 log4j。

---

版本 5.4.0

2022 年 1 月 5 日

增强：

• 支持 Play 2.7 和 2.8 框架。
• 支持 OkHttp3 Client（最高 v4.8）。
• 增强了 REDIS 组件，支持监控更多操作，如 hset、hget 等。

问题修复：

• apminsight.info 中 agent 关闭时间不断追加到之前的值的问题已解决，现在仅保留最新值。
• 新增启用/禁用诊断日志的选项。
• 修复了 JMX 指标中由 NaN 异常导致的空值问题。
• 修复了 HttpUrlConnection 类超时被单独捕获的问题。

---

版本 5.3

2021 年 9 月 3 日

增强：

• 支持监控 Kafka、RabbitMQ 和 ActiveMQ 等消息队列
• 从此 agent 版本起，Web 请求的请求头将被捕获。
• 支持跟踪带告警的关键事务。
• agent 可在运行时安装，无需重启。

问题修复：

• 修复了日志级别设置为 OFF 时，agent 在停用前仍会打印少量日志行的问题。

---

 

版本 5.2

2021 年 6 月 22 日

增强：

• 支持监控 Java 15
• 独立 HTTP 调用作为后台事务跟踪——此功能在 agent 版本 5.1 中已废弃，现已恢复。
• 自动事务分组应用于后台事务

问题修复：

• 修复了使用 MySQL client v8.x 时 SQL 查询未被捕获的问题。

---

 版本 5.1.2

2021 年 6 月 2 日

安全修复：

• APM agent 配置文件的读写权限仅针对运行应用服务器的当前用户开放。

---

版本 5.1.1

2021 年 4 月 21 日

问题修复：

• 修复了 agent 通信错误——APM Agent 抛出"CertificateChain error"和"PKIX path building failed"，导致无法向服务器发送请求。通过将 HTTPS 设为默认协议，该问题已得到修复。

---

版本 5.1

2021 年 3 月 24 日

增强：

• 通过校验和验证来验证已下载 agent 的完整性
• 支持 OkHttp 客户端
• 后台 HTTP 调用不再作为独立后台事务跟踪，而是作为执行该调用的其他事务的一部分进行捕获。

---

版本 5.0

2020 年 12 月 15 日

新功能：

• 支持 JMX 指标—— JMX 指标已被捕获，可在应用参数下查看。这些指标默认为主流应用服务器捕获。了解更多。 

---

版本 4.9

2020 年 8 月 5 日

增强：

• 增强了 agent 诊断收集器以支持故障排除——新增了专用于诊断任务的日志文件。
• 支持监控 Elasticsearch Rest Low Level 客户端。
• 阻塞线程数默认显示在应用参数中。
• 追踪中现在显示 HTTP 调用的请求方法和状态码。 

问题修复：

• 修复了监控 Oracle DB 查询的问题。
• 修复了提取 Informix DB 主机详情时出现 Stackoverflow 错误的问题。
• 修复了分布式追踪中响应头追踪的问题。

---

版本 4.8.1

2020 年 4 月 1 日

增强：

• 支持监控 Nexus 仓库管理器和 SonarQube
• 支持监控 MySQL 8 
• 支持跟踪 UnderTow 服务器中的 HTTP 状态码

问题修复

• 修复了运行时更新 instrumentation.conf 文件中的拼写错误
• 修复了 Tomcat 主线程日志记录器初始化与 agent HttpClient 初始化之间的死锁问题
• 修复了无法识别 Elasticsearch Transport 客户端索引和类型的问题
• 修复了启用 Weblogic JDBC wrapper 时 agent 无法获取 DB 查询的问题

---

版本 4.8.0

2020 年 2 月 27 日

增强：

• 自定义插桩可从服务端进行配置。 
• 可通过创建 instrumenation.conf 文件进行实例级别的自定义插桩（custom_instrumenation.conf 文件从此版本起废弃）

---

版本 4.7.0

2019 年 12 月 19 日

增强：

• 支持通过 API 自定义事务名称
• 支持通过 API 在事务中添加自定义参数
• 支持分布式追踪
• 支持 JettyHTTP 客户端

---

版本 4.6.0

2019 年 8 月 30 日

增强：

• 对于 Docker，使用完整容器 ID 作为主机名，以支持基于主机的许可证。
• agent 现在可以自动识别 AWS ECS 环境。
• agent 日志可写入 STDOUT，如已启用。
• 应用参数键名现在也支持使用点（.）。

问题修复：

• 修复了 JVM 指标显示负值的问题。

---

版本 4.5.0

2018 年 6 月 20 日

增强：

• 现在可以跟踪通过 Transport 客户端和 Rest High Level 客户端对 Elasticsearch 发出的调用。
• HTTP 请求参数现在在事务结束时捕获。
• agent 现在可以自动识别 GCE 和 AWS Fargate 环境。

问题修复：

• 修复了处理 Cassandra 和 MongoDB 查询时出现的空指针异常。
• 修复了 agent 通信中的重试间隔问题。

---

版本 4.4.1

2019 年 3 月 5 日

问题修复：

• 修复了捕获 Postgres SQL 查询时的拼写错误。
• agent 现在可以捕获失败 Cassandra 查询的主机详情。
• agent 现在支持 Jedis 最新版本 3.0。
• 修复了处理 SQL 查询时出现的空指针异常。

---

新功能： 

2019 年 1 月 31 日

• 基于上下文的监控：在同一应用服务器上运行的应用程序可作为独立上下文进行监控，便于分别查看每个上下文的指标。

问题修复：

• 修复了异常数量和 CPU 时间的数据不匹配问题。
• 修复了后台事务 100% 失败时最小响应时间未被正确捕获的问题。
• 修复了捕获已记录异常时，若错误信息为"null"agent 抛出 NullPointerException 的问题。

---

版本 4.3

2018 年 12 月 31 日

增强：

• 支持监控运行在 Java 9、10 和 11 上的应用程序。

问题修复：

• 修复了 Play 框架中事务名称包含查询字符串的问题。 
• 修复了 SQL 查询包含子查询时主查询表名提取错误的问题，现在正确捕获并显示主查询的表名和操作。
• agent 捕获的未记录异常现归类为"警告"类别。 

---

版本 4.2

2018 年 10 月 16 日

增强：

• 针对旧版 TLS 弃用的处理，用户此前需要升级应用程序编程环境以确保监控不中断。但从 Java agent 版本 4.2 起，用户无需升级编程环境，agent 已兼容 TLS 1.2，可确保监控服务不中断。 

---

版本 4.1

2018 年 10 月 8 日

增强：

• 除默认阈值配置外，事务追踪现在还会在异常数量过高、出现新异常类型或 SQL 耗时过高时被捕获。
• 线程分析中仅对 CPU 占用高的线程进行分析，而非转储所有线程。
• 追踪中显示表名及对应的 SQL 操作。
• 对于后台事务，现已捕获异常指标。此外，后台事务的实例级别指标将在应用依赖关系图中显示。 

---

版本 4.0

2018 年 9 月 19 日

增强：

• 重新引入了对 Filter 框架的监控支持。

---

版本 3.9

2018 年 6 月 1 日

新功能：

• 应用参数支持：使用应用参数监控操作或变量的频率和规模。

增强：

• 从监控中排除 HTTP 错误，以减少监控环境中的噪音

---

版本 3.8

2018 年 5 月 4 日

增强

• 代理密码已加密，并已实施 GDPR 变更
• 所有内部组件已合并到名为"APP CODE"的单一组件中
• 每个事务的组件指标数量限制为 15 个。

---

版本 3.7

2018 年 3 月 13 日

新功能

• 即使达到最大跟踪限制，agent 仍可跟踪外部调用（上限设置为最大限制的两倍）
• MongoDB 调用现在显示完整查询
• 用户现在可以将软件包从插桩中排除（在 apminsight.conf 文件中使用键"exclude.packages"，需要重启）

增强

• 已取消外部 HTTP 调用 URL 长度限制
• 追踪详情中为 Memcached 和 Redis 调用添加了主机详情
• 追踪现在以方法调用次数汇总作为第一行显示

问题修复

• 修复了当主机详情为空字符串时（从 JDBC URL 的 DB 追踪器中提取时可能出现）追踪构建失败的问题，现在主机详情为空时将跳过

---

版本 3.6

2018 年 2 月 12 日

新功能

• 用户现在可以使用 API 监控应用程序中的代码块
• 用户可以根据需要在事务名称前加上 HTTP 方法

增强

• 在追踪中，已插桩方法调用之间增加了额外行以突出显示未插桩的代码块
• HTTP CLIENT 和 HTTP CONNECTION 组件已合并为名为 HTTP CALL 的单一组件
• 线程分析中，默认分析和采样间隔已缩短。现在 agent 每一小时分析一次，持续 5 分钟

问题修复

• 修复了 agent 在失败时未能捕获 Cassandra 查询的问题 

---

版本 3.5.1

2017 年 11 月 2 日

问题修复

• 修复了在"忽略的异常"字段传入空值时 agent 丢弃所有异常的问题。

---

版本 3.5

2017 年 11 月 1 日

新功能

• agent 可跟踪来自 JAX-WS 框架的事务
• 用户现在可以将异常排除在跟踪之外
• agent 现在可以跟踪通过 Log4j2 记录的异常 
• 用户现在可以使用 API 在应用程序中跟踪异常

增强  

• 数据库指标中包含错误数量
• Cassandra 查询的主机详情已被捕获，并显示在追踪和服务地图中
• 用户可以在"数据库"选项卡中直接查看 Cassandra 查询的性能数据
• agent 现在支持跟踪通过 MySQL Client 5.x 发出的 SQL 调用
• 优化了事务过滤机制
• agent 可以检测是否在 Docker 环境中运行 
• agent 捕获的每个异常都将与一个事务关联
• 修复了异常调用栈为空的问题
• 自动插桩仅在已知环境（应用服务器/框架）中启用
• 如果已启用，HTTP 参数将在所有框架和已知服务器中被捕获
• 在许可证过期或超出限制的情况下，agent 将在自动关闭前重试通信 15 天

---

版本 3.4

2017 年 8 月 18 日 

新功能

• 为每个事务捕获失败组件的数量，可在服务地图中查看
• agent 现在可以跟踪对 Restlet 框架的请求
• agent 现在可以跟踪 MongoDB 查询的性能
• 由 Spring 框架 ExceptionHandler（@ControllerAdvice、@ExceptionHandler）处理的异常现已由 agent 捕获，可在"异常"选项卡下查看
• 用户现在可以为使用 agent 注解 API 进行自定义插桩的方法提供名称，也可以使用方法参数来命名方法 

问题修复 

• 修复了 Jersey 框架中启用捕获请求参数后 HTTP 参数无法被应用程序访问的问题。

---

版本 3.3.1

2017 年 8 月 4 日

新功能

• 用户现在可以自定义 agent 轮询间隔（最小间隔为一分钟）
• 指标阈值已修改为在所有 APM Insight agent 中保持统一

问题修复

• 修复了 agent 使用的 HttpClient 在用户应用日志中打印日志的问题
• 修复了 SQL 查询解析 regex 不正确导致指标处理阻塞的问题 

---

版本 3.3

2017 年 5 月 16 日

新功能

• 已弃用对 Java 1.5 的支持，agent 现在运行在 Java 6 及以上版本
• 线程分析（定时和按需）
• agent 自动对线程分析识别出的慢速方法进行插桩 
• agent 现在可以从原生包和第三方包中过滤应用包，有助于识别用于性能跟踪的应用特定方法。

增强

• 智能采样达到最大阈值时，数据收集不会被禁用

---

版本 3.1

2017 年 3 月 30 日

新功能

• 用户现在可以使用 regex 将事务排除在监控之外 
• 事务合并模式现在也可应用于后台事务
• agent 现在可以在 JVM 监控中跟踪 IBM Java 的内存池
• 已从调用栈中移除原生包和应用服务器包，以提供清晰的代码流视图
• 更改 agent 配置文件后无需重启 agent/服务器 

---

版本 3.0

2017 年 1 月 11 日

新功能

• 智能采样——根据 JVM 的 CPU 和内存使用率动态调整采样因子
• 更改 custom_instrumentation.conf 文件后无需重启 agent/服务器即可生效

增强

• agent 现在跟踪通过 MSSQL sqljdbc.jar 发出的 SQL 调用

问题修复

• 新增额外检查以避免对抽象方法进行插桩
• 修复了通过 Apache HttpClient 发出的调用在提取主机地址时出现 NullPointerException 的问题

---

版本 2.9.1

2016 年 11 月 4 日

新功能

• 作为后台事务处理的外部 HTTP 调用将使用 URL 为事务命名
• agent 可以识别托管在云环境中的应用程序 
• agent 现在可以跟踪通过 Apache HttpClient 4.x 发出的调用
• 支持通过环境变量（S247_LICENSE_KEY）提供 license key

问题修复

• 修复了部分外部 HTTP 调用缺少主机名的问题 

---

版本 2.9

2016 年 9 月 28 日

增强

• 在 agent 通信失败的情况下，agent 将以特定间隔尝试重新连接 

问题修复

• 修复了部分 EJB3 调用未被捕获的问题——agent 现在可以跟踪所有类型的 EJB3 调用

---

版本 2.8

2016 年 8 月 18 日

新功能

• 用户现在可以从 Site24x7 Web 客户端更改 agent 配置
• 改进了 agent 响应时间开销 

问题修复

• 修复了之前无法在 Web 客户端中查看失败 DB 查询的调用栈的问题   

---

版本 2.7.1

2016 年 8 月 5 日

新功能：

• agent 可以跟踪应用程序中的 EJB3 调用

问题修复

• 修复了 agent 向服务器发送错误请求（HTTP 状态码 400）的问题

---

版本 2.7

2016 年 7 月 22 日

新功能

• 提供 Java agent 自动安装和基本故障排除选项 
• agent 现在跟踪 Play 2.5 框架中的事务
• agent 可以监控运行在 Java 8 上的应用程序

问题修复

• 修复了存在重复 javaagent 参数时 agent 服务启动的问题

---

版本 2.6

2016 年 3 月 28 日

新功能

• agent 跟踪所有 Web 事务的 HTTP 响应码 
• agent 可以跟踪使用 Datastax 客户端发出的 Cassandra 查询
• 追踪现在基于响应时间、外部调用、CPU 时间等多个参数进行捕获。 
• 追踪中，客户端显示总方法调用次数。 
• agent 现在在追踪中显示所有外部调用 
• 追踪中，用户可以查看外部组件的成功和失败次数 
• 追踪中的异常会捕获并显示调用栈

问题修复

• 修复了监视器处于暂停状态时仍收集 JVM 指标的问题

---

版本 2.5

2016 年 1 月 6 日

新功能

• 减少了 agent 启动时间。
• 无需重启 agent/服务器即可在运行时更改日志级别
• 可通过运行 agent jar（java -jar apminsight-javaagent.jar）来识别 agent 版本
• 可在 System.out 中随 agent 钩子消息一同识别日志位置

问题修复

• 增强了单个事务的 CPU 时间计算
• 修复了自动初始化期间捆绑的 Log4j 尝试初始化用户 appender 的问题
• 精确计算外部组件的每个事务吞吐量
• 修复了即使启用了选项也未能捕获重复追踪的问题

---

版本 2.4

2015 年 11 月 5 日

新功能

• 跟踪并显示每个事务的 CPU 时间 
• agent 现在可以在违反外部组件吞吐量、CPU 阈值或插桩点异常时捕获追踪
• 更改 background_transactions.conf 文件无需重启
• 重新转换在 agent 初始化之前已加载的类

---

版本 2.3.1

2015 年 10 月 1 日

新功能

• agent 现在可以跟踪应用程序中使用 Amazon SDK 发出的 AWS 调用

---

版本 2.3

2015 年 9 月 2 日

新功能

• agent 现在可以跟踪异常数量和错误消息
• agent 现在可以跟踪通过 java.net 包发出的 HTTP 调用 

---

版本 2.2.1

2015 年 8 月 24 日

新功能

• 用户现在可以通过自定义插桩定义和监控自定义组件 
• agent 现在使用 TSLv1 协议进行通信

---

• 版本 2.2

2015 年 8 月 6 日

新功能

• 用户现在可以使用 agent 注解对特定方法进行自定义插桩
• agent 现在加载到引导类加载器中
• agent 现在可以监控对 Memcached、Redis、Apache HttpClient 和 Informix 发出的调用

问题修复

• 已移除 HttpPointcutPropertiesPool
• 在丢弃 RootTracker 时移除 threadlocal
• 在未管理状态下禁用 JVM 收集
• 调用栈深度限制为 7

---

版本 2.1

2015 年 6 月 9 日

问题修复

• 修复了由于重载方法导致 SQL 调用计数重复的问题 
• 当 agent 被多个 JVM 使用时，可通过 PID 识别 agent 日志 

---

版本 2.0

2015 年 5 月 5 日

新功能

• 支持 Play 2.0 框架
• 用户现在可以在 JVM 参数中提供应用程序名称
• 在虚拟主机环境中，用户可以查看每个事务的完整 URL

---

版本 1.9

2014 年 12 月 26 日

新功能 

• agent 可以在新 agent 版本可用时自动升级
• agent 现在可以跟踪来自 Spring Framework 的事务 
• 通过 jt400.jar 发出的 IBM DB2 SQL 调用现已被监控
• agent 现在支持在 Java 7 中进行监控

问题修复

• 修复了日志记录器初始化中的 NullPointerException——若未定义日志级别，日志记录器将使用默认值初始化

---

版本 1.8

2014 年 10 月 15 日

新功能

• JVM 指标已被监控并以独立选项卡显示

---

版本 1.7

2014 年 5 月 23 日

新功能

• 后台事务已被监控并以独立选项卡显示，已启用跟踪
• agent 可以跟踪来自 Sybase jdbc4 的 SQL 查询 

---

版本 1.6

2014 年 4 月 16 日

增强

• HTTP 参数可以被混淆 

---

版本 1.5

2013 年 12 月 30 日 

增强

• HTTP 请求参数已被监控，可在追踪下查看
• 监视器状态由 agent 本地保存在 apminsight.info 文件中 
• 引入了事务的组件视图