springcloud微服務-sentinel

sentinel作用，流量防衛兵

 

 

 

sentinel官方文檔地址：https://github.com/alibaba/Sentinel/wiki

 

sentine入門

1.引入pom依賴

 

 

 2.定義資源，注解模式為@SentinelResource

　　

 

 

 

 

 

 

 

 3.定義規則

　　

 

 

 4.檢查效果，日志文件中會打印相應的流控效果數據

　　

 

 

 5.啟動控制台，在控制台進行流控效果可視化查看

　　1.guthub下載源碼

　　2.啟動sentinel-dashboard，並加上啟動參數

　　java -Dserver.port=8080 -Dcsp.sentinel.dashboard.server=localhost:8080 -Dproject.name=sentinel-dashboard -jar sentinel-dashboard.jar

　　3.客戶端接入控制台

　　　　1）引入pom依賴　

　　　　　　<dependency>
   　　　　　　 <groupId>com.alibaba.csp</groupId> 　　　　 　　<artifactId>sentinel-transport-simple-http</artifactId> 　　　　　　 <version>x.y.z</version> 　　　　　　</dependency>

　　　　2）配置JVM啟動參數

　　　　　　-Dcsp.sentinel.dashboard.server=localhost:8080

　　　　　　-Dcsp.sentinel.api.port=8719

 

 

sentinel流控規則默認存儲在內存中，服務重啟就會丟失，需要配合持久化組件使用，比如apollo，db，redis等

 

sentinel注解模式

　　@SentinelResource(value="xxx",blockHandler="xxx", fallback="xxx"，defaultFallback=“xxx”，exceptionsToIgnore={xxx.class}，blockHandlerClass={xxx.class})

　　1.引入pom依賴　　　

　　　　<dependency>
    　　　　<groupId>com.alibaba.csp</groupId> 　　　　<artifactId>sentinel-annotation-aspectj</artifactId> 　　　　 <version>x.y.z</version> 　　　　</dependency>

　　2.注入bean

　　　　@Bean

　　    public SentinelResourceAspect sentinelResourceAspect() {
     　　   return new SentinelResourceAspect(); 

   　　 }　　

 

　　注意點：

　　1）value定義資源名稱，blockHandler處理block異常，fallback處理所有異常,defaultFallback指定默認公共異常處理邏輯

　　2）如果同時配置blockHandler和fallback，對於block異常只會走blockHandler，如果blockHandler，fallback，defaultFallback三者都沒有，則直接拋出異常

　　3）1.6版本之后，fallback函數可以處理業務異常，之前只能處理degradeException

　　4)blockHandler必須和原函數在同一個類，如果希望在另外一個類，則使用blockHandlerClass，且必須是static修飾

　　

@SentinelResource 用於定義資源，並提供可選的異常處理和 fallback 配置項。 @SentinelResource 注解包含以下屬性：

• value：資源名稱，必需項（不能為空）
• entryType：entry 類型，可選項（默認為 EntryType.OUT）
• blockHandler / blockHandlerClass: blockHandler 對應處理 BlockException 的函數名稱，可選項。blockHandler 函數訪問范圍需要是 public，返回類型需要與原方法相匹配，參數類型需要和原方法相匹配並且最后加一個額外的參數，類型為 BlockException。blockHandler 函數默認需要和原方法在同一個類中。若希望使用其他類的函數，則可以指定 blockHandlerClass 為對應的類的 Class 對象，注意對應的函數必需為 static 函數，否則無法解析。
• fallback / fallbackClass：fallback 函數名稱，可選項，用於在拋出異常的時候提供 fallback 處理邏輯。fallback 函數可以針對所有類型的異常（除了 exceptionsToIgnore 里面排除掉的異常類型）進行處理。fallback 函數簽名和位置要求：
  • 返回值類型必須與原函數返回值類型一致；
  • 方法參數列表需要和原函數一致，或者可以額外多一個 Throwable 類型的參數用於接收對應的異常。
  • fallback 函數默認需要和原方法在同一個類中。若希望使用其他類的函數，則可以指定 fallbackClass 為對應的類的 Class 對象，注意對應的函數必需為 static 函數，否則無法解析。
• defaultFallback（since 1.6.0）：默認的 fallback 函數名稱，可選項，通常用於通用的 fallback 邏輯（即可以用於很多服務或方法）。默認 fallback 函數可以針對所有類型的異常（除了 exceptionsToIgnore 里面排除掉的異常類型）進行處理。若同時配置了 fallback 和 defaultFallback，則只有 fallback 會生效。defaultFallback 函數簽名要求：
  • 返回值類型必須與原函數返回值類型一致；
  • 方法參數列表需要為空，或者可以額外多一個 Throwable 類型的參數用於接收對應的異常。
  • defaultFallback 函數默認需要和原方法在同一個類中。若希望使用其他類的函數，則可以指定 fallbackClass 為對應的類的 Class 對象，注意對應的函數必需為 static 函數，否則無法解析。
