操作指南

API 文档

Spring Cloud TSF Edgware

最近更新时间:2020-08-21 17:57:48

基于 Spring Cloud Edgware 版本 SDK,支持 Spring Boot 1.5.x。

注意:

2020年5月19日起,TSF 主要支持 Greenwich 和 Finchley 版本的功能更新,Edgware 版本主要进行缺陷修复,建议您优先使用 Finchley和 Greenwich 版本(社区 Edgware 版本 于2019年8月停止更新)。

1.21.4-Edgware-RELEASE(2020-08-20)

Bug 修复

  • 修复 MySQL 调用链数据对多数据源支持。
  • spring-cloud-tsf-msgw:
    修复 application/x-www-form-urlencoded 类型请求,当绑定插件通过 zuul 网关代理访问时出错的问题。

1.21.3-Edgware-RELEASE(2020-07-16)

Bug 修复

修复网关 MSGW SDK 和服务发现 SDK 不兼容,造成拉取服务列表过快的问题。

优化

spring-cloud-tsf-gateway 网关兼容新插件类型。

1.21.2-Edgware-RELEASE(2020-07-06)

Bug 修复

处理 tomcat 组件开源漏洞风险。

  • 升级 org.apache.tomcat.embed.tomcat-embed-core 到8.5.56版本。
  • 升级 org.apache.tomcat.embed.tomcat-embed-el 到8.5.56版本。
  • 升级 org.apache.tomcat.embed.tomcat-embed-websocket 到8.5.56版本。

优化

  • 调整泳道标签的传递属性。
  • 调整泳道入口行为。

1.22.1-Edgware-RELEASE(2020-08-19)

优化

  • 优化 TSF MSGW 未知插件类型提示。
  • 优化 TSF 第三方组件依赖。

Bug 修复

  • 处理 tomcat 组件开源漏洞风险。
    • 升级 org.apache.tomcat.embed.tomcat-embed-core 到8.5.56版本。
    • 升级 org.apache.tomcat.embed.tomcat-embed-el 到8.5.56版本。
    • 升级 org.apache.tomcat.embed.tomcat-embed-websocket 到8.5.56版本。
  • spring-cloud-tsf-msgw:
    • 修复 application/x-www-form-urlencoded 类型请求,当绑定插件通过 zuul 网关代理访问时出错的问题。
    • 修复无法使用 Feign 发起微服务调用的问题。

版本建议

支持向后兼容,建议全量升级。

1.22.0-Edgware-RELEASE(2020-04-29)

优化

  • 优化默认日志配置支持容器部署场景。
  • 优化 TSF MSGW zuul 依赖。

版本建议

支持向后兼容,建议全量升级。

1.21.1-Edgware-RELEASE(2020-04-29)

Bug 修复

修复泳道 ID 在非泳道起始应用中传递丢失的问题。

优化

  • 优化调用链生成文件名称的生成规则。
  • 任务调度组件优化任务生成器逻辑,兼容 BeanName 和 BeanType 方式获取工厂。

版本建议

  • 支持向后兼容,建议全量升级。

1.21.0-Edgware-RELEASE(2020-04-17)

新特性

  • 全链路灰度发布。
  • 增加熔断状态变更事件上报。

Bug 修复

  • spring-cloud-tsf-swagger 修复 @ApiParam 注解 Example 属性解析异常问题。
  • 修复 Tag 在 AsyncRestTemplate 下不传递的问题。
  • 修复 Feign 无法使用绝对 URL 请求的问题。
  • spring-cloud-tsf-gateway:
    • 修复 Tag 标签插件未在调用中透传的问题。
    • 修复当绑定网关插件后造成 Query 参数未透传的问题。

优化

支持 swagger 自动扫描包多路径特性。

1.20.0-Edgware-RELEASE(2020-03-02)

新特性

新增分布式任务调度功能。

