この機能を有効化すると、API Server が自動的にリクエストのトレースデータを OpenTelemetry 向けマネージドサービスにレポートし、パフォーマンスボトルネックの特定やクラスター障害のトラブルシューティングに役立つトレース詳細およびリアルタイムトポロジーを提供します。本機能の利用には、標準の ACK クラスター料金に加えて、OpenTelemetry 向けマネージドサービスに関する追加課金が発生します。
前提条件
開始する前に、以下の条件を満たしていることを確認してください。
ACK マネージド Pro クラスター(Kubernetes 1.28 以降)が実行中であること。既存クラスターのアップグレードについては、「ACK クラスターの手動アップグレード」をご参照ください。
OpenTelemetry 向けマネージドサービスが有効化され、必要な権限が付与されていること。詳細については、「OpenTelemetry 向けマネージドサービスの利用準備」をご参照ください。
OpenTelemetry 向けマネージドサービスの概要(トレースマッピング、呼び出し統計、トレーストポロジー、アプリケーション依存関係分析を含む)については、「用語」をご参照ください。Service Mesh (ASM) は OpenTelemetry 向けマネージドサービスと統合されています。課金に関する詳細は、「課金概要」をご参照ください。
ステップ 1:API Server に対するトレーシング分析の有効化
ACK コンソールにログインします。左側ナビゲーションウィンドウで、[クラスター] をクリックします。
[クラスター] ページで、管理対象のクラスター名をクリックします。左側ナビゲーションウィンドウから、[操作] → [アドオン] の順に選択します。
[コアコンポーネント] タブで、[Kube API Server] カードの右下隅にある [構成] をクリックします。
表示されたペインで、[enableTrace] および [samplingRatePerMillion] パラメーターを検索し、画面の指示に従って設定します。
パラメーター 説明 enableTraceAPI Server に対するトレーシング分析を有効化します。 samplingRatePerMillion100 万件あたりのサンプリング対象リクエスト割合を制御します。クラスターの負荷に応じて設定してください。例: 1000000= 100%(全リクエストをサンプリング)、100000= 10%、10000= 1%。
ステップ 2:OpenTelemetry 向けマネージドサービスコンソールでのトレーシングデータの確認
OpenTelemetry 向けマネージドサービスコンソールにログインします。左側ナビゲーションウィンドウで、[アプリケーション] をクリックします。
ページの上部でリージョンを選択し、アプリケーション名 [apiserver] をクリックします。
特定のクラスターのトレースをフィルター処理するには、[トレースエクスプローラー] の検索ボックスに以下を入力します:
resources.k8s.cluster.name : "<ClusterId>"<ClusterId>は、クラスターリストから取得したクラスター ID に置き換えてください。以下のタブを使用してデータを確認できます。
タブ 表示内容 [トレースエクスプローラー] API Server リクエストのトレース詳細およびアプリケーショントポロジー。トレース ID をクリックすると、トポロジー表示、関与するサービス数、および呼び出し回数を確認できます。 [提供サービス] API Server の API リクエスト数、エラー数、および平均リクエスト持続時間。 [依存関係] API Server が依存する外部コンポーネント(etcd など)の情報。リクエスト数、エラー数、および平均応答時間が含まれます。
次のステップ
データプレーンコンポーネントに対するトレーシング分析を有効化するには、「データプレーンコンポーネント向けトレーシング分析の有効化」をご参照ください。