Creazione del file di configurazione dell'agente CloudWatch

Prima di eseguire l'agente CloudWatch su un server, devi creare uno o più file di configurazione dell'agente CloudWatch.

Il file di configurazione dell'agente è un file JSON che specifica i parametri, i log e le tracce che l'agente deve raccogliere, inclusi i parametri personalizzati. Puoi crearlo utilizzando la procedura guidata oppure partendo da zero. Puoi anche utilizzare la procedura guidata per creare inizialmente il file di configurazione e quindi modificarlo manualmente. Se decidi di creare o modificare manualmente il file, la procedura risulterà più complessa. Tuttavia, avrai un maggiore controllo sui parametri raccolti e potrai specificare i parametri non disponibili nella procedura guidata.

Ogni volta che modifichi il file di configurazione dell'agente, è necessario riavviare l'agente affinché le modifiche diventino effettive. Per riavviare l'agente, segui le istruzioni descritte in (Facoltativo) Modifica della configurazione comune e del profilo denominato per l'agente CloudWatch.

Dopo avere creato un file di configurazione, puoi salvarlo manualmente come file JSON e utilizzarlo al momento dell'installazione dell'agente nel server. In alternativa, puoi memorizzarlo in Systems Manager Parameter Store se hai intenzione di utilizzare Systems Manager al momento dell'installazione dell'agente nei server.

L'agente CloudWatch supporta l'utilizzo di più file di configurazione. Per ulteriori informazioni, consulta Creazione di di più file di configurazione dell'agente CloudWatch.

Le metriche, i log e le tracce raccolti dall'agente CloudWatch sono a pagamento. Per ulteriori informazioni sui prezzi, consulta Prezzi di Amazon CloudWatch.

Creazione di di più file di configurazione dell'agente CloudWatch

Sia su server Linux sia su server Windows, è possibile configurare l'agente CloudWatch per l'utilizzo di più file di configurazione. Ad esempio, puoi utilizzare un file di configurazione comune che raccoglie un set di parametri e i log che desideri raccogliere da tutti i server dell'infrastruttura. Potrai quindi possibile utilizzare altri file di configurazione che raccolgono i parametri da determinate applicazioni o in determinate situazioni.

Per effettuare tale configurazione, dovrai innanzitutto creare i file di configurazione da utilizzare. I file di configurazione che verranno utilizzati insieme nello stesso server devono avere nomi diversi. È possibile archiviare i file di configurazione nei server o in Parameter Store.

Avviare l'agente CloudWatch con l'opzione fetch-config e specificare il primo file di configurazione. Per aggiungere il secondo file di configurazione all'agente in esecuzione, utilizzare lo stesso comando, ma con l'opzione append-config. Verranno raccolti tutti i parametri, i log e le tracce elencati in entrambi i file di configurazione. I seguenti comandi di esempio illustrano questo scenario utilizzando gli archivi di configurazione come file. La prima riga avvia l'agente utilizzando il file di configurazione infrastructure.json, mentre la seconda aggiunge il file di configurazione app.json.

I seguenti comandi di esempio sono per Linux.

/opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -m ec2 -s -c file:/tmp/infrastructure.json

/opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a append-config -m ec2 -s -c file:/tmp/app.json

I seguenti comandi di esempio sono per Windows Server.

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

& "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -a append-config -m ec2 -s -c file:"C:\Program Files\Amazon\AmazonCloudWatchAgent\app.json"

I seguenti file di configurazione di esempio mostrano l'utilizzo di questa funzione. Il primo file di configurazione viene utilizzato per tutti i server dell'infrastruttura, mentre il secondo raccoglie solo i log da una determinata applicazione e viene aggiunto ai server che eseguono tale applicazione.

infrastructure.json

{
  "metrics": {
    "metrics_collected": {
      "cpu": {
        "resources": [
          "*"
        ],
        "measurement": [
          "usage_active"
        ],
        "totalcpu": true
      },
      "mem": {
         "measurement": [
           "used_percent"
        ]
      }
    }
  },
  "logs": {
    "logs_collected": {
      "files": {
        "collect_list": [
          {
            "file_path": "/opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log",
            "log_group_name": "amazon-cloudwatch-agent.log"
          },
          {
            "file_path": "/var/log/messages",
            "log_group_name": "/var/log/messages"
          }
        ]
      }
    }
  }
}

app.json

{
    "logs": {
        "logs_collected": {
            "files": {
                "collect_list": [
                    {
                        "file_path": "/app/app.log*",
                        "log_group_name": "/app/app.log"
                    }
                ]
            }
        }
    }
}

Tutti i file di configurazione aggiunti alla configurazione devono avere nomi diversi fra loro e rispetto al file di configurazione iniziale. Se usi append-config con un file di configurazione con lo stesso nome di quello già in uso dall'agente, il comando di aggiunta sovrascriverà le informazioni del primo file di configurazione, anziché aggiungerle. Ciò vale anche se i due file di configurazione con lo stesso nome si trovano in percorsi diversi.

L'esempio precedente mostra l'uso di due file di configurazione, ma non vi è alcun limite al numero di file di configurazione che puoi aggiungere all'agente di configurazione. Puoi anche combinare l'uso di file di configurazione che si trovano nei server e le configurazioni situate in Parameter Store.