Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Installa l' CloudWatch agente con il componente aggiuntivo Amazon CloudWatch Observability EKS o il diagramma Helm

Puoi utilizzare il componente aggiuntivo Amazon CloudWatch Observability EKS o il grafico Amazon CloudWatch Observability Helm per installare l' CloudWatch agente e l' Fluent-bit agente su un cluster Amazon EKS. Puoi anche utilizzare il diagramma Helm per installare l' CloudWatch agente e l' Fluent-bit agente su un cluster Kubernetes non ospitato su Amazon EKS.

L'utilizzo di entrambi i metodi su un cluster Amazon EKS abilita sia Container Insights for Amazon EKS che CloudWatch Application Signals per impostazione predefinita. Utilizzando il componente aggiuntivo, è possibile raccogliere le metriche dell'infrastruttura, la telemetria delle prestazioni delle applicazioni e i log dei container dal cluster.

A partire dalla versione v6.2.0-eksbuild.1 o successiva del componente aggiuntivo, è possibile abilitare Container Insights with OpenTelemetry metrics, che raccoglie le metriche utilizzando il OpenTelemetry protocollo (OTLP) e supporta le query ProMQL. Per ulteriori informazioni, consulta Otel Container Insights (consigliato).

Con Container Insights with OpenTelemetry for Amazon EKS, le metriche di Container Insights vengono addebitate per GB ingerito o per osservazione se si utilizza Enhanced Container Insights (Classic). Per Application Signals, la fatturazione si basa sulle richieste in entrata alle applicazioni, sulle richieste in uscita dalle applicazioni e su ogni obiettivo del livello di servizio (SLO) configurato. Ogni richiesta in entrata ricevuta e ogni richiesta in uscita effettuata genera un segnale di applicazione. Ogni SLO crea due segnali di applicazione per ciascun periodo di misurazione. Per ulteriori informazioni sui CloudWatch prezzi, consulta Amazon Pricing. CloudWatch

Entrambi i metodi abilitano Approfondimenti sui container su nodi di lavoro Linux e Windows nel cluster Amazon EKS. Per abilitare Approfondimenti sui container su Windows, è necessario utilizzare la versione 1.5.0 o successiva del componente aggiuntivo Amazon EKS o il grafico Helm. Application Signals non è supportato su Windows nei cluster Amazon EKS.

Il componente aggiuntivo Amazon CloudWatch Observability EKS è supportato sui cluster Amazon EKS in esecuzione con Kubernetes versione 1.23 o successiva.

Quando installi il componente aggiuntivo o il grafico Helm, devi anche concedere le autorizzazioni IAM per consentire all' CloudWatch agente di inviare metriche, log e tracce a. CloudWatch Ci sono due modi per effettuare questa operazione:

Opzione 1: installazione utilizzando EKS Pod Identity

Se si utilizza la versione 3.1.0 o successiva del componente aggiuntivo, è possibile utilizzare EKS Pod Identity per concedere le autorizzazioni richieste al componente aggiuntivo. EKS Pod Identity è l'opzione consigliata e offre vantaggi come il privilegio minimo, la rotazione delle credenziali e la verificabilità. Inoltre, l'utilizzo di EKS Pod Identity consente di installare il componente aggiuntivo EKS come parte della creazione del cluster stesso.

Per utilizzare questo metodo, segui innanzitutto i passaggi di Associazione EKS Pod Identity per creare il ruolo IAM e configurare l'agente EKS Pod Identity.

Quindi installa il componente aggiuntivo Amazon CloudWatch Observability EKS. Per installare il componente aggiuntivo, puoi utilizzare la AWS CLI console Amazon EKS o Terraform CloudFormation.

AWS CLI

Per utilizzare nuovamente il plugin AWS CLI per installare il componente aggiuntivo Amazon CloudWatch Observability EKS

Esegui i comandi seguenti: Sostituiscilo my-cluster-name con il nome del cluster e sostituiscilo 111122223333 con l'ID del tuo account. Sostituisci my-role con il ruolo IAM che hai creato nella fase di associazione EKS Pod Identity.

aws iam attach-role-policy \
--role-name my-role \
--policy-arn arn:aws:iam::aws:policy/CloudWatchAgentServerPolicy

aws eks create-addon \
--addon-name amazon-cloudwatch-observability \
--cluster-name my-cluster-name \
--pod-identity-associations serviceAccount=cloudwatch-agent,roleArn=arn:aws:iam::111122223333:role/my-role

Amazon EKS console

Per utilizzare la console Amazon EKS per aggiungere il componente aggiuntivo Amazon CloudWatch Observability EKS

1. Apri la console Amazon EKS all'indirizzo https://console.aws.amazon.com/eks/home #/clusters.

2. Nel pannello di navigazione a sinistra, seleziona Cluster.

3. Scegli il nome del cluster per cui desideri configurare il componente aggiuntivo Amazon CloudWatch Observability EKS.

4. Scegli la scheda Add-ons.

5. Scegli Ottieni altri componenti aggiuntivi.

6. Nella pagina Seleziona componenti aggiuntivi, procedi come segue:

   1. Nella EKS-addons sezione Amazon, seleziona la casella di controllo Amazon CloudWatch Observability.

   2. Scegli Next (Successivo).

