目录
  • SpringBoot集成feign配置全局log
    • 概述
    • 设置Feign接口日志级别为FULL
  • feign常用配置
    • Feign的组成
    • 首先如何整合Feign
    • 如何给Feign添加日志级别
      • 细粒度
      • 全局配置
    • Feign支持的配置项
      • Ribbon配置 VS Feign配置
        • Feign 代码方式 VS 配置属性方式

        SpringBoot集成feign配置全局log

        概述

        项目里使用了Feign进行远程调用,有时为了问题排查,需要开启请求和响应日志,下面简介一下如何开启Feign日志

        设置Feign接口日志级别为FULL

        在application.yml添加log配置

        方式一: 在启动类路径设置debug级别的日志(推荐)

        logging:
          level:
            com.example.demo: debug 

        方式二: 在配置@FeignClien的类径设置debug级别的日志

        logging:
          level:
            com.example.demo.feign.DemoFeignClient: debug 

        配置feign的日志级别

        方式一: 在application.yml配置(推荐)

        feign.client.config.default.loggerLevel: full

        方式二: 使用@Configuration配置类完成配置

        @Configuration
        public class FeignConfiguration {
          @Bean
          public Logger.Level level() { return Logger.Level.FULL; }
        }

        Feign日志级别

        • NONE,无记录(DEFAULT)。
        • BASIC,只记录请求方法和URL以及响应状态代码和执行时间。
        • HEADERS,记录基本信息以及请求和响应标头。
        • FULL,记录请求和响应的头文件,正文和元数据

        feign常用配置

        Feign的组成

        日志级别 打印内容
        NONE(默认) 不记录任何日志
        BASIC 仅记录请求方法,URL,响应状态代码以及执行时间(适合生产环境)
        HEADERS 记录BASIC级别的基础上,记录请求和响应的header
        FULL 记录请求和弦ineader,body和元数据

        首先如何整合Feign

        遵循SpringBoot的三板斧第一步:加依赖

        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-openfeign</artifactId>
        </dependency>

        第二步:写注解

        @EnableFeignClients //在启动类上加

        第三步:写配置

        如何给Feign添加日志级别

        细粒度

        方式一:代码实现第一步

        添加Feign配置类,可以添加在主类下,但是不用添加@Configuration。如果添加了@Configuration而且又放在了主类之下,那么就会所有Feign客户端实例共享,同Ribbon配置类一样父子上下文加载冲突;如果一定添加@Configuration,就放在主类加载之外的包。建议还是不用加@Configuration。

        public class FeignConfig {
            @Bean
            public Logger.Level Logger() {
                return Logger.Level.FULL;
            }
        }

        第二步:给@FeignClient添加配置类

        //@FeignClient configuration = GoodsFeignConfig.class 细粒度配置,指定配置类
        @FeignClient(name = "goods", configuration = FeignConfig.class)

        第三步:写配置

        logging:
          level:
            com.xxx.xxx.FeignAPI: DEBUG #需要将FeignClient接口全路径写上# 开启日志 格式为logging.level. Feign客户端路径

        方式二:配置属性实现

        feign:
          client:
            config:
              #想要调用的微服务名称
              server-1:
                loggerLevel: FULL

        全局配置

        方式一:代码实现添加了@Configuration放在了主类之下,那么就会所有Feign客户端实例共享,同Ribbon配置类一样父子上下文加载冲突;让父子上下文ComponentScan重叠(强烈不建议)唯一正确方式

        //在启动类上为@EnableFeignClients注解添加defaultConfiguration配置
        @EnableFeignClients(defaultConfiguration = FeignConfig.class)

        方式二:配置属性实现

        feign:
          client:
            config:
              #将调用的微服务名称改成default就配置成全局的了
              default:
                loggerLevel: FULL

        Feign支持的配置项

        代码方式

        配置项 作用
        Logger.Level 指定日志级别
        Retryer 指定重试策略
        ErrorDecoder 指定错误解码器
        Request.Options 超时时间
        Collection 拦截器
        SetterFactory 用于设置Hystrix的配置属性,Fgien整合Hystrix才会用

        配置属性

        feign:
          client:
            config:
              feignName:
                connectTimeout: 5000  # 相当于Request.Optionsn 连接超时时间
                readTimeout: 5000     # 相当于Request.Options 读取超时时间
                loggerLevel: full     # 配置Feign的日志级别,相当于代码配置方式中的Logger
                errorDecoder: com.example.SimpleErrorDecoder  # Feign的错误解码器,相当于代码配置方式中的ErrorDecoder
                retryer: com.example.SimpleRetryer  # 配置重试,相当于代码配置方式中的Retryer
                requestInterceptors: # 配置拦截器,相当于代码配置方式中的RequestInterceptor
                  - com.example.FooRequestInterceptor
                  - com.example.BarRequestInterceptor
                # 是否对404错误解码
                decode404: false
                encode: com.example.SimpleEncoder
                decoder: com.example.SimpleDecoder
                contract: com.example.SimpleContract

        Feign还支持对请求和响应进行GZIP压缩,以提高通信效率,配置方式如下:

        # 配置请求GZIP压缩
        feign.compression.request.enabled=true
        # 配置响应GZIP压缩
        feign.compression.response.enabled=true
        # 配置压缩支持的MIME TYPE
        feign.compression.request.mime-types=text/xml,application/xml,application/json
        # 配置压缩数据大小的下限
        feign.compression.request.min-request-size=2048

        Ribbon配置 VS Feign配置

        粒度 Ribbon Feign
        代码局部 @RibbonClient(configuration=RibbonConfig.class),RibbonConfig类必须加@Configuration,且必须放在父上下文无法扫到的包下 @FeignClient(configuration=FeignConfig.class),FeignConfig类的@Configuration可以不加(可选),如果有,必须放在父上下文无法扫到的包下
        代码全局 @RibbonClients(defaultConfigurtion=RibbonConfig.class) @EnableFeignClients(defaultConfiguration = FeignConfig.class)…
        配置属性局部 .ribbon.NFLoadBalancerClassName… feign.client.config..loggerLevel…
        配置属性全局 feign.client.config.default.loggerLevel

        Feign 代码方式 VS 配置属性方式

        配置方式 有点 缺点
        代码配置 基于代码,更加灵活 如果Feign的配置类加了@Configuration注解,需注意父子上下文,线上修改需要重打包,发布
        属性配置 易上手配置更加直观线上修改无需重新打包,发布优先级更高 极端场景下没有代码配置更加灵活

        优先级:细粒度属性配置 > 细粒度代码配置 > 全局属性配置 > 全局代码配置

        以上为个人经验,希望能给大家一个参考,也希望大家多多支持。

        声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。