Microservices Engine:Java agent versions

4.6.3 -- Official (December 15, 2025)

New features

• Added the Completed QPS metric to indicate the number of requests completed in the current time window.

• Added conditional registration for graceful start. For details, see Conditional registration for graceful start (public preview).

• Added support for RetryableFeignBlockingLoadBalancerClient in passive notifications for graceful start and shutdown.

Improvements

• Improved graceful shutdown by making active notifications asynchronous and adding timeout detection.

4.5.2 -- Official (September 11, 2025)

Bug fixes

• Fixed a bug in throttling protection where total QPS and total concurrent requests were counted twice for the Zuul framework.

4.5.0 -- Not recommended (July 17, 2025)

New features (throttling protection)

• Added support for the RestTemplate framework.

• Added support for Apache HttpClient (4.x and 5.x).

• Added support for the OkHttp framework.

• Added a default namespace (default) configuration to throttling rules.

Bug fixes

• Fixed a bug where the regionId was missing in non-ACK environments when access to the Alibaba Cloud resource metadata API failed.

• Fixed a bug where AliyunJavaAgent for Nacos incorrectly read user AccessKey pair configurations.

• Fixed a bug where the git.properties file in the AliyunJavaAgent package overwrote user content.

Changes

• Removed unexpected rule pulling when the MSE authentication feature is disabled.

4.4.2 -- Official (September 9, 2025)

New features

• Added plug-in-free support for XXL-JOB in MSE task scheduling for end-to-end canary release.

Improvements

• Improved the coordination between the readiness probe and delayed registration in Eureka scenarios for graceful start and shutdown.

• Improved the automatic detection mechanism for different Spring MVC versions in throttling protection.

Bug fixes

• Fixed a bug where context-path metadata acquisition failed for Spring Boot applications in certain scenarios.

4.3.4 -- Not recommended (May 12, 2025)

New features

• Added support for XXL-JOB in end-to-end canary release.

• Added client-side filtering for RocketMQ gRPC 5.x in end-to-end message canary release.

Improvements

• Upgraded the throttling protection architecture to improve compatibility with open source Sentinel and overall stability.

Bug fixes

• Fixed metric classification for the Zuul and Dubbo frameworks in throttling protection.

• Fixed a bug where canary releases did not work for the Ribbon framework when Nacos rules were used.

• Fixed uneven traffic distribution for the Feign framework when round-robin was used in end-to-end canary release.

• Fixed a bug in manual offline that caused applications with duplicate IP addresses to become unavailable in certain scenarios.

• Fixed a bug in manual offline that caused unexpected applications to go offline when multiple applications were deployed on the same ECS instance.

4.2.5 -- Official (April 10, 2025)

New features

• Added server-side filtering support for RocketMQ Remoting Client 5.1.0 and later in canary releases for messages.

Improvements

• Improved memory performance in throttling protection when throttling is frequently triggered.

Bug fixes

• Fixed a bug where active notifications did not work in certain scenarios for graceful start and shutdown.

• Fixed a conversion bug in multi-tag filtering rules for RocketMQ 5 in canary releases for messages.

4.2.2 -- Official (January 9, 2025)

New features

• Added support for RocketMQ 5.0.4 and 5.0.7 in end-to-end canary release.

Bug fixes

• Fixed a bug where canary releases did not work for the Dubbo framework (2.7.x and 3.x) when ZooKeeper was used as the registry.

• Fixed incorrect concurrent request statistics in asynchronous Spring MVC scenarios for throttling protection.

4.2.0 -- Not recommended (December 6, 2024)

New features

• Added an application shutdown event for graceful start and shutdown. For details, see Event Center event summary.

• Added instrumentation support for the Tomcat servlet framework in throttling protection. Disabled by default.

• Added default circuit breaking protection, total QPS/concurrency throttling protection, and configurations for system protection and exception items. For details, see Configure system protection.

• Added support for the Dubbo 3.x Triple protocol and application-level service discovery in end-to-end canary release.

Improvements

• Improved support for the Spring Boot 3 series in graceful start and shutdown.

• Improved the border logic for Spring Cloud LoadBalancer in end-to-end canary release.

• Improved the graceful shutdown process to resolve performance issues related to passive notifications.

Bug fixes

• Fixed an issue for Spring Cloud applications that use Consul as the registry in end-to-end canary release.

• Fixed a bug in microservice administration that prevented writing to the default log folder when permissions were missing.

4.1.10 -- Not recommended (September 5, 2024)

New features

• Added preferred routing to the same availability zone for Spring Cloud and Dubbo.

• Added canary releases for messages support for ONS Client versions.

Changes

• Disabled the MyBatis plugin for MSE throttling protection by default. To re-enable it, set the spring.cloud.ahas.sentinel.mybatis.enabled=true environment variable or startup parameter.

Bug fixes

• Fixed a bug where Dubbo consumer interfaces were not visible in certain scenarios in MSE microservice administration.

