Tutorial: installazione mediante un modello inline CloudFormation Tutorial: installazione dell'agente CloudWatch tramite CloudFormation e Parameter Store Risoluzione dei problemi di installazione dell'agente CloudWatch con CloudFormation

Installazione dell'agente CloudWatch su nuove istanze tramite CloudFormation

Questa sezione descrive come installare l'agente CloudWatch su nuove istanze Amazon EC2 utilizzando AWS CloudFormation.

Nota

Amazon ha caricato diversi modelli CloudFormation in GitHub che facilitano l'installazione e l'aggiornamento dell'agente CloudWatch su nuove istanze Amazon EC2. Per ulteriori informazioni sull'utilizzo di CloudFormation, consulta Che cos'è AWS CloudFormation?

Il percorso del modello è Distribuzione dell'agente Amazon CloudWatch nelle istanze EC2 tramite CloudFormation. Questo percorso include le directory inline e ssm. Ognuna di queste directory contiene modelli per le istanze Linux e Windows.

Nei modelli inclusi nella directory inline, la configurazione dell'agente CloudWatch è incorporata nel modello CloudFormation. Per impostazione predefinita, i modelli di Linux raccolgono i parametri mem_used_percent e swap_used_percent, mentre i modelli di Windows raccolgono i parametri Memory % Committed Bytes In Use e Paging File % Usage.

Per modificare questi modelli per raccogliere altri parametri, modifica la seguente sezione del modello. L'esempio seguente è preso dal modello per i server Linux. Segui il formato e la sintassi del file di configurazione dell'agente per apportare le modifiche. Per ulteriori informazioni, consulta la pagina Creazione o modifica manuale del file di configurazione dell'agente CloudWatch.
```
{
   "metrics":{
      "append_dimensions":{
         "AutoScalingGroupName":"${!aws:AutoScalingGroupName}",
         "ImageId":"${!aws:ImageId}",
         "InstanceId":"${!aws:InstanceId}",
         "InstanceType":"${!aws:InstanceType}"
      },
      "metrics_collected":{
         "mem":{
            "measurement":[
               "mem_used_percent"
            ]
         },
         "swap":{
            "measurement":[
               "swap_used_percent"
            ]
         }
      }
   }
}
```
Nota
Nei modelli inline, tutte le variabili segnaposto devono essere precedute da un punto esclamativo (!) come un carattere di escape. Ciò è visualizzato nel modello di esempio. Se aggiungi altre variabili segnaposto, assicurati di aggiungere un punto esclamativo prima del nome.
I modelli nella directory ssm caricano un file di configurazione dell'agente da Parameter Store. Per utilizzare questi modelli, è necessario innanzitutto creare un file di configurazione e caricarlo in Parameter Store. Occorre quindi fornire il nome Parameter Store del file nel modello. Puoi creare il file di configurazione manualmente o utilizzando la procedura guidata. Per ulteriori informazioni, consulta la pagina Creazione del file di configurazione dell'agente CloudWatch.

Puoi utilizzare entrambi i tipi di modelli per installare l'agente CloudWatch e per aggiornare la configurazione dell'agente.

Per informazioni sulla configurazione dell'agente su un sistema su cui è abilitato Linux con sicurezza avanzata (SELinux), consulta Configurazione dell'agente CloudWatch con Linux con sicurezza avanzata (SELinux).

Tutorial: installazione e configurazione dell'agente CloudWatch con un modello inline CloudFormation

Questo tutorial illustra l'uso di CloudFormation per installare l'agente CloudWatch su una nuova istanza Amazon EC2. Questo tutorial esegue l'installazione in una nuova istanza che esegue Amazon Linux 2 utilizzando i modelli inline, che non richiedono l'uso del file di configurazione JSON o di Parameter Store. Il modello inline include la configurazione dell'agente nel modello. In questo tutorial viene utilizzata la configurazione dell'agente predefinita contenuta nel modello.

Dopo la procedura di installazione dell'agente, il tutorial prosegue con la procedura di aggiornamento dell'agente.

Per utilizzare CloudFormation per installare l'agente CloudWatch su una nuova istanza

Scarica il modello da GitHub. In questo tutorial, scaricare il modello inline per Amazon Linux 2 come segue:


curl -O https://raw.githubusercontent.com/aws-cloudformation/aws-cloudformation-templates/main/Solutions/AmazonCloudWatchAgent/inline/amazon_linux.yaml