7. Nella pagina Configura le impostazioni dei componenti aggiuntivi selezionati, procedi come segue:

   1. Seleziona la Versione che desideri utilizzare.

   2. Per Add-on accedere, seleziona EKS Pod Identity

   3. Se non hai configurato un ruolo IAM, scegli Crea ruolo consigliato, quindi scegli Avanti fino al Passaggio 3: Nomina, verifica e crea. Puoi cambiare il nome del tuo ruolo se lo desideri, altrimenti scegli Crea ruolo, quindi torna alla Add-on pagina e seleziona il ruolo IAM che hai appena creato.

   4. (Facoltativo) È possibile espandere le Impostazioni di configurazione facoltative. Se selezioni Sostituisci per Metodo di risoluzione dei conflitti, una o più impostazioni per il componente aggiuntivo esistente possono essere sovrascritte con le impostazioni del componente aggiuntivo di Amazon EKS. Se rimuovi questa opzione e c'è un conflitto con le impostazioni esistenti, l'operazione non va a buon fine e viene visualizzato un messaggio di errore per aiutarti a risolvere il conflitto. Prima di selezionare questa opzione, assicurarsi che il componente aggiuntivo Amazon EKS non gestisca le impostazioni che devono essere gestite dall'utente.

   5. Scegli Next (Successivo).

8. Nella pagina Rivedi e aggiungi, scegli Crea. Una volta completata l'installazione, viene visualizzato il componente aggiuntivo.

CloudFormation

Per utilizzare CloudFormation per installare il componente aggiuntivo Amazon CloudWatch Observability EKS

1. Innanzitutto, esegui il AWS CLI comando seguente per allegare la policy IAM necessaria al tuo ruolo IAM. Sostituisci my-role con il ruolo che hai creato nella fase di associazione EKS Pod Identity.

   aws iam attach-role-policy \
   --role-name my-role \
   --policy-arn arn:aws:iam::aws:policy/CloudWatchAgentServerPolicy

2. Successivamente, crea le seguenti risorse. Sostituisci my-cluster-name con il nome del tuo cluster, sostituisci 111122223333 con l'ID del tuo account e sostituisci my-role con il ruolo IAM creato nella fase di associazione EKS Pod Identity. Per ulteriori informazioni, consulta la sezione AWS::EKS::Addon.

   {
   "Resources": {
       "EKSAddOn": {
           "Type": "AWS::EKS::Addon",
           "Properties": {
               "AddonName": "amazon-cloudwatch-observability",
               "ClusterName": "my-cluster-name",
               "PodIdentityAssociations": [
                   {
                       "ServiceAccount": "cloudwatch-agent",
                       "RoleArn": "arn:aws:iam::111122223333:role/my-role"
                   }
               ]
           }
       }
   }
   }

Terraform

Per utilizzare Terraform per installare il componente aggiuntivo Amazon CloudWatch Observability EKS

1. Utilizza quanto segue. Sostituiscilo my-cluster-name con il nome del tuo cluster, sostituiscilo 111122223333 con l'ID del tuo account e sostituiscilo my-service-account-role con il ruolo IAM creato nella fase di associazione EKS Pod Identity.

   Per ulteriori informazioni, consulta Resource: aws_eks_addon nella documentazione di Terraform.

2. resource "aws_iam_role_policy_attachment" "CloudWatchAgentServerPolicy" {
     policy_arn = "arn:aws:iam::aws:policy/CloudWatchAgentServerPolicy"
     role       = "my-role"
   }
   
   resource "aws_eks_addon" "example" {
     cluster_name = "my-cluster-name"
     addon_name   = "amazon-cloudwatch-observability"
     pod_identity_associations {
     roleArn = "arn:aws:iam::111122223333:role/my-role"
     serviceAccount = "cloudwatch-agent"
     }
   }

Opzione 2: installazione con autorizzazioni IAM sui nodi di lavoro

Per utilizzare questo metodo, collega innanzitutto la policy CloudWatchAgentServerPolicy IAM ai nodi di lavoro inserendo il seguente comando. In questo comando, sostituisci my-worker-node-role con il ruolo IAM utilizzato dai tuoi nodi di lavoro Kubernetes.

aws iam attach-role-policy \
--role-name my-worker-node-role \
--policy-arn arn:aws:iam::aws:policy/CloudWatchAgentServerPolicy

Quindi installa il componente aggiuntivo Amazon CloudWatch Observability EKS. Per installare il componente aggiuntivo, puoi utilizzare la AWS CLI console o Terraform CloudFormation.

AWS CLI

Per utilizzare nuovamente il plugin AWS CLI per installare il componente aggiuntivo Amazon CloudWatch Observability EKS

Inserire il seguente comando. Sostituisci my-cluster-name con il nome del cluster.

aws eks create-addon --addon-name amazon-cloudwatch-observability --cluster-name my-cluster-name

Amazon EKS console

Per utilizzare la console Amazon EKS per aggiungere il componente aggiuntivo Amazon CloudWatch Observability EKS

1. Apri la console Amazon EKS all'indirizzo https://console.aws.amazon.com/eks/home #/clusters.

2. Nel pannello di navigazione a sinistra, seleziona Cluster.

3. Scegli il nome del cluster per cui desideri configurare il componente aggiuntivo Amazon CloudWatch Observability EKS.

4. Scegli la scheda Add-ons.

5. Scegli Ottieni altri componenti aggiuntivi.

6. Nella pagina Seleziona componenti aggiuntivi, procedi come segue:

   1. Nella EKS-addons sezione Amazon, seleziona la casella di controllo Amazon CloudWatch Observability.

   2. Scegli Next (Successivo).

7. Nella pagina Configura le impostazioni dei componenti aggiuntivi selezionati, procedi come segue:

   1. Seleziona la Versione che desideri utilizzare.

   2. (Facoltativo) È possibile espandere le Impostazioni di configurazione facoltative. Se selezioni Sostituisci per Metodo di risoluzione dei conflitti, una o più impostazioni per il componente aggiuntivo esistente possono essere sovrascritte con le impostazioni del componente aggiuntivo di Amazon EKS. Se rimuovi questa opzione e c'è un conflitto con le impostazioni esistenti, l'operazione non va a buon fine e viene visualizzato un messaggio di errore per aiutarti a risolvere il conflitto. Prima di selezionare questa opzione, assicurarsi che il componente aggiuntivo Amazon EKS non gestisca le impostazioni che devono essere gestite dall'utente.

   3. Scegli Next (Successivo).

