Lihat wawasan konfigurasi (Konsol)Lihat wawasan peningkatan (Konsol)Lihat wawasan kluster (AWS CLI)

Lihat wawasan kluster

Amazon EKS menyediakan tiga jenis wawasan: Wawasan konfigurasi, Wawasan upgrade, dan wawasan kesiapan Rollback. Wawasan konfigurasi mengidentifikasi kesalahan konfigurasi dalam penyiapan Node Hibrid EKS Anda yang dapat mengganggu fungsionalitas klaster atau beban kerja Anda. Upgrade insights mengidentifikasi masalah yang dapat memengaruhi kemampuan Anda untuk meningkatkan ke versi Kubernetes yang baru. Wawasan kesiapan rollback mengidentifikasi masalah yang dapat memengaruhi kemampuan Anda untuk memutar kembali ke versi Kubernetes sebelumnya setelah peningkatan.

Untuk melihat daftar pemeriksaan wawasan yang dilakukan dan masalah terkait apa pun yang telah diidentifikasi Amazon EKS, Anda dapat menggunakan operasi Konsol Manajemen AWS, AWS CLI, AWS SDK, dan Amazon ListInsights EKS API.

Lihat wawasan konfigurasi (Konsol)

Buka konsol Amazon EKS.
Dari daftar cluster, pilih nama cluster Amazon EKS yang ingin Anda lihat wawasannya.
Pilih Monitor cluster.
Pilih tab Kesehatan cluster.
Dalam tabel Configuration insights, Anda akan melihat kolom berikut:
- Nama — Pemeriksaan yang dilakukan oleh Amazon EKS terhadap cluster.
- Status wawasan — Wawasan dengan status Error berarti ada kesalahan konfigurasi yang kemungkinan memengaruhi fungsionalitas klaster. Wawasan dengan status Warning berarti bahwa konfigurasi tidak cocok dengan pendekatan yang didokumentasikan, tetapi fungsionalitas klaster itu mungkin berfungsi jika Anda mengonfigurasinya dengan sengaja. Wawasan dengan status Passing berarti Amazon EKS tidak menemukan masalah apa pun yang terkait dengan pemeriksaan wawasan ini di klaster Anda.
- Versi - Versi yang berlaku.
- Waktu penyegaran terakhir — Waktu status wawasan terakhir disegarkan untuk cluster ini.
- Deskripsi — Informasi dari pemeriksaan wawasan, yang mencakup peringatan dan tindakan yang direkomendasikan untuk perbaikan.

Lihat wawasan peningkatan (Konsol)

Buka konsol Amazon EKS.
Dari daftar cluster, pilih nama cluster Amazon EKS yang ingin Anda lihat wawasannya.
Pilih Monitor cluster.
Pilih tab Upgrade insights.
Untuk melihat data terbaru, pilih tombol Refresh insight dan tunggu hingga operasi penyegaran selesai.
Dalam tabel Upgrade insights, Anda akan melihat kolom berikut:
- Nama — Pemeriksaan yang dilakukan oleh Amazon EKS terhadap cluster.
- Insight status — Insight dengan status “Error” biasanya berarti versi Kubernetes yang terkena dampak adalah N+1 dari versi klaster saat ini, sedangkan status “Peringatan” berarti wawasan tersebut berlaku untuk Kubernetes versi N+2 yang akan datang atau lebih. Wawasan dengan status “Passing” berarti Amazon EKS tidak menemukan masalah apa pun yang terkait dengan pemeriksaan wawasan ini di klaster Anda. Status wawasan “Tidak Diketahui” berarti Amazon EKS tidak dapat menentukan apakah klaster Anda terpengaruh oleh pemeriksaan wawasan ini.
- Versi — Versi Kubernetes yang diperiksa wawasan untuk kemungkinan masalah.
- Waktu penyegaran terakhir — Waktu status wawasan terakhir disegarkan untuk cluster ini.
- Waktu transisi terakhir — Waktu status wawasan ini terakhir berubah.
- Deskripsi — Informasi dari pemeriksaan wawasan, yang mencakup peringatan dan tindakan yang direkomendasikan untuk perbaikan.

