应用在引入 SOFATracer 后，可以在 Spring Boot 的配置文件 application.properties 中添加相关配置项来定制 SOFATracer 的相关行为。
SOFATracer 的日志输出目录，可以在 application.properties 中配置 logging.path 的路径，那么其日志输出路径为 ${logging.path}/tracelog；如果没有配置 logging.path，那么 SOFATracer 的默认输出路径为 ${user.home}/logs/tracelog。
Spring Boot 工程配置
SOFA Tracer 配置项 | 说明 | 默认值 |
logging.path | 日志输出目录 | SOFATracer 会优先输出到 |
com.alipay.sofa.tracer.disableDigestLog | 是否关闭所有集成 SOFATracer 组件摘要日志打印 | false |
com.alipay.sofa.tracer.disableConfiguration[${logType}] | 关闭指定 | false |
com.alipay.sofa.tracer.tracerGlobalRollingPolicy | SOFATracer 日志的滚动策略 |
|
com.alipay.sofa.tracer.tracerGlobalLogReserveDay | SOFATracer 日志的保留天数 | 默认保留 |
com.alipay.sofa.tracer.statLogInterval | 统计日志的时间间隔，单位：秒 | 默认 |
com.alipay.sofa.tracer.baggageMaxLength | 透传数据能够允许存放的最大长度 | 默认 |
com.alipay.sofa.tracer.zipkin.enabled | 是否开启 SOFATracer 远程上报数据到 Zipkin | true：开启上报；false：关闭上报。默认不上报 |
com.alipay.sofa.tracer.zipkin.baseUrl | SOFATracer 远程上报数据到 Zipkin 的地址， | 格式： |
com.alipay.sofa.tracer.springmvc.filterOrder | SOFATracer 集成在 SpringMVC 的 Filter 生效的 Order | -2147483647（ |
com.alipay.sofa.tracer.springmvc.urlPatterns | SOFATracer 集成在 SpringMVC 的 Filter 生效的 URL Pattern 路径 |
|
com.alipay.sofa.tracer.JSONOutput | 是否以 JSON 格式输出日志 | true，如果期望较少日志空间占用，可以使用非 JSON 格式输出（日志顺序与 JSON 格式顺序一致） |
非 Spring Boot 工程配置
在非 Spring Boot 工程中，可以通过在 classpath 下新建一个 sofa.tracer.properties 配置文件，配置项如下：
SOFA Tracer 配置项 | 说明 | 默认值 |
disable_middleware_digest_log | 是否关闭中间件组件摘要日志打印 | false |
disable_digest_log | 关闭摘要日志打印。 | false |
tracer_global_rolling_policy | SOFATracer 日志的滚动策略 |
|
tracer_global_log_reserve_day | SOFATracer 日志的保留天数 | 默认保留 |
stat_log_interval | 统计日志的时间间隔，单位：秒 | 默认 |
tracer_penetrate_attribute_max_length | 透传数据能够允许存放的最大长度 | 默认 |
tracer_async_appender_allow_discard | 是否允许丢失日志 | false |
tracer_async_appender_is_out_discard_number | 丢失日志数 | 0 |
spring.application.name | 应用名 | - |
tracer_sampler_strategy_name_key | 采样策略名 | - |
tracer_sampler_strategy_custom_rule_class_name | 采样规则 spi 实现的类的全限定名 | - |
tracer_sampler_strategy_percentage_key | 采样比率 | - |
com.alipay.sofa.tracer.JSONOutput | 是否以 JSON 格式输出日志 | true，如果期望较少日志空间占用，可以使用非 JSON 格式输出（日志顺序与 JSON 格式顺序一致） |