ack-onepilot component introduction, usage instructions, and changelog - Container Service for Kubernetes

ack-onepilot is a probe connection assistant from Alibaba Cloud Application Real-Time Monitoring Service (ARMS). It helps you connect probes to applications in Kubernetes. This topic describes the ack-onepilot component, explains how to use it, and provides a changelog.

Component introduction

ack-onepilot is a system component of Container Service for Kubernetes (ACK) for users of ARMS and Microservices Engine (MSE). It simplifies the process of connecting applications to ARMS and MSE. The component provides the following features.

It automatically adds the necessary environment variables and prepares the probe package in your container environment. This ensures efficient and accurate collection and reporting of monitoring data for Java, Golang, and Python applications. The data includes application topology, API calls, and information about abnormal or slow transactions.
It connects microservice applications, such as Spring Cloud and Dubbo, to the MSE administration center. You can then use MSE's service administration features to improve the stability and development efficiency of your online microservices.

For more information about the basic principles of ack-onepilot, see Basic principles of the ack-onepilot component.

Usage instructions

Connect to ARMS using ack-onepilot:
- To connect Java applications in an ACK cluster to Application Monitoring, see Install the Java probe for Container Service for Kubernetes (ACK) and Container Compute Service (ACS) using the ack-onepilot component.
- To connect Golang applications in an ACK cluster to Application Monitoring, see Install the Go probe for Container Service for Kubernetes (ACK) and Container Compute Service (ACS) using the ack-onepilot component.
- To connect Python applications in an ACK cluster to Application Monitoring, see Install the Python probe for Container Service for Kubernetes (ACK) and Container Compute Service (ACS) using the ack-onepilot component.
To connect to MSE using ack-onepilot, see Connect ACK microservice applications to the MSE administration center.

Changelog

September 2025

Version number

Image address

Change time

Change 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

August 7, 2025

Optimized the parameter settings for Kubernetes probes during pod startup.
Pinned the cramjam dependency to 2.10.0 for non-intrusive Python integration to avoid version conflicts.
Automatically hid the AccessKey ID and AccessKey secret in user Helm charts to enhance security.
Optimized the integration experience for ACS scenarios.

This upgrade does not affect your services.

August 2025

Version number

Image address

Change time

Change 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 full support for connecting to CloudMonitor 2.0.
Added support for using the local image cache mode to accelerate ack-onepilot integration.
Fixed an issue where the ack-onepilot component overwrote the terminationGracePeriodSecond field if it was already defined by the user.

For ACS clusters, install the probe by following the instructions in Automatically install the probe in a general-purpose Kubernetes environment.
For registered clusters, grant the required CloudMonitor permissions to the component again by following the instructions in Connect Application Real-Time Monitoring Service (ARMS) to a registered cluster.

July 2025

Version number

Image address

Change time

Change 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 support for fully non-intrusive integration of the Python probe. For more information, see Install the Python probe for Container Service for Kubernetes (ACK) and Container Compute Service (ACS) using the ack-onepilot component.
Fixed an issue where the label parameter configuration for MSE graceful start and shutdown did not take effect.

This upgrade does not affect your services.

May 2025

Version number

Image address

Change time

Change 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

Added support for connecting multi-language applications in Sidecar scenarios. For more information, see Start monitoring multi-container applications in a single pod.

This upgrade does not affect your services.

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

Added support for specifying the network mode for the ack-onepilot component. For more information, see Specify the network mode for the ack-onepilot component.
Added support for recognizing labels in pod labels as application tags. For more information, see Add and use tags.
Added support for manually disabling annotation injection in Service Mesh environments. For more information, see Mount a Java probe for a service that uses Istio.

This upgrade does not affect your services.

April 2025

Version number

Image address

Change time

Change 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 support for specifying the probe version at the cluster namespace level.
In ARMS EDAS scenarios where an AppID is specified, applications are no longer created by default.
Fixed an issue where MSE application profiles were not reported.

