Creare il file di configurazione dell' CloudWatch agente

Prima di eseguire l' CloudWatch agente su qualsiasi server, è necessario creare uno o più file di configurazione CloudWatch dell'agente.

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 la configurazione comune e il profilo denominato per CloudWatch l'agente.

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' CloudWatch agente supporta l'utilizzo di più file di configurazione. Per ulteriori informazioni, consulta Creazione di più file di configurazione degli CloudWatch agenti.

Le metriche, i log e le tracce raccolti dall' CloudWatch agente comportano costi. Per ulteriori informazioni sui prezzi, consulta la pagina CloudWatchdei prezzi di Amazon.

Indice

• Crea il file di configurazione CloudWatch dell'agente con la procedura guidata

• Creazione di più file di configurazione degli CloudWatch agenti

• Crea o modifica manualmente il file di configurazione CloudWatch dell'agente

Creazione di più file di configurazione degli CloudWatch agenti

Sia sui server Linux che sui server Windows, è possibile configurare l' CloudWatch agente per utilizzare 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.

Avviate l' CloudWatch agente utilizzando l'fetch-configopzione e specificate 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 comandi di esempio seguenti 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.