Bug 修复

  • spring-cloud-tsf-gateway 修复 tag plugin 中 header 类型取值大小写敏感的问题。
  • 处理 tomcat 组件开源漏洞风险。
    • 升级 org.apache.tomcat.embed.tomcat-embed-core 到8.5.51版本。
    • 升级 org.apache.tomcat.embed.tomcat-embed-el 到8.5.51版本。
    • 升级 org.apache.tomcat.embed.tomcat-embed-websocket 到8.5.51版本。
    • 升级 org.apache.tomcat.tomcat-annotations-api 到8.5.51版本。
  • 修复 application/x-www-form-urlencoded 类型请求,通过 zuul 网关代理访问 provider 时,服务端不到请求参数的问题。

优化

spring-cloud-tsf-gateway 新增 tag plugin 中 path 类型取值。

版本建议

支持向后兼容,建议全量升级。

1.19.0-Edgware-RELEASE(2020-01-16)

新特性

新增服务熔断功能。

版本建议

支持向后兼容,建议全量升级。

1.18.1-Edgware-RELEASE(2020-01-14)

Bug 修复

  • spring-cloud-tsf-route 修复路由权重不准的问题。
  • spring-cloud-tsf-consul-discovery 修复服务发现线程池上限的问题。
  • spring-cloud-tsf-sleuth 修复 druid 连接池事务兼容问题。
  • spring-cloud-tsf-sleuth 修复同时依赖多个数据库连接池问题。
  • spring-cloud-tsf-core 修复 Custom Metadata 设置接口不兼容。

优化

支持通过 tsf.discovery.watch.enabled 关闭服务发现时的 watch 监听。

版本建议

支持向后兼容,建议全量升级。

1.18.0-Edgware-RELEASE(2019-12-25)

Bug 修复

  • spring-cloud-tsf-sleuth 修复 JDBC 代理过程 NPE bug 问题。
  • spring-cloud-tsf-route 修复路由系统标签匹配的问题。

新特性

  • 服务治理支持全局命名空间。
  • 新增 spring-cloud-tsf-gateway 微服务网关(zuul1 版)SDK,基于此 SDK 二次研发,无缝集成 TSF 平台服务治理能力。
  • 新增自定义日志配置需要的 Converter 和 Layout 类,支持用户使用自定义 logback\log4j\log4j2 日志配置。

优化

  • spring-cloud-tsf-sleuth 优化 TraceStatementProxyHandler JDBC 代理过程 SDK 内部异常处理逻辑:非代理异常、非 SDK 产生的异常,直接抛出;代理异常或 SDK 产生的异常,直接调用服务不经过调用链逻辑。

版本建议

支持向后兼容,建议全量升级。

1.16.3-Edgware-RELEASE (2020-04-29)

优化

优化调用链生成文件名称的生成规则。

1.16.2-Edgware-RELEASE (2020-03-02)

Bug 修复

spring-cloud-tsf-sleuth bug fixed:

  • 修复 application/x-www-form-urlencoded 类型请求,通过 zuul 网关代理访问 provider 时,服务端不到请求参数的问题。
  • 处理 Custom Metadata 设置接口不兼容。
  • 调用链输出用户自定义 Tag 和 Metadata。
  • 修复 druid 连接池事务兼容问题。
  • 修复同时依赖多个数据库连接池问题。

1.16.1-Edgware-RELEASE(2019-12-3)

Bug 修复

API 注册兼容从环境变量和启动参数中读取 TSF 参数信息。

1.16.0-Edgware-RELEASE(2019-10-11)

新特性

  • Kafka 的链路追踪能力。
  • 增加 swagger-ui 依赖包。

优化

  • 集成 spring-cloud-tsf-swagger 包后,本地启动无需设置 tsf.swagger.enabled=false。
  • 集成 spring-cloud-tsf-swagger 包后,支持本地使用 swagger-ui 进行调试。

Bug 修复

  • 修复在自定义 RedisTemplate 中指定序列化方式时的错误。
  • 修复对 StringRedisTemplate 的支持。
  • 修复引入 swagger 包后,低版本 guava 包引起冲突。
  • 配置回调功能空指针异常。

版本建议

支持向后兼容,建议全量升级。

1.14.2-Edgware-RELEASE(2019-09-10)

