Skip to main content

SmartAgent Version 10.2.1

Release Date: July 16, 2026

Version Overview​

SmartAgent 10.2.1 is a 10.2.x feature enhancement release. Since Version 10.2.0 was not released separately, its changes have been merged into 10.2.1. This release integrates agent upgrades including JavaAgent 9.15.0 and logsAgent 3.0.2, and optimizes RocketMQ startup class monitoring and agent uninstall behavior.

Version 10.2.0 Changes (merged into 10.2.1 release)

  • ✨ JavaAgent 9.15.0: Added adaptation for spring webclient/restclient, log4j2 string layouts, Hikari poolName, spring ai, and Tencent TDMQ-Pulsar; optimized URL path extraction, sql connect database name identification, and spring webflux js injection compatibility

  • 🔧 SmartAgent self: Default ignore for RocketMQ startup class monitoring; retain cache directory on uninstall to avoid cache invalidation in container-mounted paths during non-overwrite upgrades

  • 🔧 logsAgent 3.0.2 (Windows): Fixed false circuit breaker triggers caused by incorrect Windows CPU usage calculation (affects: SmartAgent 10.0.0～10.1.2)

Version 10.2.1 Changes

  • 🔧 NginxAgent 3.10.2: Fixed excessive url.len <= offset warnings in agent logs (affects: SmartAgent 9.12.6～10.1.2)
Upgrade Recommendation
  • Java application environments using spring webclient/restclient, spring ai, or Tencent TDMQ-Pulsar should upgrade for full monitoring adaptation;
  • RocketMQ environments requiring startup class monitoring exclusion can upgrade to use the default ignore configuration;
  • Environments with container-mounted cache directories requiring non-overwrite upgrades should upgrade to avoid cache invalidation;
  • Windows users on logsAgent 3.0.0～3.0.1 experiencing false circuit breaker triggers should upgrade as soon as possible;
  • NginxAgent environments with excessive [warn] url.len <= offset warnings in agent logs should upgrade as soon as possible.

Linux x86_64 System​

Supported Platform Versions​

  • One Platform: V2.2.2 and above

Integrated Agent Versions​

  • JavaAgent: 9.15.0
  • DotnetAgent: 6.16.1
  • PHPAgent: 8.7.0
  • PythonAgent: 8.7.4
  • NodejsAgent: 8.0.1
  • NginxAgent: 3.10.2
  • ApacheAgent: 3.5.0
  • SDKAgent: 5.16.1
  • GoAgent: 5.0.3
  • logsAgent: 3.0.2

Version 10.2.0 Changes (merged into 10.2.1 release)​

1. JavaAgent Upgraded to 9.15.0​

New Features

  • Added adaptation for spring webclient 5.1 & 6.0;
  • Added adaptation for spring restclient 4.1.2;
  • Added adaptation for log4j2 string layouts;
  • Added adaptation for Hikari poolName collection;
  • Added adaptation for spring ai 1.0.0/1.0.9/1.1.2/1.1.8;
  • Added adaptation for Tencent TDMQ-Pulsar 2.7.1/2.7.2/2.9.2.