Apri la console di CloudFormation all'indirizzo https://console.aws.amazon.com/cloudformation.
Seleziona Crea pila.
In Choose a template (Scegli un modello), seleziona Upload a template to Amazon S3 (Carica un modello in Amazon S3), scegli il modello scaricato e seleziona Next (Successivo).
Nella pagina Specify Details (Specifica dettagli), compili i parametri seguenti e scegli Next (Successivo):
- Stack name (Nome pila): scegli il nome per la pila CloudFormation.
- IAMRole: scegli un ruolo IAM che dispone delle autorizzazioni per scrivere parametri, log e tracce di CloudWatch. Per ulteriori informazioni, consulta Prerequisiti.
- InstanceAMI: scegli un'AMI valida nella regione in cui verrà avviato lo stack.
- InstanceType: scegli un tipo di istanza valido.
- KeyName: per abilitare l'accesso SSH alla nuova istanza, scegli una coppia di chiavi Amazon EC2 esistente. Se non hai già una coppia di chiavi Amazon EC2, puoi crearla nella Console di gestione AWS. Per ulteriori informazioni, consulta Amazon EC2 Key Pairs nella Guida per l'utente di Amazon EC2.
- SSHLocation: consente di specificare l'intervallo di indirizzi IP che è possibile utilizzare per connettersi all'istanza tramite SSH. L'impostazione predefinita consente l'accesso da qualsiasi indirizzo IP.
Nella pagina Options (Opzioni), puoi scegliere di aggiungere tag alle risorse dello stack. Scegli Next (Successivo).
Nella pagina Review (Verifica), esamina le informazioni, riconosci che lo stack può creare risorse &IAM;, quindi scegli Create (Crea).

Se aggiorni la console, lo stato del nuovo stack è CREATE_IN_PROGRESS.
Quando viene creata, puoi visualizzare l'istanza nella console Amazon EC2. Se desiderato, è possibile eseguire la connessione all'host e verificare l'avanzamento.

Utilizza il comando seguente per confermare che l'agente è installato:
```
rpm -qa amazon-cloudwatch-agent
```
Utilizza il comando seguente per confermare che l'agente è in esecuzione:
```
ps aux | grep amazon-cloudwatch-agent
```

La procedura successiva dimostra l'uso di CloudFormation per aggiornare l'agente CloudWatch mediante un modello inline. Il modello inline predefinito raccoglie il parametro mem_used_percent. In questo tutorial, puoi modificare la configurazione dell'agente per interrompere la raccolta di tale parametro.

Per utilizzare CloudFormation per aggiornare l'agente CloudWatch

Nel modello scaricato nella procedura precedente, rimuovi le righe seguenti e quindi salva il modello:



"mem": {
                        
     "measurement": [
         "mem_used_percent"
       ]
 },

Apri la console di CloudFormation all'indirizzo https://console.aws.amazon.com/cloudformation.
Nel pannello di controllo di CloudFormation, seleziona lo stack creato e scegli Update Stack (Aggiorna stack).
In Select Template (Seleziona modello), seleziona Upload a template to Amazon S3 (Carica un modello in Amazon S3), scegli il modello modificato e seleziona Next (Successivo).
Nella pagina Options (Opzioni), scegli Next (Successivo), quindi Next (Successivo).
Nella pagina Review (Rivedi), esamina le informazioni e scegli Update (Aggiorna).

Dopo qualche minuto, viene visualizzato UPDATE_COMPLETE.

Tutorial: installazione dell'agente CloudWatch tramite CloudFormation e Parameter Store

Questo tutorial illustra l'uso di CloudFormation per installare l'agente CloudWatch su una nuova istanza Amazon EC2. Questo tutorial esegue l'installazione su una nuova istanza che esegue Amazon Linux 2 utilizzando un file di configurazione dell'agente creato e salvato in Parameter Store.

Dopo la procedura di installazione dell'agente, il tutorial prosegue con la procedura di aggiornamento dell'agente.

Per utilizzare CloudFormation per installare l'agente CloudWatch su una nuova istanza utilizzando una configurazione dal Parameter Store

Se necessario, scaricare il pacchetto dell'agente CloudWatch in un computer, in modo da avere la possibilità di creare il file di configurazione dell'agente. Per ulteriori informazioni e per scaricare l'agente utilizzando Parameter Store, consulta Download del pacchetto dell'agente CloudWatch.
Creare il file di configurazione dell'agente e salvarlo in Parameter Store. Per ulteriori informazioni, consulta la pagina Creazione del file di configurazione dell'agente CloudWatch.

Scaricare il modello da GitHub come segue:


curl -O https://raw.githubusercontent.com/awslabs/aws-cloudformation-templates/master/aws/solutions/AmazonCloudWatchAgent/ssm/amazon_linux.template

