全部產品
Search
文件中心

Container Service for Kubernetes:為叢集控制面組件啟用鏈路追蹤

更新時間:Mar 20, 2025

為了快速定位效能瓶頸、排查叢集問題,建議為叢集API Server啟用鏈路追蹤,記錄其請求互動細節。啟用後,API Server的鏈路資訊將自動上報至Managed Service for OpenTelemetry,提供可視化的鏈路明細、即時拓撲等監控資料。

如果您不熟悉鏈路追蹤,可參見基本概念瞭解相關基礎概念。

前提條件

說明

使用本功能時,除ACK叢集產生的費用外,還會產生可觀測資料量計費,由Managed Service for OpenTelemetry收取。關於Managed Service for OpenTelemetry提供的免費額度和具體定價,請參見計費說明


您可以配置API Server參數,開啟鏈路追蹤並配置鏈路追蹤的採樣率。配置後,可觀測鏈路 OpenTelemetry 版控制台將展示詳細的調用鏈路資料。

步驟一:API Server開啟鏈路追蹤

  1. 登入Container Service管理主控台,在左側導覽列選擇叢集列表

  2. 叢集列表頁面,單擊目的地組群名稱,然後在左側導覽列,選擇營運管理 > 組件管理

  3. 核心組件地區,單擊Kube API Server卡片右下方的配置

  4. 在配置面板,定位enableTracesamplingRatePerMillion參數,按照頁面提示完成配置。

    image

    • enableTrace:為API Server開啟鏈路追蹤功能。

    • samplingRatePerMillion:控制採樣率,決定每一百萬次請求中被採樣的比例。您可以根據叢集的負載情況配置採樣率。

      例如,1000000表示100%的採樣率,即每一百萬次請求中,所有請求都會被採樣和記錄;100000表示10%的採樣率;10000表示1%的採樣率。

步驟二:在OpenTelemetry中查看調用鏈路資料

  1. 登入可觀測鏈路 OpenTelemetry 版控制台,在左側導覽列單擊應用列表

  2. 在頁面頂部選擇地區,然後單擊應用程式名稱apiserver,按照控制台指引查看鏈路資訊。

    • 調用鏈分析頁簽:API Server請求的調用鏈路、應用拓撲等。

      下方僅介紹主要頁簽。如需瞭解不同頁簽的詳細說明,請參見應用詳情的相關文檔。
      • 在頁面左上方的搜尋方塊中輸入resources.k8s.cluster.name : "叢集ClusterId",可過濾展示指定叢集的調用鏈。

        叢集ClusterId可在叢集列表擷取。
      • 單擊Trace列表的Trace ID,查看一個API Server請求的Trace詳情,包括拓撲視圖、涉及的服務數、調用的介面數等。

    • 提供服務頁簽:API Server API 介面的請求數、錯誤數、平均耗時等。

    • 依賴服務頁簽:API Server依賴的外部組件,例如訪問etcd時的請求數、錯誤數、平均耗時等。

相關文檔

如需監控叢集資料面的鏈路資料,請參見為叢集資料面組件啟用鏈路追蹤