Afficher les informations de configuration (console)Afficher les informations de mise à niveau (console)Afficher les informations sur le cluster (AWS CLI)

Afficher les informations sur le cluster

Amazon EKS fournit deux types d’informations : Informations sur la configuration et Informations sur la mise à niveau. Informations sur la configuration identifie les erreurs de configuration dans votre configuration de nœuds hybrides Amazon EKS qui pourraient nuire au fonctionnement de votre cluster ou de vos charges de travail. Informations sur la mise à niveau identifie les problèmes qui pourraient affecter votre capacité à mettre à niveau vers de nouvelles versions de Kubernetes.

Pour afficher la liste des vérifications effectuées et les problèmes pertinents identifiés par Amazon EKS, vous pouvez appeler le hook dans la AWS Management Console, l’AWS CLI, les SDK AWS et l’opération API Amazon EKS ListInsights.

Afficher les informations de configuration (console)

Ouvrez la console Amazon EKS.
Dans la liste de clusters, choisissez le nom du cluster Amazon EKS pour lequel vous souhaitez obtenir des informations.
Sélectionnez Surveiller le cluster.
Sélectionnez l’onglet Santé du cluster.
Dans le tableau Informations de configuration, vous verrez les colonnes suivantes :
- Nom : vérification effectuée par Amazon EKS par rapport au cluster.
- Statut de l’information : une information dont le statut est Error signifie qu’il existe une erreur de configuration susceptible d’affecter le fonctionnement du cluster. Une information dont le statut est Warning signifie que la configuration ne correspond pas à l’approche documentée, mais que le cluster peut fonctionner si vous l’avez configuré intentionnellement. Une information dont le statut est Passing signifie qu’Amazon EKS n’a détecté aucun problème associé à ce contrôle de statut dans votre cluster.
- Version : la version applicable.
- Dernière heure d’actualisation : heure à laquelle le statut de l’information a été actualisé pour la dernière fois pour ce cluster.
- Description : informations provenant de la vérification des informations, qui incluent l'alerte et les mesures correctives recommandées.

Afficher les informations de mise à niveau (console)

Ouvrez la console Amazon EKS.
Dans la liste de clusters, choisissez le nom du cluster Amazon EKS pour lequel vous souhaitez obtenir des informations.
Sélectionnez Surveiller le cluster.
Sélectionnez l’onglet Informations de mise à niveau.
Pour afficher les dernières données, cliquez sur le bouton Actualiser les informations et attendez que l’opération d’actualisation soit terminée.
Dans le tableau Informations de mise à niveau, vous verrez les colonnes suivantes :
- Nom : vérification effectuée par Amazon EKS par rapport au cluster.
- Statut de l’information : une information dont le statut est « Erreur » signifie généralement que la version Kubernetes concernée est N+1 de la version actuelle du cluster, tandis qu’un statut « Avertissement » signifie que l’information s’applique à une future version Kubernetes N+2 ou supérieure. Une information dont le statut est « Réussi » signifie qu'Amazon EKS n'a détecté aucun problème associé à cette vérification d'informations dans votre cluster. Une information dont le statut est « Inconnu » signifie qu'Amazon EKS n'est pas en mesure de déterminer si votre cluster est concerné par cette vérification des informations.
- Version : la version Kubernetes pour laquelle l’information a vérifié les problèmes éventuels.
- Dernière heure d’actualisation : heure à laquelle le statut de l’information a été actualisé pour la dernière fois pour ce cluster.
- Dernière transition : heure à laquelle le statut de cette information a été modifié pour la dernière fois.
- Description : informations provenant de la vérification des informations, qui incluent l'alerte et les mesures correctives recommandées.

Afficher les informations sur le cluster (AWS CLI)

Pour afficher les dernières données, actualisez les informations pour un cluster spécifié. Apportez les modifications suivantes à la commande si nécessaire, puis exécutez la commande modifiée.
- Remplacez region-code par le code de votre région AWS.
- Remplacez my-cluster par le nom de votre cluster.
```
aws eks start-insight-refresh --region region-code --cluster-name my-cluster
                  
```

Pour suivre l’état d’actualisation des informations, exécutez la commande suivante. Remplacez my-cluster par le nom de votre cluster.


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

L'exemple qui suit illustre un résultat.


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

Répertoriez les informations pour un cluster spécifié. Apportez les modifications suivantes à la commande si nécessaire, puis exécutez la commande modifiée.

Remplacez region-code par le code de votre région AWS.

Remplacez my-cluster par le nom de votre cluster.


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

L'exemple qui suit illustre un résultat.


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

Pour obtenir des informations descriptives sur une information, exécutez la commande suivante. Apportez les modifications suivantes à la commande si nécessaire, puis exécutez la commande modifiée.

Remplacez region-code par le code de votre région AWS.
Remplacez a1b2c3d4-5678-90ab-cdef-EXAMPLE22222 par un ID d’information récupéré à partir de la liste des informations du cluster.

Remplacez my-cluster par le nom de votre cluster.


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

L'exemple qui suit illustre un résultat.


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

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Informations sur le cluster

Mises à jour de la version Kubernetes