当需要了解 Java 应用正在使用的 Agent 探针版本或控制探针升级时，可通过探针版本管理查看版本风险和应用版本分布，并按应用接入方式选择更新模式和目标版本。本文介绍查看探针及节点版本信息、为应用设置探针版本，以及设置后的生效方式和限制。
适用的应用接入方式
Java 应用通过以下方式接入 Agent 探针，不同接入方式支持的版本设置方式不同：
K8s 自动注入：安装 ack-onepilot 组件后，由组件自动注入和管理应用探针。组件的安装和升级方法，请参见安装和升级MSE微服务治理组件。
手动安装：下载探针，并在启动 Java 应用时通过命令行注入。
选择探针版本和更新模式
探针版本提供自动更新和手动管理两种更新模式，默认使用自动更新；需要固定探针版本的应用，选择手动管理并指定目标版本。
更新模式 | 说明 | 适用的接入方式 |
自动更新（默认） | 由 ack-onepilot 组件自动管理应用的探针版本。 | K8s 自动注入 |
手动管理 | 为应用选择目标探针版本。 | K8s 自动注入、手动安装 |
手动安装的应用探针不支持自动更新。
在探针版本管理页面，已发布的探针版本会显示正常或过期状态、发布日期和版本说明。版本状态根据发布时间和 LTS 标识确定；过期版本存在风险，在选择目标版本时置灰且不可选。有关各版本的发布说明，请参见Java探针版本。
查看探针版本信息
查看版本列表
登录MSE 治理中心控制台。
从左侧导航栏选择微服务治理 > 运维中心 > 探针版本管理。
查看已发布探针版本的状态、发布日期和版本说明，支持按状态筛选版本、查看版本详情或下载对应版本的探针文件。
查看应用的版本分布
在探针版本管理页面单击版本统计。
选择命名空间，查看该命名空间下各应用的探针版本分布。
查看各版本的应用数量和节点数量、过期版本占比，以及使用过期版本的应用列表。
版本统计数据来自探针的心跳上报。
查看应用节点的探针状态
选择目标应用，查看节点列表和每个节点正在运行的探针版本。
按版本或状态筛选节点，或者按节点名称搜索指定节点。
节点的探针状态根据目标版本与当前运行版本是否一致判断；心跳超时的节点会标记为异常。
设置应用的探针版本
设置探针版本前，需要拥有目标应用的写权限；批量设置时，需要拥有所有选中应用的写权限。
探针版本设置操作不可撤销。若需将应用切换到其他版本，请重新设置为手动管理，选择另一个状态为正常的目标版本，并按应用接入方式完成重启或替换探针。
为 K8s 应用启用自动更新
此方式适用于通过 ack-onepilot 自动注入探针的 K8s 应用。
在探针版本管理页面选择一个或多个 K8s 应用。
将更新模式设置为自动更新。
确认设置，系统会更新应用的探针版本配置。
设置完成后，按照查看应用节点的探针状态确认目标版本与当前运行版本是否一致。
为 K8s 应用指定目标版本
此方式适用于需要固定探针版本的 K8s 应用。
在探针版本管理页面选择一个或多个 K8s 应用。
将更新模式设置为手动管理。
选择目标探针版本，仅可选择状态为正常的版本。
确认设置后，系统会更新应用的探针版本配置，并提示重启应用。
重启应用，使新的探针版本生效。有关升级操作，请参见升级MSE探针。
重启完成后，按照查看应用节点的探针状态确认目标版本与当前运行版本是否一致。
为手动安装的应用指定目标版本
手动安装的应用仅支持手动管理，不能设置为自动更新。
在探针版本管理页面选择手动安装探针的应用。
将更新模式设置为手动管理。
选择目标探针版本，仅可选择状态为正常的版本。
确认设置后，根据页面提供的下载链接下载对应版本的探针，并替换原探针。
有关下载和替换探针的操作，请参见升级MSE探针。替换探针后，按照查看应用节点的探针状态确认目标版本与当前运行版本是否一致。
批量设置探针版本
批量设置时，可以选择多个应用，或通过全选、按条件筛选后统一设置目标探针版本。操作完成后，页面会显示设置成功和失败的应用列表；部分应用设置失败时，会提示失败原因。
单次批量设置最多支持 100 个应用。
配置优先级
如果应用的 YAML 已指定探针版本，YAML 配置优先级高于探针版本管理页面的设置。通过 YAML 指定探针版本的方法，请参见指定MSE探针版本。
更新失败处理
如果探针版本更新因应用已配置灰度规则等原因失败，请提交工单，由技术支持人员协助更新。