ack-onepilot: Overview, usage, and release notes-Container Service for Kubernetes(ACK)-阿里云帮助中心

ack-onepilot is Alibaba Cloud ARMS probe injection assistant for Kubernetes applications. This topic describes the ack-onepilot component, how to use it, and its release notes.

Overview

ack-onepilot integrates applications in ACK clusters with ARMS and MSE:

Automatically configures agent environment variables and packages to collect monitoring data for Java, Go, and Python applications, including topology data, API calls, abnormal transactions, and slow transactions.
Integrates microservice applications, such as Spring Cloud and Dubbo, with MSE Microservices Governance for production stability and development efficiency.

See How ack-onepilot works.

Usage

Integrate with ARMS:
Integrate with MSE: Integrate ACK microservice applications with MSE Governance Center

Release notes

April 2026

Version

Image address

Date

Description

Impact

5.2.1

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

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

April 24, 2026

Fixed terminationGracePeriodSeconds not auto-extending to 60 seconds by default in MSE graceful shutdown scenarios.

Non-disruptive.

March 2026

Version

Image address

Update time

Description

Impact

5.2.0

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

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

March 27, 2026

Adds non-intrusive OpenClaw application access: Integrate OpenClaw applications.

Non-disruptive.

December 2025

Version

Image address

Modification date

Changes

Impact

5.1.2

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

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

December 24, 2025

Fixed an issue where tags failed to disable application monitoring in EDAS scenarios.
Added fully non-intrusive Dify application integration: Connect Dify applications to ARMS application monitoring.

Non-disruptive.

September 2025

Version

Image address

Release date

Description

Impact

5.1.1

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

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

September 11, 2025

Optimized the Kubernetes probe settings during pod startup.
Pinned cramjam to v2.10.0 for Python non-intrusive integration to avoid version conflicts.
Auto-redacted access key/secret key values in user Helm configurations.
Streamlined integration for ACS scenarios.

Non-disruptive.

August 2025

Version

Image address

Release date

Description

Impact

5.1.0

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

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

August 7, 2025

Added CloudMonitor 2.0 integration.
Added local image cache mode for faster ack-onepilot integration.
Fixed ack-onepilot overwriting user-defined terminationGracePeriodSecond.

For ACS clusters, install the agent using the automatic installation method for generic Kubernetes environments.
For registered clusters, re-run the Connect ARMS to a registered cluster procedure to grant the component the required permissions for CloudMonitor.

July 2025

Version

Image address

Release date

Description

Impact

5.0.0

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

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

July 11, 2025

Added non-intrusive Python agent installation on ACK and ACS clusters via ack-onepilot.
Fixed MSE graceful online/offline label parameters having no effect.

Non-disruptive.

May 2025

Version

Image address

Release date

Description

Impact

4.2.0

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

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

May 30, 2025

Supports monitoring multi-language applications using the sidecar pattern. See Monitoring multi-container applications in a single pod.

Non-disruptive.

4.1.2

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

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

May 8, 2025

Supports specifying the ack-onepilot network mode. See Specify ack-onepilot network mode.
Supports recognizing pod labels as application tags. See Add and use tags.
Supports disabling annotation injection in service mesh environments. See Inject Java agent for Istio services.

Non-disruptive.

April 2025

Version

Image address

Release date

Description

Impact

4.1.1

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

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

April 9, 2025

Added cluster namespace-level agent version specification.
Disabled automatic application creation by default in ARMS EDAS scenarios requiring a specific application ID.
Fixed MSE application profiling data not being reported.

Non-disruptive.

March 2025

Version

Image address

Release date

Description

Impact

4.1.0

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

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

March 13, 2025

Fixed the incorrect order of injected environment variables.
Optimized Portable OpenAPI Proxy (POP) liveness detection.
Fixed the deactivation switch for ARMS integration.
Enabled custom integration via JAVA_TOOL_OPTIONS. See Customize the mount path for a Java agent.
Fixed resource discovery failures in the service governance control plane.
Enabled log reporting from external nodes.

Non-disruptive.

