All Products
Search
Document Center

Application Real-Time Monitoring Service:Report ACK cluster data to ARMS across regions

Last Updated:Mar 11, 2026

When you run Container Service for Kubernetes (ACK) clusters in multiple regions, you may need to centralize monitoring data in a single region for unified alerting, dashboards, and compliance. By default, the Application Real-Time Monitoring Service (ARMS) agent in an ACK cluster reports data to the local region. To redirect monitoring data to ARMS in a different region, set the ARMS_REPORT_REGION environment variable on the ack-onepilot component.

How it works

The ack-onepilot component sends monitoring data to the ARMS endpoint in the local region by default. When you set the ARMS_REPORT_REGION environment variable, the component sends data to the ARMS endpoint in the specified region instead.

Important

This change is cluster-wide. After you set ARMS_REPORT_REGION, all applications in the cluster report data to the specified region.

Prerequisites

Before you begin, ensure that you have:

  • The ack-onepilot component at V4.0.0 or later

If the version is earlier than V4.0.0, update the ack-onepilot component before you proceed.

Configure cross-region reporting

  1. Set the ARMS_REPORT_REGION environment variable on the ack-onepilot-ack-onepilot application in the ack-onepilot namespace. The value must be the ID of a region where ARMS is available. Example: cn-hangzhou or cn-beijing.

  2. Restart existing applications or deploy new applications to start reporting data to the specified region.