Docs

Application Performance Management Plus

Best practices

Upgrade solution for Apmplus Operator certificate expiration

The Apmplus Operator certificate expired on 2025-02-07, which will cause newly created business pods to fail to collect observability data. This topic describes how to upgrade the Apmplus Operator for existing clusters.

Background

Apmplus Operator can be used for Java pods within VKE clusters to enable automatic injection of observability instrumentation capabilities. When creating pods with specific annotations, the Operator can inject the "javaagent" into them.

Currently, the Apmplus Operator certificate expired on 2025-02-07, affecting the automatic injection capability. As a direct result, newly created business pods cannot have the "javaagent" automatically injected, and thus cannot collect observability data for the service.

Prerequisites

You have already downloaded and installed the latest version of the kubectl tool locally from the official Kubernetes website. For detailed installation instructions, see Installing and configuring kubectl.

Procedure

For existing clusters that use Apmplus Operator, you can see the following steps to perform the upgrade.

Step 1: Check the deployment status of the apmplus-operator add-on

tip

If the current cluster does not have the apmplus-operator add-on deployed, it will not be affected by this certificate expiration, and the following upgrade steps are not required.

You can determine whether the apmplus-operator add-on is deployed in the current cluster by checking whether the apmplus-operator-controller-manager add-on is deployed in the apmplus namespace.

Log in to the cluster via kubectl and execute the following command to get the list of cluster namespaces, then check whether a namespace named apmplus exists.

Execute the following command to check whether the apmplus-operator-controller-manager add-on is deployed in the apmplus namespace.

Example result:

Step 2: Obtain the App Key required for APMPlus

Click Click to enter service list to go to the Service management page.

In the left navigation pane, select Integration hub, specify the workspace, and obtain the App Key from the service integration information.

Step 3: Deploy Apmplus Operator resources

Execute the following command to deploy Apmplus Operator resources in the cluster.

tip

If an error occurs when executing the kubectl apply command, it may be caused by dependency issues when deploying resources via YAML files, such as CRD and CR not being handled properly. Repeating the command usually resolves the issue.

If you deploy via the public network, execute the following command:

If you deploy via the private network, execute the following command:

The above commands contain two variables that need to be replaced with actual values:

Variable	Description
region	The region information of the cluster. Enter the corresponding RegionID based on the actual cluster region, for example, cn-beijing, cn-shanghai.
appkey	The appkey obtained in Step 2.

Last updated: 2026.08.12 17:19:08