Come faccio a installare e configurare l'agente CloudWatch unificato per inviare metriche e log da un'istanza EC2 a CloudWatch?

Risoluzione

**Nota:**prima di iniziare, stabilisci la connettività Internet nella tua istanza EC2. Per connettersi agli endpoint richiesti, l'istanza EC2 deve disporre di connettività Internet.

Creare un ruolo IAM per eseguire l'agente CloudWatch sulla propria istanza EC2

1. Apri la console AWS Identity e Access Management (IAM).

2. Nel riquadro di navigazione, seleziona Ruoli.

3. Seleziona Crea ruolo.

4. In Scegli il servizio che utilizzerà questo ruolo, seleziona EC2.

5. Seleziona Successivo: autorizzazioni.

6. Nell'elenco delle policy, seleziona la casella di controllo CloudWatchAgentServerPolicy.

7. Seleziona Successivo: Tag, quindi seleziona Avanti: rivedi.

8.Per Nome ruolo, inserisci un nome per il ruolo, ad esempio CloudWatchAgentServerRole.

9.(Facoltativo) Fornisci una descrizione del ruolo.

10. Conferma che CloudWatchAgentServerPolicy venga visualizzato accanto a Policy.

11. Seleziona Crea ruolo.

12. Collega il nuovo ruolo IAM all'istanza EC2.

Scaricare e installare l'agente CloudWatch unificato sulla propria istanza EC2

Amazon Linux, Amazon Linux 2 e Amazon Linux 2023

1. Per scaricare l'agente CloudWatch, esegui il seguente comando:

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

Nel comando precedente, sostituisci la regione con la tua regione AWS.

2. Per installare l'agente CloudWatch, esegui il seguente comando:

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

Windows

1. Per scaricare l'agente CloudWatch, esegui il seguente comando:

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

Nel comando precedente, sostituisci la regione con la tua regione AWS.

2. Passa alla directory contenente il pacchetto, quindi immetti il seguente comando:

msiexec /i amazon-cloudwatch-agent.msi

Creare il file di configurazione dell'agente

**Nota:**per semplicità, utilizza la procedura guidata per creare il file di configurazione dell'agente. Successivamente, modifica manualmente il file per aggiungere o rimuovere metriche o registri. Per ulteriori informazioni, vedi la sezione seguente, Suggerimenti per completare la procedura guidata del file di configurazione dell'agente.

Amazon Linux, Amazon Linux 2 e Amazon Linux 2023

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

Windows

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

Per impostazione predefinita, la procedura guidata crea il file di configurazione dell'agente nella seguente posizione: **C:\Program Files\Amazon\AmazonCloudWatchAgent\config.json **.

Avviare l'agente CloudWatch

Amazon Linux, Amazon Linux 2 e Amazon Linux 2023

Per avviare l'agente CloudWatch, esegui il seguente 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.

Windows

Immetti il seguente comando in PowerShell come amministratore:

& $Env:ProgramFiles\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1 -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.

Comando di esempio:

& $Env:ProgramFiles\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1 -a fetch-config -m ec2 -c file:'C:\Program Files\Amazon\AmazonCloudWatchAgent\config.json' -s

Le metriche e i log vengono ora inviati in CloudWatch. Per impostazione predefinita, l'agente invia le metriche a NameSpace CWAgent.

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

• **Vuoi attivare il daemon StatsD? **e **Vuoi monitorare le metriche di CollectD?**Se hai i plugin Statsd e CollectD installati sulla tua istanza EC2, seleziona Sì come risposta a queste domande.
• **Quale configurazione predefinita delle metriche desideri?**Per ulteriori informazioni sulle configurazioni dettagliate, consulta i CloudWatch agent predefined metric sets. Quindi, seleziona l'opzione più adatta al tuo caso d'uso.
• Disponi di un file di configurazione di un agente di log CloudWatch da importare per la migrazione?Se l'agente awslogs è installato e in esecuzione, seleziona Sì. Se selezioni 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.
• **Vuoi archiviare la configurazione nel Parameter Store, una funzionalità di AWS Systems Manager?**Se desideri archiviare questo file di configurazione dell'agente nel Parameter Store per riutilizzarlo in un secondo momento, seleziona Sì.
  **Importante:**quando si memorizza il file di configurazione dell'agente nel Parameter Store, 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. Puoi modificare manualmente questo file per aggiungere o rimuovere metriche o registri.

Per un esempio di file di configurazione personalizzato, consulta CloudWatch agent configuration file: Complete examples.

**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 Stopping and restarting the CloudWatch Agent.