catatan

Wawasan kesiapan rollback muncul di tab yang sama setelah Anda melakukan peningkatan dan tetap terlihat selama jendela kelayakan rollback 7 hari.

Lihat wawasan kluster (AWS CLI)

Untuk melihat data terbaru, segarkan wawasan untuk klaster tertentu. Buat modifikasi berikut pada perintah sesuai kebutuhan dan kemudian jalankan perintah yang dimodifikasi.
- Ganti region-code dengan kode untuk AWS Wilayah Anda.
- Ganti my-cluster dengan nama klaster Anda.
```
aws eks start-insights-refresh --region region-code --cluster-name my-cluster
                  
```

Untuk melacak status penyegaran wawasan, jalankan perintah berikut. Ganti my-cluster dengan nama klaster Anda.


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

Contoh output adalah sebagai berikut.


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

Buat daftar wawasan untuk cluster tertentu. Buat modifikasi berikut pada perintah sesuai kebutuhan dan kemudian jalankan perintah yang dimodifikasi.

Ganti region-code dengan kode untuk AWS Wilayah Anda.

Ganti my-cluster dengan nama klaster Anda.


aws eks list-insights --region region-code --cluster-name my-cluster

Contoh output adalah sebagai berikut.


{
"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,
}

Untuk informasi deskriptif tentang wawasan, jalankan perintah berikut. Buat modifikasi berikut pada perintah sesuai kebutuhan dan kemudian jalankan perintah yang dimodifikasi.

Ganti region-code dengan kode untuk AWS Wilayah Anda.
Ganti a1b2c3d4-5678-90ab-cdef-EXAMPLE22222 dengan ID wawasan yang diambil dari daftar wawasan cluster.

Ganti my-cluster dengan nama klaster Anda.


aws eks describe-insight --region region-code --id a1b2c3d4-5678-90ab-cdef-EXAMPLE22222 --cluster-name my-cluster

Contoh output adalah sebagai berikut.


{
  "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": [] },
    },
}

Output sebelumnya menunjukkan keduanya UPGRADE_READINESS dan ROLLBACK_READINESS wawasan. Wawasan kesiapan rollback hanya ada untuk cluster yang telah ditingkatkan dalam 7 hari terakhir.

Filter wawasan berdasarkan kategori

Anda dapat memfilter wawasan berdasarkan kategori untuk hanya melihat jenis tertentu:


aws eks list-insights \
  --cluster-name my-cluster \
  --region region-code \
  --filter '{"categories": ["ROLLBACK_READINESS"]}'

Anda juga dapat memfilter berdasarkan status untuk melihat hanya masalah pemblokiran:


aws eks list-insights \
  --cluster-name my-cluster \
  --region region-code \
  --filter '{"categories": ["ROLLBACK_READINESS"], "statuses": ["ERROR"]}'

Lihat detail wawasan kesiapan rollback

Untuk wawasan kesiapan rollback, describe-insight perintah mengembalikan informasi serupa tentang sumber daya yang terpengaruh dan langkah-langkah remediasi. Contoh:


{
    "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"
                }
            }
        ]
    }
}

Jika Anda menemukan wawasan kesiapan rollback"status": "ERROR", Anda harus mengatasi masalah tersebut sebelum melakukan rollback, atau menggunakan --force flag untuk melewati pemeriksaan wawasan. Untuk informasi lebih lanjut tentang proses rollback, lihat. Rollback cluster ke versi Kubernetes sebelumnya

Jika wawasan menunjukkan UNKNOWN status, EKS tidak dapat mengevaluasi wawasan. Rollback diblokir hingga insight berhasil dievaluasi, atau Anda menggunakan --force flag untuk melewati pemeriksaan insight.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Wawasan cluster

Perbarui versi Kubernetes