This topic explains how to view and specify the MSE Microservices Governance agent version.
View the MSE agent version
-
Log on to the MSE console, and select a region in the top navigation bar.
-
In the left-side navigation pane, choose Microservices Governance > Application Governance.
-
On the Application list page, click the resource card of the desired application.
-
In the left-side navigation pane, click Node details.
-
In the All Nodes section, click the target node. You can view the Probe Version in the Basic Information section.
Specify agent version with ack-onepilot
Prerequisites
The ack-onepilot component must be version 3.0.16 or later. If you are using an earlier version, see Install and update the Microservices Governance component.
Procedure
If you do not specify an agent version, the latest stable version is used by default. If you specify a version, that version is used instead. The download URLs are formatted as follows:
-
Public endpoint:
http://arms-apm-${regionId}.oss-${regionId}.aliyuncs.com/${agentVersion}/ArmsAgent.zip -
Internal endpoint:
http://arms-apm-${regionId}.oss-${regionId}-internal.aliyuncs.com/${agentVersion}/ArmsAgent.zip
-
In the Pod that you want to connect to, use Labels
aliyun.com/agent-version: agent versionto specify the agent version.For example, to specify agent version 4.2.5 for a Pod, add the following labels to the Deployment's YAML file:
spec: template: metadata: labels: aliyun.com/agent-version: "4.2.5" mseNamespace: "default" # The MSE microservice namespace to which your application belongs. msePilotCreateAppName: "<yourAppName>" # Replace with the actual application name.Note-
For a list of agent versions and key features, see Java agent release notes.
-
Before you configure the version, download the agent package to confirm that the version exists.
-
-
After you apply the changes and restart your application, verify the agent version on the Node details page.
Specify agent version for ECS
When using an ECS instance, specify the agent version by downloading the desired package before you connect your application to MSE. For more information, see Connect an ECS microservice to Microservices Governance.
The agent download URLs are as follows:
-
Public endpoint:
http://arms-apm-${regionId}.oss-${regionId}.aliyuncs.com/${agentVersion}/ArmsAgent.zip -
Internal endpoint:
http://arms-apm-${regionId}.oss-${regionId}-internal.aliyuncs.com/${agentVersion}/ArmsAgent.zip
-
regionIdis the ID of the region, for example,cn-hangzhouorap-southeast-1. For more information, see Supported regions. -
agentVersionis the version of the agent, for example,4.2.5. For more information, see Java agent release notes. -
In an Alibaba Cloud VPC, use the internal endpoint. In other environments, use the public endpoint to download the agent.
-
The download URL for the China (Hangzhou) Finance region is different. You can submit a ticket to request a specific version.