Consulta de la información de configuración (consola)Consulta de la información de actualización (consola)Consulta de la información del clúster (AWS CLI)

Consulta de la información del clúster

Amazon EKS proporciona tres tipos de información: información de configuración, información de actualización e información de preparación para la reversión. La información de configuración identifica errores de configuración en la configuración de los nodos híbridos de EKS que podrían afectar a la funcionalidad del clúster o las cargas de trabajo. La información de actualización identifica los problemas que podrían afectar a su capacidad de actualizar a nuevas versiones de Kubernetes. La información de preparación para la reversión identifica los problemas que podrían afectar a su capacidad de revertir a una versión anterior de Kubernetes después de una actualización.

Para ver la lista de comprobaciones de información hechas y cualquier problema pertinente que Amazon EKS haya identificado, puede usar la operación Consola de administración de AWS, la CLI de AWS, los SDK de AWS y la API ListInsights de Amazon EKS.

Consulta de la información de configuración (consola)

Abra la consola de Amazon EKS.
En la lista de clústeres, elija el nombre del clúster de Amazon EKS del que desea ver la información.
Elija Supervisar clúster.
Elija la pestaña Estado del clúster.
En la tabla Información de configuración, verá las siguientes columnas:
- Nombre: la comprobación realizada por Amazon EKS en relación con el clúster.
- Estado de la información: una información con un estado de Error significa que hay un error de configuración que probablemente esté afectando a la funcionalidad del clúster. Una información con un estado de Warning significa que la configuración no coincide con el enfoque documentado, pero que la funcionalidad del clúster podría funcionar si la configuró intencionadamente. Una información con el estado de Passing significa que Amazon EKS no encontró ningún problema relacionado con esta comprobación de información en su clúster.
- Versión: la versión aplicable.
- Hora de la última actualización: la hora en que se actualizó por última vez el estado de la información para este clúster.
- Descripción: información de la comprobación de información, que incluye la alerta y las acciones recomendadas para su corrección.

Consulta de la información de actualización (consola)

Abra la consola de Amazon EKS.
En la lista de clústeres, elija el nombre del clúster de Amazon EKS del que desea ver la información.
Elija Supervisar clúster.
Seleccione la pestaña Información sobre actualizaciones.
Para ver los datos más recientes, pulse Actualizar información y espere a que finalice la operación de actualización.
En la tabla Información sobre actualizaciones, verá las siguientes columnas:
- Nombre: la comprobación realizada por Amazon EKS en relación con el clúster.
- Estado de la información: una información con un estado de “Error” normalmente significa que la versión de Kubernetes afectada es N+1 de la versión actual del clúster, mientras que un estado de “Advertencia” significa que la información se aplica a una versión futura de Kubernetes N+2 o posterior. Una información con el estado “Aprobado” significa que Amazon EKS no ha encontrado ningún problema relacionado con esta comprobación de información en su clúster. Un estado de información “Desconocido” significa que Amazon EKS no puede determinar si su clúster se ve afectado por esta comprobación de información.
- Versión: la versión de Kubernetes que la información comprobó para detectar posibles problemas.
- Hora de la última actualización: la hora en que se actualizó por última vez el estado de la información para este clúster.
- Hora de la última transición: la hora en que se modificó por última vez el estado de esta información.
- Descripción: información de la comprobación de información, que incluye la alerta y las acciones recomendadas para su corrección.

nota

La información de preparación para la reversión aparece en la misma pestaña después de llevar a cabo una actualización y permanece visible durante el periodo de 7 días en el que se puede revertir.

Consulta de la información del clúster (AWS CLI)

Para ver los datos más recientes, actualice la información de un clúster especificado. Lleve a cabo las siguientes modificaciones en el comando según sea necesario y, a continuación, ejecute el comando modificado.
- Reemplace region-code por el código de la región de AWS.
- Reemplace my-cluster por el nombre de su clúster.
```
aws eks start-insights-refresh --region region-code --cluster-name my-cluster
                  
```

Para hacer un seguimiento del estado de una actualización de información, ejecute el siguiente comando. Reemplace my-cluster por el nombre de su clúster.


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

Un ejemplo de salida sería el siguiente.


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

Enumere la información de un clúster especificado. Lleve a cabo las siguientes modificaciones en el comando según sea necesario y, a continuación, ejecute el comando modificado.

Reemplace region-code por el código de la región de AWS.

Reemplace my-cluster por el nombre de su clúster.


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

Un ejemplo de salida sería el siguiente.


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

Para obtener información descriptiva, ejecuta el siguiente comando. Lleve a cabo las siguientes modificaciones en el comando según sea necesario y, a continuación, ejecute el comando modificado.

Reemplace region-code por el código de la región de AWS.
Sustituya a1b2c3d4-5678-90ab-cdef-EXAMPLE22222 por un ID de información recuperado de la lista de información del clúster.

Reemplace my-cluster por el nombre de su clúster.


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

Un ejemplo de salida sería el siguiente.


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

La salida anterior muestra tanto la información de UPGRADE_READINESS como de ROLLBACK_READINESS. La información de preparación para la reversión solo está disponible para los clústeres que se hayan actualizado en los últimos 7 días.

Filtrado de información por categoría

Puede filtrar la información por categoría para ver solo un tipo específico:


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

También puede filtrar por estado para ver solo los problemas de bloqueo:


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

Visualización de los detalles de la información de preparación para la reversión

Para la información de preparación para la reversión, el comando describe-insight devuelve información similar sobre los recursos afectados y los pasos de corrección. Por ejemplo:


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

Si encuentra información de preparación para la reversión con "status": "ERROR", debe abordar el problema antes de llevar a cabo la reversión o utilizar el indicador --force para omitir las comprobaciones de información. Para obtener más información sobre el proceso de reversión, consulte Reversión de un clúster a una versión anterior de Kubernetes.

Si la información muestra el estado UNKNOWN, EKS no ha podido evaluarla. La reversión se bloquea hasta que la información se pueda evaluar correctamente o hasta que se utilice el indicador --force para omitir las comprobaciones de información.

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Información sobre clústeres

Actualización de una versión de Kubernetes