Container Insights によって収集されるメトリック
Container insights は、Azure Kubernetes Service (AKS) と Azure Arc 対応 Kubernetes クラスターのノードとポッドからカスタム メトリックを収集します。 カスタム メトリックによって、次のことができます。
- パフォーマンス グラフにタイムリーな集計計算 (平均、カウント、最大、最小、合計) を表示する。
- Azure portal ダッシュボードにパフォーマンス グラフをピン留めする。
- メトリック アラートを活用する。
重要
これらのメトリックは、「コンテナー分析情報の推奨アラート (カスタム メトリック) (プレビュー) の廃止が 2024 年 5 月 31 日に前倒し」で説明されているように、2024 年 3 月 31 日以降は収集されなくなります。 Prometheus メトリックの収集を有効にする方法については、「Prometheus と Grafana を有効にする」を参照してください。
カスタム メトリックを使用する
Container Insights によって収集されるカスタム メトリックには、メトリック エクスプローラーやメトリック アラートなど、他のデータ ソースから収集されるカスタム メトリックと同じ方法でアクセスできます。
収集されるメトリック
次のセクションでは、クラスターについて収集されるメトリック値について説明します。
ノード メトリック
名前空間: Insights.container/nodes
ディメンション: host
| メトリック | 説明 |
|---|---|
| cpuUsageMillicores | ホスト別の CPU 使用率 (ミリコア単位)。 |
| cpuUsagePercentage、cpuUsageAllocatablePercentage (プレビュー) | ノード別の CPU 使用率と、割り当て可能な CPU 使用率。 |
| memoryRssBytes | ホスト別のメモリ RSS 使用量 (バイト単位)。 |
| memoryRssPercentage、memoryRssAllocatablePercentage (プレビュー) | ホスト別のメモリ RSS 使用率と、割り当て可能なメモリ RSS 使用率。 |
| memoryWorkingSetBytes | ホスト別のメモリ ワーキング セット使用量 (バイト単位)。 |
| memoryWorkingSetPercentage、memoryRssAllocatablePercentage (プレビュー) | ホスト別のメモリ ワーキング セット使用率と、割り当て可能なメモリ ワーキング セット使用率。 |
| nodesCount | 状態別のノード数。 |
| diskUsedPercentage | デバイス別のノードで使用されるディスクの割合 (%)。 |
ポッドのメトリック
名前空間: Insights.container/pods
Dimensions: controllerName, Kubernetes namespace
| メトリック | 説明 |
|---|---|
| podCount | コントローラー、名前空間、ノード、フェーズ別のポッド数。 |
| completedJobsCount | ユーザーが構成可能なしきい値 (既定値は 6 時間) より前に完了したジョブのコントローラー、Kubernetes 名前空間別の数。 |
| restartingContainerCount | コントローラーおよび Kubernetes 名前空間別のコンテナー再起動回数。 |
| oomKilledContainerCount | OOM により中止されたコンテナーのコントローラーおよび Kubernetes 名前空間別の数。 |
| podReadyPercentage | コントローラーおよび Kubernetes 名前空間別の準備完了状態のポッドの割合 (%)。 |
コンテナー メトリック
名前空間: Insights.container/containers
ディメンション: containerName、 controllerName、 Kubernetes namespace、 podName
| メトリック | 説明 |
|---|---|
| (古い)cpuExceededPercentage | ユーザーが構成可能なしきい値 (既定値は 95.0) を超えるコンテナーの CPU 使用率 (%)。コンテナー名、コントローラー名、Kubernetes 名前空間、ポッド名別。 収集済み |
| (新規)cpuThresholdViolated | メトリックは、コンテナーの CPU 使用率がユーザーが構成可能なしきい値 (既定値は 95.0) をコンテナー名、コントローラー名、Kubernetes 名前空間、ポッド名別に超えた場合にトリガーされます。 収集済み |
| (古い)memoryRssExceededPercentage | ユーザーが構成可能なしきい値 (既定値は 95.0) を超えるコンテナーのメモリ RSS (%)。コンテナー名、コントローラー名、Kubernetes 名前空間、ポッド名別。 |
| (新規)memoryRssThresholdViolated | メトリックは、コンテナーのメモリ RSS (%) がユーザーが構成可能なしきい値 (既定値は 95.0) をコンテナー名、コントローラー名、Kubernetes 名前空間、ポッド名別に超えた場合にトリガーされます。 |
| (古い)memoryWorkingSetExceededPercentage | ユーザーが構成可能なしきい値 (既定値は 95.0) を超えるコンテナーのメモリ ワーキング セットの割合 (%)。コンテナー名、コントローラー名、Kubernetes 名前空間、ポッド名別。 |
| (新規)memoryWorkingSetThresholdViolated | メトリックは、コンテナーのメモリ ワーキング セットの割合 (%) が、ユーザーが構成可能なしきい値 (既定値は 95.0) をコンテナー名、コントローラー名、Kubernetes 名前空間、ポッド名別に超えた場合にトリガーされます。 |
永続ボリュームのメトリック
名前空間: Insights.container/persistentvolumes
ディメンション: kubernetesNamespace、 node、 podName、 volumeName
| メトリック | 説明 |
|---|---|
| (古い)pvUsageExceededPercentage | ユーザーが構成可能なしきい値 (既定値は 60.0) を超える永続ボリュームの永続ボリューム (PV) 使用率 (%)。要求名、Kubernetes 名前空間、ボリューム名、ポッド名、ノード名別。 |
| (新規)pvUsageThresholdViolated | メトリックは、永続ボリュームの PV 使用率 (%) が、ユーザーが構成可能なしきい値 (既定値は 60.0) を要求名、Kubernetes 名前空間、ボリューム名、ポッド名、ノード名別に超えた場合にトリガーされます。 |
カスタム メトリックを有効にする
クラスターで Container Insights に マネージド ID 認証が使用されている場合は、カスタム メトリックが有効になります。 そうでない場合は、以下のいずれかの方法を使用してカスタム メトリックを有効にする必要があります。
このプロセスにより、クラスターのサービス プリンシパルに 監視メトリック パブリッシャー ロールが割り当てられます。 監視指標パブリッシャーには、リソースにメトリックをプッシュする権限しかありません。 状態の変更、リソースの更新、データの読み取りはできません。 詳細については、「監視メトリック パブリッシャー ロールを参照してください。 監視メトリック パブリッシャー ロールの要件は、Azure Arc 対応 Kubernetes クラスターには適用されません。
前提条件
クラスターを更新する前に、ノードとポッドのカスタム パフォーマンス メトリックの収集を可能にするために、AKS クラスター リソースの所有者ロールのメンバーであることを確認してください。 この要件は、Azure Arc 対応 Kubernetes クラスターには適用されません。
有効化オプション
1 つのクラスターまたはサブスクリプション内のすべてのクラスターのカスタム メトリックを有効にするには、次のいずれかの方法を使用します。
Azure portal でクラスターの [Insights] メニューを選択します。
ウィンドウの上部に表示されるバナーで、[有効] を選択して更新を開始します。
プロセスが完了するまでに数秒かかる場合があります。 進行状況は、メニューの [通知] で追跡できます。
更新プログラムを確認する
カスタム メトリックが有効になっていることを確認するには、メトリック エクスプローラーを開き、メトリック名前空間から [Insights] が一覧表示されていることを確認します。