8. Nella pagina Rivedi e aggiungi, scegli Crea. Una volta completata l'installazione, viene visualizzato il componente aggiuntivo.

CloudFormation

Per utilizzare CloudFormation per installare il componente aggiuntivo Amazon CloudWatch Observability EKS

Sostituisci my-cluster-name con il nome del cluster. Per ulteriori informazioni, consulta la sezione AWS::EKS::Addon.

{
"Resources": {
    "EKSAddOn": {
        "Type": "AWS::EKS::Addon",
        "Properties": {
            "AddonName": "amazon-cloudwatch-observability",
            "ClusterName": "my-cluster-name"
        }
    }
}
}

Helm chart

Per utilizzare il grafico Helm di amazon-cloudwatch-observability

1. È necessario che Helm sia installato per utilizzare questo grafico. Per ulteriori informazioni sull'installazione di Helm, consulta la documentazione di Helm.

2. Dopo aver installato Helm, immetti i seguenti comandi. Sostituiscilo my-cluster-name con il nome del cluster e sostituiscilo my-cluster-region con la regione in cui viene eseguito il cluster.

   helm repo add aws-observability https://aws-observability.github.io/helm-charts
   helm repo update aws-observability
   helm install --wait --create-namespace --namespace amazon-cloudwatch amazon-cloudwatch-observability aws-observability/amazon-cloudwatch-observability --set clusterName=my-cluster-name --set region=my-cluster-region

Terraform

Per utilizzare Terraform per installare il componente aggiuntivo Amazon CloudWatch Observability EKS

Sostituisci my-cluster-name con il nome del cluster. Per ulteriori informazioni, consulta la sezione Risorsa: aws_eks_addon.

resource "aws_eks_addon" "example" {
  addon_name   = "amazon-cloudwatch-observability"
  cluster_name = "my-cluster-name"
}

Opzione 3: installazione tramite il ruolo dell'account di servizio IAM (si applica solo all'utilizzo del componente aggiuntivo)

Questo metodo è valido solo se utilizzi il componente aggiuntivo Amazon CloudWatch Observability EKS. Prima di utilizzare questo metodo, verifica di soddisfare i seguenti prerequisiti:

AWS CLI

Per utilizzare nuovamente il plugin AWS CLI per installare il componente aggiuntivo Amazon CloudWatch Observability EKS utilizzando il ruolo dell'account del servizio IAM

1. Immetti il comando seguente per creare un provider OpenID Connect (OIDC), se il cluster non ne ha già uno. Per ulteriori informazioni, consulta la pagina Configuring a Kubernetes service account to assume an IAM role nella Guida per l'utente di Amazon EKS.

   eksctl utils associate-iam-oidc-provider --cluster my-cluster-name --approve

2. Inserisci il seguente comando per creare il ruolo IAM con la CloudWatchAgentServerPolicy policy allegata e configurare l'account del servizio agente in modo che assuma quel ruolo utilizzando OIDC. Sostituiscilo my-cluster-name con il nome del tuo cluster e sostituiscilo my-service-account-role con il nome del ruolo a cui desideri associare l'account di servizio. Se il ruolo non esiste ancora, eksctl lo crea per tuo conto.

   eksctl create iamserviceaccount \
     --name cloudwatch-agent \
     --namespace amazon-cloudwatch --cluster my-cluster-name \
     --role-name my-service-account-role \
     --attach-policy-arn arn:aws:iam::aws:policy/CloudWatchAgentServerPolicy \
     --role-only \
     --approve

3. Installa il componente aggiuntivo immettendo il seguente comando. Sostituisci my-cluster-name con il nome del tuo cluster, sostituisci 111122223333 con l'ID del tuo account e sostituisci my-service-account-role con il ruolo IAM creato nel passaggio precedente.

   aws eks create-addon --addon-name amazon-cloudwatch-observability --cluster-name my-cluster-name --service-account-role-arn arn:aws:iam::111122223333:role/my-service-account-role

Amazon EKS console

Per utilizzare la console per installare il componente aggiuntivo Amazon CloudWatch Observability EKS utilizzando il ruolo dell'account del servizio IAM

1. Apri la console Amazon EKS all'indirizzo https://console.aws.amazon.com/eks/home #/clusters.

2. Nel pannello di navigazione a sinistra, seleziona Cluster.

3. Scegli il nome del cluster per cui desideri configurare il componente aggiuntivo Amazon CloudWatch Observability EKS.

4. Scegli la scheda Add-ons.

5. Scegli Ottieni altri componenti aggiuntivi.

6. Nella pagina Seleziona componenti aggiuntivi, procedi come segue:

   1. Nella EKS-addons sezione Amazon, seleziona la casella di controllo Amazon CloudWatch Observability.

   2. Scegli Next (Successivo).

7. Nella pagina Configura le impostazioni dei componenti aggiuntivi selezionati, procedi come segue:

   1. Seleziona la Versione che desideri utilizzare.

   2. Per Add-on l'accesso, seleziona i ruoli IAM per gli account di servizio (IRSA)

   3. Seleziona il ruolo IAM nella casella di Add-on accesso.

   4. (Facoltativo) È possibile espandere le Impostazioni di configurazione facoltative. Se selezioni Sostituisci per Metodo di risoluzione dei conflitti, una o più impostazioni per il componente aggiuntivo esistente possono essere sovrascritte con le impostazioni del componente aggiuntivo di Amazon EKS. Se rimuovi questa opzione e c'è un conflitto con le impostazioni esistenti, l'operazione non va a buon fine e viene visualizzato un messaggio di errore per aiutarti a risolvere il conflitto. Prima di selezionare questa opzione, assicurarsi che il componente aggiuntivo Amazon EKS non gestisca le impostazioni che devono essere gestite dall'utente.

   5. Scegli Next (Successivo).

