Inicio rápido: instalar y configurar el agente de CloudWatch Logs en una instancia EC2 de Linux en ejecución

Para configurar el rol o usuario de IAM de CloudWatch Logs

1. Abra la consola de IAM en https://console.aws.amazon.com/iam/.

2. Seleccione Roles (Roles) en el panel de navegación.

3. Para elegir el rol, seleccione el nombre de rol (no seleccione la casilla de verificación junto al nombre).

4. Elija Attach Policies (Asociar políticas), Create Policy (Crear política).

   Se abrirá una nueva pestaña o ventana del navegador.

5. Elija la pestaña JSON y escriba el siguiente documento de política JSON.

   {
     "Version":"2012-10-17",		 	 	 
     "Statement": [
       {
         "Effect": "Allow",
         "Action": [
           "logs:CreateLogGroup",
           "logs:CreateLogStream",
           "logs:PutLogEvents",
           "logs:DescribeLogStreams"
       ],
         "Resource": [
           "*"
       ]
     }
    ]
   }
   

6. Cuando haya terminado, elija Review policy (Revisar la política). El validador de políticas notifica los errores de sintaxis.

7. En la página Review Policy (Revisar la política), escriba un Name (Nombre) y una Description (Descripción) (opcional) para la política que crea. Revise el Summary (Resumen) de la política para ver los permisos concedidos por su política. A continuación, elija Create policy (Crear política) para guardar su trabajo.

8. Cierre la pestaña o ventana del navegador y vuelva a la página Add permissions (Agregar permisos) para su rol. Elija Refresh (Actualizar) y, a continuación, elija la política nueva para adjuntarla al rol.

9. Elija Attach Policy (Adjuntar política).

Para instalar y configurar CloudWatch Logs en una instancia de Amazon Linux existente

A partir de la AMI de Amazon Linux 2014.09, el agente de CloudWatch Logs está disponible como una instalación de RPM con el paquete awslogs. Las versiones anteriores de Amazon Linux pueden obtener acceso al paquete awslogs mediante la actualización de su instancia con el comando sudo yum update -y. Al instalar el paquete awslogs como RPM en lugar de utilizar el instalador de CloudWatch Logs, la instancia recibe actualizaciones de paquete regulares y parches de AWS sin tener que volver a instalar el agente de CloudWatch Logs manualmente.

1. Conéctese con su instancia de Amazon Linux. Para obtener más información, consulte Conexión a una instancia en la Guía del usuario de Amazon EC2.

   Para obtener más información sobre problemas de conexión, consulte Solucionar problemas de conexión con la instancia en la Guía del usuario de Amazon EC2.

2. Actualice la instancia de Amazon Linux para recoger los últimos cambios en los repositorios de paquetes.

   sudo yum update -y

3. Instale el paquete awslogs. Este es el método recomendado para instalar awslogs en instancias de Amazon Linux.

   sudo yum install -y awslogs

4. Edite el archivo /etc/awslogs/awslogs.conf a fin de configurar los registros para realizar seguimiento. Para obtener más información sobre la edición de este archivo, consulte Referencia del agente de CloudWatch Logs.

5. De forma predeterminada, el archivo /etc/awslogs/awscli.conf apunta a la región EE. UU.-este-1. Para enviar los registros a una región diferente, edite el archivo awscli.conf y especifique dicha región.

6. Inicie el servicio awslogs.

   sudo service awslogs start

   Si ejecuta Amazon Linux 2, inicie el servicio awslogs con el siguiente comando.

   sudo systemctl start awslogsd

7. (Opcional) Compruebe el archivo /var/log/awslogs.log para ver si se han registrado errores al iniciar el servicio.

8. (Opcional) Ejecute el siguiente comando para iniciar el servicio awslogs en cada arranque del sistema.

   sudo chkconfig awslogs on

   Si ejecuta Amazon Linux 2, utilice el siguiente comando para iniciar el servicio en cada arranque del sistema.

   sudo systemctl enable awslogsd.service

9. Debería ver el grupo de registro y el flujo de registros de nueva creación en la consola de CloudWatch después de que el agente haya estado en ejecución durante unos minutos.

   Para obtener más información, consulte Vea los datos de registro enviados a Registros de CloudWatch.

Para instalar y configurar CloudWatch Logs en una instancia de Ubuntu Server, CentOS o Red Hat existente

Si utiliza una AMI que ejecuta Ubuntu Server, CentOS o Red Hat, utilice el siguiente procedimiento para instalar manualmente el agente de CloudWatch Logs en la instancia.

