Unterstützung für die Verbesserung dieser Seite beitragen
Um zu diesem Benutzerhandbuch beizutragen, klicken Sie auf den Link Diese Seite auf GitHub bearbeiten, der sich im rechten Bereich jeder Seite befindet.
Cluster-Erkenntnisse anzeigen
Amazon EKS bietet zwei Arten von Einblicken: Konfigurationseinblicke und Upgrade-Einblicke. Konfigurationseinblicke identifizieren Fehlkonfigurationen in Ihrer Einrichtung von EKS Hybrid Nodes, welche die Funktionalität Ihres Clusters oder Ihrer Workloads beeinträchtigen könnten. Upgrade-Einblicke identifizieren Probleme, die sich auf Ihre Fähigkeit auswirken könnten, auf neue Versionen von Kubernetes zu aktualisieren.
Um die Liste der durchgeführten Erkenntnisprüfungen und alle relevanten Probleme anzuzeigen, die Amazon EKS identifiziert hat, können Sie die Suche in der AWS-Managementkonsole-, der AWS-CLI-, AWS-SDKs- und Amazon-EKS-ListInsights-API-Operation aufrufen.
Konfigurationserkenntnisse anzeigen (Konsole)
-
Öffnen Sie die Amazon-EKS-Konsole
. -
Wählen Sie in der Clusterliste den Namen des Amazon-EKS-Clusters aus, für den Sie die Erkenntnisse anzeigen möchten.
-
Wählen Sie Cluster überwachen aus.
-
Wählen Sie die Registerkarte Cluster-Zustand aus.
-
In der Tabelle Konfigurationsinformationen werden die folgenden Spalten angezeigt:
-
Name: Die Überprüfung, die von Amazon EKS für den Cluster durchgeführt wurde.
-
Erkenntnisstatus – Eine Erkenntnis mit dem Status
Errorweist auf eine Fehlkonfiguration hin, die wahrscheinlich die Cluster-Funktionalität beeinträchtigt. Eine Erkenntnis mit dem StatusWarningbedeutet, dass die Konfiguration nicht dem dokumentierten Ansatz entspricht, die Cluster-Funktionalität jedoch möglicherweise funktioniert, wenn Sie sie absichtlich konfiguriert haben. Eine Erkenntnis mit dem StatusPassingbedeutet, dass Amazon EKS keine Probleme im Zusammenhang mit dieser Erkenntnisüberprüfung in Ihrem Cluster festgestellt hat. -
Version – Die anwendbare Version.
-
Zeit der letzten Aktualisierung – Der Zeitpunkt, zu dem der Status der Erkenntnis für diesen Cluster zuletzt aktualisiert wurde.
-
Beschreibung: Informationen der letzten Erkenntnisüberprüfung (einschließlich der Warnung und der empfohlenen Behandlungsmaßnahmen).
-
Upgrade-Einblicke anzeigen (Konsole)
-
Öffnen Sie die Amazon-EKS-Konsole
. -
Wählen Sie in der Clusterliste den Namen des Amazon-EKS-Clusters aus, für den Sie die Erkenntnisse anzeigen möchten.
-
Wählen Sie Cluster überwachen aus.
-
Wählen Sie die Registerkarte Upgrade-Erkenntnisse aus.
-
Um die neuesten Daten anzuzeigen, klicken Sie auf die Schaltfläche Erkenntnisse aktualisieren und warten Sie, bis der Aktualisierungsvorgang abgeschlossen ist.
-
In der Tabelle Upgrade-Erkenntnisse werden die folgenden Spalten angezeigt:
-
Name: Die Überprüfung, die von Amazon EKS für den Cluster durchgeführt wurde.
-
Erkenntnisstatus: – Eine Erkenntnis mit dem Status „Fehler“ bedeutet normalerweise, dass die betroffene Kubernetes-Version N+1 der aktuellen Cluster-Version ist, während der Status „Warnung“ bedeutet, dass die Erkenntnis für eine zukünftige Kubernetes-Version N+2 oder höher gilt. Eine Erkenntnis mit dem Status „Bestanden“ bedeutet, dass Amazon EKS keine Probleme im Zusammenhang mit dieser Erkenntnisüberprüfung in Ihrem Cluster festgestellt hat. Bei einer Erkenntnis mit dem Status „Unbekannt“ kann Amazon EKS nicht feststellen, ob Ihr Cluster von dieser Erkenntnisüberprüfung betroffen ist.
-
Version – Die Kubernetes-Version, die das Erkenntnis auf mögliche Probleme überprüft hat.
-
Zeit der letzten Aktualisierung – Der Zeitpunkt, zu dem der Status der Erkenntnis für diesen Cluster zuletzt aktualisiert wurde.
-
Letzte Übergangszeit – Der Zeitpunkt, zu dem sich der Status dieser Erkenntnis zuletzt geändert hat.
-
Beschreibung: Informationen der letzten Erkenntnisüberprüfung (einschließlich der Warnung und der empfohlenen Behandlungsmaßnahmen).
-
Cluster-Erkenntnisse anzeigen (AWS-CLI)
-
Um die neuesten Daten anzuzeigen, aktualisieren Sie die Erkenntnisse für einen angegebenen Cluster. Nehmen Sie nach Bedarf die folgenden Änderungen am Befehl vor und führen Sie anschließend den geänderten Befehl aus:
-
Ersetzen Sie
region-codedurch den Code für Ihre AWS-Region. -
Ersetzen Sie
my-clusterdurch den Namen Ihres Clusters.aws eks start-insight-refresh --regionregion-code--cluster-namemy-cluster
-
-
Um den Status einer Erkenntnisaktualisierung zu verfolgen, führen Sie den folgenden Befehl aus. Ersetzen Sie
my-clusterdurch den Namen Ihres Clusters.aws eks describe-insights-refresh --cluster-namemy-clusterEine Beispielausgabe sieht wie folgt aus.
{ "message": "Insights refresh is in progress", "status": "IN_PROGRESS", "startedAt": "2025-07-30T13:36:09-07:00" } -
Listen Sie die Erkenntnisse für einen angegebenen Cluster auf. Nehmen Sie nach Bedarf die folgenden Änderungen am Befehl vor und führen Sie anschließend den geänderten Befehl aus:
-
Ersetzen Sie
region-codedurch den Code für Ihre AWS-Region. -
Ersetzen Sie
my-clusterdurch den Namen Ihres Clusters.aws eks list-insights --regionregion-code--cluster-namemy-clusterEine Beispielausgabe sieht wie folgt aus.
{ "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, }
-
-
Um beschreibende Informationen zu einer Erkenntnis zu erhalten, führen Sie den folgenden Befehl aus. Nehmen Sie nach Bedarf die folgenden Änderungen am Befehl vor und führen Sie anschließend den geänderten Befehl aus:
-
Ersetzen Sie
region-codedurch den Code für Ihre AWS-Region. -
Ersetzen Sie
a1b2c3d4-5678-90ab-cdef-EXAMPLE22222durch eine Erkenntnis-ID, die Sie aus der Auflistung der Cluster-Erkenntnisse abrufen. -
Ersetzen Sie
my-clusterdurch den Namen Ihres Clusters.aws eks describe-insight --region region-code --ida1b2c3d4-5678-90ab-cdef-EXAMPLE22222--cluster-name my-clusterEine Beispielausgabe sieht wie folgt aus.
{ "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": [] }, }, }
-