ack-onepilot组件介绍、使用说明及变更记录_容器服务 Kubernetes 版 ACK(ACK)-阿里云帮助中心

ack-onepilot是阿里云ARMS针对Kubernetes应用接入场景提供的探针接入助手。本文介绍ack-onepilot组件的信息、使用说明和变更记录。

组件介绍

ack-onepilot是ACK面向ARMS与MSE用户提供的系统组件，帮助用户更便捷地接入ARMS与MSE。组件提供以下功能。

在容器环境中自动添加探针上报所需的环境变量，并准备探针包，确保在容器环境中能够高效、准确地收集和上报Java、Golang、Python应用的拓扑数据、接口调用、异常事务和慢事务等监控数据。
将部署在集群中的Spring Cloud和Dubbo等微服务应用接入MSE治理中心，使用MSE提供的一系列服务治理能力，提升线上微服务的稳定性和开发效率，

关于ack-onepilot的基本原理，请参见ack-onepilot组件基本原理说明。

使用说明

ack-onepilot接入ARMS：
- ACK集群中的Java应用接入应用监控，请参见容器服务ACK和容器计算服务ACS通过ack-onepilot组件安装Java探针。
- ACK集群中的Golang应用接入应用监控，请参见容器服务ACK和容器计算服务ACS通过ack-onepilot组件安装Go探针。
- ACK集群中的Python应用接入应用监控，请参见容器服务ACK和容器计算服务ACS通过ack-onepilot组件安装Python探针。
ack-onepilot接入MSE，请参见ACK微服务应用接入MSE治理中心。

变更记录

2025年04月

版本号

镜像地址

变更时间

变更内容

变更影响

4.1.1

registry.{REGION}.aliyuncs.com/acs/ack-onepilot:4.1.1

registry.{REGION}.aliyuncs.com/acs/ack-onepilot-init:4.1.1

2025年04月09日

支持在集群命名空间级别指定接入探针的版本。
ARMS EDAS场景（强制指定APPID）下默认不再创建应用。
修复MSE应用画像不上报的问题。

此次升级不会对业务造成影响。

2025年03月

版本号

镜像地址

变更时间

变更内容

变更影响

4.1.0

registry.{REGION}.aliyuncs.com/acs/ack-onepilot:4.1.0

registry.{REGION}.aliyuncs.com/acs/ack-onepilot-init:4.1.0

2025年03月13日

修复注入环境变量乱序问题。
优化POP网络探活逻辑。
修复ARMS接入时关闭开关无效的问题。
支持自定义JAVA_TOOL_OPTIONS接入模式：如何自定义Java探针挂载路径
修复服务治理控制面板资源发现失败的问题。
支持外部节点的日志上报。

此次升级不会对业务造成影响。

2025年02月

版本号

镜像地址

变更时间

变更内容

变更影响

4.0.1

registry.{REGION}.aliyuncs.com/acs/ack-onepilot:4.0.1

registry.{REGION}.aliyuncs.com/acs/ack-onepilot-init:4.0.1

2025年02月27日

修复MSE微服务治理专业版命名空间下应用按照企业版方式接入的问题。

此次升级不会对业务造成影响。

2025年01月

版本号

镜像地址

变更时间

变更内容

变更影响

4.0.0

registry.{REGION}.aliyuncs.com/acs/ack-onepilot:4.0.0

registry.{REGION}.aliyuncs.com/acs/ack-onepilot-init:4.0.0

2025年01月09日

优化ack-onepilot性能。
ARMS不再支持通过Annotation接入。请参见容器服务ACK和容器计算服务ACS通过ack-onepilot组件安装Java探针使用添加Label的方式接入。

此次升级不会对业务造成影响。

2024年12月

版本号

镜像地址

变更时间

变更内容

变更影响

3.3.4

registry.{REGION}.aliyuncs.com/acs/ack-onepilot:3.3.4