8. Nella pagina Rivedi e aggiungi, scegli Crea. Una volta completata l'installazione, viene visualizzato il componente aggiuntivo.

(Facoltativo) Configurazione aggiuntiva

Disattivazione della raccolta di log di container

Per impostazione predefinita, l'add-on utilizza Fluent Bit per raccogliere i log dei container da tutti i pod e quindi inviarli a Logs. CloudWatch Per informazioni su quali log vengono raccolti, consulta la pagina Inviare i CloudWatch log ai Logs.

Per disattivare la raccolta dei log dei container se stai utilizzando il componente aggiuntivo Amazon CloudWatch Observability EKS, passa la seguente opzione quando crei o aggiorni il componente aggiuntivo:

--configuration-values '{ "containerLogs": { "enabled": false } }'

Per annullare la raccolta dei log dei container se utilizzi il grafico Helm, utilizza la seguente opzione quando crei o aggiorni il componente aggiuntivo:

--set containerLogs.enabled=false

Utilizzo di una configurazione Fluent Bit personalizzata

A partire dalla versione 1.7.0 del componente aggiuntivo Amazon CloudWatch Observability EKS, puoi modificare la configurazione di Fluent Bit quando crei o aggiorni il componente aggiuntivo o il grafico Helm. Fornisci la configurazione Fluent Bit personalizzata nella sezione di livello root containerLogs della configurazione avanzata del componente aggiuntivo o sostituisci i valori nel grafico Helm. All'interno di questa sezione, fornisci la configurazione Fluent Bit personalizzata nella sezione config (per Linux) o nella sezione configWindows (per Windows). config è ulteriormente suddiviso nelle seguenti sottosezioni:

Per trovare la config sezione relativa al tuo cluster, consulta aws-observability/helm-charts on GitHub e trova la release corrispondente alla versione dell'add-on o del grafico di Helm che stai installando. Quindi vai a /charts/amazon-cloudwatch-observability/values.yaml per individuare la sezione config (per Linux) e la sezione configWindows (per Windows) all'interno della sezione fluentBit sotto containerLogs.

Ad esempio, la configurazione predefinita di Fluent Bit per la versione 1.7.0 è disponibile qui.

Ti consigliamo di fornirlo config come YAML quando lo fornisci utilizzando la configurazione avanzata del componente aggiuntivo Amazon EKS o quando lo fornisci come valore sostitutivo per l'installazione di Helm. Assicurati che YAML sia conforme alla seguente struttura.

containerLogs:
  fluentBit:
config:
  service: |
    ...
  customParsers: |
    ...
  extraFiles:
    application-log.conf: |
      ...
    dataplane-log.conf: |
      ...
    host-log.conf: |
      ...

L'esempio seguente di config modifica l'impostazione globale per l'intervallo di flush in modo che sia di 45 secondi. Anche se l'unica modifica riguarda il campo Flush, è comunque necessario fornire la definizione di SERVICE completa per la sottosezione del servizio. Poiché questo esempio non ha specificato le sostituzioni per le altre sottosezioni, per esse vengono utilizzate le impostazioni predefinite.

containerLogs:
  fluentBit:
config:
  service: |
    [SERVICE]
      Flush                     45
      Grace                     30
      Log_Level                 error
      Daemon                    off
      Parsers_File              parsers.conf
      storage.path              /var/fluent-bit/state/flb-storage/
      storage.sync              normal
      storage.checksum          off
      storage.backlog.mem_limit 5M

La configurazione di esempio seguente include un file conf Fluent bit aggiuntivo. In questo esempio, stai aggiungendo un sottoinsieme personalizzato che verrà incluso my-service.conf in extraFiles aggiunta ai tre predefiniti. extraFiles

containerLogs:
  fluentBit:
