Visualizzare approfondimenti sulla configurazione (console)Visualizzare gli approfondimenti sugli aggiornamenti (console)Visualizzare gli approfondimenti sui cluster (AWS CLI)

Visualizzazione degli approfondimenti sui cluster

EKS fornisce due tipi di approfondimenti: Approfondimenti sulla configurazione e Approfondimenti sugli aggiornamenti. Gli approfondimenti sulla configurazione identificano le configurazioni errate nella configurazione di nodi ibridi EKS che potrebbero compromettere la funzionalità del cluster o dei carichi di lavoro. Gli approfondimenti sugli aggiornamenti identificano i problemi che potrebbero influire sulla capacità di aggiornamento a nuove versioni di Kubernetes.

Per visualizzare l’elenco dei controlli sugli approfondimenti eseguiti e gli eventuali problemi rilevanti identificati da Amazon EKS, è possibile consultare Console di gestione AWS, AWS CLI, AWS SDK e richiamare l’operazione dell’API ListInsights di Amazon EKS.

Visualizzare approfondimenti sulla configurazione (console)

Aprire la Console Amazon EKS.
Dall'elenco dei cluster, scegli il nome del cluster Amazon EKS per il quale desideri visualizzare gli approfondimenti.
Scegli Monitora cluster.
Scegli la scheda Integrità del cluster.
Nella tabella Approfondimenti sulla configurazione, vedrai le seguenti colonne:
- Nome: il controllo eseguito da Amazon EKS sul cluster.
- Stato di approfondimento: un approfondimento con stato Error indica una configurazione errata che potrebbe influire sulla funzionalità del cluster. Un approfondimento con uno stato Warning indica che la configurazione non corrisponde all’approccio documentato, ma che la funzionalità del cluster potrebbe funzionare se configurata intenzionalmente. Un approfondimento con lo stato Passing indica che Amazon EKS non ha riscontrato alcun problema associato a questo controllo sull’approfondimento nel cluster.
- Versione: la versione applicabile.
- Ora dell’ultimo aggiornamento: l’ora in cui lo stato dell’approfondimento è stato aggiornato l’ultima volta per questo cluster.
- Descrizione: informazioni tratte dal controllo sull'approfondimento, che include l'avviso e le azioni consigliate per la correzione.

Visualizzare gli approfondimenti sugli aggiornamenti (console)

Aprire la Console Amazon EKS.
Dall'elenco dei cluster, scegli il nome del cluster Amazon EKS per il quale desideri visualizzare gli approfondimenti.
Scegli Monitora cluster.
Scegli la scheda Approfondimenti sugli aggiornamenti.
Per visualizzare i dati più recenti, scegli il pulsante Aggiorna approfondimenti e attendi il completamento dell’operazione di aggiornamento.
Nella tabella Approfondimenti sugli aggiornamenti, vedrai le seguenti colonne:
- Nome: il controllo eseguito da Amazon EKS sul cluster.
- Stato dell’approfondimento: un approfondimento che presenta lo stato “Errore” in genere indica che la versione di Kubernetes interessata è N+1 rispetto alla versione corrente del cluster, mentre lo stato “Avviso” indica che l’approfondimento si applica a una versione di Kubernetes futura N+2 o superiore. Un approfondimento con lo stato "Ammesso" indica che Amazon EKS non ha riscontrato alcun problema associato a questo controllo sull'approfondimento nel cluster. Lo stato dell'approfondimento "Sconosciuto" significa che Amazon EKS non è in grado di determinare se il cluster è interessato da questo controllo sull'approfondimento.
- Versione: la versione di Kubernetes che l’approfondimento ha verificato per individuare possibili problemi.
- Ora dell’ultimo aggiornamento: l’ora in cui lo stato dell’approfondimento è stato aggiornato l’ultima volta per questo cluster.
- Ora dell’ultima transizione: l’ora in cui lo stato di questo approfondimento è cambiato l’ultima volta.
- Descrizione: informazioni tratte dal controllo sull'approfondimento, che include l'avviso e le azioni consigliate per la correzione.

Visualizzare gli approfondimenti sui cluster (AWS CLI)

Utilizza gli approfondimenti per un cluster specificato per visualizzare i dati più recenti. Apporta le seguenti modifiche al comando, se necessario, quindi esegui il comando modificato:
- Sostituisci region-code con il codice della regione AWS.
- Sostituisci my-cluster con il nome del tuo cluster.
```
aws eks start-insight-refresh --region region-code --cluster-name my-cluster
                  
```

Esegui il comando seguente per tenere traccia dello stato di un aggiornamento di approfondimenti. Sostituisci my-cluster con il nome del tuo cluster.


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

Di seguito viene riportato un output di esempio:


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

Elenca gli approfondimenti per un cluster specificato. Apporta le seguenti modifiche al comando, se necessario, quindi esegui il comando modificato:

Sostituisci region-code con il codice della regione AWS.

Sostituisci my-cluster con il nome del tuo cluster.


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

Di seguito viene riportato un output di esempio:


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

Esegui il comando seguente per visualizzare le informazioni dettagliate relative a un approfondimento. Apporta le seguenti modifiche al comando, se necessario, quindi esegui il comando modificato:

Sostituisci region-code con il codice della regione AWS.
Sostituisci a1b2c3d4-5678-90ab-cdef-EXAMPLE22222 con un ID di approfondimento recuperato dall’elenco degli approfondimenti sui cluster.

Sostituisci my-cluster con il nome del tuo cluster.


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

Di seguito viene riportato un output di esempio:


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

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Approfondimenti sui cluster

Aggiornamento della versione di Kubernetes