February 2025

Version

Image address

Release date

Description

Impact

4.0.1

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

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

February 27, 2025

Fixed applications in MSE Professional Edition namespaces being incorrectly onboarded as Enterprise Edition.

Non-disruptive.

January 2025

Version

Image address

Release date

Description

Impact

4.0.0

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

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

January 9, 2025

Improved ack-onepilot performance.
ARMS no longer supports annotation-based integration. Use labels per Install the ARMS Java agent in ACK and ACS clusters.

Non-disruptive.

December 2024

Version

Image address

Release date

Description

Impact

3.3.4

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

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

December 26, 2024

Fixed a compatibility issue with older arms-pilot versions that prevented application startup.
Fixed a rare startup failure caused by agent package permission errors.
Improved Python agent integration speed.
Optimized timeout-related logs.

Non-disruptive.

November 2024

Version

Image address

Release date

Changes

Impact

3.3.3

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

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

November 21, 2024

Added probe integration for Istio DNS proxy scenarios.
Adjusted ack-onepilot health check timing for faster startup.

Non-disruptive.

3.3.2

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

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

November 7, 2024

Optimized MSE logging and event notification when MSE is not integrated.

Non-disruptive.

October 2024

Version

Image address

Date

Changes

Impact

3.3.1

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

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

October 29, 2024

Added the option to skip sidecar injection for graceful shutdown.
Added new fields for log reporting.

Non-disruptive.

Version

Image address

Release date

Changes

Impact

3.3.0

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

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

October 11, 2024

Supports progressive agent upgrades.
Fixed integration failures under certain network conditions.
Fixed Helm parsing failures in certain scenarios.

Non-disruptive.

September 2024

Version

Image address

Date

Changes

Impact

3.2.5

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

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

September 10, 2024

Fixed an intermittent restart issue when using MSE.

Non-disruptive.

3.2.4

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

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

September 3, 2024

Added Python application support.
Fixed bugs with graceful online/offline in MSE.

Non-disruptive.

July 2024

Version

Image address

Date

Changes

Impact

3.2.3

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

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

July 30, 2024

Added service governance support for Go applications in MSE.

Non-disruptive.

3.2.2

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

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

July 5, 2024

Fixed application startup failures caused by invalid ARMS parameters.

Non-disruptive.

June 2024

Version	Image address	Release date	Changes	Impact
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	June 19, 2024	Added Go application support. Java applications now automatically inject crash log collection parameters.	Non-disruptive.
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	June 19, 2024	Fixed an integration failure caused by symbolic link handling in poor network conditions.	Non-disruptive.
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	June 13, 2024	Fixed incomplete agent package downloads in unstable network conditions. Fixed duplicate init container injection when using pilotx.	Non-disruptive.

May 2024

Version

Image address

Update date

Changes

Impact

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

May 30, 2024

Added JAR format for agent package downloads.
Changed the probe package name to aliyun-java-agent.jar and its full path to /home/admin/.opt/AliyunJavaAgent/aliyun-java-agent.jar.
Increased the default memory usage of the init container from 100 MB to 250 MB.

ack-onepilot 3.1.0 is incompatible with probes older than version 2.7.3.5. You must upgrade these probes before upgrading to this ack-onepilot version.

April 2024

Version

Image address

Update date

Changes

Impact

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

April 17, 2024

Fixed a startup failure for ack-onepilot in open-source Kubernetes clusters without public network access.

Non-disruptive.

March 2024

Version

Image address

Release date

Description

Impact

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

March 23, 2024

Fixed occasional ARMS console redirection failures when integrating new applications.
Fixed StatefulSet application integration failures.
Fixed Service Mesh (ASM) applications not taking effect after integration.

Non-disruptive.

March 2024

Version

Image address

Update time

Changes

Impact

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

March 13, 2024

Updated the Kubernetes SDK to support gRPC health checks.
Now automatically adapts to service mesh environments.
Fixed arms.workload environment variable occasionally being injected as empty.

Non-disruptive.

December 2023

Version

Image address

Release date

Description

