Java agent versions - Microservices Engine - Alibaba Cloud Documentation Center

This topic describes the version information for the service administration agent.

Note

The MSE agent and the Application Real-Time Monitoring Service (ARMS) agent are the same Java agent. This topic provides version information for MSE only. For ARMS version information, see Agent version information.
Version types
- Official version: A stable version that is officially released. Each official version is supported for six months from its release date.
- Not recommended: A version that contains known bugs. Do not use this version. You should upgrade to an official version as soon as possible.

2025

Version	Version type	Release date	Release notes
4.6.3	Official version	December 15, 2025	Adds the Completed QPS metric for MSE to indicate the number of requests completed in the current time window. Supports conditional registration for graceful start. For more information, see Conditional registration for graceful start (public preview). Makes active notifications for graceful shutdown asynchronous and adds timeout detection. Adds support for `RetryableFeignBlockingLoadBalancerClient` in passive notifications for graceful start and shutdown.
4.5.2	Official version	September 11, 2025	Throttling protection: Fixes a bug where the total QPS and total concurrent requests were counted twice for the Zuul framework.
4.5.0	Not recommended	July 17, 2025	Throttling protection: Adds support for the RestTemplate framework. Throttling protection: Adds support for the Apache HttpClient (4.x and 5.x) framework. Throttling protection: Adds support for the OkHttp framework. Throttling protection: Adds a default namespace (`default`) configuration to rules. Removes unexpected rule pulling when the MSE authentication feature is disabled. Fixes a bug where the `regionId` was missing in specific scenarios, such as in non-ACK environments where access to the Alibaba Cloud resource metadata API failed. Fixes a bug where AliyunJavaAgent for Nacos incorrectly read user AccessKey pair configurations. Fixes a bug where the `git.properties` file in the AliyunJavaAgent package overwrote user content.
4.4.2	Official version	September 09, 2025	End-to-end canary release: Adds plug-in-free support for XXL-JOB in MSE task scheduling. Graceful start and shutdown: Optimizes the coordination between the readiness probe and delayed registration features in Eureka scenarios. Throttling protection: Optimizes the automatic detection mechanism for different versions of Spring MVC. Fixes a bug where `context-path` metadata acquisition failed for Spring Boot applications in certain scenarios.
4.3.4	Not recommended	May 12, 2025	Throttling protection: Upgrades the architecture to optimize compatibility with open source Sentinel and improve overall stability. Note If you collect MSE metric logs or use open source Sentinel, see Changes in MSE agent 4.3.x. Throttling protection: Fixes a bug related to metric classification for the Zuul and Dubbo frameworks. End-to-end canary release: Fixes a bug where canary releases did not work for the Ribbon framework when Nacos rules were used. End-to-end canary release: Fixes a bug that caused uneven traffic distribution for the Feign framework when the round-robin method was used. End-to-end canary release: Adds support for XXL-JOB. End-to-end message canary release supports the client-side filtering feature in RocketMQ gRPC 5.x. Fixes a bug in the manual offline feature that caused applications with duplicate IP addresses to become unavailable in certain scenarios. Fixes a bug in the manual offline feature that caused unexpected applications to go offline when multiple applications were deployed on the same ECS instance.
4.2.5	Official version	April 10, 2025	Graceful start and shutdown: Fixes a bug where active notifications did not work in certain scenarios. End-to-end canary release: Fixes a bug in the conversion of multi-tag filtering rules for RocketMQ 5 in canary releases for messages. End-to-end canary release: Adds support for server-side filtering for RocketMQ Remoting Client 5.1.0 and later in canary releases for messages. Throttling protection: Optimizes memory performance in scenarios where throttling is frequently triggered.
4.2.2	Official version	January 09, 2025	End-to-end canary release: Adds support for RocketMQ 5.0.4 and 5.0.7. End-to-end canary release: Fixes an issue where canary releases did not work for the Dubbo framework (2.7.x and 3.x) when ZooKeeper was used as the registry. Throttling protection: Fixes an issue with concurrent request statistics in asynchronous Spring MVC scenarios.

2024

