Tutorial: Installazione utilizzando un modello AWS CloudFormation in linea Tutorial: installa l' CloudWatch agente utilizzando AWS CloudFormation Parameter Store Risoluzione dei problemi di installazione dell'agente con CloudWatch AWS CloudFormation

Installa l' CloudWatch agente su nuove istanze utilizzando AWS CloudFormation

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

Nota

Amazon ha caricato diversi AWS CloudFormation modelli GitHub che possono aiutarti a installare e aggiornare l' CloudWatch agente su nuove EC2 istanze Amazon. Per ulteriori informazioni sull'utilizzo AWS CloudFormation, consulta What is AWS CloudFormation? .

La posizione del modello è Deploy the Amazon CloudWatch agent to EC2 instances using. AWS CloudFormation Questo percorso include le directory inline e ssm. Ognuna di queste directory contiene modelli per le istanze Linux e Windows.

I modelli nella inline directory hanno la configurazione dell' CloudWatch agente incorporata nel AWS CloudFormation modello. 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 Crea o modifica manualmente il file di configurazione CloudWatch dell'agente.
```
{
   "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 Crea il file di configurazione CloudWatch dell'agente.

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

Tutorial: installa e configura l' CloudWatch agente utilizzando un AWS CloudFormation modello in linea

Questo tutorial illustra come AWS CloudFormation installare l' CloudWatch agente su una nuova EC2 istanza Amazon. Questo tutorial si installa su una nuova istanza che esegue Amazon Linux 2 utilizzando i modelli in linea, che non richiedono l'uso del file di JSON configurazione o del 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.

Da utilizzare AWS CloudFormation per installare l' CloudWatch agente 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 AWS CloudFormation console 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):
- Nome dello stack: scegli un nome per lo stack. AWS CloudFormation
- IAMRole: scegli un IAM ruolo con le autorizzazioni per scrivere CloudWatch metriche, log e tracce. Per ulteriori informazioni, consulta Crea IAM ruoli da utilizzare con l' CloudWatch agente sulle EC2 istanze Amazon.
- Istanza AMI: scegli un AMI nome valido nella regione in cui intendi lanciare lo stack.
- InstanceType: Scegli un tipo di istanza valido.
- KeyName: per abilitare SSH l'accesso alla nuova istanza, scegli una coppia di EC2 chiavi Amazon esistente. Se non disponi già di una coppia di EC2 chiavi Amazon, puoi crearne una in AWS Management Console. Per ulteriori informazioni, consulta Amazon EC2 Key Pairs nella Amazon EC2 User Guide.
- SSHLocation: specifica l'intervallo di indirizzi IP che può essere utilizzato per connettersi all'istanza utilizzandoSSH. 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) esaminare le informazioni, riconoscere che lo stack può creare risorse IAM, quindi scegliere Create (Crea).

Se aggiorni la console, lo stato del nuovo stack è CREATE_IN_PROGRESS.
Quando l'istanza viene creata, puoi vederla nella EC2 console Amazon. 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 illustra l'utilizzo AWS CloudFormation per aggiornare l' CloudWatch agente utilizzando un modello in linea. 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.

Da utilizzare per AWS CloudFormation 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 AWS CloudFormation console in https://console.aws.amazon.com/cloudformation.
Nella AWS CloudFormation dashboard, seleziona lo stack che hai creato e scegli Update 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: installa l' CloudWatch agente utilizzando AWS CloudFormation e Parameter Store

Questo tutorial illustra come AWS CloudFormation installare l' CloudWatch agente su una nuova EC2 istanza Amazon. 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.

Da utilizzare AWS CloudFormation per installare l' CloudWatch agente su una nuova istanza utilizzando una configurazione di Parameter Store

Se non l'hai già fatto, scarica il pacchetto dell' CloudWatch agente su uno dei tuoi computer in modo da poter creare il file di configurazione dell'agente. Per ulteriori informazioni e per scaricare l'agente utilizzando Parameter Store, consulta Scarica, configura ed esegui l' CloudWatch agente utilizzando SSM. Per ulteriori informazioni su come scaricare il pacchetto tramite la riga di comando, consulta Scarica e configura l' CloudWatch agente utilizzando la riga di comando.
Creare il file di configurazione dell'agente e salvarlo in Parameter Store. Per ulteriori informazioni, consulta Crea il file di configurazione CloudWatch dell'agente.

Scaricate il modello da GitHub quanto segue:


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

Apri la AWS CloudFormation console all'indirizzo https://console.aws.amazon.com/cloudformation.
Seleziona Crea stack.
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 dello stack: scegli un nome per lo stack. AWS CloudFormation
- IAMRole: scegli un IAM ruolo con le autorizzazioni per scrivere CloudWatch metriche, log e tracce. Per ulteriori informazioni, consulta Crea IAM ruoli da utilizzare con l' CloudWatch agente sulle EC2 istanze Amazon.
- Istanza AMI: scegli un AMI nome valido nella regione in cui intendi lanciare lo stack.
- InstanceType: Scegli un tipo di istanza valido.
- KeyName: per abilitare SSH l'accesso alla nuova istanza, scegli una coppia di EC2 chiavi Amazon esistente. Se non disponi già di una coppia di EC2 chiavi Amazon, puoi crearne una in AWS Management Console. Per ulteriori informazioni, consulta Amazon EC2 Key Pairs nella Amazon EC2 User Guide.
- SSHLocation: specifica l'intervallo di indirizzi IP che può essere utilizzato per connettersi all'istanza utilizzandoSSH. 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) esaminare le informazioni, riconoscere che lo stack può creare risorse IAM, quindi scegliere Create (Crea).

Se aggiorni la console, lo stato del nuovo stack è CREATE_IN_PROGRESS.
Quando l'istanza viene creata, puoi vederla nella EC2 console Amazon. 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 illustra l'utilizzo AWS CloudFormation per aggiornare l' CloudWatch agente, utilizzando una configurazione dell'agente salvata in Parameter Store.

Da utilizzare AWS CloudFormation per aggiornare l' CloudWatch agente utilizzando una configurazione in Parameter Store

Modificare il file di configurazione dell'agente archiviato in Parameter Store con la nuova configurazione desiderata.
Nel AWS CloudFormation modello scaricato nell'Tutorial: installa l' CloudWatch agente utilizzando AWS CloudFormation e Parameter Storeargomento, modifica il numero di versione. Ad esempio, puoi modificare VERSION=1.0 in VERSION=2.0.
Apri la AWS CloudFormation console in https://console.aws.amazon.com/cloudformation.
Nella AWS CloudFormation dashboard, seleziona lo stack che hai creato e scegli Update 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 con CloudWatch AWS CloudFormation

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

Rilevamento di aggiornamento non riuscito

Se si utilizza AWS CloudFormation per aggiornare la configurazione CloudWatch dell'agente e si utilizza una configurazione non valida, l'agente interrompe l'invio di qualsiasi metrica 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 CloudWatch file e posizioni degli agenti.

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

Installa l' CloudWatch agente sui server locali

CloudWatch preferenza per le credenziali dell'agente