As seções a seguir listam cada versão do agente Java do Microservices Engine (MSE) desde a versão 2.7.3.5, com datas de lançamento, status de estabilidade e histórico detalhado de alterações.
O agente do MSE e o agente do Application Real-Time Monitoring Service (ARMS) compartilham o mesmo binário do agente Java. Esta página aborda apenas as alterações específicas do MSE. Para as alterações do ARMS, consulte ARMS Java agent release notes.
Tipos de versão
Cada versão do agente Java do MSE é classificada com um dos seguintes tipos de versão.
|
Tipo |
Significado |
|
Oficial |
Versão estável. Com suporte por seis meses a partir da data de lançamento. |
|
Não recomendada |
Contém bugs conhecidos. Atualize para a versão oficial mais recente. |
A versão oficial mais recente do agente Java do MSE é a 5.3.0.
Compatibilidade com JDK
A compatibilidade do agente Java do MSE com o JDK mudou ao longo das versões:
O JDK 11 e o JDK 17 têm suporte a partir da versão 2.8.3.
O MSE descontinuou o suporte ao JDK 1.6 e ao JDK 1.7 a partir da versão 3.0.7.
O JDK 21 tem suporte na administração de microsserviços a partir da versão 3.2.9.
2026
5.3.0 -- Oficial (30 de setembro de 2026)
Novos recursos
Adicionado: suporte a tipos genéricos para coleta de dados de interface e compatibilidade com o hutool-core.
Adicionado: suporte a desligamento suave para clientes do protocolo gRPC do ApsaraMQ for RocketMQ.
Correções de bugs
Corrigido: problema em que os agentes 5.x não ofereciam suporte a canary release para configurações do Nacos.
5.1.0 -- Oficial (12 de junho de 2026)
Correções de bugs
Corrigido: bug na proteção de throttling em que o número de recursos de throttling aumentava significativamente durante o throttling no lado do cliente.
Corrigido: bug que causava falha na inicialização das aplicações em cenários com Spring WebFlux 6.x.
Corrigido: problema de perda de tráfego durante atualizações em rolagem após a ativação do horizontal pod autoscaler (HPA) em um cluster, ou durante atualizações em rolagem que alteravam o número de réplicas simultaneamente.
4.8.0 -- Oficial (29 de abril de 2026)
Correções de bugs
Corrigido: problema de perda de tráfego durante o desligamento do cliente RocketMQ.
Corrigido: bug que causava a perda de metadados durante o registro da aplicação no Eureka, resultando em falhas no canary release de ponta a ponta.
Corrigido: bug que causava a perda de tags de canary release de ponta a ponta para os produtores do RocketMQ.
4.7.1 -- Oficial (26 de fevereiro de 2026)
Novos recursos
Adicionado: suporte à proteção de throttling para o framework Spring WebFlux.
Adicionado: suporte a comportamento personalizado para proteção do sistema.
Adicionado: suporte à conexão e ao uso da administração de microsserviços do MSE por clusters externos.
Melhorias
Aprimorado: desempenho do início e desligamento suave em cenários com Spring Cloud Nacos e Eureka para evitar ainda mais a perda de tráfego.
Otimizado: relatório e exibição da métrica de utilização da CPU do sistema.
Correções de bugs
Corrigido: bug que impedia o funcionamento do roteamento preferencial para a mesma zona de disponibilidade no Dubbo quando
simplified=trueestava ativado.Corrigido: erro de serialização durante o registro atrasado de clientes Eureka.
Corrigido: falha de análise do campo
java.versionpara métricas do sistema em imagens Docker OpenJDK Alpine.Corrigido: bug de análise de source na proteção de throttling para cenários com Dubbo 3.x.
Corrigido: bug que impedia o funcionamento do canary release de ponta a ponta para o Spring Cloud Alibaba 2023 e versões posteriores.
Corrigido: vazamento de memória causado por problemas de rede durante o relatório de metadados.
2025
4.6.3 -- Oficial (15 de dezembro de 2025)
Novos recursos
Adicionado: métrica Completed QPS para indicar o número de requisições concluídas na janela de tempo atual.
Adicionado: registro condicional para início suave. Para mais detalhes, consulte conditional registration for graceful start.
Adicionado: suporte a
RetryableFeignBlockingLoadBalancerClientem notificações passivas para início e desligamento suave.
Melhorias
Aprimorado: desligamento suave ao tornar as notificações ativas assíncronas e adicionar a detecção de tempo limite.
4.5.2 -- Oficial (11 de setembro de 2025)
Correções de bugs
Corrigido: bug na proteção de throttling que causava a contagem dupla do QPS total e do total de requisições simultâneas para o framework Zuul.
4.4.2 -- Oficial (9 de setembro de 2025)
Novos recursos
Adicionado: suporte a canary release de ponta a ponta sem plug-ins para o XXL-JOB no agendamento de tarefas do MSE.
Melhorias
Aprimorada: coordenação entre a sonda de prontidão e o registro atrasado em cenários Eureka para início e desligamento suave.
Otimizado: mecanismo de detecção automática para diferentes versões do Spring MVC na proteção de throttling.
Correções de bugs
Corrigido: bug que causava falha na aquisição de metadados de
context-pathpara aplicações Spring Boot.
4.5.0 -- Não recomendada (17 de julho de 2025)
Novos recursos (proteção de throttling)
Adicionado: suporte ao framework RestTemplate.
Adicionado: suporte ao Apache HttpClient (4.x e 5.x).
Adicionado: suporte ao framework OkHttp.
Adicionado: configuração de namespace padrão (
default) para as regras de throttling.
Correções de bugs
Corrigido: bug que causava a ausência do
regionIdem ambientes não ACK quando o acesso à API de metadados de recursos do Alibaba Cloud falhava.Corrigido: bug que fazia o AliyunJavaAgent para Nacos ler incorretamente as configurações de pares de AccessKey do usuário.
Corrigido: bug que fazia o arquivo
git.propertiesno pacote AliyunJavaAgent sobrescrever o conteúdo do usuário.
Alterações
Removida: obtenção inesperada de regras quando o recurso de autenticação do MSE está desativado.
4.3.4 -- Não recomendada (12 de maio de 2025)
Se você coletar logs de métricas do MSE ou usar o Sentinel de código aberto, consulte Changes in MSE agent 4.3.x antes de atualizar.
Novos recursos
Adicionado: suporte ao XXL-JOB no canary release de ponta a ponta.
Adicionado: filtragem no lado do cliente para RocketMQ gRPC 5.x no canary release de ponta a ponta para mensagens.
Melhorias
Atualizada: arquitetura de proteção de throttling para melhorar a compatibilidade com o Sentinel de código aberto e a estabilidade geral.
Correções de bugs
Corrigido: classificação de métricas para os frameworks Zuul e Dubbo na proteção de throttling.
Corrigido: bug que impedia o funcionamento do canary release para o framework Ribbon ao usar as regras do Nacos.
Corrigido: distribuição desigual de tráfego para o framework Feign quando o round-robin era usado no canary release de ponta a ponta.
Corrigido: bug na operação manual de offline que causava a indisponibilidade de aplicações com endereços IP duplicados.
Corrigido: bug na operação manual de offline que causava a queda inesperada de aplicações quando várias aplicações eram implantadas na mesma instância ECS.
4.2.5 -- Oficial (10 de abril de 2025)
Novos recursos
Adicionado: suporte a filtragem no lado do servidor para o RocketMQ Remoting Client 5.1.0 e versões posteriores no canary release de ponta a ponta para mensagens.
Melhorias
Aprimorado: desempenho de memória na proteção de throttling quando o throttling é acionado com frequência.
Correções de bugs
Corrigido: bug que impedia o funcionamento das notificações ativas para o início e desligamento suave.
Corrigido: bug de conversão nas regras de filtragem de múltiplas tags para o RocketMQ 5 no canary release de ponta a ponta para mensagens.
4.2.2 -- Oficial (9 de janeiro de 2025)
Novos recursos
Adicionado: suporte ao RocketMQ 5.0.4 e 5.0.7 no canary release de ponta a ponta.
Correções de bugs
Corrigido: bug que impedia o funcionamento do canary release para o framework Dubbo (2.7.x e 3.x) ao usar o ZooKeeper como registro.
Corrigido: estatísticas incorretas de requisições simultâneas para a proteção de throttling em cenários assíncronos do Spring MVC.
2024
4.2.0 -- Não recomendada (6 de dezembro de 2024)
Novos recursos
Adicionado: evento de desligamento de aplicação para início e desligamento suave. Para mais detalhes, consulte Event Center event summary.
Adicionado: suporte a instrumentação para o framework de servlets Tomcat na proteção de throttling. Desativado por padrão.
Adicionado: proteção padrão contra quebra de circuito, proteção de throttling de QPS/concorrência total e configurações de proteção do sistema e itens de exceção. Para mais detalhes, consulte default circuit breaking protection settings.
Adicionado: suporte ao protocolo Triple do Dubbo 3.x e à descoberta de serviço no nível da aplicação no canary release de ponta a ponta.
Melhorias
Aprimorado: suporte à série Spring Boot 3 no início e desligamento suave.
Otimizada: lógica de limites para o Spring Cloud LoadBalancer no canary release de ponta a ponta.
Refinado: processo de desligamento suave para resolver problemas de desempenho relacionados a notificações passivas.
Correções de bugs
Corrigido: problema no canary release de ponta a ponta para aplicações Spring Cloud que usam o Consul como registro.
Corrigido: bug na administração de microsserviços que impedia a gravação na pasta de log padrão quando as permissões estavam ausentes.
4.1.10 -- Não recomendada (5 de setembro de 2024)
Novos recursos
Adicionado: roteamento preferencial para a mesma zona de disponibilidade no Spring Cloud e no Dubbo.
Adicionado: suporte a versões do ONS Client no canary release de ponta a ponta para mensagens.
Correções de bugs
Corrigido: bug que impedia a visualização das interfaces de consumidor do Dubbo na administração de microsserviços do MSE.
Corrigido: bug na proteção de throttling que afetava o framework Feign ao usar um fallback.
Alterações
Desativado: plug-in MyBatis para a proteção de throttling do MSE por padrão. Para reativá-lo, defina a variável de ambiente ou o parâmetro de inicialização
spring.cloud.ahas.sentinel.mybatis.enabled=true.
3.2.10 -- Oficial (11 de julho de 2024)
Correções de bugs
Corrigido: problema que causava falha na inicialização das aplicações ao usar o framework Spring Cloud Alibaba Sentinel.
4.1.9 -- Oficial (10 de julho de 2024)
Novos recursos
Adicionado: suporte ao Sync Pull do RocketMQ 4.x no canary release de ponta a ponta para mensagens.
Adicionado: variável de ambiente
ALIYUN_JAVA_AGENT_MINIMAL_MEMORYpara especificar o tamanho mínimo de memória de inicialização.Adicionado: suporte ao desligamento suave para Dubbo 3.2.x e RocketMQ.
Correções de bugs
Corrigido: problema que causava falha na extração de regras de roteamento baseadas em tags do Dubbo.
Corrigido: bug na administração de microsserviços em cenários SAE.
Corrigido: conflito entre o agente e o
sentinel-spring-webmvc-6x-adapter.
Alterações
Introduzido: endpoint
:54199/readinesspara sondas de prontidão.
3.2.9 -- Oficial (28 de março de 2024)
Novos recursos
Adicionado: instrumentação personalizada para proteção de throttling na administração de microsserviços. Para mais detalhes, consulte Add a custom interface in microservice administration.
Adicionado: suporte ao Spring Boot 3.0 ao 3.2 na administração de microsserviços.
Adicionado: suporte ao JDK 21 na administração de microsserviços.
Adicionado: suporte ao Dubbo 3.x na administração de microsserviços.
2023
3.1.4 -- Oficial (25 de dezembro de 2023)
Novos recursos
Adicionado: tolerância a falhas no canary release de ponta a ponta: requisições com trace vazio agora são roteadas para o ambiente base em vez de ambientes aleatórios.
Melhorias
Aprimorado: desempenho da lógica do MSE.
Otimizada: análise de parâmetros de requisição e do corpo da requisição do Tomcat para os componentes de filtro do Zuul e Spring Cloud Gateway.
Atualizada: fonte de dados para a métrica de utilização da CPU no MSE Enterprise Edition para o Sentinel.
Correções de bugs
Corrigido: problema que causava falha na sonda de prontidão ao alterar
Relateddefalseparatrue.Corrigido: problema que impedia o registro atrasado de surtir efeito para o Eureka.
Alterações
Interrompida: coleta de spans, métricas e metadados do ARMS quando apenas o recurso do MSE está ativado.
3.0.7 -- Oficial (18 de novembro de 2023)
A partir da versão 3.0.7, o agente do MSE não oferece mais suporte ao JDK 1.6 ou JDK 1.7.
Novos recursos (proteção de throttling)
Adicionado: suporte à personalização do comportamento de chamadas RPC.
Adicionado: suporte à configuração do
SentinelWebInterceptorno início da cadeia de processamento para obter dados de throttling precisos.Adicionado: injeção baseada em agente do
SentinelWebInterceptorcomo suplemento quando o mecanismo de injeção do starter falha.
Melhorias
Alinhados: nomes de recursos do WebInterceptor com seu comportamento padrão para que os nomes das interfaces incluam o prefixo
context-path.Definido: pool de threads do agente como
static finalpara esclarecer a propriedade do pool de threads.
Correções de bugs
Corrigido: conflito entre a opção de autenticação de serviço e outros itens de configuração.
Corrigido: erro na proteção de throttling quando o
FeignClientBuilderusava o métodoforTypepara construir umFeignClient.
Alterações
Interrompida: execução da lógica do MSE quando o MSE não está ativado no agente.
Interrompido: relatório de dados do Microservice Insight para o lado do servidor. O agente grava os dados em logs locais. Colete os logs de forma independente.
2.9.2 -- Oficial (9 de setembro de 2023)
Novos recursos (proteção de throttling)
Adicionado: suporte à personalização do comportamento de chamadas RPC.
Adicionado: suporte ao posicionamento do
SentinelWebInterceptorno início da cadeia de processamento.Adicionado: injeção baseada em agente do
SentinelWebInterceptorcomo suplemento quando o mecanismo de injeção do starter falha.
2.9.1.2 -- Oficial (3 de agosto de 2023)
Novos recursos
Adicionado: suporte ao uso de rótulos e anotações
alicloud_service_tagpara aplicar tags em nós.Lançada: administração de microsserviços na região China (Hangzhou) Finance Cloud.
Correções de bugs
Corrigido: carga de tráfego desigual para o Spring Cloud Ribbon.
Corrigido: problema de cache para o
GetLocalV4Ip.Corrigido: bug que causava falha nas requisições de tráfego ao usar o MSE Enterprise Edition com o Spring Cloud Gateway e o SCA Sentinel de código aberto.
Corrigido: bug na proteção de throttling que afetava o framework Feign ao usar apenas o fallback.
Corrigido: problema que causava um novo registro contínuo devido a carimbos de data/hora inconsistentes em arquivos de rótulos e anotações.
Corrigido: problema que causava a perda ocasional de traces assíncronos no framework Reactor.
Alterações
Interrompida: inicialização da lógica relacionada ao MSE quando o MSE não está ativado.
2.9.0 -- Oficial (13 de julho de 2023)
Novos recursos
Adicionado: suporte à proteção de throttling para os frameworks Zuul e Spring Cloud Gateway.
Adicionado: descoberta de serviço persistente para o MSE.
Adicionado: suporte ao Dubbo 3.x no canary release e no roteamento baseado em tags.
Adicionado: suporte à correspondência de regras de canary release de ponta a ponta com base no corpo HTTP.
Melhorias
Aprimorado: desempenho de início e desligamento suave para o MSE.
2.8.3 -- Oficial (31 de março de 2023)
Novos recursos
Adicionado: suporte ao JDK 11 e JDK 17.
Adicionado: acesso baseado em namespace para isolar ambientes como desenvolvimento, teste e produção no MSE.
Adicionado: proteção de throttling para o MSE.
Adicionado: suporte ao Consul como registro na administração de microsserviços do MSE.
Adicionado: suporte ao Consul e Undertow no canary release de ponta a ponta.
Lançado: Microservice Insight, que fornece observabilidade para o início e desligamento suave e para o canary release de ponta a ponta.
2022
2.7.3.5 -- Oficial (27 de julho de 2022)
Novos recursos
Adicionado: canary release de ponta a ponta para mensagens do RocketMQ.
Adicionado: suporte a tags no registro OpenSergo e no canary release em gateways nativos da cloud do MSE.