Microservices Engine:マイクロサービスガバナンスへのカスタムインターフェイスの追加

前提条件

開始する前に、以下の条件を満たしていることを確認してください。

• マイクロサービスガバナンスが有効化されたアプリケーション

• MSE Java エージェント バージョン 3.2.9 以降

可視化にはトラフィックが必要

プログラミングパターンの制約により、マイクロサービスガバナンスではトラフィックを受信したカスタムインターフェイスのみが表示されます。イベントトラッキング済みのコードブロックが呼び出されていない場合、コンソールには表示されません。

SDK の依存関係を追加

pom.xml に Sentinel コアライブラリを追加します。

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

ビジネスロジックのラップ

SphU.entry() を try-with-resources ブロック内で使用して、コードセクションを Sentinel リソースとして登録します。リソース名は、MSE コンソール上のモニタリングページおよびインターフェイス一覧でこのインターフェイスを識別するための名称です。

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」は、モニタリングページおよび MSE コンソールのインターフェイス一覧に表示されるリソース名です。
// EntryType.IN は、インバウンドトラフィック向けの流入リソースであることを示します。
try (Entry entry = SphU.entry("HelloWorld", EntryType.IN)) {
    // 保護対象のビジネスロジック
    System.out.println("Hello MSE Sentinel!");
} catch (BlockException e) {
    // 速度制限またはサーキットブレーカーがトリガーされました。
    // フォールバック応答を返すか、イベントをログに記録してください。
}

try-with-resources パターンにより、ブロック終了時に自動的にエントリが解放されます。これにより、finally ブロック内で entry.exit() を手動で呼び出す際に発生する可能性のあるリソースリークを防止できます。

結果の確認

1. MSE コンソール にログインします。

2. 左側のナビゲーションウィンドウで、マイクロサービスガバナンス ＞ アプリケーションガバナンス を選択します。

3. アプリケーション一覧 ページで、ご利用のアプリケーションのリソースカードが表示され、データを報告していることを確認します。

   

4. カスタムインターフェイスに対してトラフィックを生成し、インターフェイスの詳細ページを開いて カスタムインターフェイス タブを選択し、インターフェイスが一覧に表示されていることを確認します。

次のステップ

カスタムインターフェイスにガバナンスルールを適用します。

• 速度制限ルールの作成

• 隔離ルールの作成

• サーキットブレーカールールの作成