Feature Optimizations

  • Optimized URL path extraction (/http:/*);
  • Improved sql connect database name identification;
  • Improved spring webflux js injection compatibility.

2. SmartAgent Self Optimizations​

Feature Optimizations

  • Default ignore for RocketMQ startup class monitoring:
    • org.apache.rocketmq.namesrv.NamesrvStartup
    • org.apache.rocketmq.broker.BrokerStartup
    • org.apache.rocketmq.proxy.ProxyStartup
    • org.apache.rocketmq.controller.ControllerStartup
    • org.apache.rocketmq.tools.command.MQAdminStartup
  • Retain cache directory on uninstall to avoid cache invalidation in container-mounted paths during non-overwrite upgrades.

Version 10.2.1 Changes​

1. NginxAgent Upgraded to 3.10.2​

Bug Fixes

  • Fixed excessive [warn] 19#19: url.len <= offset. ... warnings in agent logs (affects: NginxAgent 3.8.5～3.10.1, SmartAgent 9.12.6～10.1.2).
  • Specific scenario: In proxy_pass scenarios where url and location have the same length, i.e., url.len == offset, warn should not be reported.

Linux ARM64 System​

Supported Platform Versions​

  • One Platform: V2.2.2 and above

Integrated Agent Versions​

  • JavaAgent: 9.15.0
  • DotnetAgent: 6.16.1
  • PHPAgent: 8.7.0
  • PythonAgent: 8.7.4
  • NginxAgent: 3.10.2
  • SDKAgent: 5.16.1
  • GoAgent: 5.0.3
  • logsAgent: 3.0.2

Version 10.2.0 Changes (merged into 10.2.1 release)​

1. JavaAgent Upgraded to 9.15.0​

New Features

  • Added adaptation for spring webclient 5.1 & 6.0;
  • Added adaptation for spring restclient 4.1.2;
  • Added adaptation for log4j2 string layouts;
  • Added adaptation for Hikari poolName collection;
  • Added adaptation for spring ai 1.0.0/1.0.9/1.1.2/1.1.8;
  • Added adaptation for Tencent TDMQ-Pulsar 2.7.1/2.7.2/2.9.2.

Feature Optimizations

  • Optimized URL path extraction (/http:/*);
  • Improved sql connect database name identification;
  • Improved spring webflux js injection compatibility.

2. SmartAgent Self Optimizations​

Feature Optimizations

  • Default ignore for RocketMQ startup class monitoring (same as Linux x86_64);
  • Retain cache directory on uninstall to avoid cache invalidation in container-mounted paths during non-overwrite upgrades.

Version 10.2.1 Changes​

1. NginxAgent Upgraded to 3.10.2​

Bug Fixes

  • Fixed excessive [warn] 19#19: url.len <= offset. ... warnings in agent logs (affects: NginxAgent 3.8.5～3.10.1, SmartAgent 9.12.6～10.1.2).
  • Specific scenario: In proxy_pass scenarios where url and location have the same length, i.e., url.len == offset, warn should not be reported.
Platform Notes
  • ARM64 does not currently support NodejsAgent or ApacheAgent

Windows x86_64 Platform​

Supported Platform Versions​

  • One Platform: V2.2.2 and above

Integrated Agent Versions​

  • JavaAgent: 9.15.0
  • DotnetAgent: 6.16.1
  • logsAgent: 3.0.2

Version 10.2.0 Changes (merged into 10.2.1 release)​

1. JavaAgent Upgraded to 9.15.0​

New Features

  • Added adaptation for spring webclient 5.1 & 6.0;
  • Added adaptation for spring restclient 4.1.2;
  • Added adaptation for log4j2 string layouts;
  • Added adaptation for Hikari poolName collection;
  • Added adaptation for spring ai 1.0.0/1.0.9/1.1.2/1.1.8;
  • Added adaptation for Tencent TDMQ-Pulsar 2.7.1/2.7.2/2.9.2.

Feature Optimizations

  • Optimized URL path extraction (/http:/*);
  • Improved sql connect database name identification;
  • Improved spring webflux js injection compatibility.

2. logsAgent Upgraded to 3.0.2​

Bug Fixes

  • Fixed false circuit breaker triggers caused by incorrect Windows CPU usage calculation (affects: logsAgent 3.0.0～3.0.1, SmartAgent 10.0.0～10.1.2).

3. SmartAgent Self Optimizations​

Feature Optimizations

  • Default ignore for RocketMQ startup class monitoring (same as Linux x86_64).
Platform Notes

This release has no Version 10.2.1-specific functional changes on Windows.

Compatibility Notes​

Platform Compatibility​

Operating SystemSupported ArchitectureMinimum One Version
Linuxx86_64V2.2.2
LinuxARM64V2.2.2
Windowsx86_64V2.2.2