K8sメトリクス収集
ダウンロード
フォーカスモード
フォントサイズ
本文では、自社構築のK8sおよびTKEクラスタ（TKE標準クラスタとTKE Serverlessクラスタを含む）のメトリクスをCLSに収集する方法について説明します。
前提条件
指標報告に関する権限を設定済みです。詳細は指標報告アクセスポリシーテンプレートをご覧ください。
操作手順
ステップ1：指標トピックを選択する
1. CLSコンソールにログインします。
2. 左側のナビゲーションバーで指標トピックを選択し、配信対象の指標トピックを選択して、指標トピック名をクリックし、指標トピック詳細ページに移動します。指標トピックをまだ作成していない場合は、指標トピックの作成をクリックして作成できます。詳細については指標トピックをご覧ください。
3. 指標トピック詳細ページで、左側のメニューからアクセス管理>K8s指標を選択します。ここでは、K8s基本監視指標とK8sカスタムサービス指標の報告が提供されます。右側の管理ページで新規作成をクリックすると、対応するK8s指標設定フローに進むことができます。
ステップ2：K8sメトリクス収集を設定する
1. 右側のK8s基本監視指標で新規作成をクリックし、設定フローに進みます。
2. 収集対象のクラスタを選択します。選択したクラスタで指標収集が有効になっていない場合は、赤い文字にマウスをホバーしてください。ガイドに従って指標収集を有効にすると、クラスタを選択できます。
3. 設定ページに進んだ後、指標収集を設定します。ここでは、クイック設定とカスタムYAMLのインポートという2種類の指標設定方法が提供されます。
クイック設定：
一部のよく使用されるK8s基本監視指標がデフォルトで選択されています。変更をクリックして調整できます。
3種類の基本指標を提供します：コンテナ使用量監視、K8sリソース状態監視、ホスト監視です。
カスタムYAML：YAMLテンプレートを使用してKubernetes基本監視コンポーネントを迅速に有効化し、クラスタ、ノード、コンテナレベルの主要指標データを収集できます。独立して制御可能な3つの収集コンポーネントスイッチを提供し、各スイッチは1つのYAMLデプロイテンプレートに対応しています。実際のビジネスシナリオに応じてYAMLを調整できます。
kube-state-metrics：Kubernetesリソースオブジェクト（Deployment、Pod、Nodeなど）の実行状態情報を収集します。
node-exporter：ノードレベルのシステムリソース指標を収集します。
cAdvisor：コンテナランタイム指標を収集し、Podとコンテナのリソース使用状況の監視に使用されます。
4. 設定が完了したら、送信をクリックします。完了後、収集を開始できます。
1. 右側のK8sカスタムサービス指標で新規作成をクリックし、設定フローに進みます。
2. 収集対象のクラスタを選択します。選択したクラスタで指標収集が有効になっていない場合は、赤い文字にマウスをホバーしてください。ガイドに従って指標収集を有効にすると、クラスタを選択できます。
3. 設定ページに入った後、指標収集を設定します。
収集設定の内容は下の表をご覧ください。
パラメータ | 説明 |
設定名 | 指標収集設定の名前です。 |
収集対象 | 指標収集の対象となるK8sオブジェクトです。複数選択に対応しています。 名前空間：収集対象の名前空間を選択します。 Pod Label：Labelを使用してターゲットPodを選択し、key/value設定をサポートします。複数のルールはAND関係です。 ポート（Port）：指標収集ポート。 Metric アドレス（Path）：指標収集のパス。  |
データ処理 | 収集した指標データに対してルール処理を行うために使用されます。ここでのロジックはPrometheusのrelabelルールと一致し、複数のデータ整理ルールを設定できます。複数のルールはルール番号のパイプラインに従って実行されます。 ルール操作でサポートされる機能：Label置換、Label破棄、Label保持、小文字化、大文字化、指標破棄（完全一致/正規表現一致）、指標保持（完全一致/正規表現一致）、ハッシュモジュロ、Labelマッピングなど。 |
カスタムLabel | 元のメトリクス内容に加えて、コンテナやKubernetes関連のメタデータ（例：ログを生成したコンテナID）も一緒にCLSへ報告されます。これにより、ユーザーはメトリクスを確認する際にソースを追跡したり、コンテナ識別子や特徴（例：コンテナ名、labels）に基づいて検索したりできます。これらのメタデータを報告するかどうかはご自身で選択でき、必要に応じてチェックしてアップロードするか、カスタムメタデータを定義して報告することができます。  |
その他の設定内容は以下の表の通りです。
パラメータ | 説明 |
通信プロトコル | 指標収集に使用するプロトコルです。HTTPまたはHTTPSをサポートし、デフォルトはHTTPです。 |
収集頻度 | 指標収集間隔です。デフォルトは60sです。 |
収集タイムアウト時間 | 指標収集リクエストのタイムアウト時間です。デフォルトは30sです。 |
元のタグを保持 | 元の指標ラベルを保持するかどうかです。デフォルトでは無効です。 |
4. 設定が完了したら、送信をクリックします。完了後、収集を開始できます。
1. 右側のK8sカスタムサービス指標でYAMLからインポートをクリックし、設定フローに進みます。
2. 収集対象のクラスタを選択します。選択したクラスタで指標収集が有効になっていない場合は、赤い文字にマウスをホバーしてください。ガイドに従って指標収集を有効にすると、クラスタを選択できます。
3. 設定ページに入った後、指標収集を設定します。
4種類のYAMLタイプをサポートします：
ServiceMonitor(Prometheus-Operator)
PodMonitor(Prometheus-Operator)
ScrapeConfig(Prometheus-Operator)
ScrapeConfig（Prometheusネイティブ）
選択したタイプに応じて、YAML入力ボックスに関連設定を入力するだけで完了します。
4. 設定が完了したら、送信をクリックします。完了後、収集を開始できます。
ステップ3：検索分析
ここまでで、K8s指標収集の設定が完了しました。次のステップでは、検索分析ページに移動し、コンソール左側で対象の指標トピックを選択すると、指標の検索とクエリを実行できます。指標の検索構文ルールについては、指標検索構文ルールを参照してください。
フィードバック