Version	Version type	Release date	Release notes
4.2.0	Not recommended	December 06, 2024	Graceful start and shutdown: Adds an application shutdown event. For more information, see Event Center event summary. Graceful start and shutdown: Improves support for the Spring Boot 3 series. Throttling protection: Adds instrumentation support for the Tomcat servlet framework. This feature is disabled by default. System protection: Adds default circuit breaking protection, total QPS/concurrency throttling protection, and configurations for system protection and exception items. For more information, see Configure system protection. End-to-end canary release: Optimizes the border logic for Spring Cloud LoadBalancer. End-to-end canary release: Adds support for the Dubbo 3.x Triple protocol and application-level service discovery. End-to-end canary release: Fixes an issue for Spring Cloud applications that use Consul as the registry. Optimized the graceful shutdown process to resolve performance issues related to passive notifications. Microservice administration: Fixes a bug that prevented writing to the default log folder when permissions were missing.
4.1.10	Not recommended	September 05, 2024	Adds support for preferred routing to the same availability zone for Spring Cloud and Dubbo. The MyBatis plugin for MSE throttling protection is disabled by default. To enable it, add the `spring.cloud.ahas.sentinel.mybatis.enabled=true` environment variable or application startup parameter to the configuration file. Adds support for canary releases for messages for ONS Client versions. Fixes a bug where service consumer interfaces of the MSE Dubbo framework were invisible in certain scenarios. Throttling protection: Fixes a bug that occurred in the Feign framework when a fallback was used in certain scenarios.
4.1.9	Official version	July 10, 2024	Fixes an issue where pulling Dubbo tag-based routing rules failed. Fixes a bug in microservice administration in SAE scenarios and introduces the `:54199/readiness` endpoint for readiness probes. Fixes a conflict between the agent and `sentinel-spring-webmvc-6x-adapter`. Adds support for canary releases for messages for RocketMQ 4.x Sync Pull. Adds support for specifying the minimum startup memory size using the `ALIYUN_JAVA_AGENT_MINIMAL_MEMORY` environment variable. Graceful shutdown: Adds support for Dubbo 3.2.x and RocketMQ.
3.2.10	Official version	July 11, 2024	Fixes an issue where applications failed to start in certain scenarios when the Spring Cloud Alibaba Sentinel framework was used.
3.2.9	Official version	March 28, 2024	Microservice administration: Adds support for custom instrumentation for throttling protection. For more information, see How to add a custom interface in microservice administration. Microservice administration: Adds support for Spring Boot 3.0 to 3.2. Microservice administration: Adds support for JDK 21. Microservice administration: Adds support for Dubbo 3.x.

2023

Version	Version type	Release date	Release notes
3.1.4	Official version	December 25, 2023	Fixes performance issues in the MSE logic. Fixes an issue where changing `Related` from `false` to `true` caused the readiness probe to fail. Fixes an issue where delayed registration was invalid for Eureka. Stops collecting ARMS span, metrics, and metadata when only the MSE feature is enabled. Migrates the parsing logic for request parameters and request bodies from Tomcat to the filter components of Zuul or Spring Cloud Gateway. End-to-end canary release: Adds fault tolerance logic. If a trace is empty, requests are sent to the base environment by default instead of being randomly routed to other environments. Switches the data source for the CPU utilization metric in Microservice Engine (MSE) Enterprise Edition to Sentinel.
3.0.7	Official version	November 18, 2023	Starting from version 3.0.7, the MSE agent no longer supports JDK 1.6 and JDK 1.7. Fixes a conflict between the service authentication switch and other configuration items. Sets the agent thread pool to the `static final` type to determine thread pool ownership. The MSE logic does not execute if MSE is not enabled on the agent. Throttling protection: Aligns the resource names of the two WebInterceptor types with their default behavior. The interface names include the `context-path` prefix. The microservice administration insight feature no longer reports data to the server-side. The agent records the relevant data to local logs, which you can collect on your own. Throttling protection: Fixes an error that occurred when `FeignClientBuilder` used the `forType` method to build a `FeignClient`. Throttling protection: Adds support for customizing the behavior of RPC calls. Throttling protection: Adds support for configuring `SentinelWebInterceptor` to be at the head of the processing chain to obtain accurate throttling data. Throttling protection: Uses the agent to inject `SentinelWebInterceptor` as a supplement when the starter injection mechanism fails.
2.9.2	Official version	September 09, 2023	Throttling protection: Adds support for customizing the behavior of RPC calls. Throttling protection: Adds support for placing `SentinelWebInterceptor` at the head of the processing chain. Throttling protection: Uses the agent to inject `SentinelWebInterceptor` as a supplement when the starter injection mechanism fails.
2.9.1.2	Official version	August 03, 2023	Fixes an issue of uneven traffic loads for Spring Cloud Ribbon. Adds support for using `alicloud_service_tag` labels/annotations to tag nodes. Microservice administration is launched in the China (Hangzhou) Finance Cloud region. The MSE-related logic is not initialized if MSE is not enabled. Fixes a caching issue for `GetLocalV4Ip`. Fixes an issue where traffic requests failed when MSE Enterprise Edition was used with Spring Cloud Gateway and open source SCA Sentinel. Throttling protection: Fixes a bug related to the support for only the fallback usage in the Feign framework. Fixes an issue where inconsistent timestamps in the labels and annotations files caused continuous re-registration. Fixes an issue where asynchronous traces were occasionally lost in the Reactor framework.
2.9.0	Official version	July 13, 2023	Traffic Protection supports the Zuul and Spring Cloud Gateway frameworks. MSE: Adds support for persistent service discovery. Canary release and tag-based routing: Adds support for Dubbo 3.x. Adds support for matching end-to-end canary release rules based on the HTTP body. Optimizes the performance of graceful start and shutdown for MSE.
2.8.3	Official version	March 31, 2023	Adds support for JDK 11 and JDK 17. MSE: Adds support for namespace-based access to isolate different environments, such as development, testing, and production. MSE: Adds support for the throttling protection feature. Microservice Insight is fully launched and provides enhanced observability for graceful start/shutdown and end-to-end canary releases. MSE microservice administration: Adds support for Consul as the registry. End-to-end canary release: Adds support for Consul and Undertow.

2022

Version	Version type	Release date	Release notes
2.7.3.5	Official version	July 27, 2022	Adds support for canary releases for RocketMQ messages. Adds support for tagging in the OpenSergo registry and for canary releases on MSE cloud-native gateways.