ECS マイクロサービスアプリケーションの MSE ガバナンスセンターへの接続 - Microservices Engine

Microservices Engine (MSE) は、コードを変更することなく、既存の Spring Cloud または Dubbo アプリケーションにガバナンス機能を追加する Java エージェントを提供します。このエージェントは、アプリケーションの JVM にアタッチされ、ランタイムでサービスの呼び出しをインターセプトし、MSE コンソールで設定したガバナンスポリシーを適用します。

このガイドでは、MSE Java エージェントのダウンロード、Elastic Compute Service (ECS) インスタンスでの設定、および接続の検証手順を説明します。同じ手順は、Alibaba Cloud 以外の仮想マシン (VM) 上のアプリケーションにも適用されます。

エージェントの仕組み

MSE Java エージェントは、JVM プラグイン (-javaagent) として実行されます。起動時に、リージョン固有のライセンスキーを使用して MSE コントロールプレーンで認証を行い、インバウンドおよびアウトバウンドのサービス呼び出しをインターセプトしてガバナンスポリシーを適用します。エージェントはアプリケーションメタデータを MSE コンソールにレポートし、アプリケーションは [マイクロサービスガバナンス] > [アプリケーションガバナンス] の下に表示されます。

MSE と Application Real-Time Monitoring Service (ARMS) は同じ基盤となるエージェントを共有しているため、両方のサービスを使用する場合、単一の -javaagent 添付ファイルでガバナンスとモニタリングの両方が処理されます。

前提条件

開始する前に、以下のものがあることを確認してください：

ECS インスタンス。詳細については、「ECS インスタンスの作成」をご参照ください。
JAVA_HOME 環境変数が設定された Java 開発キット (JDK) がインストールされていること。ダウンロードリンクについては、「Java ダウンロード」をご参照ください。
JVM ヒープメモリが 256 MB を超えていること。MSE Java エージェントは、これより小さいヒープでは起動できません。
ご利用の ECS インスタンスと同じリージョンに MSE マイクロサービスガバナンスインスタンスがあること。ライセンスキーはリージョン固有であるため、リージョンが一致しない場合、エージェントの認証は失敗します。

説明

MSE マイクロサービスガバナンスには、Basic Edition、Professional Edition、Enterprise Edition の 3 つのエディションがあります。ガバナンス要件に合ったエディションを選択してください。

ステップ 1：MSE Java エージェントのダウンロード

ECS コンソールにログインします。
左側のナビゲーションウィンドウで、[インスタンス & イメージ] > [インスタンス] を選択します。
上部のナビゲーションバーで、[リージョン] を選択します。
[インスタンス] ページで、マイクロサービスガバナンスを有効にするインスタンスを見つけ、[アクション] 列の [接続] をクリックします。
[リモート接続] ダイアログボックスで、接続方法を選択します。詳細については、「ECS インスタンスへの接続方法」をご参照ください。
エージェントパッケージをダウンロードします。${regionId} を実際のリージョン ID (例：cn-hangzhou) に置き換えます。サポートされているリージョン ID の完全なリストについては、「サポートされているリージョン」をご参照ください。インターネット経由でダウンロード： VPC 経由でダウンロード (インスタンスがインターネットにアクセスできない場合に推奨)： たとえば、中国 (杭州) リージョンでインターネット経由でエージェントをダウンロードする場合：
```
   wget http://arms-apm-${regionId}.oss-${regionId}.aliyuncs.com/AliyunJavaAgent.zip \
     -O AliyunJavaAgent.zip
```
```
   wget http://arms-apm-${regionId}.oss-${regionId}-internal.aliyuncs.com/AliyunJavaAgent.zip \
     -O AliyunJavaAgent.zip
```
```
   wget http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/AliyunJavaAgent.zip \
     -O AliyunJavaAgent.zip
```

重要

エージェントパッケージはリージョン固有です。常にマイクロサービスガバナンスインスタンスのリージョンに一致するパッケージをダウンロードしてください。

ステップ 2：エージェントのインストールと設定

エージェントパッケージを任意のディレクトリに展開します。<your-install-dir> を実際のディレクトリパス (例：/opt/mse) に置き換えます。
```
   unzip AliyunJavaAgent.zip -d /<your-install-dir>/
```

次の JVM パラメーターをアプリケーションの起動コマンドに追加します。次のプレースホルダーを実際の値に置き換えてください：

重要

JVM ヒープメモリは 256 MB を超えている必要があります。これより小さいヒープではエージェントは起動に失敗します。

プレースホルダー	説明	例
`<your-install-dir>`	エージェントを展開したディレクトリ	`/opt/mse`
`<your-license-key>`	MSE コンソールのライセンスキー。[マイクロサービスガバナンス] > [概要] ページで確認できます。このキーは共有しないでください。	`abcdef1234****`
`<your-app-name>`	MSE コンソールでアプリケーションを識別するための名前	`order-service`

   java \
     -javaagent:/<your-install-dir>/AliyunJavaAgent/aliyun-java-agent.jar \
     -Dmse.licenseKey=<your-license-key> \
     -Dmse.appName=<your-app-name> \
     -Dprofiler.micro.service.mse.version=pro \
     -Dmse.namespace=default \
     -Dmse.enable=true \
     -jar application.jar

パラメーターリファレンス

パラメーター	説明
`mse.licenseKey`	MSE によって生成されたライセンスキー。[マイクロサービスガバナンス] の [概要] ページで確認できます。リージョン固有です。機密情報として扱ってください。
`mse.appName`	MSE コンソールでのアプリケーションの表示名。
`profiler.micro.service.mse.version`	有効にするガバナンスのエディション。有効な値：`base` (Basic Edition)、`pro` (Professional Edition)、`ent` (Enterprise Edition)。
`mse.namespace`	このアプリケーションが属するガバナンスの名前空間。利用可能な名前空間は MSE コンソールでクエリできます。
`mse.enable`	`true` に設定するとガバナンスが有効になり、`false` に設定すると無効になります。

アプリケーションがすでに ARMS を使用している場合

MSE と ARMS は同じ Java エージェントを共有します。起動コマンドに ARMS 用の -javaagent パラメーターがすでに存在する場合、再度追加しないでください。MSE 固有のパラメーター (mse.licenseKey、mse.appName、profiler.micro.service.mse.version、mse.namespace、および mse.enable) のみを既存のコマンドに追加します。

ステップ 3：接続の検証

MSE コンソールにログインします。
上部のナビゲーションバーで、アプリケーションのデプロイメントリージョンと一致するリージョンを選択します。
左側のナビゲーションウィンドウで、[マイクロサービスガバナンス] > [アプリケーションガバナンス] を選択します。
アプリケーションがアプリケーションリストに表示されることを確認します。表示されていれば、エージェントは接続されており、ガバナンスはアクティブな状態です。

次のステップ

マイクロサービスガバナンスを有効にすると、MSE コンソールから Spring Cloud または Dubbo アプリケーションを管理できます。MSE が提供するガバナンス機能を使用して、オンラインのマイクロサービスアプリケーションの安定性と開発効率を向上させます。