微服务平台 TSF
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 微服务平台 TSF > 开发指南 > Java 应用开发 > Spring Cloud（TSF 依赖） > Spring Cloud 2020 & 2021 SDK 使用说明

Spring Cloud 2020 & 2021 SDK 使用说明

最近更新时间：2023-12-21 09:35:32

我的收藏

本页目录：

使用说明及限制

1. 修改 在pom.xml中的 parent 依赖。
<parent>
    <groupId>com.tencent.tsf</groupId>
    <artifactId>spring-cloud-tsf-dependencies</artifactId>
    <version><!-- 调整为 SDK 长期维护（LTS）版本号 --></version>
</parent>
SDK 版本号请参考：
2020版本
2021版本
普通微服务：向工程中添加spring-cloud-tsf-starter依赖。
<dependency>
  <groupId>com.tencent.tsf</groupId>
  <artifactId>spring-cloud-tsf-starter</artifactId>
</dependency>
spring-cloud-tsf-starter中包含了服务注册发现、服务路由、服务鉴权、服务限流、服务熔断、服务容错、服务监控、分布式配置功能。
网关：向工程中添加spring-cloud-tsf-msgw-scg依赖。
<dependency>
  <groupId>com.tencent.tsf</groupId>
  <artifactId>spring-cloud-tsf-msgw-scg</artifactId>
</dependency>
注意
TSF Spring Cloud 2020 开始不再支持 zuul1 网关。
2. 向 Application 类中添加注解@EnableTsf。
// 下面省略了无关的代码
import org.springframework.tsf.annotation.EnableTsf;
@SpringBootApplication
@EnableTsf
public class ProviderApplication {
    public static void main(String[] args) {
        SpringApplication.run(ProviderApplication.class, args);
    }
}
注意
Spring Cloud Finchley/Greenwich/Hoxton 支持 @EnableTsfAuth 等注解的单独使用，仅开启部分功能，Spring Cloud 2020 不再支持，添加依赖后即支持全部 SDK 功能。
3. 配置日志 pattern。Spring Cloud 2020（Spring Boot 2.4）开始，默认的日志格式有所变化。如果需要用日志配置项中的 Spring Boot 格式采集日志，需要对 pattern 进行以下设置：
logging:
  pattern:
    level: "%-5level [${spring.application.name},%mdc{trace_id},%mdc{span_id},]"
虚拟机：部署时展开高级选项，勾选“Agent 配置”中的“可观测 Agent”。
容器（通过 TSF 控制台制作的镜像）部署时展开高级选项，勾选“Agent 配置”中的“可观测 Agent”。


容器（手动制作的镜像）：Dockerfile 中添加 ot-agent-release.tar ，并通过 VM options 配置启动参数：
-javaagent:ot-agent-release/opentelemetry-javaagent.jar -Dotel.javaagent.extensions=ot-agent-release/femas-trace-opentelemetry.jar -Dotel.traces.exporter=none

中国站