Apri la console di CloudFormation all'indirizzo https://console.aws.amazon.com/cloudformation.
Seleziona Crea pila.
In Choose a template (Scegli un modello), seleziona Upload a template to Amazon S3 (Carica un modello in Amazon S3), scegli il modello scaricato e seleziona Next (Successivo).
Nella pagina Specify Details (Specifica dettagli), compili di conseguenza i seguenti parametri e scegli Next (Successivo):
- Nome stack: scegli il nome per lo stack di CloudFormation.
- IAMRole: scegli un ruolo IAM che dispone delle autorizzazioni per scrivere parametri, log e tracce di CloudWatch. Per ulteriori informazioni, consulta Prerequisiti.
- InstanceAMI: scegli un'AMI valida nella regione in cui verrà avviato lo stack.
- InstanceType: scegli un tipo di istanza valido.
- KeyName: per abilitare l'accesso SSH alla nuova istanza, scegli una coppia di chiavi Amazon EC2 esistente. Se non hai già una coppia di chiavi Amazon EC2, puoi crearla nella Console di gestione AWS. Per ulteriori informazioni, consulta Amazon EC2 Key Pairs nella Guida per l'utente di Amazon EC2.
- SSHLocation: consente di specificare l'intervallo di indirizzi IP che è possibile utilizzare per connettersi all'istanza tramite SSH. L'impostazione predefinita consente l'accesso da qualsiasi indirizzo IP.
- SSMKey: specifica il file di configurazione dell'agente creato e salvato in Parameter Store.
Nella pagina Options (Opzioni), puoi scegliere di aggiungere tag alle risorse dello stack. Scegli Next (Successivo).
Nella pagina Review (Verifica), esamina le informazioni, riconosci che lo stack può creare risorse &IAM;, quindi scegli Create (Crea).

Se aggiorni la console, lo stato del nuovo stack è CREATE_IN_PROGRESS.
Quando viene creata, puoi visualizzare l'istanza nella console Amazon EC2. Se desiderato, è possibile eseguire la connessione all'host e verificare l'avanzamento.

Utilizza il comando seguente per confermare che l'agente è installato:
```
rpm -qa amazon-cloudwatch-agent
```
Utilizza il comando seguente per confermare che l'agente è in esecuzione:
```
ps aux | grep amazon-cloudwatch-agent
```

La procedura successiva dimostra l'utilizzo di CloudFormation per aggiornare l'agente CloudWatch, utilizzando una configurazione dell'agente salvata in Parameter Store.

Per utilizzare CloudFormation per aggiornare l'agente CloudWatch tramite una configurazione in Parameter Store

Modificare il file di configurazione dell'agente archiviato in Parameter Store con la nuova configurazione desiderata.
Nel modello CloudFormation scaricato nell'argomento Tutorial: installazione dell'agente CloudWatch tramite CloudFormation e Parameter Store, modifica il numero di versione. Ad esempio, puoi modificare VERSION=1.0 in VERSION=2.0.
Apri la console di CloudFormation all'indirizzo https://console.aws.amazon.com/cloudformation.
Nel pannello di controllo di CloudFormation, seleziona lo stack creato e scegli Update Stack (Aggiorna stack).
In Select Template (Seleziona modello), seleziona Upload a template to Amazon S3 (Carica un modello in Amazon S3), scegli il modello appena modificato e seleziona Next (Successivo).
Nella pagina Options (Opzioni), scegli Next (Successivo), quindi Next (Successivo).
Nella pagina Review (Rivedi), esamina le informazioni e scegli Update (Aggiorna).

Dopo qualche minuto, viene visualizzato UPDATE_COMPLETE.

Risoluzione dei problemi di installazione dell'agente CloudWatch con CloudFormation

Questa sezione consente di risolvere i problemi di installazione e aggiornamento dell'agente CloudWatch tramite CloudFormation.

Rilevamento di aggiornamento non riuscito

Se utilizzi CloudFormation per aggiornare la configurazione dell'agente CloudWatch e utilizzi una configurazione non valida, l'agente smette di inviare eventuali parametri a CloudWatch. Per controllare rapidamente se un aggiornamento della configurazione dell'agente è andato a buon fine, puoi esaminare il file cfn-init-cmd.log. Su un server Linux, il file si trova in /var/log/cfn-init-cmd.log. Su un'istanza Windows, il file si trova in C:\cfn\log\cfn-init-cmd.log.

Parametri mancanti

Se alcuni parametri previsti dopo l'installazione o l'aggiornamento dell'agente non sono visualizzati, verifica che l'agente sia configurato per raccogliere tale parametro. A questo scopo, controlla il file amazon-cloudwatch-agent.json per assicurarti che il parametro sia elencato e verifica di stare effettuando la ricerca nello spazio dei nomi parametro corretto. Per ulteriori informazioni, consulta File e ubicazioni dell'agente CloudWatch.

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

Installazione dell'agente CloudWatch su server on-premises

Installare l'agente CloudWatch con il componente aggiuntivo Amazon CloudWatch Observability EKS o il grafico Helm.