Bug 修复

  • 限流 Bug fix。
  • TsfContext.putTag 覆盖 bug fix。

版本建议

  • 支持向后兼容,建议全量升级。

1.14.1-Edgware-RELEASE(2019-07-24)

Bug 修复

  • 修复 tsf sdk 依赖的 scheduler 和业务自身的 scheduler 相互影响的问题。
  • 修复 spring-cloud-tsf-ratelimit 包限流不准确问题。
  • 修复 spring-cloud-tsf-sleuth 包数据源和 Mybatis 兼容性问题。

版本建议

支持向后兼容,建议全量升级。

1.14.0-Edgware-RELEASE(2019-06-21)

新特性

支持 MySQL JDBC、Redis、MongoDB、CMQ 组件调用链。

版本建议

支持向后兼容,建议全量升级。

1.12.5-Edgware-RELEASE(2020-07-17)

Bug 修复

修复 spring-cloud-tsf-route 包路由不准确问题。

优化

调整心跳请求的超时时间,当出现丢包时能够快速重试。

版本建议

支持向后兼容,建议全量升级。

1.12.4-Edgware-RELEASE(2019-08-15)

Bug 修复

  • 修复 tsf sdk 依赖的 scheduler 和业务自身的 scheduler 相互影响的问题。
  • 修复 spring-cloud-tsf-ratelimit 包限流不准确问题。

版本建议

支持向后兼容,建议全量升级。

1.12.2-Edgware-RELEASE(2019-04-22)

Bug 修复

修复 Edgware 版本自定义 tag 问题。

版本建议

支持向后兼容,建议全量升级。

1.12.1-Edgware-RELEASE(2019-03-25)

Bug 修复

修复配置回调功能未生效问题。

版本建议

支持向后兼容,建议全量升级。

1.12.0-Edgware-RELEASE(2019-03-13)

新特性

  • 支持自动重注册,服务鉴权/路由/限流策略本地缓存。
  • 服务路由支持基于可用区和地域就近访问策略。

优化

  • 升级分布式配置监听,精确并减小监听范围,处理更新为空的场景,避免大范围 key 刷新事件。
  • 优化分部署配置回调触发逻辑。

Bug 修复

  • spring-cloud-commons 升级到1.3.1解决 RetryTemplate 会导致 LoadBalanceInterceptor thread unsafe 问题。
  • 修复启用 hystrix 时配置会导致 tsf-route 与 feignbuilder 冲突的问题。

版本建议

支持向后兼容,建议全量升级。

1.10.0-RELEASE(2018-11-12)

新特性

  • 服务路由(srping-cloud-tsf-route):支持服务下单个 API 请求级别的路由。
  • 服务限流(spring-cloud-tsf-ratelimite):支持服务下单个 API 请求级别的限流。
  • 日志输出(spring-cloud-tsf-logger):支持默认日志输出。
  • API 注册(spring-cloud-tsf-swagger):支持服务下 API 信息自动注册,查看 API 出入参请求结构。

Bug 修复

  • 解决 RestTemplate Bean 冲突问题。

升级建议

  • 支持向后兼容。
  • 新功能建议全量升级。

1.1.1-RELEASE(2018-08-26)

新特性

  • 服务限流 (spring-cloud-tsf-rate-limit) :支持针对所有请求、单个服务的请求进行流量控制。
  • 服务路由(spring-cloud-tsf-route):支持基于部署组、系统标签、自定义标签的路由设置。
  • 服务鉴权 (spring-cloud-tsf-auth):支持基于服务名和标签的鉴权设置。
  • 配置加密 (spring-cloud-tsf-encrypt):支持配置加密功能。
  • 应用状况监控(spring-cloud-tsf-metrics):支持查看 Spring Boot 应用的 JVM 内存分布、线程、HTTP Traces、环境变量。
  • 调用链 (spring-cloud-tsf-sleuth):支持在调用链上设置标签和自定义 Metada。

Bug 修复

调用链 SDK 问题修复。

升级建议

全部建议升级。

目录