This upgrade does not affect your services.

March 2025

Version number

Image address

Change time

Change 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 an issue where injected environment variables were out of order.
Optimized the liveness probe logic for POP networks.
Fixed an issue where the switch for disabling ARMS integration was invalid.
Added support for a custom JAVA_TOOL_OPTIONS integration mode. For more information, see How to customize the Java probe mount path.
Fixed an issue where resource discovery failed in the service administration control panel.
Added support for log reporting from external nodes.

This upgrade does not affect your services.

February 2025

Version number

Image address

Change time

Change 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 an issue where applications in the namespace of MSE Microservice Governance Professional Edition were connected as if they were in the Enterprise Edition.

This upgrade does not affect your services.

January 2025

Version number

Image address

Change time

Change 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

Optimized the performance of ack-onepilot.
ARMS no longer supports integration using annotations. To connect your application, add a label. For more information, see Install the Java probe for Container Service for Kubernetes (ACK) and Container Compute Service (ACS) using the ack-onepilot component.

This upgrade does not affect your services.

December 2024

Version number

Image address

Change time

Change 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 an issue where user applications failed to start when an older version of arms-pilot was present.
Fixed a startup failure issue caused by the failure to modify probe package permissions in extreme cases.
Removed invalid logic from the Python probe integration process to accelerate integration.
Optimized logs related to timeouts.

This upgrade does not affect your services.

November 2024

Version number

Image address

Change time

Change description

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

Adapted probe integration for Istio DNS proxy scenarios.
Adjusted the health check time for ack-onepilot to accelerate its startup.

This upgrade does not affect your services.

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 the logic for logs and event prompts related to MSE when MSE is not connected.

This upgrade does not affect your services.

October 2024

Version number

Image address

Change time

Change description

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 support for skipping Sidecar injection for graceful shutdown.
Added more fields for log reporting.

This upgrade does not affect your services.

Version number

Image address

Change time

Change description

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

Added support for progressive probe upgrades.
Fixed an integration failure issue that occurred in some cases of network disconnection.
Fixed an issue where Helm chart parsing failed in some scenarios.

This upgrade does not affect your services.

September 2024

Version number

Image address

Change time

Change description

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 occasional restart issue that occurred in MSE scenarios.

This upgrade does not affect your services.

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 support for connecting Python applications.
Fixed some bugs related to graceful start and shutdown in MSE.

This upgrade does not affect your services.

July 2024

Version number

Image address

Change time

Change description

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

MSE now supports service administration features for Go applications.

This upgrade does not affect your services.

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 an application startup failure issue caused by abnormal ARMS parameters.

This upgrade does not affect your services.

June 2024

Version number	Image address	Change time	Change description	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 support for connecting Go applications. Added support for automatically injecting parameters for crash log collection in Java applications.	This upgrade does not affect your services.
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 issue caused by symbolic link handling problems in some weak network scenarios.	This upgrade does not affect your services.
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 an issue where the agent package was not fully downloaded in unstable network conditions. Fixed an issue where the init-container was injected twice when pilotx was used.	This upgrade does not affect your services.

May 2024

Version number

Image address

Change time

Change description

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 support for downloading the agent package as a JAR file.
Changed the probe package name to aliyun-java-agent.jar. The full path of the probe is changed 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 no longer supports probes earlier than version 2.7.3.5. If you use an earlier probe version, upgrade your probe or do not upgrade to this version of ack-onepilot.

April 2024

Version number

Image address

Change time

Change description

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 an issue where ack-onepilot failed to start when an open source Kubernetes cluster could not access the internet.

This upgrade does not affect your services.

March 2024

Version number

Image address

Change time

Change 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 an issue where redirection to the ARMS console occasionally failed when a new application was connected.
Fixed an integration failure issue for StatefulSet applications.
Fixed an issue where Service Mesh application integration did not take effect.