registry.{REGION}.aliyuncs.com/acs/ack-onepilot-init:3.3.4

2024年12月26日

兼容老版本arms-pilot存在时用户业务应用启动失败的问题。
修复极端情况下探针包权限修改失败导致启动失败的问题。
去除Python探针接入时的无效逻辑，加快Python探针接入速度。
优化超时时间的相关日志。

此次升级不会对业务造成影响。

2024年11月

版本号

镜像地址

变更时间

变更内容

变更影响

3.3.3

registry.{REGION}.aliyuncs.com/acs/ack-onepilot:3.3.3

registry.{REGION}.aliyuncs.com/acs/ack-onepilot-init:3.3.3

2024年11月21日

适配istio DNS代理场景下的探针接入。
调整ack-onepilot的健康检查时间，加速ack-onepilot的启动。

此次升级不会对业务造成影响。

3.3.2

registry.{REGION}.aliyuncs.com/acs/ack-onepilot:3.3.2

registry.{REGION}.aliyuncs.com/acs/ack-onepilot-init:3.3.2

2024年11月07日

优化未接入MSE时MSE相关的日志和事件提示逻辑。

此次升级不会对业务造成影响。

2024年10月

版本号

镜像地址

变更时间

变更内容

变更影响

3.3.1

registry.{REGION}.aliyuncs.com/acs/ack-onepilot:3.3.1

registry.{REGION}.aliyuncs.com/acs/ack-onepilot-init:3.3.1

2024年10月29日

无损下线Sidecar注入支持跳过。
增加日志上报字段。

此次升级不会对业务造成影响。

版本号

镜像地址

变更时间

变更内容

变更影响

3.3.0

registry.{REGION}.aliyuncs.com/acs/ack-onepilot:3.3.0

registry.{REGION}.aliyuncs.com/acs/ack-onepilot-init:3.3.0

2024年10月11日

支持探针渐进式升级。
修复部分网络不通情况下接入失败的问题。
修复部分场景下Helm解析失败的问题。

此次升级不会对业务造成影响。

2024年09月

版本号

镜像地址

变更时间

变更内容

变更影响

3.2.5

registry.{REGION}.aliyuncs.com/acs/ack-onepilot:3.2.5

registry.{REGION}.aliyuncs.com/acs/ack-onepilot-init:3.2.5

2024年09月10日

修复使用MSE场景下的一个偶发重启问题。

此次升级不会对业务造成影响。

3.2.4

registry.{REGION}.aliyuncs.com/acs/ack-onepilot:3.2.4

registry.{REGION}.aliyuncs.com/acs/ack-onepilot-init:3.2.4

2024年09月03日

支持Python语言应用的接入。
MSE修复无损上下线的部分Bug。

此次升级不会对业务造成影响。

2024年07月

版本号

镜像地址

变更时间

变更内容

变更影响

3.2.3

registry.{REGION}.aliyuncs.com/acs/ack-onepilot:3.2.3

registry.{REGION}.aliyuncs.com/acs/ack-onepilot-init:3.2.3

2024年07月30日

MSE支持Go语言服务端治理相关功能。

此次升级不会对业务造成影响。

3.2.2

registry.{REGION}.aliyuncs.com/acs/ack-onepilot:3.2.2

registry.{REGION}.aliyuncs.com/acs/ack-onepilot-init:3.2.2

2024年07月05日

修复ARMS参数异常导致应用启动失败的问题。

此次升级不会对业务造成影响。

2024年06月

版本号	镜像地址	变更时间	变更内容	变更影响
3.2.0	registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.2.0 registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.2.0	2024年06月19日	支持Go语言应用的接入。 Java应用支持自动注入崩溃日志收集参数。	此次升级不会对业务造成影响。
3.1.2	registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.1.2 registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.1.2	2024年06月19日	修复部分弱网场景下由于软链接处理问题引起的接入失败。	此次升级不会对业务造成影响。
3.1.1	registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.1.1 registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.1.1	2024年06月13日	修复网络不稳定情况下Agent包下载不完整的问题。修复使用pilotx时init-container被注入两次的问题。	此次升级不会对业务造成影响。