• Fixed a bug in the Feign framework when a fallback was used in certain scenarios in throttling protection.

4.1.9 -- Official (July 10, 2024)

New features

• Added canary releases for messages support for RocketMQ 4.x Sync Pull.

• Added the ALIYUN_JAVA_AGENT_MINIMAL_MEMORY environment variable to specify the minimum startup memory size.

• Added graceful shutdown support for Dubbo 3.2.x and RocketMQ.

Bug fixes

• Fixed an issue where pulling Dubbo tag-based routing rules failed.

• Fixed a bug in microservice administration in SAE scenarios. Introduced the :54199/readiness endpoint for readiness probes.

• Fixed a conflict between the agent and sentinel-spring-webmvc-6x-adapter.

3.2.10 -- Official (July 11, 2024)

Bug fixes

• Fixed an issue where applications failed to start when the Spring Cloud Alibaba Sentinel framework was used in certain scenarios.

3.2.9 -- Official (March 28, 2024)

New features

• Added custom instrumentation for throttling protection in microservice administration. For details, see Add a custom interface in microservice administration.

• Added support for Spring Boot 3.0 through 3.2 in microservice administration.

• Added support for JDK 21 in microservice administration.

• Added support for Dubbo 3.x in microservice administration.

3.1.4 -- Official (December 25, 2023)

Improvements

• Improved MSE logic performance.

• Migrated request parameter and request body parsing from Tomcat to the filter components of Zuul and Spring Cloud Gateway.

• Switched the data source for the CPU utilization metric in MSE Enterprise Edition to Sentinel.

Bug fixes

• Fixed an issue where changing Related from false to true caused the readiness probe to fail.

• Fixed an issue where delayed registration was invalid for Eureka.

Changes

• Stopped collecting ARMS span, metrics, and metadata when only the MSE feature is enabled.

• Added fault tolerance to end-to-end canary release: requests with an empty trace now route to the base environment instead of random environments.

3.0.7 -- Official (November 18, 2023)

New features (throttling protection)

• Added support for customizing the behavior of RPC calls.

• Added support for configuring SentinelWebInterceptor to be at the head of the processing chain for accurate throttling data.

• Added agent-based injection of SentinelWebInterceptor as a supplement when the starter injection mechanism fails.

Improvements

• Aligned WebInterceptor resource names with their default behavior so that interface names include the context-path prefix.

• Set the agent thread pool to static final to clarify thread pool ownership.

Bug fixes

• Fixed a conflict between the service authentication switch and other configuration items.

• Fixed an error in throttling protection when FeignClientBuilder used the forType method to build a FeignClient.

Changes

• The MSE logic does not run if MSE is not enabled on the agent.

• The microservice administration insight feature no longer reports data to the server side. The agent records data to local logs. Collect the logs independently.

2.9.2 -- Official (September 9, 2023)

New features (throttling protection)

• Added support for customizing the behavior of RPC calls.

• Added support for placing SentinelWebInterceptor at the head of the processing chain.

• Added agent-based injection of SentinelWebInterceptor as a supplement when the starter injection mechanism fails.

2.9.1.2 -- Official (August 3, 2023)

New features

• Added support for using alicloud_service_tag labels and annotations to tag nodes.

• Launched microservice administration in the China (Hangzhou) Finance Cloud region.

Changes

• MSE-related logic is no longer initialized if MSE is not enabled.

Bug fixes

• Fixed uneven traffic loads for Spring Cloud Ribbon.

• Fixed a caching issue for GetLocalV4Ip.

• Fixed a bug where traffic requests failed when MSE Enterprise Edition was used with Spring Cloud Gateway and open source SCA Sentinel.

• Fixed a bug in throttling protection related to supporting only the fallback usage in the Feign framework.

• Fixed an issue where inconsistent timestamps in labels and annotations files caused continuous re-registration.

• Fixed an issue where asynchronous traces were occasionally lost in the Reactor framework.

2.9.0 -- Official (July 13, 2023)

New features

• Added traffic protection support for the Zuul and Spring Cloud Gateway frameworks.

• Added persistent service discovery for MSE.

• Added support for Dubbo 3.x in canary release and tag-based routing.

• Added support for matching end-to-end canary release rules based on the HTTP body.

Improvements

• Improved graceful start and shutdown performance for MSE.

2.8.3 -- Official (March 31, 2023)

New features

• Added support for JDK 11 and JDK 17.

• Added namespace-based access to isolate environments such as development, testing, and production in MSE.

• Added throttling protection for MSE.

• Added support for Consul as the registry in MSE microservice administration.

• Added support for Consul and Undertow in end-to-end canary release.

• Launched Microservice Insight with observability for graceful start and shutdown and end-to-end canary releases.

2.7.3.5 -- Official (July 27, 2022)

New features

• Added canary releases for RocketMQ messages.

• Added tagging support in the OpenSergo registry and canary releases on MSE cloud-native gateways.