config:
  extraFiles:
    my-service.conf: |
      [INPUT]
        Name              tail
        Tag               myservice.*
        Path              /var/log/containers/*myservice*.log
        DB                /var/fluent-bit/state/flb_myservice.db
        Mem_Buf_Limit     5MB
        Skip_Long_Lines   On
        Ignore_Older      1d
        Refresh_Interval  10
      
      [OUTPUT]
        Name                cloudwatch_logs
        Match               myservice.*
        region              ${AWS_REGION}
        log_group_name      /aws/containerinsights/${CLUSTER_NAME}/myservice
        log_stream_prefix   ${HOST_NAME}-
        auto_create_group   true

Il prossimo esempio rimuove completamente un file conf esistente da extraFiles. Ciò lo esclude completamente da application-log.conf sovrascrivendolo con una stringa vuota. La semplice omissione application-log.conf da extraFiles comporterebbe invece l'utilizzo dell'impostazione predefinita, che non è ciò che si sta cercando di ottenere in questo esempio. Lo stesso vale per la rimozione di qualsiasi file conf personalizzato che potresti aver aggiunto in precedenza a extraFiles.

containerLogs:
  fluentBit:
config:
  extraFiles:
    application-log.conf: ""

Gestione delle tolleranze di Kubernetes per i carichi di lavoro dei pod installati

A partire dalla versione 1.7.0 del componente aggiuntivo Amazon CloudWatch Observability EKS, il componente aggiuntivo e il diagramma Helm impostano di default le tolleranze di Kubernetes per tollerare tutte le contaminazioni sui carichi di lavoro del pod installati dall'add-on o dal diagramma Helm. Ciò garantisce che i daemonset come l'agent e Fluent Bit possano pianificare i pod su tutti i nodi del cluster per impostazione predefinita. CloudWatch Per ulteriori informazioni su taint e tolleranze, consulta Taints and Tolerations nella documentazione di Kubernetes.

Le tolleranze predefinite impostate dal componente aggiuntivo o dal grafico Helm sono le seguenti:

tolerations:
- operator: Exists

È possibile sovrascrivere le tolleranze predefinite impostando il campo tolerations al livello root quando si utilizza la configurazione avanzata del componente aggiuntivo o quando si installa o si aggiorna il grafico Helm con sostituzioni dei valori. Di seguito è riportato un possibile esempio:

tolerations:
- key: "key1"
  operator: "Exists"
  effect: "NoSchedule"

Per omettere completamente le tolleranze, puoi utilizzare una configurazione simile alla seguente:

tolerations: []

Qualsiasi modifica alle tolleranze si applica a tutti i carichi di lavoro dei pod installati dal componente aggiuntivo o dal grafico Helm.

Disattivazione della raccolta di metriche di calcolo accelerato

Per impostazione predefinita, Container Insights con osservabilità avanzata raccoglie metriche per il monitoraggio di Accelerated Compute, tra cui le metriche NVIDIA GPU, le metriche AWS Neuron per Trainium e Inferentia e le metriche Elastic Fabric Adapter (EFA). AWS AWS AWS

Le metriche delle GPU NVIDIA dai carichi di lavoro di Amazon EKS vengono raccolte per impostazione predefinita a partire dalla versione del componente aggiuntivo EKS o dal diagramma Helm e dalla versione dell'agente. v1.3.0-eksbuild.1 1.300034.0 CloudWatch Per un elenco delle metriche raccolte e dei prerequisiti, consulta Metriche della GPU NVIDIA.

AWS Le metriche Neuron per gli acceleratori AWS Trainium e AWS Inferentia vengono raccolte per impostazione predefinita a partire dalla versione del componente aggiuntivo EKS o del diagramma Helm e dalla versione v1.5.0-eksbuild.1 dell'agente. 1.300036.0 CloudWatch Per un elenco delle metriche raccolte e dei prerequisiti, consulta AWS Metriche dei neuroni per AWS Trainium e AWS Inferentia.

AWS Le metriche di Elastic Fabric Adapter (EFA) dai nodi Linux sui cluster Amazon EKS vengono raccolte per impostazione predefinita a partire dalla versione del componente aggiuntivo EKS o dal diagramma Helm e dalla versione v1.5.2-eksbuild.1 dell'agente. 1.300037.0 CloudWatch Per un elenco delle metriche raccolte e dei prerequisiti, consulta AWS Metriche Elastic Fabric Adapter (EFA).

Puoi scegliere di non raccogliere queste metriche impostando il accelerated_compute_metrics campo nel file di configurazione dell'agente su. CloudWatch false Questo campo si trova nella kubernetes sezione della metrics_collected sezione del file di CloudWatch configurazione. Di seguito è riportato un esempio di configurazione di non adesione. Per ulteriori informazioni su come utilizzare le configurazioni personalizzate degli CloudWatch agenti, vedere la sezione seguente,Utilizza una configurazione personalizzata CloudWatch dell'agente.

{
  "logs": {
"metrics_collected": {
  "kubernetes": {
    "enhanced_container_insights": true,
    "accelerated_compute_metrics": false
  }
}
  }
}

Utilizza una configurazione personalizzata CloudWatch dell'agente

Per raccogliere altre metriche, log o tracce utilizzando l' CloudWatch agente, puoi specificare una configurazione personalizzata mantenendo abilitati anche Container Insights e CloudWatch Application Signals. Per fare ciò, incorpora il file di configurazione CloudWatch dell'agente nella chiave di configurazione sotto la chiave agente della configurazione avanzata che puoi usare per creare o aggiornare il componente aggiuntivo EKS o il grafico Helm. Di seguito è rappresentata la configurazione predefinita dell'agente quando non si fornisce alcuna configurazione aggiuntiva.

L'esempio seguente mostra la configurazione predefinita dell' CloudWatch agente su Windows. L' CloudWatch agente su Windows non supporta la configurazione personalizzata.

{
  "logs": {
"metrics_collected": {
  "kubernetes": {
    "enhanced_container_insights": true
  },
}
  }
}

Gestisci i certificati webhook di ammissione TLS

L'add-on Amazon CloudWatch Observability EKS e il grafico Helm utilizzano i webhook di ammissione Kubernetes per convalidare e modificare le richieste di risorse (CR) Instrumentation personalizzate AmazonCloudWatchAgent e, facoltativamente, le richieste pod Kubernetes sul cluster se Application Signals è abilitato. CloudWatch In Kubernetes, i webhook richiedono un certificato TLS di cui il server API è configurato in modo affidabile per garantire una comunicazione sicura.

Per impostazione predefinita, il componente aggiuntivo Amazon CloudWatch Observability EKS e il grafico Helm generano automaticamente una CA autofirmata e un certificato TLS firmato da questa CA per proteggere la comunicazione tra il server API e il server webhook. Questo certificato generato automaticamente ha una scadenza predefinita di 10 anni e non viene rinnovato automaticamente alla scadenza. Inoltre, il bundle CA e il certificato vengono rigenerati ogni volta che il componente aggiuntivo o il grafico Helm viene aggiornato o reinstallato, reimpostando così la scadenza. Se desideri modificare la scadenza predefinita del certificato generato automaticamente, puoi utilizzare le seguenti configurazioni aggiuntive durante la creazione o l'aggiornamento del componente aggiuntivo. Sostituiscilo con la durata expiry-in-days di scadenza desiderata in giorni.

Per una soluzione di autorità di certificazione più sicura e ricca di funzionalità, il componente aggiuntivo offre il supporto opt-in per cert-manager, una soluzione ampiamente adottata per la gestione dei certificati TLS in Kubernetes che semplifica il processo di ottenimento, rinnovo, gestione e utilizzo di tali certificati. Assicura che i certificati siano validi e aggiornati e tenta di rinnovarli in un orario configurato prima della scadenza. cert-manager semplifica inoltre l'emissione di certificati da una varietà di fonti supportate, inclusa Private Certificate Authority. AWS Certificate Manager

Ti consigliamo di esaminare le best practice per la gestione dei certificati TLS sui tuoi cluster e di scegliere di utilizzare cert-manager per gli ambienti di produzione. Tieni presente che se scegli di abilitare cert-manager per la gestione dei certificati TLS del webhook di ammissione, devi preinstallare cert-manager sul tuo cluster Amazon EKS prima di installare il componente aggiuntivo Amazon CloudWatch Observability EKS o il diagramma Helm. Per ulteriori informazioni sulle opzioni di installazione disponibili, consulta la documentazione di cert-manager. Dopo l'installazione, puoi scegliere di utilizzare cert-manager per la gestione dei certificati TLS webhook di ammissione utilizzando la seguente configurazione aggiuntiva.

--configuration-values '{ "admissionWebhooks": { "certManager": { "enabled": true } } }' 

La configurazione avanzata discussa in questa sezione utilizza per impostazione predefinita un SelfSigned emittente.

Raccolta degli ID dei volumi Amazon EBS

Se desideri raccogliere gli ID dei volumi Amazon EBS nei log delle prestazioni, ti basta aggiungere al ruolo IAM un'altra policy collegata ai nodi worker o all'account di servizio. Aggiungi quanto segue come una policy inline. Per ulteriori informazioni, consulta la pagina Adding and Removing IAM Identity Permissions.

JSON

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Action": [
                "ec2:DescribeVolumes"
            ],
            "Resource": "*",
            "Effect": "Allow"
        }
    ]
}

Raccolta delle metriche di Java Management Extensions (JMX)

L' CloudWatch agente supporta la raccolta di metriche Java Management Extensions (JMX) su Amazon EKS. Ciò consente di raccogliere metriche aggiuntive dalle applicazioni Java in esecuzione su cluster Amazon EKS, consentendo di ottenere informazioni dettagliate su prestazioni, utilizzo della memoria, traffico e altre metriche critiche. Per ulteriori informazioni, consulta Raccolta delle metriche di Java Management Extensions (JMX).

Abilitazione delle metriche di Kueue

A partire dalla versione v2.4.0-eksbuild.1 del componente aggiuntivo CloudWatch Observability EKS, Container Insights for Amazon EKS supporta la raccolta di metriche Kueue dai cluster Amazon EKS. Per ulteriori informazioni su questi parametri, consulta Metriche Kueue.

Se stai utilizzando il componente aggiuntivo Amazon SageMaker AI Hyperpod Task Governance EKS, puoi saltare i passaggi nella sezione Prerequisiti e seguire semplicemente i passaggi indicati. Abilitazione del flag di configurazione

Prerequisiti

Prima di installare Kueue nel cluster Amazon EKS, apporta le seguenti modifiche al file manifesto:

Abilitazione del flag di configurazione

Per abilitare le metriche di Kueue, è necessario abilitare kueue_container_insights nella configurazione aggiuntiva del componente aggiuntivo. Puoi farlo utilizzando il componente aggiuntivo EKS Observability AWS CLI per configurare o utilizzando la console Amazon EKS.

Dopo aver installato correttamente il componente aggiuntivo EKS Observability con uno dei seguenti metodi, puoi visualizzare le metriche del cluster Amazon EKS nella scheda Dashboard della console. HyperPod

AWS CLI

Per abilitare le metriche Kueue utilizzando AWS CLI

• Immetti il seguente AWS CLI comando per installare il componente aggiuntivo.

  aws eks create-addon --cluster-name cluster-name --addon-name amazon-cloudwatch-observability --configuration-values "configuration_json_file"

  Di seguito è riportato un esempio del file JSON con i valori di configurazione.

  {
  "agent": {
      "config": {
          "logs": {
              "metrics_collected": {
                  "kubernetes": {
                      "kueue_container_insights": true,
                      "enhanced_container_insights": true
                  },
                  "application_signals": { }
              }
          },
          "traces": {
              "traces_collected": {
                  "application_signals": { }
              }
          }
      },
  },
  }

Amazon EKS console

Per abilitare le metriche di Kueue tramite la console Amazon EKS

1. Apri la console Amazon EKS all'indirizzo https://console.aws.amazon.com/eks/home #/clusters.

2. Scegli il nome del cluster.

3. Scegli Add-ons.

4. Trova il componente aggiuntivo Amazon CloudWatch Observability nell'elenco e installalo. Quando lo fai, scegli Configurazione facoltativa e includi i seguenti valori di configurazione JSON.

   {
   "agent": {
       "config": {
           "logs": {
               "metrics_collected": {
                   "kubernetes": {
                       "kueue_container_insights": true,
                       "enhanced_container_insights": true
                   },
                   "application_signals": { }
               }
           },
           "traces": {
               "traces_collected": {
                   "application_signals": { }
               }
           }
       },
   },
   }

Aggiungere i file di configurazione del OpenTelemetry raccoglitore

L' CloudWatch agente supporta file di configurazione supplementari del OpenTelemetry raccoglitore insieme ai propri file di configurazione. Questa funzionalità consente di utilizzare le funzionalità degli CloudWatch agenti come CloudWatch Application Signals o Container Insights attraverso la configurazione dell' CloudWatch agente e di inserire la configurazione esistente del OpenTelemetry raccoglitore con un singolo agente.

Per evitare conflitti di fusione con le pipeline create automaticamente dall' CloudWatch agente, aggiungete un suffisso personalizzato a ciascuno dei componenti e delle pipeline nella configurazione del raccoglitore. OpenTelemetry In questo modo si eviteranno scontri e conflitti di unione.

Abilitazione dell'APM tramite Application Signals per il tuo cluster Amazon EKS

Per impostazione predefinita, OpenTelemetry l'Application Performance Monitoring (APM) basato su (OTEL) è abilitato tramite Application Signals quando si installa il componente aggiuntivo CloudWatch Observability EKS (V5.0.0 o versione successiva) o il diagramma Helm. Puoi personalizzare ulteriormente impostazioni specifiche utilizzando la configurazione avanzata per il componente aggiuntivo Amazon EKS o sovrascrivendo i valori con il grafico Helm.

Monitor automatico di Application Signals

La versione 5.0.0 del componente aggiuntivo CloudWatch Observability Amazon EKS e del grafico Helm introduce nuove funzionalità. Ora puoi abilitare automaticamente Application Signals per tutti o specifici carichi di lavoro di servizio nel tuo cluster EKS tramite la configurazione di Monitor automatico. Le seguenti impostazioni autoMonitor possono essere specificate nella sezione applicationSignals sotto la sezione manager della configurazione avanzata.

Di seguito è riportato un esempio di configurazione che abilita automaticamente Application Signals per tutti i carichi di lavoro di servizio esistenti e nuovi sul cluster.

manager:
  applicationSignals:
autoMonitor:
  monitorAllServices: true
  restartPods: true

Di seguito è riportato un esempio di configurazione che abilita automaticamente Application Signals per ogni nuovo carico di lavoro di servizio che viene attivato e per qualsiasi carico di lavoro di servizio esistente che viene riavviato in modo esplicito nel cluster.

manager:
  applicationSignals:
autoMonitor:
  monitorAllServices: true

Di seguito è riportato un esempio di configurazione che abilita automaticamente Application Signals con Java per tutti i pod esistenti e nuovi che corrispondono a un carico di lavoro nel namespace pet-warehouse.

manager:
  applicationSignals:
autoMonitor:
  restartPods: true
  customSelector:
    java:
      namespaces: ["pet-warehouse"]

Di seguito è riportato un esempio di configurazione che abilita automaticamente Application Signals con Python per tutti i carichi di lavoro di servizio esistenti e nuovi sul cluster, ad eccezione dell'implementazione pet-clinic.

manager:
  applicationSignals:
autoMonitor:
  monitorAllServices: true
  languages: ["python"]
  restartPods: true
  exclude:
    python:
      deployments: ["pet-warehouse/pet-clinic"]

Di seguito è riportato un esempio di configurazione che abilita automaticamente Application Signals con Java per tutti i carichi di lavoro di servizio nel cluster, ad eccezione di quelli nel namespace python-apps, e inoltre abilita Application Signals con Python specificamente per l'implementazione sample-python-app nel namespace python-apps.

manager:
  applicationSignals:
autoMonitor:
  monitorAllServices: true
  languages: ["java"]
  restartPods: true
  customSelector:
    python:
      deployments: ["python-apps/sample-python-app"]
  exclude:
    java:
      namespaces: ["python-apps"]

Considerazioni per i cluster Kubernetes di grandi dimensioni

Se utilizzi cluster Kubernetes di grandi dimensioni, potresti aver bisogno di una configurazione aggiuntiva per assicurarti che l'agente funzioni in modo affidabile. CloudWatch Le sezioni seguenti descrivono i problemi comuni e le configurazioni consigliate per cluster di grandi dimensioni.

Installazioni separate degli agenti per le metriche a livello di cluster e a livello di nodo

Per impostazione predefinita, l' CloudWatch agente viene eseguito come daemonset su ogni nodo del cluster. Un agente Pod viene eletto leader per raccogliere le metriche a livello di cluster. Queste metriche includono le metriche del piano di controllo e le metriche sullo stato del carico di lavoro. Su cluster di grandi dimensioni, questo leader Pod può essere interrotto con un errore di memoria esaurita (OOM) perché esegue un lavoro aggiuntivo condividendo gli stessi limiti di risorse di tutti gli altri agenti. Pod

Per determinare se stai riscontrando questo problema, verifica la presenza di agenti Pod in stato di errore con codice di uscita e motivo. 137 OOMKilled Un sintomo comune è che un agente Pod (il leader) si blocca, viene eletto un nuovo leader e Pod anche questo si blocca, creando un ciclo ricorrente. Per confermare questo comportamento, controlla l'elezione del leader ConfigMap eseguendo il comando seguente.

kubectl describe configmap cwagent-clusterleader -n amazon-cloudwatch

Se ConfigMap mostra frequenti modifiche alla voce del leader, ciò indica che un nuovo leader viene eletto ripetutamente, il che conferma il problema.

Per evitare questo problema, è possibile separare l'agente in due installazioni:

Questa separazione consente di gestire e scalare ogni installazione in modo indipendente.

Per abilitare questa configurazione, utilizzate la configurazione avanzata per definire due voci nella agents sezione:

L'esempio seguente mostra una configurazione avanzata che separa l'agente in due installazioni.

agents:
  - name: cloudwatch-agent
env:
  - name: CWAGENT_ROLE
    value: NODE
  - name: cloudwatch-agent-ci-leader
mode: deployment
config:
  {
    "logs": {
      "metrics_collected": {
        "kubernetes": {
          "enhanced_container_insights": true
        }
      }
    }
  }
env:
  - name: CWAGENT_ROLE
    value: LEADER
resources:
  limits:
    memory: 10Gi
    cpu: 2000m

In questo esempio, oltre a impostare la variabile di CWAGENT_ROLE ambiente su ogni installazione dell'agente, sovrascrive la modalità, la configurazione e i limiti di risorse predefiniti solo per l'agente di distribuzione. L'cloudwatch-agentinstallazione di base utilizza le impostazioni predefinite.

È possibile personalizzare ulteriormente l'installazione di ogni agente aggiungendo nodeSelectortolerations, o nodeAffinity campi per pianificare il leader Pod su un nodo specifico. I limiti delle risorse mostrati nell'esempio precedente sono illustrativi. Modifica questi valori in base alle dimensioni del cluster e al numero di metriche raccolte dal leader. Pod

Considerazioni per Amazon EKS Hybrid Nodes

Node-level le metriche non sono disponibili per i nodi ibridi perché Container Insights dipendono dalla disponibilità dell'EC2 Instance Metadata Service (IMDS) per le metriche a livello di nodo. Per i nodi ibridi sono disponibili metriche a livello di cluster, Pod, carico di lavoro e container.

Dopo aver installato il componente aggiuntivo, applica una patch alla amazoncloudwatchagents risorsa per aggiungere la variabile di RUN_WITH_IRSA ambiente in modo che l'agente funzioni correttamente sui nodi ibridi:

kubectl patch amazoncloudwatchagents cloudwatch-agent -n amazon-cloudwatch --type=json -p '[{"op":"add","path":"/spec/env/-","value":{"name":"RUN_WITH_IRSA","value":"True"}}]'

Risoluzione dei problemi relativi al componente aggiuntivo Amazon CloudWatch Observability EKS o al diagramma Helm

Utilizza le seguenti informazioni per risolvere i problemi con il componente aggiuntivo Amazon CloudWatch Observability EKS o il diagramma Helm

Aggiornamento ed eliminazione del componente aggiuntivo Amazon CloudWatch Observability EKS o del diagramma Helm

Per istruzioni sull'aggiornamento o l'eliminazione del componente aggiuntivo Amazon CloudWatch Observability EKS, consulta Gestione dei componenti aggiuntivi Amazon EKS. https://docs.aws.amazon.com/eks/latest/userguide/managing-add-ons.html Usa amazon-cloudwatch-observability come nome del componente aggiuntivo.

Per eliminare il grafico Helm in un cluster, immetti il comando seguente.

helm delete amazon-cloudwatch-observability -n amazon-cloudwatch --wait

Verifica la versione dell' CloudWatch agente utilizzata dal componente aggiuntivo Amazon CloudWatch Observability EKS o dal grafico Helm

Il componente aggiuntivo Amazon CloudWatch Observability EKS e il diagramma Helm installano una risorsa personalizzata di tipo AmazonCloudWatchAgent che controlla il comportamento del daemonset dell' CloudWatch agente nel cluster, inclusa la versione dell'agente utilizzata. CloudWatch È possibile ottenere un elenco di tutte le risorse AmazonCloudWatchAgent personalizzate installate sul cluster u immettendo il seguente comando:

kubectl get amazoncloudwatchagent -A

Nell'output di questo comando, dovresti essere in grado di controllare la versione dell'agente. CloudWatch In alternativa, puoi anche descrivere la risorsa amazoncloudwatchagent o uno dei pod cloudwatch-agent-* in esecuzione sul cluster per ispezionare l'immagine utilizzata.

Gestione di un ConfigurationConflict quando si gestisce il componente aggiuntivo o il grafico Helm

Quando installi o aggiorni il componente aggiuntivo Amazon CloudWatch Observability EKS o il diagramma Helm, se noti un errore causato dalle risorse esistenti, è probabile che l' CloudWatch agente e i componenti associati come ServiceAccount, the e the siano già installati nel ClusterRole cluster. ClusterRoleBinding

L'errore visualizzato dal componente aggiuntivo includerà Conflicts found when trying to apply. Will not continue due to resolve conflicts mode,

L'errore visualizzato dal grafico Helm sarà simile a Error: INSTALLATION FAILED: Unable to continue with install and invalid ownership metadata..

Quando l'add-on o il diagramma Helm tenta di installare l' CloudWatch agente e i componenti associati, se rileva modifiche nei contenuti, per impostazione predefinita fallisce l'installazione o l'aggiornamento per evitare di sovrascrivere lo stato delle risorse sul cluster.

Se stai tentando di eseguire l'onboarding del componente aggiuntivo Amazon CloudWatch Observability EKS e riscontri questo errore, ti consigliamo di eliminare una configurazione di CloudWatch agente esistente che avevi precedentemente installato nel cluster e quindi di installare il componente aggiuntivo EKS o il diagramma Helm. Assicurati di eseguire il backup di tutte le personalizzazioni che potresti aver apportato alla configurazione originale CloudWatch dell'agente, ad esempio una configurazione personalizzata dell'agente, e forniscile al componente aggiuntivo o al diagramma Helm la prossima volta che lo installerai o lo aggiornerai. Se in precedenza avevi installato l' CloudWatch agente per l'onboarding in Container Insights, consulta Guida all'installazione (AWS CLI) per ulteriori informazioni.

In alternativa, il componente aggiuntivo supporta un'opzione di configurazione per la risoluzione dei conflitti che può specificare OVERWRITE. È possibile utilizzare questa opzione per procedere con l'installazione o l'aggiornamento del componente aggiuntivo sovrascrivendo i conflitti nel cluster. Se utilizzi la console Amazon EKS, trovi il metodo di risoluzione dei conflitti selezionando le impostazioni di configurazione facoltative quando crei o aggiorni il componente aggiuntivo. Se stai usando il AWS CLI, puoi fornire il comando --resolve-conflicts OVERWRITE per creare o aggiornare il componente aggiuntivo.

Disattiva i segnali delle applicazioni

Fine-tune le tue preferenze di monitoraggio del servizio nella CloudWatch console o con l'SDK.

Per disattivare il monitoraggio automatico di Application Signals, segui la procedura seguente:

Utilizzando CLI o SDK

La seguente configurazione può essere applicata sia come configurazione avanzata all'add-on EKS sia come sovrascrittura dei valori quando si utilizza il grafico helm.

{
  "manager": {
"applicationSignals": {
  "autoMonitor": {
    "monitorAllServices": false
  }
}
  }
}

Riavviate i servizi per rendere effettive le modifiche.

Utilizzo della console