2024年05月

版本号

镜像地址

变更时间

变更内容

变更影响

3.1.0

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.1.0

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.1.0

2024年05月30日

支持使用Jar包方式下载Agent包。
探针包名更改为aliyun-java-agent.jar，探针的全路径更改为/home/admin/.opt/AliyunJavaAgent/aliyun-java-agent.jar。
init-container默认内存占用从100MB增大到250MB。

3.1.0 ack-onepilot将不再支持2.7.3.5以下版本探针的接入，请使用以上探针版本的用户升级探针版本或者不要升级到本ack-onepilot版本。

2024年04月

版本号

镜像地址

变更时间

变更内容

变更影响

3.0.20

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.0.20

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.0.20

2024年04月17日

修复开源Kubernetes集群无法接入公网时ack-onepilot启动失败的问题。

此次升级不会对业务造成影响。

2024年03月

版本号

镜像地址

变更时间

变更内容

变更影响

3.0.19

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.0.19

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.0.19

2024年03月23日

修复新应用接入时偶发跳转至ARMS控制台失败的问题。
修复StatefulSet应用接入失败的问题。
修复服务网格应用接入不生效的问题。

此次升级不会对业务造成影响。

2024年03月

版本号

镜像地址

变更时间

变更内容

变更影响

3.0.18

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.0.18

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.0.18

2024年03月13日

更新了K8s SDK版本，可支持gRPC健康检查。
自动适配服务网格网络环境。
修复arms.workload环境变量偶发注入为空的问题。

此次升级不会对业务造成影响。

2023年12月

版本号

镜像地址

变更时间

变更内容

变更影响

3.0.17

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.0.17

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.0.17

2023年12月26日

支持下载新版本探针。
修复内网连接超时问题。
新增更新版本时创建K8s事件的功能。

此次升级不会对业务造成影响。

2023年11月

版本号

镜像地址

变更时间

变更内容

变更影响

3.0.16

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.0.16

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.0.16

2023年11月28日

支持使用Tar包方式下载Agent包。

此次升级不会对业务造成影响。

2023年10月

版本号

镜像地址

变更时间

变更内容

变更影响

3.0.15

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.0.15

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.0.15

2023年10月18日

新增ack-onepilot资源配置。

此次升级不会对业务造成影响。

2023年09月

版本号

镜像地址

变更时间

变更内容

变更影响

3.0.14

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.0.14

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.0.14

2023年09月05日

新增支持优雅升级。
ARMS用户支持通过跨账号配置AccessKey ID和AccessKey Secret，实现接入。
MSE去除对AliyunMSEForECIRole的依赖。
修复Pod环境变量重复的问题。

此次升级不会对业务造成影响。

2023年08月

版本号

镜像地址

变更时间

变更内容

变更影响

3.0.13

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.0.13

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.0.13

2023年08月18日

新增支持Arm 64架构。
优化Metrics指标和监控Agent挂载成功率。
修复在Webhook阶段同步创建Client超时的问题。

此次升级不会对业务造成影响。

2023年06月

版本号

镜像地址

变更时间

变更内容

变更影响

3.0.12

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.0.12

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.0.12

2023年06月20日

优化ack-onepilot组件性能。

此次升级不会对业务造成影响。

2023年04月

版本号

镜像地址

变更时间

变更内容

变更影响

3.0.11

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.0.11

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.0.11

2023年04月20日

修复权限问题。
支持环境变量设置CPU、MEM（内存）大小。

此次升级不会对业务造成影响。

2023年03月

版本号

镜像地址

变更时间

变更内容

变更影响

3.0.10

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.0.10

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.0.10

