Microservices Engine：如何在微服務治理中添加自訂介面

限制條件

• 請確保您的MSE Java探針版本為3.2.9或以上。

說明

目前線上版本參考探針版本說明，如有需要也可以參考指定MSE探針版本來指定版本。

• 目前由於編程模式的限制，只有具有流量的自訂介面才能在微服務治理中展示。

操作步驟

在您的應用已經接入MSE微服務治理的情況下，您可以按照如下操作來添加自訂介面。

1. 在應用的pom.xml檔案中添加以下依賴：

   <dependency>
     <groupId>com.alibaba.csp</groupId>
     <artifactId>sentinel-core</artifactId>
     <version>1.8.7</version>
   </dependency>

2. 添加埋點。將您的商務邏輯使用以下進行封裝：

   import com.alibaba.csp.sentinel.Entry;
   import com.alibaba.csp.sentinel.SphU;
   import com.alibaba.csp.sentinel.slots.block.BlockException;
   import com.alibaba.csp.sentinel.EntryType;
   // HelloWorld為該調用資源名稱，控制台上監控頁面、介面列表會顯示該資源。
   // 配置規則的時候也是針對某個資源名稱配置。
   // EntryType.IN標識該資源為入口資源。
   try (Entry entry = SphU.entry("HelloWorld", EntryType.IN)) {
    // 被保護的商務邏輯。
    System.out.println("Hello MSE Sentinel!");
   } catch (BlockException e) {
    // 觸發流控降級，在此處進行限流處理（如Fallback或記錄日誌）。
   }

   說明

   • EntryType用於區分該資源是入口流量（Inbound）還是出口流量（Outbound）。EntryType.IN代表入口流量，EntryType.OUT代表出口流量。系統規則只對入口資源生效。

   • 控制台展示的監控的應用總流量僅統計EntryType.IN的流量。

   • 自訂埋點的資源名稱最長不能超過1024個字元。

   • 自訂埋點的資源名中符號只建議使用-或_或.或:。

結果驗證

登入MSE治理中心控制台。在左側導覽列選擇治理中心 > 應用治理。若在應用治理頁面出現該應用的資源卡片且有資料上報，說明接入成功。

同時，如果您配置的自訂介面有流量，那麼在對應應用的自訂介面頁簽中，可以看到您自訂的介面。

進入應用的介面詳情頁面，選擇自訂介面頁簽，左側列出各自訂介面及其請求量、成功率等指標，右側展示所選介面的QPS和最大並發監控曲線。

相關文檔

您可以對自訂介面進行流量防護，具體操作，請參見配置流控規則、配置隔離規則、配置熔斷規則。