Création du fichier de configuration de CloudWatch l'agent

Avant d'exécuter l' CloudWatch agent sur un serveur, vous devez créer un ou plusieurs fichiers de configuration de CloudWatch l'agent.

Le fichier de configuration d'agent est un fichier JSON qui spécifie les métriques, les journaux et les traces que l'agent doit collecter, notamment les métriques personnalisées. Vous pouvez le créer à l'aide de l'assistant ou en le créant vous-même à partir de zéro. Vous pouvez également utiliser l'assistant pour créer le fichier de configuration, puis le modifier manuellement. Si vous créez ou modifiez le fichier manuellement, le processus est plus complexe, mais vous avez plus de contrôle sur les métriques collectées, et vous pouvez spécifier des métriques non disponibles via l'assistant.

Chaque fois que vous modifiez le fichier de configuration d'agent, vous devez ensuite redémarrer l'agent pour que les modifications prennent effet. Pour redémarrer l'agent, suivez les instructions de la section (Facultatif) Modifiez la configuration commune et le profil nommé de CloudWatch l'agent.

Une fois que vous avez créé un fichier de configuration, vous pouvez l'enregistrer manuellement en tant que fichier JSON, puis utiliser ce fichier lors de l'installation de l'agent sur vos serveurs. Vous pouvez également le stocker dans le Parameter Store du Systems Manager si vous allez utiliser Systems Manager lorsque vous installez l'agent sur les serveurs.

L' CloudWatch agent prend en charge l'utilisation de plusieurs fichiers de configuration. Pour de plus amples informations, veuillez consulter Création de plusieurs fichiers de configuration d' CloudWatch agents.

Les métriques, les journaux et les traces collectés par l' CloudWatch agent entraînent des frais. Pour plus d'informations sur les tarifs, consultez Amazon CloudWatch Pricing.

Table des matières

• Créez le fichier de configuration de l' CloudWatch agent avec l'assistant

• Création de plusieurs fichiers de configuration d' CloudWatch agents

• Création ou modification manuelle du fichier de configuration de CloudWatch l'agent

Création de plusieurs fichiers de configuration d' CloudWatch agents

Sur les serveurs Linux et Windows, vous pouvez configurer l' CloudWatch agent pour qu'il utilise plusieurs fichiers de configuration. Par exemple, vous pouvez utiliser un fichier de configuration courant qui recueille un ensemble de métriques, de journaux et de traces que vous souhaitez toujours collecter à partir de tous les serveurs dans votre infrastructure. Vous pouvez alors utiliser les fichiers de configuration supplémentaires qui collectent des métriques de certaines applications ou dans certaines situations.

Pour cette configuration, commencez par créer les fichiers de configuration que vous souhaitez utiliser. Tous les fichiers de configuration qui seront utilisés ensemble sur le même serveur doivent avoir différents noms de fichiers. Vous pouvez stocker les fichiers de configuration sur les serveurs ou dans le Parameter Store.

Démarrez l' CloudWatch agent à l'aide de l'fetch-configoption et spécifiez le premier fichier de configuration. Pour ajouter le second fichier de configuration pour l'agent en cours d'exécution, utilisez la même commande, mais avec l'option append-config. L'ensemble des métriques, des journaux et des traces répertoriés dans l'un ou l'autre fichier de configuration sont collectés. Les exemples de commandes suivants illustrent ce scénario en utilisant des stockages de configurations sous forme de fichiers. La première ligne démarre l'agent à l'aide du fichier de configuration infrastructure.json et la seconde ligne ajoute le fichier de configuration app.json.

Les exemples de commandes suivants concernent 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

Les exemples de commandes suivants concernent 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"

Les exemples de fichiers de configuration suivants illustrent une utilisation pour cette fonction. Le premier fichier de configuration est utilisé pour tous les serveurs de l'infrastructure. Le second collecte des journaux uniquement à partir d'une application et est ajouté aux serveurs exécutant cette application.

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"
                    }
                ]
            }
        }
    }
}

Tous les fichiers de configuration ajoutés à la configuration doivent avoir des noms de fichiers différents les uns des autres et du fichier de configuration initiale. Si vous utilisez append-config avec un fichier de configuration ayant le même nom de fichier qu'un fichier de configuration que l'agent utilise déjà, la commande Ajouter écrasera les informations provenant du premier fichier de configuration, au lieu d'effectuer un ajout. C'est le cas même si les deux fichiers de configuration avec le même nom de fichier sont sur différents chemins de fichier.

L'exemple précédent montre l'utilisation des deux fichiers de configuration, mais il n'y a pas de limite au nombre de fichiers de configuration que vous pouvez ajouter à la configuration de l'agent. Vous pouvez également combiner l'utilisation des fichiers de configuration situés sur les serveurs et les configurations situées dans le Parameter Store.