使用限制
TSF Spring Cloud 2020 开始不再支持 zuul1 网关。
Spring Cloud Finchley/Greenwich/Hoxton 支持 @EnableTsfAuth 等注解的单独使用,仅开启部分功能,Spring Cloud 2020 不再支持,添加依赖后即支持全部 SDK 功能,添加依赖相关内容请参见 Demo 工程概述。
可观测性使用说明
1. 配置日志 pattern。Spring Cloud 2020(Spring Boot 2.4)开始,日志格式有所变化。如果需要用日志配置项中的 Spring Boot 格式采集日志,需要对 pattern 进行以下设置。如果采集格式使用自定义 logback 格式/自定义 log4j2 格式或其他自定义规则格式,也需要参考该 pattern 进行对应的调整。
1.1 无 XML 日志配置文件,输出格式使用 logging.pattern.level 配置进行设置:
logging:pattern:level: "%-5level [${spring.application.name},%mdc{trace_id},%mdc{span_id},]"
1.2 输出格式使用 logback.xml 配置。 logback.xml 中的 pattern 需要进行以下配置,其中 %X{trace_id} 表示调用链 trace id 的占位符,%X{span_id} 表示调用链 span id 的占位符。
%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level [${spring.application.name},%X{trace_id},%X{span_id},] ${PID} --- [%thread] %logger : %msg%n
1.3 输出格式使用 log4j2.xml 配置。 log4j2.xml 中的 pattern 需要进行以下配置,其中 %X{trace_id} 表示调用链 trace id 的占位符,%X{span_id} 表示调用链 span id 的占位符。
%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level [${spring:spring.application.name},%X{trace_id},%X{span_id},] %pid --- [%thread] %logger : %msg%n
1.4 输出格式使用其他方式:参考以上 logback 和 log4j2 配置调整 pattern。
2. 配置可观测 Agent。Spring Cloud 2020(Spring Boot 2.4)开始,TSF 采用可观测 Agent 生成调用链、监控信息。需要进行以下配置:
虚拟机:部署时展开高级选项,勾选“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