¿Cómo puedo instalar y configurar el agente unificado de CloudWatch para enviar métricas y registros de mi instancia de EC2 en CloudWatch?

Resolución

Antes de empezar, establezca conectividad a Internet en su instancia de EC2. La instancia de EC2 debe tener conectividad a Internet para conectarse a los puntos de enlace necesarios.

Creación de un rol de IAM para ejecutar el agente de CloudWatch en su instancia de EC2

Siga estos pasos:

1. Abra la consola de AWS Identity and Access Management (IAM).
2. En el panel de navegación, seleccione Roles.
3. Seleccione Crear rol.
4. En Elegir el servicio que utilizará este rol, seleccione EC2.
5. Seleccione Siguiente: Permisos.
6. En la lista de políticas, seleccione CloudWatchAgentServerPolicy.
7. Elija Siguiente: Etiquetas y, a continuación, Siguiente: Revisar.
8. En Nombre del rol, introduzca un nombre para el rol, por ejemplo, CloudWatchAgentServerRole.
9. (Opcional) Proporcione una descripción del rol.
10. Confirme que CloudWatchAgentServerPolicy aparezca junto a Políticas.
11. Seleccione Crear rol.
12. Asocie el nuevo rol de IAM a la instancia de EC2.

Descarga e instalación del agente unificado de CloudWatch

Instancia de EC2 de Linux

Siga estos pasos:

1. Para descargar el agente de CloudWatch, ejecute el siguiente comando en su terminal:

   wget https://s3.region.amazonaws.com/amazoncloudwatch-agent-region/amazon_linux/amd64/latest/amazon-cloudwatch-agent.rpm

   Nota: En el comando anterior, sustituya region por su región de AWS.

2. Para instalar el agente de CloudWatch, ejecute el siguiente comando en su terminal:

   sudo rpm -U ./amazon-cloudwatch-agent.rpm

Instancia de EC2 de Windows

Siga estos pasos como administrador en Windows PowerShell:

1. Navegue hasta la carpeta en la que desea descargar el instalador:

   cd "path"

   Nota: En el comando anterior, sustituya path por la ruta a la carpeta en la que desea descargar el instalador.

2. Para descargar el agente de CloudWatch, ejecute el siguiente comando:

   Invoke-WebRequest -Uri https://s3.region.amazonaws.com/amazoncloudwatch-agent-region/windows/amd64/latest/amazon-cloudwatch-agent.msi -outFile amazon-cloudwatch-agent.msi

   Nota: En el comando anterior, sustituya region por su región.

   Si su versión de TLS es anterior a la versión 1.2, aparece el siguiente error al ejecutar el comando Invoke-WebRequest anterior:

   «Invoke-WebRequest: la solicitud se ha anulado: no se ha podido crear un canal seguro SSL/TLS»

   Para configurar la versión de TLS, ejecute el siguiente comando y, a continuación, vuelva a ejecutar el comando Invoke-WeRequest anterior:

   [Net.ServicePointManager]::SecurityProtocol = "Tls, Tls11, Tls12, Ssl3"

3. Para iniciar el instalador del agente, ejecute el siguiente comando:

   msiexec /i amazon-cloudwatch-agent.msi

Creación del archivo de configuración del agente

Para crear el archivo de configuración del agente, utilice el asistente. A continuación, edite manualmente el archivo para agregar o eliminar métricas o registros.

Instancia de EC2 de Linux

Ejecute el siguiente comando:

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-config-wizard

Instancia de EC2 de Windows

Ejecute el siguiente comando como administrador en Windows PowerShell:

cd "C:\Program Files\Amazon\AmazonCloudWatchAgent"  
.\amazon-cloudwatch-agent-config-wizard.exe

El asistente crea el archivo de configuración del agente con la ruta C:\Program Files\Amazon\AmazonCloudWatchAgent\config.json de forma predeterminada.

Inicio del agente de CloudWatch

Instancia de EC2 de Linux

Ejecute el siguiente comando:

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -m ec2 -c file:configuration-file-path -s

Nota: En el ejemplo anterior, sustituya configuration-file-path por la ruta del archivo de configuración.

Instancia de EC2 de Windows

Ejecute el siguiente comando como administrador en Windows PowerShell:

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

Nota: En el comando anterior, sustituya configuration-file-path por la ruta de su configuración.

De forma predeterminada, el agente envía las métricas a NameSpace CWAgent.

Verificación del estado del agente

El agente tarda en rellenar las métricas que ha configurado en CloudWatch. Para comprobar si el agente se está ejecutando antes de que rellene las métricas, ejecute los siguientes comandos.

Instancia de EC2 de Linux:

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -m ec2 -a status

Instancia de EC2 de Windows:

& "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -m ec2 -a status

Consejos para el asistente de archivos de configuración del agente

Utilice las siguientes sugerencias para responder a las preguntas que tenga cuando utilice el asistente de archivos de configuración del agente.

¿Desea activar el daemon de StatsD? y ¿Quiere supervisar las métricas de collectd? Si tiene instalados los complementos StatsD y collectd en su instancia de EC2, seleccione Sí para responder a estas preguntas.

¿Qué configuración predeterminada de las métricas desea? Para obtener más información sobre los detalles de las configuraciones, consulte ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-preset-metrics)Conjuntos predefinidos de métricas del agente de CloudWatch[. Luego, elija la opción que mejor se adapte a su caso práctico.

¿Tiene algún archivo de configuración del agente de Registros de CloudWatch que pueda importar para migrarlo? Si ha instalado el agente awslogs y se está ejecutando, seleccione Sí. Si elige Sí, el asistente leerá el archivo de configuración del agente awslogs (/etc/awslogs/awslogs.conf o /var/awslogs/etc/awslogs.conf) para determinar los archivos de registro que debe supervisar.

¿Desea almacenar la configuración en el Almacén de parámetros de AWS Systems Manager? Para almacenar el archivo de configuración del agente en el Almacén de parámetros para volver a utilizarlo más adelante, seleccione Sí. Si almacena el archivo de configuración del agente en el Almacén de parámetros, el comando para iniciar el agente será distinto.

Tras configurar el asistente, el archivo de configuración del agente se almacenará en /opt/aws/amazon-cloudwatch-agent/bin/config.json de forma predeterminada. Para agregar o eliminar métricas o registros, puede editar el archivo manualmente.

Para ver un ejemplo de archivo de configuración personalizado, consulte Archivo de configuración del agente de CloudWatch: ejemplos completos.

Nota: Si modifica el archivo de configuración del agente, utilice el comando fetch-config para iniciar el agente y asegurarse de que los cambios se reflejen en el agente.

Inicio y detención del agente de CloudWatch

Para obtener más información, consulte Cierre y reinicio del agente de CloudWatch.