Installation de l’agent CloudWatch sur un serveur sur site

Si vous avez téléchargé l’agent CloudWatch sur un ordinateur et créé votre fichier de configuration d’agent, vous pouvez réutiliser ce fichier de configuration pour installer l’agent sur d’autres serveurs sur site.

Téléchargement de l'agent CloudWatch sur un serveur sur site

Vous pouvez télécharger le package de l'agent CloudWatch à l'aide de Systems Manager Run Command ou d'un lien de téléchargement Amazon S3.

Téléchargement à l'aide de Systems Manager

Pour utiliser la fonctionnalité Exécuter la commande de Systems Manager, vous devez enregistrer votre serveur sur site auprès d'Amazon EC2 Systems Manager. Pour plus d'informations, consultez Setting Up Systems Manager in Hybrid Environments (Configuration de Systems Manager dans des environnements hybrides) dans le Guide de l'utilisateur AWS Systems Manager.

Si vous avez déjà enregistré votre serveur, mettez à jour l'agent SSM Agent vers la dernière version.

Pour plus d'informations sur la mise à jour de l'agent SSM sur un serveur exécutant Linux, consultez Installation de l'agent SSM Agent pour un environnement hybride (Linux) dans le Guide de l'utilisateur AWS Systems Manager.

Pour plus d'informations sur la mise à jour de l'agent SSM sur un serveur exécutant Windows Server, consultez Installation de l'agent SSM Agent pour un environnement hybride (Windows) dans le Guide de l'utilisateur AWS Systems Manager.

(Installation sur un serveur sur site) Spécification la région IAM et AWS

Pour activer l'agent CloudWatch afin d'envoyer des données à partir d'un serveur sur site, vous devez spécifier la clé d'accès et la clé secrète de l'utilisateur IAM que vous avez créé précédemment.

Vous devez également spécifier la région AWS à laquelle envoyer les métriques à l'aide du champ region.

Voici un exemple de ce fichier.

[AmazonCloudWatchAgent]
aws_access_key_id=my_access_key
aws_secret_access_key=my_secret_key
region = us-west-1

Pour my_access_key et my_secret_key, utilisez les clés provenant de l'utilisateur IAM qui ne possède pas les autorisations pour écrire sur le Parameter Store du Systems Manager.

Aucune autre action n'est requise de votre part si vous nommez ce profil AmazonCloudWatchAgent. Le cas échéant, vous pouvez lui attribuer un nom différent et spécifier ce nom comme valeur pour shared_credential_profile dans le fichier common-config.toml, ce qui est détaillé dans la section suivante.

Voici un exemple d'utilisation de la commande aws configure pour créer un profil nommé pour l'agent CloudWatch. Cet exemple suppose que vous utilisez le nom de profil par défaut de AmazonCloudWatchAgent.

(Facultatif) Modification de la configuration commune et du profil nommé pour l'agent CloudWatch

L'agent CloudWatch comprend un fichier de configuration nommé common-config.toml. Le cas échéant, vous pouvez utiliser ce fichier pour spécifier le proxy et les informations de région.

Sur un serveur exécutant Linux, ce fichier se trouve dans le répertoire /opt/aws/amazon-cloudwatch-agent/etc. Sur un serveur exécutant Windows Server, ce fichier se trouve dans le répertoire C:\ProgramData\Amazon\AmazonCloudWatchAgent.

Le common-config.toml par défaut est comme suit :

# This common-config is used to configure items used for both ssm and cloudwatch access
 
 
## Configuration for shared credential.
## Default credential strategy will be used if it is absent here:
##            Instance role is used for EC2 case by default.
##            AmazonCloudWatchAgent profile is used for onPremise case by default.
# [credentials]
#    shared_credential_profile = "{profile_name}"
#    shared_credential_file= "{file_name}"
 
## Configuration for proxy.
## System-wide environment-variable will be read if it is absent here.
## i.e. HTTP_PROXY/http_proxy; HTTPS_PROXY/https_proxy; NO_PROXY/no_proxy
## Note: system-wide environment-variable is not accessible when using ssm run-command.
## Absent in both here and environment-variable means no proxy will be used.
# [proxy]
#    http_proxy = "{http_url}"
#    https_proxy = "{https_url}"
#    no_proxy = "{domain}"

Toutes les lignes comportent initialement un commentaire. Pour définir le profil des informations d'identification ou les paramètres de proxy, retirez # de cette ligne et indiquez une valeur. Vous pouvez éditer ce fichier manuellement ou en utilisant la fonctionnalité Exécuter la commande RunShellScript dans Systems Manager :