2023年03月24日

修复环境变量问题。
修复Ingress支持问题。
完善国际化文档支持。
添加对Helm2的支持。

此次升级不会对业务造成影响。

2023年02月

版本号

镜像地址

变更时间

变更内容

变更影响

3.0.9

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:3.0.9

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:3.0.9

2023年02月20日

支持通过Kubernetes的Namespace Label来控制接入的微服务命名空间。
修复ARMS接入问题。

此次升级不会对业务造成影响。

3.0.8

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:3.0.8

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:3.0.8

2023年02月08日

简化部署Pod数量。
修复Service Mesh接入问题。

此次升级不会对业务造成影响。

2023年01月

版本号

镜像地址

变更时间

变更内容

变更影响

3.0.7

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:3.0.7

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:3.0.7

2023年01月16日

MSE微服务治理接入支持不同Namespace，可以通过Pod的mseNamespace来控制接入的微服务命名空间名字。

此次升级不会对业务造成影响。

2022年11月

版本号

镜像地址

变更时间

变更内容

变更影响

3.0.6

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:3.0.6

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:3.0.6

2022年11月17日

删除废弃组件mseruletrait。

此次升级不会对业务造成影响。

2022年10月

版本号

镜像地址

变更时间

变更内容

变更影响

3.0.5

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:3.0.5

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:3.0.5

2022年10月21日

支持阿里云Ingress灰度。

此次升级不会对业务造成影响。

2022年08月

版本号

镜像地址

变更时间

变更内容

变更影响

3.0.4

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:3.0.4

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:3.0.4

2022年08月17日

标签中心支持ACK环境下打标并同步部分标签。

此次升级不会对业务造成影响。

2022年07月

版本号

镜像地址

变更时间

变更内容

变更影响

3.0.3

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:3.0.3

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:3.0.3

2022年07月19日

支持通过Pod的Label配置无损上线。

此次升级不会对业务造成影响。

3.0.2

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:3.0.2

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:3.0.2

2022年07月05日

修复prestop的问题。

此次升级不会对业务造成影响。

2022年06月

版本号

镜像地址

变更时间

变更内容

变更影响

3.0.1

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:3.0.1

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:3.0.1

2022年06月13日

支持MSE企业版接入，提供MSE流量防护能力。

此次升级不会对业务造成影响。

2022年05月

版本号

镜像地址

变更时间

变更内容

变更影响

3.0.0

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:3.0.0

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:3.0.0

2022年05月13日

支持Service Mesh
支持同步Kubernetes Service到MSE Nacos。

此次升级不会对业务造成影响。

2.0.9

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:2.0.9

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:2.0.9

2022年05月25日

修复下载超时时间设置。
修复命名空间创建问题。
减少注入的JAVA_TOOL_OPTIONS长度。

此次升级不会对业务造成影响。

2022年04月

版本号

镜像地址

变更时间

变更内容

变更影响

2.0.8

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:2.0.8

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:2.0.8

2022年04月19日

支持AHAS流量防护。
优化日志逻辑，辅助问题排查。

此次升级不会对业务造成影响。

2.0.6

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:2.0.6

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:2.0.6

2022年04月11日

支持按照应用名称灰度Agent。

此次升级不会对业务造成影响。

2022年03月

版本号

镜像地址

变更时间

变更内容

变更影响

2.0.5

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:2.0.5

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:2.0.5

2022年03月17日

支持EDAS单独版本的Agent。

此次升级不会对业务造成影响。

2022年02月

版本号

镜像地址

变更时间

变更内容

变更影响

2.0.4

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:2.0.4

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:2.0.4

2022年02月28日

支持严格模式，支持仅Label接入。

此次升级不会对业务造成影响。

2.0.3

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:2.0.3

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:2.0.3

2022年02月11日

添加readinessProbe就绪探针，防止升级期间Pilot服务中断。

此次升级不会对业务造成影响。