このページの改善にご協力ください
このユーザーガイドに貢献するには、すべてのページの右側のペインにある「GitHub でこのページを編集する」リンクを選択してください。
クラスターインサイトを表示する
Amazon EKS は、設定インサイト、アップグレードインサイト、およびロールバックの準備状況インサイトの 3 種類のインサイトを提供します。設定インサイトは、クラスターまたはワークロードの機能を損なう可能性のある EKS Hybrid Nodes の設定ミスを特定します。アップグレードインサイトは、Kubernetes の新しいバージョンにアップグレードする機能に影響を与える可能性のある問題を特定します。ロールバックの準備状況インサイトは、アップグレード後に以前の Kubernetes バージョンにロールバックする機能に影響を与える可能性のある問題を特定します。
実行されたインサイトチェックのリストと、Amazon EKS によって特定された関連する問題を確認するには、AWS マネジメントコンソール、AWS CLI、AWS SDK、および Amazon EKS ListInsights API オペレーションを使用できます。
設定インサイトを表示する (コンソール)
-
Amazon EKS コンソール
を開きます。 -
クラスターのリストから、インサイトを確認する Amazon EKS クラスターの名前を選択します。
-
[クラスターを監視する] を選択します。
-
[クラスターヘルス] タブを選択します。
-
[設定インサイト] テーブルには、次の列が表示されます。
-
名前 — Amazon EKS がクラスターに対して実行したチェック。
-
インサイトステータス – ステータスが
Errorのインサイトは、クラスター機能に影響を与える可能性のある設定ミスがあることを意味します。ステータスがWarningのインサイトは、設定が文書化されたアプローチと一致しないことを意味しますが、クラスター機能を意図的に設定すると機能する可能性があります。ステータスがPassingのインサイトは、Amazon EKS でこのインサイトチェックに関連する問題がクラスター内で検出されなかったことを意味します。 -
バージョン – 該当するバージョン。
-
最終更新時刻 – このクラスターについてのインサイトのステータスが最後に更新された時刻。
-
説明 — アラートと修復のための推奨アクションを含むインサイトチェックの情報。
-
アップグレードインサイトを表示する (コンソール)
-
Amazon EKS コンソール
を開きます。 -
クラスターのリストから、インサイトを確認する Amazon EKS クラスターの名前を選択します。
-
[クラスターを監視する] を選択します。
-
[アップグレードインサイト] タブを選択します。
-
最新のデータを表示するには、[インサイトを更新] ボタンを選択し、更新操作が完了するまで待ちます。
-
[アップグレードインサイト] テーブルには、次の列が表示されます。
-
名前 — Amazon EKS がクラスターに対して実行したチェック。
-
インサイトステータス — ステータスが「エラー」のインサイトは、通常、影響を受ける Kubernetes バージョンが現在のクラスターバージョンの N+1 であることを意味し、ステータスが「警告」とは、インサイトが将来の Kubernetes バージョン N+2 以上に適用されることを意味します。ステータスが「合格」のインサイトは、Amazon EKS がこのインサイトチェックに関連する問題をクラスター内で発見しなかったことを意味します。インサイトステータスが「不明」の場合は、Amazon EKS はクラスターがこのインサイトチェックの影響を受けているかどうかを判断できないことを意味します。
-
バージョン — インサイトにより問題の可能性がチェックされた Kubernetes バージョン。
-
最終更新時刻 – このクラスターについてのインサイトのステータスが最後に更新された時刻。
-
前回の移行時刻 – このインサイトのステータスが最後に変更された時刻。
-
説明 — アラートと修復のための推奨アクションを含むインサイトチェックの情報。
-
注記
ロールバックの準備状況インサイトは、アップグレードの実行後に同じタブに表示され、7 日間のロールバック資格ウィンドウ中も表示されます。
クラスターインサイトを表示する (AWS CLI)
-
最新のデータを表示するには、指定されたクラスターのインサイトを更新します。必要に応じてコマンドに次の変更を加えてから、そのコマンドを実行してください。
-
region-codeを、AWS リージョンのコードに置き換えます。 -
マイクラスターの部分は自分のクラスター名に置き換えます。aws eks start-insights-refresh --regionregion-code--cluster-namemy-cluster
-
-
インサイト更新のステータスを追跡するには、次のコマンドを実行します。
マイクラスターの部分は自分のクラスター名に置き換えます。aws eks describe-insights-refresh --cluster-namemy-cluster出力例は次のとおりです。
{ "message": "Insights refresh is in progress", "status": "IN_PROGRESS", "startedAt": "2025-07-30T13:36:09-07:00" } -
指定されたクラスターのインサイトをリストします。必要に応じてコマンドに次の変更を加えてから、そのコマンドを実行してください。
-
region-codeを、AWS リージョンのコードに置き換えます。 -
マイクラスターの部分は自分のクラスター名に置き換えます。aws eks list-insights --regionregion-code--cluster-namemy-cluster出力例は次のとおりです。
{ "insights": [ { "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "name": "Deprecated APIs removed in Kubernetes vX.XX", "category": "UPGRADE_READINESS", "kubernetesVersion": "X.XX", "lastRefreshTime": 1734557315.000, "lastTransitionTime": 1734557309.000, "description": "Checks for usage of deprecated APIs that are scheduled for removal in Kubernetes vX.XX. Upgrading your cluster before migrating to the updated APIs supported by vX.XX could cause application impact.", "insightStatus": { "status": "PASSING", "reason": "No deprecated API usage detected within the last 30 days.", }, }, { "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "name": "Kubelet version skew", "category": "UPGRADE_READINESS", "kubernetesVersion": "X.XX", "lastRefreshTime": 1734557309.000, "lastTransitionTime": 1734557309.000, "description": "Checks for kubelet versions of worker nodes in the cluster to see if upgrade would cause non compliance with supported Kubernetes kubelet version skew policy.", "insightStatus": { "status": "UNKNOWN", "reason": "Unable to determine status of node kubelet versions.", }, }, { "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "name": "Deprecated APIs removed in Kubernetes vX.XX", "category": "UPGRADE_READINESS", "kubernetesVersion": "X.XX", "lastRefreshTime": 1734557315.000, "lastTransitionTime": 1734557309.000, "description": "Checks for usage of deprecated APIs that are scheduled for removal in Kubernetes vX.XX. Upgrading your cluster before migrating to the updated APIs supported by vX.XX could cause application impact.", "insightStatus": { "status": "PASSING", "reason": "No deprecated API usage detected within the last 30 days.", }, }, { "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLEaaaaa", "name": "Cluster health issues", "category": "UPGRADE_READINESS", "kubernetesVersion": "X.XX", "lastRefreshTime": 1734557314.000, "lastTransitionTime": 1734557309.000, "description": "Checks for any cluster health issues that prevent successful upgrade to the next Kubernetes version on EKS.", "insightStatus": { "status": "PASSING", "reason": "No cluster health issues detected.", }, }, { "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLEbbbbb", "name": "EKS add-on version compatibility", "category": "UPGRADE_READINESS", "kubernetesVersion": "X.XX", "lastRefreshTime": 1734557314.000, "lastTransitionTime": 1734557309.000, "description": "Checks version of installed EKS add-ons to ensure they are compatible with the next version of Kubernetes. ", "insightStatus": { "status": "PASSING", "reason": "All installed EKS add-on versions are compatible with next Kubernetes version."}, }, { "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLEccccc", "name": "kube-proxy version skew", "category": "UPGRADE_READINESS", "kubernetesVersion": "X.XX", "lastRefreshTime": 1734557314.000, "lastTransitionTime": 1734557309.000, "description": "Checks version of kube-proxy in cluster to see if upgrade would cause non compliance with supported Kubernetes kube-proxy version skew policy.", "insightStatus": { "status": "PASSING", "reason": "kube-proxy versions match the cluster control plane version.", }, }, { "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLEddddd", "name": "Deprecated APIs removed in Kubernetes vX.XX", "category": "UPGRADE_READINESS", "kubernetesVersion": "X.XX", "lastRefreshTime": 1734557315.000, "lastTransitionTime": 1734557309.000, "description": "Checks for usage of deprecated APIs that are scheduled for removal in Kubernetes vX.XX. Upgrading your cluster before migrating to the updated APIs supported by vX.XX could cause application impact.", "insightStatus": { "status": "PASSING", "reason": "No deprecated API usage detected within the last 30 days.", }, }, { "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE44444", "name": "Incompatible API usage", "category": "ROLLBACK_READINESS", "kubernetesVersion": "X.XX", "lastRefreshTime": 1734557315.000, "lastTransitionTime": 1734557309.000, "description": "Checks for usage of APIs that are not compatible with the previous Kubernetes version. Rolling back your cluster before removing incompatible API usage could cause data loss or application impact.", "insightStatus": { "status": "ERROR", "reason": "Incompatible API usage detected.", }, }, { "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE55555", "name": "Kubelet version rollback compatibility", "category": "ROLLBACK_READINESS", "kubernetesVersion": "X.XX", "lastRefreshTime": 1734557309.000, "lastTransitionTime": 1734557309.000, "description": "Checks for kubelet versions of worker nodes in the cluster to see if rollback would cause non compliance with supported Kubernetes kubelet version skew policy.", "insightStatus": { "status": "ERROR", "reason": "At least one node kubelet version matches the cluster control plane version.", }, }, { "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE66666", "name": "EKS add-on version rollback compatibility", "category": "ROLLBACK_READINESS", "kubernetesVersion": "X.XX", "lastRefreshTime": 1734557314.000, "lastTransitionTime": 1734557309.000, "description": "Checks version of installed EKS add-ons to ensure they are compatible with the previous version of Kubernetes.", "insightStatus": { "status": "PASSING", "reason": "All installed EKS add-on versions are compatible with previous Kubernetes version.", }, }, ], "nextToken": null, }
-
-
インサイトの詳細を表示するには、次のコマンドを実行します。必要に応じてコマンドに次の変更を加えてから、そのコマンドを実行してください。
-
region-codeを、AWS リージョンのコードに置き換えます。 -
a1b2c3d4-5678-90ab-cdef-EXAMPLE22222を、クラスターインサイトのリストから取得したインサイト ID に置き換えます。 -
マイクラスターの部分は自分のクラスター名に置き換えます。aws eks describe-insight --region region-code --ida1b2c3d4-5678-90ab-cdef-EXAMPLE22222--cluster-name my-cluster出力例は次のとおりです。
{ "insight": { "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "name": "Kubelet version skew", "category": "UPGRADE_READINESS", "kubernetesVersion": "1.27", "lastRefreshTime": 1734557309.000, "lastTransitionTime": 1734557309.000, "description": "Checks for kubelet versions of worker nodes in the cluster to see if upgrade would cause non compliance with supported Kubernetes kubelet version skew policy.", "insightStatus": { "status": "UNKNOWN", "reason": "Unable to determine status of node kubelet versions.", }, "recommendation": "Upgrade your worker nodes to match the Kubernetes version of your cluster control plane.", "additionalInfo": { "Kubelet version skew policy": "https://kubernetes.io/releases/version-skew-policy/#kubelet", "Updating a managed node group": "https://docs.aws.amazon.com/eks/latest/userguide/update-managed-node-group.html", }, "resources": [], "categorySpecificSummary": { "deprecationDetails": [], "addonCompatibilityDetails": [] }, }, }
-
前述の出力には、UPGRADE_READINESS と ROLLBACK_READINESS の両方のインサイトが表示されます。ロールバックの準備状況インサイトは、過去 7 日以内にアップグレードされたクラスターにのみ存在します。
カテゴリでインサイトをフィルタリングする
カテゴリでインサイトをフィルタリングして、特定のタイプのみを表示できます:
aws eks list-insights \ --cluster-namemy-cluster\ --regionregion-code\ --filter '{"categories": ["ROLLBACK_READINESS"]}'
ステータスでフィルタリングして、ブロックの問題のみを表示することもできます:
aws eks list-insights \ --cluster-namemy-cluster\ --regionregion-code\ --filter '{"categories": ["ROLLBACK_READINESS"], "statuses": ["ERROR"]}'
ロールバックの準備状況インサイトの詳細を表示する
ロールバックの準備状況インサイトでは、describe-insight コマンドは影響を受けるリソースと修復ステップに関する同様の情報を返します。例えば、次のようになります。
{
"clusterId": "73a0e91f-f016-4555-bb7c-177496c47c9d",
"insight": {
"category": "ROLLBACK_READINESS",
"name": "API usage rollback compatibility",
"kubernetesVersion": "1.32",
"insightStatus": {
"status": "ERROR",
"reason": "Detected incompatible API objects with version rollback."
},
"resources": [
{
"kubernetesResourceUri": "/apis/networking.k8s.io/v1/servicecidrs/kubernetes",
"status": {
"status": "ERROR",
"reason": "networking.k8s.io/v1 is not compatible with Kubernetes version 1.32"
}
}
]
}
}"status": "ERROR" でロールバックの準備状況インサイトが見つかった場合は、ロールバックを実行する前に問題に対処するか、--force フラグを使用してインサイトチェックをバイパスする必要があります。ロールバックプロセスの詳細については、「以前の Kubernetes バージョンにクラスターをロールバックする」を参照してください。
インサイトが UNKNOWN ステータスを示す場合、EKS はインサイトを評価できていません。ロールバックは、インサイトが正常に評価されるか、--force フラグを使用してインサイトチェックをバイパスするまでブロックされます。
