Container Service for Kubernetes:コントロールプレーンコンポーネントのトレース分析の有効化

トレースを初めて使用する場合は、「基本概念」で基本を学んでください。

前提条件

• Kubernetes 1.28 以降を実行する ACK マネージド Pro クラスター があること。クラスターをアップグレードする必要がある場合は、「クラスターの手動アップグレード」をご参照ください。

• Managed Service for OpenTelemetryが有効化され、承認されました。詳細については、「はじめに」をご参照ください。

  Managed Service for OpenTelemetry は、エンドツーエンドのトレース再構築、リクエスト量の統計、トレースのトポロジー、アプリケーションの依存関係分析など、分散アプリケーション向けのツールを提供します。

API サーバーのパラメーターを設定して、トレース分析を有効にし、そのサンプルレートを設定できます。 設定が完了すると、OpenTelemetry 用マネージドサービスコンソールに詳細なトレースデータが表示されます。

ステップ 1: API サーバーのトレース分析を有効にする

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

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

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

4. 設定パネルで、enableTrace パラメーターと samplingRatePerMillion パラメーターを見つけ、以下のように値を設定します。

   enableTrace を有効にする前に、Managed Service for OpenTelemetry がアクティブ化され、現在のリージョンで利用可能であることを確認してください。

   • enableTrace: API サーバーのトレース分析を有効にします。

   • samplingRatePerMillion：100万リクエストごとにサンプリングするリクエスト数を指定します。クラスターのワークロードに基づいてサンプルレートを設定できます。

     たとえば、値 1000000 は 100% のサンプルレートに相当し、すべてのリクエストがサンプリングされて記録されます。値 100000 は 10% のサンプルレートに、10000 は 1% のサンプルレートに相当します。

ステップ 2： OpenTelemetry でのトレースデータの表示

1. Managed Service for OpenTelemetry コンソールにログインします。左側メニューで、[Applications] をクリックします。

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

   • トレースエクスプローラー タブ: API サーバー リクエストのトレースとアプリケーショントポロジを表示します。

     各タブの詳細については、「アプリケーション詳細」をご参照ください。

     • ページの左上隅にある検索ボックスに resources.k8s.cluster.name : "your_cluster_id" を入力すると、特定のクラスターからのトレースが表示されます。

       クラスター ID はクラスターリストページから取得できます。

     • トレース一覧でトレース ID をクリックすると、トポロジービュー、関連するサービスの数、API コールの数など、特定の API サーバートレースの詳細を表示できます。

   • [提供サービス] タブには、API サーバーエンドポイントのメトリクス（リクエスト数、エラー数、平均レイテンシーなど）が表示されます。

   • 依存関係 タブ: API サーバー の外部依存関係のメトリクス (etcd へのアクセス時のリクエスト数、エラー数、平均レイテンシーなど) を表示します。

関連ドキュメント

クラスターのデータプレーンコンポーネントからのトレースデータを監視するには、「データプレーンコンポーネントのトレース分析の有効化」をご参照ください。