This upgrade does not affect your services.

March 2024

Version number

Image address

Change time

Change description

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.
Added automatic adaptation to Service Mesh network environments.
Fixed an issue where the arms.workload environment variable was occasionally injected as an empty value.

This upgrade does not affect your services.

December 2023

Version number

Image address

Change time

Change 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 support for downloading new probe versions.
Fixed an internal network connection timeout issue.
Added a feature to create Kubernetes events during version updates.

This upgrade does not affect your services.

November 2023

Version number

Image address

Change time

Change 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 support for downloading the agent package as a TAR file.

This upgrade does not affect your services.

October 2023

Version number

Image address

Change time

Change 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.

This upgrade does not affect your services.

September 2023

Version number

Image address

Change time

Change 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 support for graceful upgrades.
ARMS users can now connect by configuring the AccessKey ID and AccessKey secret across accounts.
Removed the dependency on the AliyunMSEForECIRole for MSE.
Fixed an issue with duplicate pod environment variables.

This upgrade does not affect your services.

August 2023

Version number

Image address

Change time

Change 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 support for the Arm64 architecture.
Optimized metrics and the success rate of mounting the monitoring agent.
Fixed a client creation timeout issue during the webhook phase.

This upgrade does not affect your services.

June 2023

Version number

Image address

Change time

Change 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 the performance of the ack-onepilot component.

This upgrade does not affect your services.

April 2023

Version number

Image address

Change time

Change 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 support for setting CPU and memory (MEM) sizes using environment variables.

This upgrade does not affect your services.

March 2023

Version number

Image address

Change time

Change 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 environment variable issue.
Fixed an Ingress support issue.
Improved support for internationalized documentation.
Added support for Helm 2.

This upgrade does not affect your services.

February 2023

Version number

Image address

Change time

Change description

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 support for controlling the connected microservice namespace using Kubernetes namespace labels.
Fixed an ARMS integration issue.

This upgrade does not affect your services.

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

Simplified the number of deployed pods.
Fixed a Service Mesh integration issue.

This upgrade does not affect your services.

January 2023

Version number

Image address

Change time

Change 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 microservice administration now supports different namespaces. You can use the mseNamespace label of a pod to control the name of the connected microservice namespace.

This upgrade does not affect your services.

November 2022

Version number

Image address

Change time

Change 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.

This upgrade does not affect your services.

October 2022

Version number

Image address

Change time

Change 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 support for Alibaba Cloud Ingress grayscale releases.

This upgrade does not affect your services.

August 2022

Version number

Image address

Change time

Change 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

Tag Engine now supports tagging and synchronizing some tags in ACK environments.

This upgrade does not affect your services.

July 2022

Version number

Image address

Change time

Change 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 support for configuring graceful start using pod labels.

This upgrade does not affect your services.

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 a prestop issue.

This upgrade does not affect your services.

June 2022

Version number

Image address

Change time

Change 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 support for connecting to MSE Enterprise Edition and provides MSE traffic mitigation capabilities.

This upgrade does not affect your services.

May 2022

Version number

Image address

Change time

Change 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 13, 2022

Added support for Service Mesh.
Added support for synchronizing Kubernetes services to MSE Nacos.

This upgrade does not affect your services.

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 25, 2022

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

This upgrade does not affect your services.

April 2022

Version number

Image address

Change time

Change 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

Added support for AHAS traffic mitigation.
Optimized the logging logic to help with troubleshooting.

This upgrade does not affect your services.

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

Added support for grayscale releases of the agent based on the application name.

This upgrade does not affect your services.

March 2022

Version number

Image address

Change time

Change 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 support for a separate agent version for EDAS.

This upgrade does not affect your services.

February 2022

Version number

Image address

Change time

Change 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 support for strict mode and integration using only labels.

This upgrade does not affect your services.

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 readinessProbe to prevent service interruptions during upgrades.

This upgrade does not affect your services.