Come posso installare e configurare l'agente CloudWatch unificato per inviare metriche e log dalla mia istanza EC2 a CloudWatch?

Risoluzione

Prima di iniziare, stabilisci la connettività Internet nella tua istanza EC2. L'istanza EC2 deve disporre di connettività Internet per connettersi agli endpoint richiesti.

Crea un ruolo IAM per eseguire l'agente CloudWatch sulla tua istanza EC2

Completa i seguenti passaggi:

1. Apri la console AWS Identity e Access Management (IAM).
2. Nel pannello di navigazione, scegli Ruoli.
3. Scegli Crea ruolo.
4. Per Scegli il servizio che utilizzerà questo ruolo, scegli EC2.
5. Scegli Avanti: Autorizzazioni.
6. Nell'elenco delle policy, seleziona CloudWatchAgentServerPolicy.
7. Scegli Avanti: Tag, quindi scegli Successivo: Verifica.
8. Per Nome ruolo, inserisci un nome per il ruolo, per esempio CloudWatchAgentServerRole.
9. (Facoltativo) Fornisci una descrizione del ruolo.
10. Conferma che CloudWatchAgentServerPolicy venga visualizzato accanto a Policy.
11. Scegli Crea ruolo.
12. Collega il nuovo ruolo IAM all'istanza EC2.

Scarica e installa l'agente CloudWatch unificato

Istanza Linux EC2

Completa i seguenti passaggi:

1. Per scaricare l'agente CloudWatch, esegui questo comando dal tuo terminale:

   wget https://s3.region.amazonaws.com/amazoncloudwatch-agent-region/amazon_linux/amd64/latest/amazon-cloudwatch-agent.rpm

   Nota: nel comando precedente, sostituisci region con la tua Regione AWS.

2. Per installare l'agente CloudWatch, esegui questo comando dal tuo terminale:

   sudo rpm -U ./amazon-cloudwatch-agent.rpm

Istanza Windows EC2

Completa i seguenti passaggi come amministratore in Windows PowerShell:

1. Vai alla cartella in cui desideri scaricare il programma di installazione:

   cd "path"

   Nota: nel comando precedente, sostituisci path con il percorso della cartella in cui desideri scaricare il programma di installazione.

2. Per scaricare l'agente CloudWatch, esegui questo comando:

   Invoke-WebRequest -Uri https://s3.region.amazonaws.com/amazoncloudwatch-agent-region/windows/amd64/latest/amazon-cloudwatch-agent.msi -outFile amazon-cloudwatch-agent.msi

   Nota: nel comando precedente, sostituisci region con la tua Regione.

   Se la versione TLS è precedente alla versione 1.2, ricevi il seguente errore quando esegui il precedente comando Invoke-WebRequest:

   "Invoke-WebRequest : The request was aborted: Could not create SSL/TLS secure channel"

   Per configurare la versione TLS, esegui questo comando, quindi esegui nuovamente il precedente comando Invoke-WeRequest:

   [Net.ServicePointManager]::SecurityProtocol = "Tls, Tls11, Tls12, Ssl3"

3. Per avviare il programma di installazione dell'agente, esegui questo comando:

   msiexec /i amazon-cloudwatch-agent.msi

Crea il file di configurazione dell'agente

Per creare il file di configurazione dell'agente, utilizza la procedura guidata. Quindi modifica manualmente il file per aggiungere o rimuovere metriche o log.

Istanza Linux EC2

Esegui questo comando:

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-config-wizard

Istanza Windows EC2

Esegui questo comando come amministratore in Windows PowerShell:

cd "C:\Program Files\Amazon\AmazonCloudWatchAgent"  
.\amazon-cloudwatch-agent-config-wizard.exe

La procedura guidata crea il file di configurazione dell'agente con il percorso C:\Program Files\Amazon\AmazonCloudWatchAgent\config.json per impostazione predefinita.

Avvia l'agente CloudWatch

Istanza Linux EC2

Esegui questo comando:

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -m ec2 -c file:configuration-file-path -s

Nota: nell'esempio precedente, sostituisci configuration-file-path con il percorso del tuo file di configurazione.

Istanza Windows EC2

Esegui questo comando come amministratore in Windows PowerShell:

& "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -a fetch-config -m ec2 -c file:configuration-file-path -s

Nota: nel comando precedente, sostituisci configuration-file-path con il percorso della tua configurazione.

Per impostazione predefinita, l'agente invia le metriche a NameSpace CWAgent.

Verifica lo stato dell'agente

L'agente impiega del tempo per compilare le metriche configurate in CloudWatch. Per verificare se l'agente è in esecuzione prima che compili le metriche, esegui questi comandi.

Istanza Linux EC2:

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -m ec2 -a status

Istanza Windows EC2:

& "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -m ec2 -a status

Suggerimenti per la procedura guidata del file di configurazione dell'agente

Utilizza i seguenti suggerimenti per rispondere alle domande quando utilizzi la procedura guidata del file di configurazione dell'agente.

**Desideri attivare il daemon StatsD?**e **Desideri monitorare le metriche di collectd?**Se hai i plugin StatsD e collectd installati nell'istanza EC2, scegli Sì in risposta alle domande.

**Quale configurazione predefinita delle metriche desideri?**Per ulteriori informazioni sulle configurazioni dettagliate, consulta Set di metriche predefiniti dell’agente CloudWatch. Quindi scegli l'opzione più adatta al caso d'uso.

Disponi di un file di configurazione di un agente di log CloudWatch da importare per la migrazione?Se hai installato l'agente awslogs ed è in esecuzione, scegli Sì. Se scegli Sì, la procedura guidata legge il file di configurazione dell'agente awslogs (/etc/awslogs/awslogs.conf o /var/awslogs/etc/awslogs.conf) per determinare i file di log da monitorare.

**Desideri archiviare la configurazione nell'Archivio dei parametri, una funzionalità di AWS Systems Manager?**Per archiviare il file di configurazione dell'agente nell'Archivio dei parametri per riutilizzarlo in un secondo momento, scegli Sì. Quando memorizzi il file di configurazione dell'agente nell'Archivio dei parametri, il comando per l'avvio dell'agente varia.

Una volta completata la procedura guidata, il file di configurazione dell'agente viene archiviato in /opt/aws/amazon-cloudwatch-agent/bin/config.json per impostazione predefinita. Per aggiungere o rimuovere metriche o log, puoi modificare manualmente il file.

Per un esempio di file di configurazione personalizzato, consulta File di configurazione dell’agente CloudWatch: esempi completi.

Nota: quando modifichi il file di configurazione dell'agente, utilizza il comando fetch-config di avvio dell'agente per assicurarti che rifletta le modifiche.

Avvia e arresta l'agente CloudWatch

Per ulteriori informazioni, consulta Arresto e riavvio dell’agente CloudWatch.