すべてのプロダクト
Search
ドキュメントセンター

Microservices Engine:エージェントバージョンの指定

最終更新日:Jul 22, 2025

このトピックでは、Microservices Engine (MSE) で Microservices Governance エージェントのバージョンを指定する方法について説明します。

MSE エージェントのバージョンを表示する

  1. MSE コンソール にログインし、上部のナビゲーションバーでリージョンを選択します。

  2. 左側のナビゲーションウィンドウで、Microservices Governance > Application Governance を選択します。

  3. Application list ページで、目的のアプリケーションのリソースカードをクリックします。

  4. 左側のナビゲーションウィンドウで、Node details をクリックします。

  5. All Nodes セクションで、目的のノードをクリックします。Basic Information タブで、Probe Version 列のエージェントバージョンを表示します。

    image

ack-onepilot コンポーネントを使用してエージェントバージョンを指定する

前提条件

バージョン 3.0.16 以降の ack-onepilot コンポーネントがインストールされています。インストールされている ack-onepilot コンポーネントのバージョンが 3.0.16 以前の場合は、「マイクロサービスガバナンスコンポーネントのインストールと更新」の手順に従ってコンポーネントをアップグレードしてください。

手順

エージェントバージョンを指定しない場合は、最新の安定バージョンのエージェントが使用されます。エージェントバージョンを指定する場合は、指定したバージョンのエージェントを使用して、アプリケーションのマイクロサービスガバナンスを有効にします。エージェントパッケージは、次のエンドポイントのいずれかからダウンロードできます。

  • パブリックエンドポイント: http://arms-apm-${regionId}.oss-${regionId}.aliyuncs.com/${agentVersion}/ArmsAgent.zip

  • 内部エンドポイント: http://arms-apm-${regionId}.oss-${regionId}-internal.aliyuncs.com/${agentVersion}/ArmsAgent.zip

  1. アプリケーションが存在するポッドについて、ラベルに aliyun.com/agent-version: agent version を設定して、エージェントバージョンを指定します。

    バージョン 4.2.5 のエージェントをポッドに使用する場合、デプロイメントの YAML ファイルにラベルを追加します。サンプルコード:

    spec:
     template:
       metadata:
         labels:
           aliyun.com/agent-version: "4.2.5"
           mseNamespace: "default" # アプリケーションが属する MSE マイクロサービス名前空間。
           msePilotCreateAppName: "<yourAppName>" # <yourAppName> をアプリケーションの実際の名前に置き換えます。

    説明
    • エージェントのバージョンと機能の詳細については、「Java エージェントバージョン」をご参照ください。

    • エージェントバージョンを指定する前に、エージェントパッケージを手動でダウンロードし、必要なエージェントバージョンが存在することを確認することをお勧めします。

  2. 前の手順を完了してアプリケーションを再起動した後、アプリケーションの [ノードの詳細] ページで使用中のエージェントバージョンを確認します。

    image

ECS インスタンスを使用してエージェントバージョンを指定する

ECS インスタンスを使用してマイクロサービスガバナンスを有効にする場合は、必要なバージョンのエージェントパッケージをダウンロードし、アプリケーションのマイクロサービスガバナンスを有効にすることができます。詳細については、「ECS インスタンス上のマイクロサービスアプリケーションのマイクロサービスガバナンスを有効にする」をご参照ください。

エージェントパッケージは、次のエンドポイントのいずれかからダウンロードできます。

  • パブリックエンドポイント: http://arms-apm-${regionId}.oss-${regionId}.aliyuncs.com/${agentVersion}/ArmsAgent.zip

  • 内部エンドポイント: http://arms-apm-${regionId}.oss-${regionId}-internal.aliyuncs.com/${agentVersion}/ArmsAgent.zip

説明
  • エンドポイントでは、regionId はリージョンの ID を指定します。例: cn-hangzhou、ap-southeast-1。詳細については、「サポートされているリージョン」をご参照ください。

  • agentVersion はエージェントバージョンを指定します。例: 4.2.5。詳細については、「Java エージェントバージョン」をご参照ください。

  • 仮想プライベートクラウド (VPC) 環境では、内部エンドポイントを使用してエージェントにアクセスできます。非 VPC 環境では、パブリックエンドポイントを使用してエージェントパッケージをダウンロードすることをお勧めします。

  • 中国東部 1 金融リージョンのアプリケーション用に指定されたバージョンの MSE エージェントパッケージをダウンロードするには、チケットを送信 してください。