檢視組態洞察 (主控台)檢視升級洞察 (主控台)檢視叢集洞察 (AWS CLI)

檢視叢集洞察

Amazon EKS 提供兩種類型的洞見：組態洞見和升級洞見。組態洞察可辨識出 EKS 混合節點設定中的錯誤組態，這些設定可能會使叢集或工作負載的功能受損。升級洞察可辨識出可能會影響升級至 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 版本。
- 上次重新整理時間 – 上次重新整理此叢集的洞察狀態的時間。
- 上次轉換時間 – 此洞察的狀態上次變更的時間。
- 描述：來自洞察檢查的資訊，其中包括提醒和建議的補救措施。

檢視叢集洞察 (AWS CLI)

如需檢視最新資料，重新整理指定叢集的洞察。視需要對命令進行下列修改，然後執行修改後的命令。
- 使用您的 AWS 區域代碼取代 region-code 。
- 使用您叢集的名稱取代 my-cluster。
```
aws eks start-insight-refresh --region region-code --cluster-name my-cluster
                  
```

如需追蹤洞察重新整理的狀態，執行以下命令。使用您叢集的名稱取代 my-cluster。


aws eks describe-insights-refresh --cluster-name my-cluster

範例輸出如下。


{
    "message": "Insights refresh is in progress",
    "status": "IN_PROGRESS",
    "startedAt": "2025-07-30T13:36:09-07:00"
}

列示指定叢集的洞察。視需要對命令進行下列修改，然後執行修改後的命令。

使用您的 AWS 區域代碼取代 region-code 。

使用您叢集的名稱取代 my-cluster。


aws eks list-insights --region region-code --cluster-name my-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.",
            },
        },
    ],
"nextToken": null,
}

如需洞察的描述性資訊，執行以下命令。視需要對命令進行下列修改，然後執行修改後的命令。

使用您的 AWS 區域代碼取代 region-code 。
使用從列示叢集洞察的清單中擷取的洞察 ID 來取代 a1b2c3d4-5678-90ab-cdef-EXAMPLE22222。

使用您叢集的名稱取代 my-cluster。


aws eks describe-insight --region region-code --id a1b2c3d4-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": [] },
    },
}

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

叢集洞見

更新 Kubernetes 版本