Impact

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

December 26, 2023

Added new probe version downloads.
Fixed internal network connection timeouts.
Added ACK event creation on ack-onepilot updates.

Non-disruptive.

November 2023

Version

Image address

Release date

Description

Impact

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

November 28, 2023

Added tar package format for agent downloads.

Non-disruptive.

October 2023

Version

Image address

Release date

Description

Impact

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

October 18, 2023

Added resource configuration for ack-onepilot.

Non-disruptive.

September 2023

Version

Image address

Release date

Description

Impact

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

September 5, 2023

Added graceful update support.
ARMS users can now connect using an AccessKey ID and AccessKey Secret from another account.
MSE no longer requires the AliyunMSEForECIRole.
Fixed duplicate pod environment variables.

Non-disruptive.

August 2023

Version

Image address

Release date

Description

Impact

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

August 18, 2023

Added Arm64 architecture support.
Optimized metrics and improved monitoring agent mount reliability.
Fixed a synchronous client creation timeout during the webhook phase.

Non-disruptive.

June 2023

Version

Image address

Release date

Description

Impact

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

June 20, 2023

Optimized ack-onepilot performance.

Non-disruptive.

April 2023

Version

Image address

Release date

Description

Impact

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

April 20, 2023

Fixed a permission issue.
Added CPU and memory sizing via environment variables.

Non-disruptive.

March 2023

Version

Image address

Release date

Description

Impact

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

March 24, 2023

Fixed an issue with environment variables.
Fixed an issue with Ingress support.
Improved internationalization support.
Added Helm 2 support.

Non-disruptive.

February 2023

Version

Image address

Release date

Updates

Impact

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

February 20, 2023

Added Kubernetes namespace label selection for microservice namespace connections.
Fixed ARMS integration issues.

Non-disruptive.

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

February 8, 2023

Reduced the number of pods required for deployment.
Fixed service mesh integration issues.

Non-disruptive.

January 2023

Version

Image address

Release date

Description

Impact

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

January 16, 2023

MSE microservices governance supports namespace-level integration via the pod's mseNamespace parameter.

Non-disruptive.

November 2022

Version

Image address

Release date

Description

Impact

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

November 17, 2022

Removed the deprecated mseruletrait component.

Non-disruptive.

October 2022

Version

Image address

Release date

Description

Impact

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

October 21, 2022

Added canary release support for Alibaba Cloud ingress.

Non-disruptive.

August 2022

Version

Image address

Release date

Description

Impact

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

August 17, 2022

Added ACK cluster labeling with partial label synchronization.

Non-disruptive.

July 2022

Version

Image address

Release date

Description

Impact

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

July 19, 2022

Added graceful startup configuration via pod labels.

Non-disruptive.

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

July 5, 2022

Fixed an issue with the preStop hook.

Non-disruptive.

June 2022

Version

Image address

Release date

Description

Impact

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

June 13, 2022

Added MSE Enterprise Edition integration for traffic protection.

Non-disruptive.

May 2022

Version

Image address

Release date

Description

Impact

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

May 25, 2022

Added service mesh support.
Added Kubernetes Services synchronization to MSE Nacos.

Non-disruptive.

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

May 13, 2022

Fixed a download timeout issue.
Fixed a namespace creation issue.
Reduced the length of the JAVA_TOOL_OPTIONS value.

Non-disruptive.

April 2022

Version

Image address

Release date

Description

Impact

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

April 19, 2022

Supports traffic protection with Application High Availability Service (AHAS).
Optimized logging for easier troubleshooting.

Non-disruptive.

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

April 11, 2022

Supports agent canary releases based on application names.

Non-disruptive.

March 2022

Version

Image address

Release date

Description

Impact

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

March 17, 2022

Added a dedicated EDAS agent version.

Non-disruptive.

February 2022

Version

Image address

Release date

Description

Impact

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

February 28, 2022

Added strict mode and label-only integration.

Non-disruptive.

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

February 11, 2022

Added a readiness probe to prevent Pilot service interruptions during updates.

Non-disruptive.