すべてのプロダクト
Search
ドキュメントセンター

Container Service for Kubernetes:クラスターのコントロールプレーンコンポーネントに対するトレーシングの有効化

最終更新日:Mar 26, 2026

この機能を有効化すると、API Server が自動的にリクエストのトレースデータを OpenTelemetry 向けマネージドサービスにレポートし、パフォーマンスボトルネックの特定やクラスター障害のトラブルシューティングに役立つトレース詳細およびリアルタイムトポロジーを提供します。本機能の利用には、標準の ACK クラスター料金に加えて、OpenTelemetry 向けマネージドサービスに関する追加課金が発生します。

前提条件

開始する前に、以下の条件を満たしていることを確認してください。

OpenTelemetry 向けマネージドサービスの概要(トレースマッピング、呼び出し統計、トレーストポロジー、アプリケーション依存関係分析を含む)については、「用語」をご参照ください。Service Mesh (ASM) は OpenTelemetry 向けマネージドサービスと統合されています。課金に関する詳細は、「課金概要」をご参照ください。

ステップ 1:API Server に対するトレーシング分析の有効化

  1. ACK コンソールにログインします。左側ナビゲーションウィンドウで、[クラスター] をクリックします。

  2. [クラスター] ページで、管理対象のクラスター名をクリックします。左側ナビゲーションウィンドウから、[操作][アドオン] の順に選択します。

  3. [コアコンポーネント] タブで、[Kube API Server] カードの右下隅にある [構成] をクリックします。

  4. 表示されたペインで、[enableTrace] および [samplingRatePerMillion] パラメーターを検索し、画面の指示に従って設定します。

    パラメーター説明
    enableTraceAPI Server に対するトレーシング分析を有効化します。
    samplingRatePerMillion100 万件あたりのサンプリング対象リクエスト割合を制御します。クラスターの負荷に応じて設定してください。例: 1000000 = 100%(全リクエストをサンプリング)、100000 = 10%、10000 = 1%。

    image

ステップ 2:OpenTelemetry 向けマネージドサービスコンソールでのトレーシングデータの確認

  1. OpenTelemetry 向けマネージドサービスコンソールにログインします。左側ナビゲーションウィンドウで、[アプリケーション] をクリックします。

  2. ページの上部でリージョンを選択し、アプリケーション名 [apiserver] をクリックします。

  3. 特定のクラスターのトレースをフィルター処理するには、[トレースエクスプローラー] の検索ボックスに以下を入力します:

    resources.k8s.cluster.name : "<ClusterId>"

    <ClusterId> は、クラスターリストから取得したクラスター ID に置き換えてください。

  4. 以下のタブを使用してデータを確認できます。

    タブ表示内容
    [トレースエクスプローラー]API Server リクエストのトレース詳細およびアプリケーショントポロジー。トレース ID をクリックすると、トポロジー表示、関与するサービス数、および呼び出し回数を確認できます。
    [提供サービス]API Server の API リクエスト数、エラー数、および平均リクエスト持続時間。
    [依存関係]API Server が依存する外部コンポーネント(etcd など)の情報。リクエスト数、エラー数、および平均応答時間が含まれます。

次のステップ

データプレーンコンポーネントに対するトレーシング分析を有効化するには、「データプレーンコンポーネント向けトレーシング分析の有効化」をご参照ください。