Cree el archivo de configuración del agente de CloudWatch
Antes de ejecutar el agente de CloudWatch en un servidor, debe crear uno o más archivos de configuración del agente de CloudWatch.
El archivo de configuración del agente es un archivo JSON que especifica las métricas, registros y seguimientos que debe recopilar el agente, incluidas las métricas personalizadas. Puede crearlo mediante el asistente o desde cero. También puede utilizar el asistente para crear inicialmente el archivo de configuración y, a continuación, modificarlo manualmente. Si lo crea o lo modifica manualmente, el proceso es más complejo, pero dispone de más control sobre las métricas recopiladas y puede especificar métricas no disponibles en el asistente.
Cada vez que cambie el archivo de configuración del agente, debe reiniciar el agente para que los cambios surtan efecto. Para reiniciar el agente, siga las instrucciones que se describen en (Opcional) Modifique la configuración común y el perfil con nombre para el agente de CloudWatch.
Una vez que haya creado un archivo de configuración, puede guardarlo manualmente como un archivo JSON y, a continuación, utilizar este archivo al instalar el agente en sus servidores. Si lo prefiere, se puede almacenar en el almacén de parámetros de Systems Manager si va a utilizar Systems Manager al instalar el agente en los servidores.
El agente de CloudWatch admite el uso de varios archivos de configuración. Para obtener más información, consulte Creación de varios archivos de configuración del agente de CloudWatch.
Las métricas, los registros y los seguimientos recopilados por el agente de CloudWatch conllevan cargos. Para obtener más información sobre precios, consulte Precios de Amazon CloudWatch
Contenido
Creación de varios archivos de configuración del agente de CloudWatch
En los servidores Linux y Windows, puede configurar el agente de CloudWatch para que utilice varios archivos de configuración. Por ejemplo, puede utilizar un archivo de configuración común que recopile un conjunto de métricas, registros y seguimientos que siempre desea recopilar de todos los servidores de la infraestructura. Y también puede utilizar archivos de configuración adicionales que recopilen métricas de determinadas aplicaciones o en situaciones concretas.
Para realizar esta configuración, primero debe crear los archivos de configuración que desea utilizar. Los archivos de configuración que se vayan a utilizar conjuntamente en el mismo servidor deben tener nombres diferentes. Puede almacenar los archivos de configuración en los servidores o en el almacén de parámetros.
Inicie el agente de CloudWatch mediante la opción fetch-config
y especifique el primer archivo de configuración. Para añadir el segundo archivo de configuración al agente en ejecución, utilice el mismo comando pero con la opción append-config
. Se recopilan todas las métricas, registros y seguimientos indicados en los dos archivos de configuración. Los siguientes comandos de ejemplo ilustran este escenario mediante almacenes de configuración como archivos. La primera línea inicia el agente mediante el archivo de configuración infrastructure.json
y la segunda añade el archivo de configuración app.json
.
Los siguientes comandos de ejemplo son para 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
Los siguientes comandos de ejemplo son para 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"
Los siguientes archivos de configuración de ejemplo ilustran un uso de esta característica. El primer archivo de configuración se utiliza para todos los servidores de la infraestructura y el segundo solo recopila los registros de una determinada aplicación y se asocia a los servidores que ejecutan dicha aplicación.
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" } ] } } } }
Los archivos de configuración que se añadan a la configuración deben tener nombres diferentes y distintos del archivo de configuración inicial. Si utiliza append-config
con un archivo de configuración que tiene el mismo nombre que otro que ya está utilizando el agente, el comando append sobrescribe la información del primer archivo de configuración en lugar de añadirle nuevo contenido. Esto es válido incluso si los dos archivos de configuración con el mismo nombre se encuentran en diferentes rutas de archivo.
El ejemplo anterior muestra el uso de dos archivos de configuración, pero no existe ningún límite respecto al número de archivos de configuración que se pueden añadir a la configuración del agente. También puede combinar el uso de archivos de configuración ubicados en servidores con las configuraciones ubicadas en el almacén de parámetros.