All Products
Search
Document Center

Application Real-Time Monitoring Service:Enable tracing for control plane (API Server) components in ACK clusters

Last Updated:Sep 21, 2026

When troubleshooting latency or diagnosing unexpected behavior in a Kubernetes cluster, API Server traces reveal how requests flow through the control plane. Enable API Server tracing in your ACK managed cluster to automatically export distributed traces to Managed Service for OpenTelemetry, where you can inspect request timelines, service topology, and dependency details.

If you are new to distributed tracing concepts such as traces, spans, and sampling, see Basic concepts.

Prerequisites

Before you begin, make sure that you have:

Managed Service for OpenTelemetry provides tools for distributed applications, including complete trace restoration, request volume statistics, trace topology, and application dependency analysis.

Billing

API Server tracing incurs two types of charges:

Charge typeDetails
ACK cluster feesPro edition cluster billing
Managed Service for OpenTelemetry feesBased on the volume of trace data collected. A free quota is included. See Billing description for details

Enable tracing for the API Server

  1. Log on to the ACK console. In the left-side navigation pane, click Clusters.

  2. On the Clusters page, click the name of the target cluster. In the left-side navigation pane, choose Operations > Add-ons.

  3. In the Core Components area, find the Kube API Server card and click Configure.

  4. Set the following parameters:

    ParameterDescription
    enableTraceTurn on tracing for the API Server.
    samplingRatePerMillionThe number of requests to sample per one million requests. Adjust this value based on cluster load.

    API Server tracing configuration

    The following table shows common sampling rate values:

    ValueSampling rateMeaning
    1000000100%Every request is traced
    10000010%1 in 10 requests is traced
    100001%1 in 100 requests is traced

View trace data in the OpenTelemetry console

  1. Log on to the Managed Service for OpenTelemetry console. In the left-side navigation pane, click Application List.

  2. Select the region at the top of the page, then click the application named apiserver.

  3. Explore the available tabs:

    • Trace Analysis -- Displays API Server request traces and application topology.

      • To filter traces for a specific cluster, enter resources.k8s.cluster.name : "<cluster-id>" in the search box. Find your cluster ID in the ACK cluster list.

      • Click a trace ID to view the full request timeline, including the topology, number of services involved, and number of interfaces invoked.

    • Provided Services -- Shows request count, fault count, and average response time for each API Server endpoint.

    • Dependent Services -- Lists external components that the API Server calls (such as etcd), with request count, fault count, and average response time.

    For a complete guide to all tabs, see Application details.

Related topics