¿Cómo puedo instalar y configurar el agente unificado de CloudWatch para insertar métricas y registros de mi instancia de EC2 en CloudWatch?
Quiero usar el agente unificado de Amazon CloudWatch para insertar métricas y registros de mi instancia de Amazon Elastic Compute Cloud (Amazon EC2) en Amazon CloudWatch.
Solución
Nota: 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
1. Abra la consola de AWS Identity and Access Management (IAM).
2. En el panel de navegación, elija Roles.
3. Seleccione Crear rol.
4. En Elegir el servicio que utilizará este rol, seleccione EC2.
5. Elija Siguiente: Permisos.
6. En la lista de políticas, marque la casilla 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 en su instancia de EC2
Amazon Linux, Amazon Linux 2 y Amazon Linux 2023
1. 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
En el comando anterior, sustituya region por su región de AWS.
2. Para instalar el agente de CloudWatch, ejecute el siguiente comando:
sudo rpm -U ./amazon-cloudwatch-agent.rpm
Windows
1. 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
En el comando anterior, sustituya region por su región de AWS.
2. Vaya al directorio que contiene el paquete y, a continuación, escriba el siguiente comando:
msiexec /i amazon-cloudwatch-agent.msi
Creación del archivo de configuración del agente
Nota: Para simplificar, utilice el asistente para crear el archivo de configuración del agente. Más adelante, 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
sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-config-wizard
Windows
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 monitorear 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í.
Importante: 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.
Contenido relevante
- OFICIAL DE AWSActualizada hace 2 años
- OFICIAL DE AWSActualizada hace un año
- OFICIAL DE AWSActualizada hace 3 años
- OFICIAL DE AWSActualizada hace 2 años