• exceptionsToIgnore（since 1.6.0）：用於指定哪些異常被排除掉，不會計入異常統計中，也不會進入 fallback 邏輯中，而是會原樣拋出。

注：1.6.0 之前的版本 fallback 函數只針對降級異常（DegradeException）進行處理，不能針對業務異常進行處理。

特別地，若 blockHandler 和 fallback 都進行了配置，則被限流降級而拋出 BlockException 時只會進入 blockHandler 處理邏輯。若未配置 blockHandler、fallback 和 defaultFallback，則被限流降級時會將 BlockException 直接拋出（若方法本身未定義 throws BlockException 則會被 JVM 包裝一層 UndeclaredThrowableException）。

示例：

public class TestService {

    // 對應的 `handleException` 函數需要位於 `ExceptionUtil` 類中，並且必須為 static 函數.
    @SentinelResource(value = "test", blockHandler = "handleException", blockHandlerClass = {ExceptionUtil.class})
    public void test() {
        System.out.println("Test");
    }

    // 原函數
    @SentinelResource(value = "hello", blockHandler = "exceptionHandler", fallback = "helloFallback")
    public String hello(long s) {
        return String.format("Hello at %d", s);
    }
    
    // Fallback 函數，函數簽名與原函數一致或加一個 Throwable 類型的參數.
    public String helloFallback(long s) {
        return String.format("Halooooo %d", s);
    }

    // Block 異常處理函數，參數最后多一個 BlockException，其余與原函數一致.
    public String exceptionHandler(long s, BlockException ex) {
        // Do some log here.
        ex.printStackTrace();
        return "Oops, error occurred at " + s;
    }
}

從 1.4.0 版本開始，注解方式定義資源支持自動統計業務異常，無需手動調用 Tracer.trace(ex) 來記錄業務異常。Sentinel 1.4.0 以前的版本需要自行調用 Tracer.trace(ex) 來記錄業務異常。

配置

Spring Cloud Alibaba

若您是通過 Spring Cloud Alibaba 接入的 Sentinel，則無需額外進行配置即可使用 @SentinelResource 注解。

Spring AOP

若您的應用使用了 Spring AOP（無論是 Spring Boot 還是傳統 Spring 應用），您需要通過配置的方式將 SentinelResourceAspect 注冊為一個 Spring Bean：

@Configuration
public class SentinelAspectConfiguration {

    @Bean
    public SentinelResourceAspect sentinelResourceAspect() {
        return new SentinelResourceAspect();
    }
}

我們提供了 Spring AOP 的示例，可以參見 sentinel-demo-annotation-spring-aop。

AspectJ

若您的應用直接使用了 AspectJ，那么您需要在 aop.xml 文件中引入對應的 Aspect：

<aspects>
    <aspect name="com.alibaba.csp.sentinel.annotation.aspectj.SentinelResourceAspect"/> </aspects>

 

sentinel集成dubbo

　　1.引入pom依賴：

 

 

sentinel集成rocketmq（沒講清楚）

 

sentinel集群流控

 不太成熟，無法解決高可用和server性能問題，生產環境不要使用，用gateway進行集群流控

 

生產環境下使用sentinel

　　1）原始模式    基於內存，不支持持久化，嚴重不建議在生產環境使用，故需要結合持久化組件

　　2）pull模式     客戶端向規則管理中心主動拉取，缺點是不能保證實時性

　　3）push模式，生產環境一般使用這種模式，需要引用第三方依賴

 

apollo入門：

　　1.官方文檔：https://github.com/ctripcorp/apollo/wiki

　　2.使用步驟：

　　　　1）jdk1.8以上

　　　　2）mysql5.6.5以上，apollo持久化依賴於mysql

　　　　3）下載quick start 安裝包

　　　　

 

 

 　　　　4）創建數據庫

　　　　　　

 

 

 　　　　5）修改數據庫連接信息

　　　　　　

 

 

 　　　　6）啟動apollo配置中心　

　　　　　　　　

 

 

 

　

　　　　　　

 

 

 　　　　7）訪問apollo,默認用戶名密碼都是apollo

　　　　　　

 

 

 

 3.搭建apollo-client

　　1）引入pom依賴

　　　　

　　2）啟動類加上@EnableApolloConfig，開啟apollo客戶端

　　3）配置文件

　　　　

 

 

 　　4）控制台創建項目，app-id要與配置文件保持一致

　　　　

 

 

 　　　　5）新增或配置

　　　　6）發布

　　　　　　

 

 

 

Apollo開放平台

　　

 

 

 第三方應用接入開放平台的步驟

　　　

 

 

 　　　　

 

 

 

　　　　創建第三方應用：　　　　

　　　　

　　　　賦權：

 　　　　　　

 

 　　第三方應用調用open api進行配置項管理

　　　　

 

 　　　　　　

 

 　　然后查閱官方api文檔進行http請求即可

 

sentinel整合apollo進行規則持久化(看不懂)