¿Cómo puedo instalar y configurar el agente unificado de CloudWatch para insertar 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, marque la casilla CloudWatchAgentServerPolicy.
7. Seleccione 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 en su instancia de EC2

Amazon Linux, Amazon Linux 2 y Amazon Linux 2023

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

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.

Para instalar el agente de CloudWatch, ejecute el siguiente comando:

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

Windows

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

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

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

Vaya al directorio que contiene el paquete y, a continuación, 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 añadir o eliminar métricas o registros. Para obtener más información, consulte la sección Consejos para completar el asistente de archivos de configuración del agente.

Amazon Linux, Amazon Linux 2 y Amazon Linux 2023

Para crear el archivo de configuración del agente, ejecute el siguiente comando:

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

Windows

Para crear el archivo de configuración del agente, ejecute el siguiente comando:

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

De forma predeterminada, el asistente crea el archivo de configuración del agente en la siguiente ubicación: C:\Archivos de programa\Amazon\AmazonCloudWatchAgent\config.json.

Inicio del agente de CloudWatch

Amazon Linux, Amazon Linux 2 y Amazon Linux 2023

Para iniciar el agente de CloudWatch, 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.

Windows

Introduzca el siguiente comando en PowerShell como administrador:

Env:ProgramFiles\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1 -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.

Ejemplo de comando:

Env:ProgramFiles\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1 -a fetch-config -m ec2 -c file:'C:\Program Files\Amazon\AmazonCloudWatchAgent\config.json' -s

Ahora las métricas y los registros se insertan en CloudWatch. De forma predeterminada, el agente inserta las métricas en NameSpace CWAgent.

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

¿Desea activar el daemon de StatsD? ¿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 el agente awslogs está instalado y en ejecución, 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 monitorear.

¿Desea almacenar la configuración en el Almacén de parámetros de AWS Systems Manager? Si desea almacenar este archivo de configuración del agente en el Almacén de parámetros para reutilizarlo 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.

Cuando complete el asistente, el archivo de configuración del agente se almacenará en /opt/aws/amazon-cloudwatch-agent/bin/config.json de forma predeterminada. Puede editar este archivo manualmente para añadir o eliminar métricas o registros.

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.