1. Conéctese a la instancia EC2. Para obtener más información, consulte Conexión a una instancia en la Guía del usuario de Amazon EC2.

   Para obtener más información sobre problemas de conexión, consulte Solucionar problemas de conexión con la instancia en la Guía del usuario de Amazon EC2.

2. Ejecute el instalador del agente de CloudWatch Logs CON una de estas dos opciones. Puede ejecutarlo directamente desde Internet o descargar los archivos y ejecutarlo de forma independiente.

   nota

   Si ejecuta CentOS 6.x, Red Hat 6.x o Ubuntu 12.04, utilice los pasos para descargar y ejecutar el instalador independiente. La instalación del agente de CloudWatch Logs directamente desde Internet no es compatible con estos sistemas.

   nota

   En Ubuntu, ejecute apt-get update antes de ejecutar los comandos siguientes.

   Para ejecutarlo directamente desde Internet, utilice los siguientes comandos y siga las instrucciones:

   curl https://s3.amazonaws.com/aws-cloudwatch/downloads/latest/awslogs-agent-setup.py -O

   sudo python ./awslogs-agent-setup.py --region us-east-1

   Si el comando anterior no funciona, pruebe lo siguiente:

   sudo python3 ./awslogs-agent-setup.py --region us-east-1

   Para descargar y ejecutarlo de forma independiente, utilice los siguientes comandos y siga las instrucciones:

   curl https://s3.amazonaws.com/aws-cloudwatch/downloads/latest/awslogs-agent-setup.py -O

   curl https://s3.amazonaws.com/aws-cloudwatch/downloads/latest/AgentDependencies.tar.gz -O

   tar xvf AgentDependencies.tar.gz -C /tmp/

   sudo python ./awslogs-agent-setup.py --region us-east-1 --dependency-path /tmp/AgentDependencies

   Para instalar el agente de CloudWatch Logs, especifique las regiones us-east-1, us-west-1, us-west-2, ap-south-1, ap-northeast-2, ap-southeast-1, ap-southeast-2, ap-northeast-1, eu-central-1, eu-west-1 o sa-east-1.

   nota

   Para obtener más información sobre la versión actual y el historial de versiones de awslogs-agent-setup, consulte CHANGELOG.txt.

   El instalador del agente de CloudWatch Logs requiere cierta información durante la configuración. Antes de comenzar, debe saber qué archivo de registros monitorear y su formato de marca temporal. También debe tener preparada la siguiente información.

   Elemento	Descripción
   AWSID de clave de acceso de	Pulse Intro si utiliza un rol de IAM. De lo contrario, escriba su ID de clave de acceso de AWS.
   AWSClave de acceso secreta de	Pulse Intro si utiliza un rol de IAM. De lo contrario, escriba su clave de acceso secreta de AWS.
   Nombre de región predeterminado	Pulse Intro. La región predeterminada es us-east-2. Puede configurarlo a us-east-1, us-west-1, us-west-2, ap-south-1, ap-northeast-2, ap-southeast-1, ap-southeast-2, ap-northeast-1, eu-central-1, eu-west-1 o sa-east-1.
   Formato de salida predeterminado	Déjelo en blanco y pulse Intro.
   Ruta del archivo de registros que cargar	La ubicación del archivo que contiene los datos de registro que se van a enviar. El instalador sugiere una ruta.
   Nombre de grupo de registro de destino	El nombre de su grupo de registro. El instalador sugiere un nombre de grupo de registro.
   Nombre de flujo de registros de destino	De forma predeterminada, es el nombre del host. El instalador sugiere un nombre de host.
   Formato de marca temporal	Especifique el formato de la marca temporal en el archivo de registros especificado. Elija personalizado para especificar su propio formato.
   Posición inicial	Cómo se han cargado los datos. Establézcalo en start_of_file para cargar todo en el archivo de datos. Establézcalo en end_of_file para cargar solo los datos recién agregados.

   Una vez que haya completado estos pasos, el instalador preguntará si desea configurar otro archivo de registros. Puede ejecutar el proceso tantas veces como desee para cada archivo de registros. Si no tiene más archivos de registros que monitorear, elija N cuando el instalador lo solicite para configurar otro registro. Para obtener más información sobre la configuración en el archivo de configuración del agente, consulte Referencia del agente de CloudWatch Logs.

   nota

   No se admite configurar varias fuentes de registro para enviar datos a un único flujo de registro.

3. Debería ver el grupo de registro y el flujo de registros de nueva creación en la consola de CloudWatch después de que el agente haya estado en ejecución durante unos minutos.

   Para obtener más información, consulte Vea los datos de registro enviados a Registros de CloudWatch.